'\"macro stdmacro
.if n .pH g1.xserver @(#)xserver	40.3 of 1/9/90
.nr X
.if \nX=0 .ds x} XSERVER 1 "9/1/88" "X\s-2WIN\s+2 3.0" "\&"
.if \nX=1 .ds x} XSERVER 1 "9/1/88" "X\s-2WIN\s+2 3.0"
.if \nX=2 .ds x} XSERVER 1 "" "\&"
.if \nX=3 .ds x} XSERVER "" "" "\&"
.TH \*(x}
.tr ~
.SH NAME
X - X Window System server
.SH SYNOPSIS
.B X
[:displaynumber] [-option ...] [ttyname]
.SH DESCRIPTION
.I X
is the generic name for the X Window System server and is started from
the \fIxinit(1)\fP program. 
The \fIdisplaynumber\fP argument is used
by clients in their DISPLAY environment variables to indicate which server
to contact (large machines may have several displays attached).	 This
number is usually in the range of 0-6 and is also used in determining the
names of various startup files.	 
.PP
The executable that is invoked when \fIX\fP is run
is actually one of a collection of programs that depend on the hardware
that is installed on the machine.  
.in -4
.SH "STARTING THE SERVER"
.PP
Installations that run more than one window system will still need to use the
\fIxinit\fP utility.  However, \fIxinit\fP is to be considered a tool for
building startup scripts and is not intended for use by end users.  Site
adminstrators are \fBstrongly\fP urged to build nicer interfaces for novice
users.
.PP
When the sample 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.
.SH OPTIONS
The following options can be given on the command line to any X server.
Any items marked with <no action> are not supported by the AT&T X server.
.TP 8
.B \-a \fInumber\fP
sets pointer acceleration (i.e. the ratio of how much is reported to how much
the user actually moved the pointer). <no action>
.TP 8
.B \-bs
disables backing store support on all screens.
.TP 8
.B \-c
turns off key-click. <no action> 
.TP 8
.B c \fIvolume\fP
sets key-click volume (allowable range: 0-8). <no action>
.TP 8
.B \-f \fIvolume\fP
sets feep (bell) volume (allowable range: 0-7).
.TP 8
.B \-logo
turns on the X Window System logo display in the screen-saver.
.TP 8
.B nologo
turns off the X Window System logo display in the screen-saver.
.TP 8
.B \-p \fIminutes\fP
sets screen-saver pattern cycle time in minutes.
.TP 8
.B \-r
turns off auto-repeat. <no action>
.TP 8
.B r
turns on auto-repeat.
.TP 8
.B \-s \fIminutes\fP
sets screen-saver timeout time in minutes.
.TP 8
.B \-su
disables save under support on all screens.
.TP 8
.B \-t \fInumbers\fP
sets pointer acceleration threshold in pixels (i.e. after how many pixels
pointer acceleration should take effect). <no action>
.TP 8
.B \-to \fIseconds\fP
sets default connection timeout in seconds.
.TP 8
.B v
sets video blanking on for screen-saver preference.
.TP 8
.B \-v
sets screen-saver preference without video blanking.
.TP 8
.B \-co \fIfilename\fP
sets name of RGB color database
.TP 8
.B \-help
prints a usage message
.TP 8
.B \-fp \fIfontPath
sets the search path for fonts
.TP 8
.B \-fc \fIcursorFont\fP
sets default cursor font
.TP 8
.B \-fn \fIfont\fP
sets the default font
.TP 8
.B \-wm
forces the default backing-store of all windows to be WhenMapped;
a cheap trick way of getting backing-store to apply to all windows.
.PP
Many servers also have device-specific command line options.  See the
manual pages for the individual servers for more details.
.SH "SECURITY"
.PP
The sample server uses an access control list for deciding whether or not
to accept connections from clients on a particular machine.  This list
initially consists of the host on which the server is running as well as
any machines listed in the file \fI/etc/X\fBn\fI.hosts\fR, where \fBn\fP
is the display number of the server.  
.PP
Users can add or remove hosts from this list and enable or disable access
control using the \fIxhost\fP command from the same machine as the server.
.PP
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.  The core protocol does
have support for providing authentication information when establishing
connections, but is not used in the sample implementation.  Sites that have
authentication and authorization systems (such as Kerberos) might wish to make
use of the hooks in the libraries and the server to provide additional
security. 
.SH
Fonts are usually stored as individual files in directories.  The list of
directories in which the server looks when trying to open a font is controlled
by the \fIfont path\fP.  Although most sites will choose to have the server
start up with the appropriate font path (using the \fI-fp\fP option mentioned
above), it can be overridden using the \fIxset\fP program.
.PP
The default font path for
the sample server contains three directories:
.TP 8
.I /usr/lib/X11/fonts/misc
This directory contains several miscellaneous fonts that are useful on all
systems.  It contains a very small family of fixed-width fonts (\fB6x10\fP, 
\fB6x12\fP, \fB6x13\fP, \fB8x13\fP, \fB8x13bold\fP, and \fB9x15\fP) and the
cursor font.  It also has font name aliases for the commonly used fonts
\fBfixed\fP and \fBvariable\fP.
.TP 8
.I /usr/lib/X11/fonts/75dpi
This directory contains fonts contributed by Adobe Systems, Inc. and
Digital Equipment Corporation and by Bitstream, Inc.
for 75 dots per inch displays.  An integrated selection of sizes, styles, 
and weights are provided for each family.
.TP 8
.I /usr/lib/X11/fonts/100dpi
This directory contains versions of some of 
the fonts in the \fI75dpi\fP directory
for 100 dots per inch displays.
.PP
An additional directory, /usr/lib/X11/fonts/Xol,  contains the OPEN LOOK 
fonts. This directory is
not part of the server's default font path, but can be set using the
XWINFONTPATH environment variable. The XWINFONTPATH is an environment
variable that should be set to the full pathname of the directories that
should be part of the server's default font path. This variable should
be exported. For example, to include the OPEN LOOK fonts in the server's
default font path put the following commands in a startup file:
.PP
XWINFONTPATH=/usr/lib/X11/fonts/Xol,/usr/lib/X11/fonts/misc/,/usr
      /lib/X11/fonts/ 75dpi/,/usr/lib/X11/fonts/100dpi
