Annotation of researchv9/X11/src/X.V11R1/server/X.8c, revision 1.1.1.1

1.1       root        1: .TH X 8C "10 September 1987"  "X Version 11"
                      2: .SH NAME
                      3: X - X window system server
                      4: .SH SYNOPSIS
                      5: .B X
                      6: <display> [ option ... ] <tty>
                      7: .SH DESCRIPTION
                      8: .I X
                      9: is the window system server.
                     10: It is normally run automatically by \fIinit(8)\fP,
                     11: which provides the tty argument.
                     12: The display argument is the number of the bitmap display to service.
                     13: The number is typically in the range 0-6, and defines the ports the
                     14: server will accept connections on and the filename of the device.
                     15: .PP
                     16: The program \fIxinit(8)\fP is  usually used to start
                     17: X interactively.
                     18: .PP
                     19: The X that gets invoked in either of these ways is actually one
                     20: of a range of servers configured for the hardware you are running
                     21: on.  Their individual peculiarites are documented in separate
                     22: manual pages in this section.
                     23: .PP
                     24: Connections through the Unix domain, through TCP, and through DECnet are
                     25: currently possible.  The connections actually accepted by a server depend
                     26: on how it was compiled.  Unix domain connections are through \fI/dev/X*\fP,
                     27: where * is the display number.
                     28: TCP connections are through ports 6000+N (VAX byte order),
                     29: where N is the display number.  DECnet
                     30: connections are through object name ``X*'', where * is the display number.
                     31: .SH OPTIONS
                     32: The following options can be given on the command line to any X server, usually
                     33: when it is
                     34: started by \fIinit(1)\fP using information stored in the file \fI/etc/ttys\fP.
                     35: (see \fIttys(5)\fP for details):
                     36: .TP
                     37: \fB-a\fP #
                     38: sets mouse acceleration (pixels)
                     39: .TP
                     40: \fB-c\fP
                     41: turns off key-click
                     42: .TP
                     43: \fBc\fP #
                     44: sets key-click volume (0-8)
                     45: .TP
                     46: \fB-f\fP #
                     47: sets feep(bell) volume (0-7)
                     48: .TP
                     49: \fB-p\fP #
                     50: sets screen-saver pattern cycle time (minutes)
                     51: .TP
                     52: \fB-r\fP
                     53: turns off auto-repeat
                     54: .TP
                     55: \fBr\fP        
                     56: turns on auto-repeat
                     57: .TP
                     58: \fB-s\fP #
                     59: sets screen-saver timeout (minutes)
                     60: .TP
                     61: \fB-t\fP #
                     62: sets mouse threshold (pixels)
                     63: .TP
                     64: \fB-to\fP \fItimeout\fP
                     65: sets default screensaver timeout
                     66: .TP
                     67: \fBv\fP
                     68: sets video-on screen-saver preference
                     69: .TP
                     70: \fB-v\fP
                     71: sets video-off screen-saver preference
                     72: .TP
                     73: \fB-co\fP \fIrgbdb\fP
                     74: sets RGB database file
                     75: .TP
                     76: \fB-help\fP
                     77: prints a usage message
                     78: .TP
                     79: \fB-fp\fP \fIfontPath\fP
                     80: sets the search path for fonts
                     81: .TP
                     82: \fB-fc\fP \fIcursorFont\fP
                     83: sets default cursor font
                     84: .TP
                     85: \fB-fn\fP \fIfont\fP
                     86: sets the default font
                     87: .PP
                     88: Specific implementations may have other command-line options.
                     89: .SH
                     90: INITIALIZATION
                     91: .PP
                     92: \fIX(1)\fP and your first \fIxterm(1)\fP are normally started by the 
                     93: \fIinit(8)\fP program.
                     94: .sp
                     95: A typical line in \fI/etc/ttys\fP might be:
                     96: .sp
                     97: .nf
                     98:        ttyv0 "/etc/xterm -L =-1+1 :0" xterm on secure window="/etc/Xvs100 0 -c -l"
                     99: .fi
                    100: .sp
                    101: However, if you want the xterm to run on a different machine, you might have:
                    102: .sp
                    103: .nf
                    104:        remote "/etc/X 0 -l -c" xterm on secure
                    105: .fi
                    106: .sp
                    107: on the server machine and
                    108: .sp
                    109: .nf
                    110:        ttyv0 "/exe/xterm -L =-1+1 orpheus:0" xterm on secure
                    111: .fi
                    112: .sp
                    113: on the client machine.
                    114: .sp
                    115: .I X
                    116: maintains an access control list for accepting connections.  The host where
                    117: the server runs is initially on the list.
                    118: In addition, hosts listed the file
                    119: \fI/etc/X*.hosts\fP,
                    120: where \fI*\fP is the display number, are also initially on the list.
                    121: The format of this file is a list of host names, one per line.  DECnet hosts
                    122: are distinguished from Internet hosts by the existence of a trailing ``::'' in
                    123: the name.  
                    124: The access control list can be manipulated with \fIxhost(1)\fP.
                    125: .sp
                    126: .I X
                    127: will catch the SIGHUP signal sent by \fIinit(8)\fP
                    128: after the initial process (usually
                    129: the login \fIxterm(1)\fP) started on the display terminates.
                    130: This signal causes all connections to be closed (thereby ``disowning'' the
                    131: terminal), all resources to be freed, and all defaults restored.
                    132: .sp
                    133: The X protocol is documented in ``X.doc''.
                    134: Note that while X is running, all access to the display must be through
                    135: the window system.
                    136: .SH "SEE ALSO"
                    137: X(1), xinit(1), xterm(1), bitmap(1), xwm(1), xhost(1), xload(1), xset(1), init(8),
                    138: Xqvss(8c), Xqdss(8c), Xsun(8c), Xapollo(8c), Xapa16(8c)
                    139: .SH DIAGNOSTICS
                    140: Are too numerous to list them all.
                    141: If run from \fIinit(8)\fP, errors are logged in the file \fI/usr/adm/X*msgs\fP,
                    142: .SH FILES
                    143: .ta \w'/usr/new/lib/X/s-code   'u
                    144: /etc/X*.hosts  Initial access control list
                    145: .br
                    146: /usr/lib/X11/fonts     Font directory
                    147: .br
                    148: /dev/X*        Unix domain socket (if configured)
                    149: .br
                    150: /usr/adm/X*msgs        Error log file
                    151: .SH BUGS
                    152: The option syntax is inconsistent with itself and \fIxset(1)\fP.
                    153: .sp
                    154: If
                    155: .I X
                    156: dies before its clients, new clients won't be able to connect until all
                    157: existing connections have their TCP TIME_WAIT timers expire.
                    158: .SH AUTHORS
                    159: Susan Angebranndt, Raymond Drewry, Philip Karlton, and Todd Newman,
                    160: supported by a cast of thouands.  (See the protocl and Xlib
                    161: documents for complete acknowledgements.)
                    162: .br
                    163: Copyright (c) 1984, 1985, 1986, 1987 by Massachusetts Institute of Technology.
                    164: .br
                    165: See \fIX(1)\fP for a complete copyright notice.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.