Xdomain(1) UNIX Programmer's Manual Xdomain(1)
NAME
Xdomain - X Window System server for Domain/OS
SYNOPSIS
Xdomain :displaynumber [option] ttyname
DESCRIPTION
X is the window system server. The displaynumber argument
is used by clients in their DISPLAY environment variable to
indicate which server to contact (large machines may have
several displays attached). This number can be any number,
but there can't be more than 4 of them. If no number is
specified, 0 is used. This number is also used in determin-
ing the names of various startup files. The ttyname argu-
ment is passed in by init and isn't used.
When the server starts up, it takes over the display. If
you are running on a workstation whose console is the
display, you cannot log into the console while the server is
running.
The Hewlett-Packard server has support for the following
protocols:
TCP/IP
The server listens on port htons(6000+N), where N is
the display number.
Local IPC Mechanism
OPTIONS
The following options can be given on the command line:
-a number
sets pointer acceleration (i.e. the ratio of how
much is reported to how much the user actually moved
the pointer).
-auth authorization-file
Specifies a file which contains a collection of
authorization records used to authenticate access.
bc disables certain kinds of error checking, for bug
compatibility with previous releases (e.g., to work
around bugs in R2 and R3 xterms and toolkits).
Deprecated.
-bs disables backing store support on all screens.
-c turns off key-click.
Printed 2/15/92 1
Xdomain(1) UNIX Programmer's Manual Xdomain(1)
c volume
sets key-click volume (allowable range: 0-100).
-co filename
sets name of RGB color database.
-dpi resolution
sets the resolution of the screen, in dots per inch.
To be used when the server cannot determine the
screen size from the hardware.
-f volume
sets feep (bell) volume (allowable range: 0-100).
-fc cursorFont
sets default cursor font.
-fn font
sets the default font.
-fp fontPath
sets the search path for fonts. This path is a
comma separated list of directories which the sample
server searches for font databases.
-help prints a usage message.
-I causes all remaining command line arguments to be
ignored.
-ld kilobytes
sets the data space limit of the server to the
specified number of kilobytes. The default value is
zero, making the data size as large as possible. A
value of -1 leaves the data space limit unchanged.
-ls kilobytes
sets the stack space limit of the server to the
specified number of kilobytes. The default value is
zero, making the stack size as large as possible. A
value of -1 leaves the stack space limit unchanged.
-logo turns on the X Window System logo display in the
screen-saver. There is currently no way to change
this from a client. This is the default.
nologo turns off the X Window System logo display in the
screen-saver. There is currently no way to change
this from a client.
-p minutes
sets screen-saver pattern cycle time in minutes.
Printed 2/15/92 2
Xdomain(1) UNIX Programmer's Manual Xdomain(1)
-r turns off auto-repeat.
r turns on auto-repeat.
-s minutes
sets screen-saver timeout time in minutes.
-su disables save under support on all screens.
-t number
sets pointer acceleration threshold in pixels (i.e.
after how many pixels pointer acceleration should
take effect).
-terminate
If the server ever recycles (all the clients die or
the server gets a SIGHUP), the server will exit.
-to seconds
sets default connection timeout in seconds.
ttyxx ignored, for servers started the ancient way (from
init).
v sets video-on screen-saver preference to screen
blanking. This is the default.
-v sets video-off screen-saver preference to a bouncing
X logo.
-wm forces the default backing-store of all windows to
be WhenMapped; a way of getting backing-store to
apply to all windows.
-x extension
loads the specified extension at runtime. Not sup-
ported.
noborrow
Inhibit borrow mode. When this flag is used, the
borrow mode mechanism can not be used - the borrow
hot key and signals are ignored. Useful if running
the server from init and the DM will never be run.
You can also have the X server connect to xdm using XDMCP.
Although this is not typically useful as it doesn't allow
xdm to manage the server process, it can be used to debug
XDMCP implementations, and serves as a sample implementation
of the server side of XDMCP. The following options control
the behavior of XDMCP.
-query host-name
Printed 2/15/92 3
Xdomain(1) UNIX Programmer's Manual Xdomain(1)
Enable XDMCP and send Query packets to the specified
host.
-broadcast
Enable XDMCP and broadcast BroadcastQuery packets to
the network. The first responding display manager
will be chosen for the session.
-indirect host-name
Enable XDMCP and send IndirectQuery packets to the
specified host.
-port port-num
Use an alternate port number for XDMCP packets.
Must be specified before any -query, -broadcast or
-indirect options.
-once Normally, the server keeps starting sessions, one
after the other. This option makes the server exit
after the first session is over.
-class display-class
XDMCP has an additional display qualifier used in
resource lookup for display-specific options. This
option sets that value, by default it is "MIT-
Unspecified" (not a very useful value).
-displayID display-id
Yet another XDMCP specific value, this one allows
the display manager to identify each display so that
it can locate the shared key.
RUNNING FROM INIT
It is possible to run Xdomain, instead of the Display
Manager, when the system boots by modifing the configuration
file specified for it in /etc/rc. If you just want to use
the node as a display server and plan to run all clients
from anther node, "touch /etc/daemons/Xdomain". (The
Display Manager is also run in this case unless you tell the
system not to (see /etc/rc) - this is usually not a problem
because things work as you would expect). If you want to
run clients on the same node as the server, use xdm. xdm
provides an environment vaguely similar to the Display
Manager. To run xdm at boot time, "touch /etc/daemons/xdm".
Be sure to configure xdm or you will probably be disapointed
with the results.
SECURITY
X uses an access control list for deciding whether or not to
accept a connection from a given client. This list
Printed 2/15/92 4
Xdomain(1) UNIX Programmer's Manual Xdomain(1)
initially consists of the machine on which the server is
running, and any hosts listed in the file /etc/X*.hosts
(where * is the display number). This file should contain
one line per host name, with no white space.
The user can manipulate a dynamic form of this list in the
server using the xhost(1) program from the same machine as
the server.
Unlike some window systems, X does not have any notion of
window operation permissions or place any restrictions on
what a client can do; if a program can connect to a display,
it has full run of the screen.
SIGNALS
X will catch the SIGHUP signal sent by init(1M) after the
initial process (usually the login terminal window) started
on the display terminates. This signal causes all connec-
tions to be closed (thereby disowning the terminal), all
resources to be freed, and all defaults restored.
A SIGTERM or SIGINT will cause X to gracefully exit.
SIGUSR1 and SIGUSR2 are used to trigger the borrow mode
mechanism. See Borrow Mode.
Borrow Mode
Unlike the share mode X server, the borrow mode server can
not share the display with the Display Manager. However, X
and the DM can pass the display, keyboard and mouse back and
forth. Sending a SIGUSR1 signal to X (or pressing Shift
Control F9) will cause it to pass the display back to the
DM. (While X does not have control of the display, recy-
cling and exiting is inhibited). Sending a SIGUSR2 signal
to X will cause it to take the display back from the DM.
You can still talk to the inactive display (manager), you
just can't see the results until it is borrowed back.
MISCELLANEOUS
To exit the server, you can press Shift-Control-Exit. This
is a bad idea if you ran just the server at boot time
(you'll have to reboot). OK if xdm ran the server from
boot.
The display drivers are loaded at server run time. This
means that the drivers will have to be in the correct places
and a magic incantation recited so the server can find the
drivers. This should have been done by the process that
Printed 2/15/92 5
Xdomain(1) UNIX Programmer's Manual Xdomain(1)
installed the server.
Xdomain requires 10.3.2 (and later) Domain/OS, Display
Manager, gprlib, awslib and pmlib. These were distributed
on a 10.3 PSK.
There are many programs that start the X server and set up
an environment (windows, window manager, etc). These
include xdm.
DIAGNOSTICS
Too numerous to list them all. If run boot time, errors are
logged in the file /usr/adm/X*msgs.
FILES
/etc/X*.hosts Initial access control list
/usr/lib/X11/fonts/... Font directories
/usr/lib/X11/rgb.txt Color database
/usr/lib/X11/rgb.pag Color database
/usr/lib/X11/rgb.dir Color database
/usr/adm/X*msgs Error log file
/usr/lib/X11/X*devices Input devices used by the
server
/usr/lib/X11/X*pointerkeys Keyboard pointer device file
/sys/mgrs.split/.. Directories containing the
display drivers
NOTES
The option syntax is inconsistent with itself and xset(1).
The acceleration option should take a numerator and a denom-
inator like the protocol.
If X dies before its clients, new clients won't be able to
connect until all existing connections have their TCP
TIME_WAIT timers expire.
The color database is missing a large number of colors.
However, there doesn't seem to be a better one available
that can generate RGB values.
Printed 2/15/92 6
Xdomain(1) UNIX Programmer's Manual Xdomain(1)
COPYRIGHT
Copyright 1988, 1989, Massachusetts Institute of Technology.
See X(1) for a full statement of rights and permissions.
ORIGIN
MIT Distribution
SEE ALSO
Xapollo(1), X(1), bdftosnf bitmap(1), getty(1M), get-
tydefs(4), gwindstop(1), hpterm(1), init(1M), inittab(4),
rgb(1), uwm(1), x11start(1), xclock(1), xfc(1), xfd(1),
xhost(1), xinit(1), xinitcolormap(1), xload(1), xmodmap(1),
xrefresh(1), xseethru(1), xset(1), xsetroot(1), xterm(1),
xwcreate(1), xwd(1), xwdestroy(1), xwininfo(1), xwud(1),
Programming With Xlib, Programming With the Xt Intrinsics
Printed 2/15/92 7