.br
export XWINFONTPATH
.PP
Both the default font path and the XWINFONTPATH environment variable can
be overriden by using a command line argument when starting the server.
.PP
Font databases are created by running the \fImkfontdir\fP program in the
directory containing the compiled versions of the fonts (the \fI.snf\fP files).
Whenever fonts are added to a directory, \fImkfontdir\fP should be rerun
so that the server can find the new fonts.  \fBIf \fImkfontdir\fP is not
run, the server will not be able to find any fonts in the directory.\fR
.SH DIAGNOSTICS
Too numerous to list them all.
If run from \fIinit(8)\fP, errors are logged in the file \fI/usr/adm/X*msgs\fP,
.SH FILES
.TP 30
/etc/X*.hosts
Initial access control list
.TP 30
/usr/lib/X11/fonts/misc/,/usr/lib/X11/fonts/75dpi/,/usr/lib/X11/fonts/100dpi 
Font directories
.TP 30
/usr/lib/X11/rgb.<display_type>.txt
Color database
.TP 30
/usr/adm/X*msgs
Error log file
.SH "SEE ALSO"
X(1),  mkfontdir(1),
xinit(1), xterm(1), olwm(1), xhost(1), xset(1), xsetroot(1), 
.I "X Window System Protocol,"
.I "Definition of the Porting Layer for the X v11 Sample Server,"
.I "Strategies for Porting the X v11 Sample Server,"
.I "Godzilla's Guide to Porting the X V11 Sample Server"
.SH BUGS
The option syntax is inconsistent with itself and \fIxset(1)\fP.
.PP
The acceleration option should take a numerator and a denominator like the
protocol.
.PP
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
tailorable to particular displays.
.PP
.SH CAVEAT
The X server must be killed with -2 an NOT -9; this allows the server
environment to reset itself to its previous state.
The X server resets itself to default settings when no clients are
active.
.PP
.SH COPYRIGHT
Copyright 1984, 1985, 1986, 1987, 1988, Massachusetts Institute of Technology.


