| 1 | .\" $Xorg: Xserver.man,v 1.4 2001/02/09 02:04:07 xorgcvs Exp $ |
| 2 | .\" $XdotOrg: xserver/xorg/doc/Xserver.man.pre,v 1.4 2005/12/23 20:11:12 alanc Exp $ |
| 3 | .\" Copyright 1984 - 1991, 1993, 1994, 1998 The Open Group |
| 4 | .\" |
| 5 | .\" Permission to use, copy, modify, distribute, and sell this software and its |
| 6 | .\" documentation for any purpose is hereby granted without fee, provided that |
| 7 | .\" the above copyright notice appear in all copies and that both that |
| 8 | .\" copyright notice and this permission notice appear in supporting |
| 9 | .\" documentation. |
| 10 | .\" |
| 11 | .\" The above copyright notice and this permission notice shall be included |
| 12 | .\" in all copies or substantial portions of the Software. |
| 13 | .\" |
| 14 | .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
| 15 | .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
| 16 | .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
| 17 | .\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR |
| 18 | .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
| 19 | .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
| 20 | .\" OTHER DEALINGS IN THE SOFTWARE. |
| 21 | .\" |
| 22 | .\" Except as contained in this notice, the name of The Open Group shall |
| 23 | .\" not be used in advertising or otherwise to promote the sale, use or |
| 24 | .\" other dealings in this Software without prior written authorization |
| 25 | .\" from The Open Group. |
| 26 | .\" $XFree86: xc/programs/Xserver/Xserver.man,v 3.31 2004/01/10 22:27:46 dawes Exp $ |
| 27 | .\" shorthand for double quote that works everywhere. |
| 28 | .ds q \N'34' |
| 29 | .TH XSERVER 1 __xorgversion__ |
| 30 | .SH NAME |
| 31 | Xserver \- X Window System display server |
| 32 | .SH SYNOPSIS |
| 33 | .B X |
| 34 | [option ...] |
| 35 | .SH DESCRIPTION |
| 36 | .I X |
| 37 | is the generic name for the X Window System display server. It is |
| 38 | frequently a link or a copy of the appropriate server binary for |
| 39 | driving the most frequently used server on a given machine. |
| 40 | .SH "STARTING THE SERVER" |
| 41 | The X server is usually started from the X Display Manager program |
| 42 | \fIxdm\fP(1) or a similar display manager program. |
| 43 | This utility is run from the system boot files and takes care of keeping |
| 44 | the server running, prompting for usernames and passwords, and starting up |
| 45 | the user sessions. |
| 46 | .PP |
| 47 | Installations that run more than one window system may need to use the |
| 48 | \fIxinit\fP(1) utility instead of a display manager. However, \fIxinit\fP is |
| 49 | to be considered a tool for building startup scripts and is not |
| 50 | intended for use by end users. Site administrators are \fBstrongly\fP |
| 51 | urged to use a display manager, or build other interfaces for novice users. |
| 52 | .PP |
| 53 | The X server may also be started directly by the user, though this |
| 54 | method is usually reserved for testing and is not recommended for |
| 55 | normal operation. On some platforms, the user must have special |
| 56 | permission to start the X server, often because access to certain |
| 57 | devices (e.g. \fI/dev/mouse\fP) is restricted. |
| 58 | .PP |
| 59 | When the X server starts up, it typically takes over the display. If |
| 60 | you are running on a workstation whose console is the display, you may |
| 61 | not be able to log into the console while the server is running. |
| 62 | .SH OPTIONS |
| 63 | Many X servers have device-specific command line options. See the manual |
| 64 | pages for the individual servers for more details; a list of |
| 65 | server-specific manual pages is provided in the SEE ALSO section below. |
| 66 | .PP |
| 67 | All of the X servers accept the command line options described below. |
| 68 | Some X servers may have alternative ways of providing the parameters |
| 69 | described here, but the values provided via the command line options |
| 70 | should override values specified via other mechanisms. |
| 71 | .TP 8 |
| 72 | .B :\fIdisplaynumber\fP |
| 73 | The X server runs as the given \fIdisplaynumber\fP, which by default is 0. |
| 74 | If multiple X servers are to run simultaneously on a host, each must have |
| 75 | a unique display number. See the DISPLAY |
| 76 | NAMES section of the \fIX\fP(__miscmansuffix__) manual page to learn how to |
| 77 | specify which display number clients should try to use. |
| 78 | .TP 8 |
| 79 | .B \-a \fInumber\fP |
| 80 | sets pointer acceleration (i.e. the ratio of how much is reported to how much |
| 81 | the user actually moved the pointer). |
| 82 | .TP 8 |
| 83 | .B \-ac |
| 84 | disables host-based access control mechanisms. Enables access by any host, |
| 85 | and permits any host to modify the access control list. |
| 86 | Use with extreme caution. |
| 87 | This option exists primarily for running test suites remotely. |
| 88 | .TP 8 |
| 89 | .B \-audit \fIlevel\fP |
| 90 | sets the audit trail level. The default level is 1, meaning only connection |
| 91 | rejections are reported. Level 2 additionally reports all successful |
| 92 | connections and disconnects. Level 4 enables messages from the |
| 93 | SECURITY extension, if present, including generation and revocation of |
| 94 | authorizations and violations of the security policy. |
| 95 | Level 0 turns off the audit trail. |
| 96 | Audit lines are sent as standard error output. |
| 97 | .TP 8 |
| 98 | .B \-auth \fIauthorization-file\fP |
| 99 | specifies a file which contains a collection of authorization records used |
| 100 | to authenticate access. See also the \fIxdm\fP(1) and |
| 101 | \fIXsecurity\fP(__miscmansuffix__) manual pages. |
| 102 | .TP 8 |
| 103 | .BI \-background\ none |
| 104 | Asks the driver not to clear the background on startup, if the driver supports that. |
| 105 | May be useful for smooth transition with eg. fbdev driver. |
| 106 | For security reasons this is not the default as the screen contents might |
| 107 | show a previous user session. |
| 108 | .TP 8 |
| 109 | .B \-br |
| 110 | sets the default root window to solid black instead of the standard root weave |
| 111 | pattern. This is the default unless -retro or -wr is specified. |
| 112 | .TP 8 |
| 113 | .B \-bs |
| 114 | disables backing store support on all screens. |
| 115 | .TP 8 |
| 116 | .B \-c |
| 117 | turns off key-click. |
| 118 | .TP 8 |
| 119 | .B c \fIvolume\fP |
| 120 | sets key-click volume (allowable range: 0-100). |
| 121 | .TP 8 |
| 122 | .B \-cc \fIclass\fP |
| 123 | sets the visual class for the root window of color screens. |
| 124 | The class numbers are as specified in the X protocol. |
| 125 | Not obeyed by all servers. |
| 126 | .TP 8 |
| 127 | .B \-core |
| 128 | causes the server to generate a core dump on fatal errors. |
| 129 | .TP 8 |
| 130 | .B \-displayfd \fIfd\fP |
| 131 | specifies a file descriptor in the launching process. Rather than specify |
| 132 | a display number, the X server will attempt to listen on successively higher |
| 133 | display numbers, and upon finding a free one, will write the display number back |
| 134 | on this file descriptor as a newline-terminated string. The \-pn option is |
| 135 | ignored when using \-displayfd. |
| 136 | .TP 8 |
| 137 | .B \-deferglyphs \fIwhichfonts\fP |
| 138 | specifies the types of fonts for which the server should attempt to use |
| 139 | deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), |
| 140 | none (no fonts), or 16 (16 bit fonts only). |
| 141 | .TP 8 |
| 142 | .B \-dpi \fIresolution\fP |
| 143 | sets the resolution for all screens, in dots per inch. |
| 144 | To be used when the server cannot determine the screen size(s) from the |
| 145 | hardware. |
| 146 | .TP 8 |
| 147 | .B dpms |
| 148 | enables DPMS (display power management services), where supported. The |
| 149 | default state is platform and configuration specific. |
| 150 | .TP 8 |
| 151 | .B \-dpms |
| 152 | disables DPMS (display power management services). The default state |
| 153 | is platform and configuration specific. |
| 154 | .TP 8 |
| 155 | .BI \-extension extensionName |
| 156 | disables named extension. If an unknown extension name is specified, |
| 157 | a list of accepted extension names is printed. |
| 158 | .TP 8 |
| 159 | .BI +extension extensionName |
| 160 | enables named extension. If an unknown extension name is specified, |
| 161 | a list of accepted extension names is printed. |
| 162 | .TP 8 |
| 163 | .B \-f \fIvolume\fP |
| 164 | sets beep (bell) volume (allowable range: 0-100). |
| 165 | .TP 8 |
| 166 | .B \-fc \fIcursorFont\fP |
| 167 | sets default cursor font. |
| 168 | .TP 8 |
| 169 | .B \-fn \fIfont\fP |
| 170 | sets the default font. |
| 171 | .TP 8 |
| 172 | .B \-fp \fIfontPath\fP |
| 173 | sets the search path for fonts. This path is a comma separated list |
| 174 | of directories which the X server searches for font databases. |
| 175 | See the FONTS section of this manual page for more information and the default |
| 176 | list. |
| 177 | .TP 8 |
| 178 | .B \-help |
| 179 | prints a usage message. |
| 180 | .TP 8 |
| 181 | .B \-I |
| 182 | causes all remaining command line arguments to be ignored. |
| 183 | .TP 8 |
| 184 | .B \-maxbigreqsize \fIsize\fP |
| 185 | sets the maximum big request to |
| 186 | .I size |
| 187 | MB. |
| 188 | .TP 8 |
| 189 | .B \-nocursor |
| 190 | disable the display of the pointer cursor. |
| 191 | .TP 8 |
| 192 | .B \-nolisten \fItrans-type\fP |
| 193 | disables a transport type. For example, TCP/IP connections can be disabled |
| 194 | with |
| 195 | .BR "\-nolisten tcp" . |
| 196 | This option may be issued multiple times to disable listening to different |
| 197 | transport types. |
| 198 | .TP 8 |
| 199 | .B \-noreset |
| 200 | prevents a server reset when the last client connection is closed. This |
| 201 | overrides a previous |
| 202 | .B \-terminate |
| 203 | command line option. |
| 204 | .TP 8 |
| 205 | .B \-p \fIminutes\fP |
| 206 | sets screen-saver pattern cycle time in minutes. |
| 207 | .TP 8 |
| 208 | .B \-pn |
| 209 | permits the server to continue running if it fails to establish all of |
| 210 | its well-known sockets (connection points for clients), but |
| 211 | establishes at least one. This option is set by default. |
| 212 | .TP 8 |
| 213 | .B \-nopn |
| 214 | causes the server to exit if it fails to establish all of its well-known |
| 215 | sockets (connection points for clients). |
| 216 | .TP 8 |
| 217 | .B \-r |
| 218 | turns off auto-repeat. |
| 219 | .TP 8 |
| 220 | .B r |
| 221 | turns on auto-repeat. |
| 222 | .TP 8 |
| 223 | .B -retro |
| 224 | starts the stipple with the classic stipple and cursor visible. The default |
| 225 | is to start with a black root window, and to suppress display of the cursor |
| 226 | until the first time an application calls XDefineCursor(). For the Xorg |
| 227 | server, this also sets the default for the DontZap option to FALSE. For |
| 228 | kdrive servers, this implies -zap. |
| 229 | .TP 8 |
| 230 | .B \-s \fIminutes\fP |
| 231 | sets screen-saver timeout time in minutes. |
| 232 | .TP 8 |
| 233 | .B \-su |
| 234 | disables save under support on all screens. |
| 235 | .TP 8 |
| 236 | .B \-seat \fIseat\fP |
| 237 | seat to run on. Takes a string identifying a seat in a platform |
| 238 | specific syntax. On platforms which support this feature this may be |
| 239 | used to limit the server to expose only a specific subset of devices |
| 240 | connected to the system. |
| 241 | .TP 8 |
| 242 | .B \-t \fInumber\fP |
| 243 | sets pointer acceleration threshold in pixels (i.e. after how many pixels |
| 244 | pointer acceleration should take effect). |
| 245 | .TP 8 |
| 246 | .B \-terminate |
| 247 | causes the server to terminate at server reset, instead of continuing to run. |
| 248 | This overrides a previous |
| 249 | .B \-noreset |
| 250 | command line option. |
| 251 | .TP 8 |
| 252 | .B \-to \fIseconds\fP |
| 253 | sets default connection timeout in seconds. |
| 254 | .TP 8 |
| 255 | .B \-tst |
| 256 | disables all testing extensions (e.g., XTEST, XTrap, XTestExtension1, RECORD). |
| 257 | .TP 8 |
| 258 | .B tty\fIxx\fP |
| 259 | ignored, for servers started the ancient way (from init). |
| 260 | .TP 8 |
| 261 | .B v |
| 262 | sets video-off screen-saver preference. |
| 263 | .TP 8 |
| 264 | .B \-v |
| 265 | sets video-on screen-saver preference. |
| 266 | .TP 8 |
| 267 | .B \-wm |
| 268 | forces the default backing-store of all windows to be WhenMapped. This |
| 269 | is a backdoor way of getting backing-store to apply to all windows. |
| 270 | Although all mapped windows will have backing store, the backing store |
| 271 | attribute value reported by the server for a window will be the last |
| 272 | value established by a client. If it has never been set by a client, |
| 273 | the server will report the default value, NotUseful. This behavior is |
| 274 | required by the X protocol, which allows the server to exceed the |
| 275 | client's backing store expectations but does not provide a way to tell |
| 276 | the client that it is doing so. |
| 277 | .TP 8 |
| 278 | .B \-wr |
| 279 | sets the default root window to solid white instead of the standard root weave |
| 280 | pattern. |
| 281 | .TP 8 |
| 282 | .B \-x \fIextension\fP |
| 283 | loads the specified extension at init. |
| 284 | This is a no-op for most implementations. |
| 285 | .TP 8 |
| 286 | .B [+-]xinerama |
| 287 | enables(+) or disables(-) the XINERAMA extension. The default state is |
| 288 | platform and configuration specific. |
| 289 | .SH SERVER DEPENDENT OPTIONS |
| 290 | Some X servers accept the following options: |
| 291 | .TP 8 |
| 292 | .B \-ld \fIkilobytes\fP |
| 293 | sets the data space limit of the server to the specified number of kilobytes. |
| 294 | A value of zero makes the data size as large as possible. The default value |
| 295 | of \-1 leaves the data space limit unchanged. |
| 296 | .TP 8 |
| 297 | .B \-lf \fIfiles\fP |
| 298 | sets the number-of-open-files limit of the server to the specified number. |
| 299 | A value of zero makes the limit as large as possible. The default value |
| 300 | of \-1 leaves the limit unchanged. |
| 301 | .TP 8 |
| 302 | .B \-ls \fIkilobytes\fP |
| 303 | sets the stack space limit of the server to the specified number of kilobytes. |
| 304 | A value of zero makes the stack size as large as possible. The default value |
| 305 | of \-1 leaves the stack space limit unchanged. |
| 306 | .TP 8 |
| 307 | .B \-render |
| 308 | .BR default | mono | gray | color |
| 309 | sets the color allocation policy that will be used by the render extension. |
| 310 | .RS 8 |
| 311 | .TP 8 |
| 312 | .I default |
| 313 | selects the default policy defined for the display depth of the X |
| 314 | server. |
| 315 | .TP 8 |
| 316 | .I mono |
| 317 | don't use any color cell. |
| 318 | .TP 8 |
| 319 | .I gray |
| 320 | use a gray map of 13 color cells for the X render extension. |
| 321 | .TP 8 |
| 322 | .I color |
| 323 | use a color cube of at most 4*4*4 colors (that is 64 color cells). |
| 324 | .RE |
| 325 | .TP 8 |
| 326 | .B \-dumbSched |
| 327 | disables smart scheduling on platforms that support the smart scheduler. |
| 328 | .TP |
| 329 | .B \-schedInterval \fIinterval\fP |
| 330 | sets the smart scheduler's scheduling interval to |
| 331 | .I interval |
| 332 | milliseconds. |
| 333 | .SH XDMCP OPTIONS |
| 334 | X servers that support XDMCP have the following options. |
| 335 | See the \fIX Display Manager Control Protocol\fP specification for more |
| 336 | information. |
| 337 | .TP 8 |
| 338 | .B \-query \fIhostname\fP |
| 339 | enables XDMCP and sends Query packets to the specified |
| 340 | .IR hostname . |
| 341 | .TP 8 |
| 342 | .B \-broadcast |
| 343 | enable XDMCP and broadcasts BroadcastQuery packets to the network. The |
| 344 | first responding display manager will be chosen for the session. |
| 345 | .TP 8 |
| 346 | .B \-multicast [\fIaddress\fP [\fIhop count\fP]] |
| 347 | Enable XDMCP and multicast BroadcastQuery packets to the network. |
| 348 | The first responding display manager is chosen for the session. If an |
| 349 | address is specified, the multicast is sent to that address. If no |
| 350 | address is specified, the multicast is sent to the default XDMCP IPv6 |
| 351 | multicast group. If a hop count is specified, it is used as the maximum |
| 352 | hop count for the multicast. If no hop count is specified, the multicast |
| 353 | is set to a maximum of 1 hop, to prevent the multicast from being routed |
| 354 | beyond the local network. |
| 355 | .TP 8 |
| 356 | .B \-indirect \fIhostname\fP |
| 357 | enables XDMCP and send IndirectQuery packets to the specified |
| 358 | .IR hostname . |
| 359 | .TP 8 |
| 360 | .B \-port \fIport-number\fP |
| 361 | uses the specified \fIport-number\fP for XDMCP packets, instead of the |
| 362 | default. This option must be specified before any \-query, \-broadcast, |
| 363 | \-multicast, or \-indirect options. |
| 364 | .TP 8 |
| 365 | .B \-from \fIlocal-address\fP |
| 366 | specifies the local address to connect from (useful if the connecting host |
| 367 | has multiple network interfaces). The \fIlocal-address\fP may be expressed |
| 368 | in any form acceptable to the host platform's \fIgethostbyname\fP(3) |
| 369 | implementation. |
| 370 | .TP 8 |
| 371 | .B \-once |
| 372 | causes the server to terminate (rather than reset) when the XDMCP session |
| 373 | ends. |
| 374 | .TP 8 |
| 375 | .B \-class \fIdisplay-class\fP |
| 376 | XDMCP has an additional display qualifier used in resource lookup for |
| 377 | display-specific options. This option sets that value, by default it |
| 378 | is "MIT-Unspecified" (not a very useful value). |
| 379 | .TP 8 |
| 380 | .B \-cookie \fIxdm-auth-bits\fP |
| 381 | When testing XDM-AUTHENTICATION-1, a private key is shared between the |
| 382 | server and the manager. This option sets the value of that private |
| 383 | data (not that it is very private, being on the command line!). |
| 384 | .TP 8 |
| 385 | .B \-displayID \fIdisplay-id\fP |
| 386 | Yet another XDMCP specific value, this one allows the display manager to |
| 387 | identify each display so that it can locate the shared key. |
| 388 | .SH XKEYBOARD OPTIONS |
| 389 | X servers that support the XKEYBOARD (a.k.a. \*qXKB\*q) extension accept the |
| 390 | following options. All layout files specified on the command line must be |
| 391 | located in the XKB base directory or a subdirectory, and specified as the |
| 392 | relative path from the XKB base directory. The default XKB base directory is |
| 393 | .IR __projectroot__/lib/X11/xkb . |
| 394 | .TP 8 |
| 395 | .BR [+-]accessx " [ \fItimeout\fP [ \fItimeout_mask\fP [ \fIfeedback\fP [ \fIoptions_mask\fP ] ] ] ]" |
| 396 | enables(+) or disables(-) AccessX key sequences. |
| 397 | .TP 8 |
| 398 | .B \-xkbdir \fIdirectory\fP |
| 399 | base directory for keyboard layout files. This option is not available |
| 400 | for setuid X servers (i.e., when the X server's real and effective uids |
| 401 | are different). |
| 402 | .TP 8 |
| 403 | .B \-ardelay \fImilliseconds\fP |
| 404 | sets the autorepeat delay (length of time in milliseconds that a key must |
| 405 | be depressed before autorepeat starts). |
| 406 | .TP 8 |
| 407 | .B \-arinterval \fImilliseconds\fP |
| 408 | sets the autorepeat interval (length of time in milliseconds that should |
| 409 | elapse between autorepeat-generated keystrokes). |
| 410 | .TP 8 |
| 411 | .B \-xkbmap \fIfilename\fP |
| 412 | loads keyboard description in \fIfilename\fP on server startup. |
| 413 | .SH "NETWORK CONNECTIONS" |
| 414 | The X server supports client connections via a platform-dependent subset of |
| 415 | the following transport types: TCP\/IP, Unix Domain sockets, DECnet, |
| 416 | and several varieties of SVR4 local connections. See the DISPLAY |
| 417 | NAMES section of the \fIX\fP(__miscmansuffix__) manual page to learn how to |
| 418 | specify which transport type clients should try to use. |
| 419 | .SH GRANTING ACCESS |
| 420 | The X server implements a platform-dependent subset of the following |
| 421 | authorization protocols: MIT-MAGIC-COOKIE-1, XDM-AUTHORIZATION-1, |
| 422 | XDM-AUTHORIZATION-2, SUN-DES-1, and MIT-KERBEROS-5. See the |
| 423 | \fIXsecurity\fP(__miscmansuffix__) manual page for information on the |
| 424 | operation of these protocols. |
| 425 | .PP |
| 426 | Authorization data required by the above protocols is passed to the |
| 427 | server in a private file named with the \fB\-auth\fP command line |
| 428 | option. Each time the server is about to accept the first connection |
| 429 | after a reset (or when the server is starting), it reads this file. |
| 430 | If this file contains any authorization records, the local host is not |
| 431 | automatically allowed access to the server, and only clients which |
| 432 | send one of the authorization records contained in the file in the |
| 433 | connection setup information will be allowed access. See the |
| 434 | \fIXau\fP manual page for a description of the binary format of this |
| 435 | file. See \fIxauth\fP(1) for maintenance of this file, and distribution |
| 436 | of its contents to remote hosts. |
| 437 | .PP |
| 438 | The X server also uses a host-based access control list for deciding |
| 439 | whether or not to accept connections from clients on a particular machine. |
| 440 | If no other authorization mechanism is being used, |
| 441 | this list initially consists of the host on which the server is running as |
| 442 | well as any machines listed in the file \fI/etc/X\fBn\fI.hosts\fR, where |
| 443 | \fBn\fP is the display number of the server. Each line of the file should |
| 444 | contain either an Internet hostname (e.g. expo.lcs.mit.edu) or a DECnet |
| 445 | hostname in double colon format (e.g. hydra::) or a complete name in the format |
| 446 | \fIfamily\fP:\fIname\fP as described in the \fIxhost\fP(1) manual page. |
| 447 | There should be no leading or trailing spaces on any lines. For example: |
| 448 | .sp |
| 449 | .in +8 |
| 450 | .nf |
| 451 | joesworkstation |
| 452 | corporate.company.com |
| 453 | star:: |
| 454 | inet:bigcpu |
| 455 | local: |
| 456 | .fi |
| 457 | .in -8 |
| 458 | .PP |
| 459 | Users can add or remove hosts from this list and enable or disable access |
| 460 | control using the \fIxhost\fP command from the same machine as the server. |
| 461 | .PP |
| 462 | If the X FireWall Proxy (\fIxfwp\fP) is being used without a sitepolicy, |
| 463 | host-based authorization must be turned on for clients to be able to |
| 464 | connect to the X server via the \fIxfwp\fP. If \fIxfwp\fP is run without |
| 465 | a configuration file and thus no sitepolicy is defined, if \fIxfwp\fP |
| 466 | is using an X server where xhost + has been run to turn off host-based |
| 467 | authorization checks, when a client tries to connect to this X server |
| 468 | via \fIxfwp\fP, the X server will deny the connection. See \fIxfwp\fP(1) |
| 469 | for more information about this proxy. |
| 470 | .PP |
| 471 | The X protocol intrinsically does not have any notion of window operation |
| 472 | permissions or place any restrictions on what a client can do; if a program can |
| 473 | connect to a display, it has full run of the screen. |
| 474 | X servers that support the SECURITY extension fare better because clients |
| 475 | can be designated untrusted via the authorization they use to connect; see |
| 476 | the \fIxauth\fP(1) manual page for details. Restrictions are imposed |
| 477 | on untrusted clients that curtail the mischief they can do. See the SECURITY |
| 478 | extension specification for a complete list of these restrictions. |
| 479 | .PP |
| 480 | Sites that have better |
| 481 | authentication and authorization systems might wish to make |
| 482 | use of the hooks in the libraries and the server to provide additional |
| 483 | security models. |
| 484 | .SH SIGNALS |
| 485 | The X server attaches special meaning to the following signals: |
| 486 | .TP 8 |
| 487 | .I SIGHUP |
| 488 | This signal causes the server to close all existing connections, free all |
| 489 | resources, and restore all defaults. It is sent by the display manager |
| 490 | whenever the main user's main application (usually an \fIxterm\fP or window |
| 491 | manager) exits to force the server to clean up and prepare for the next |
| 492 | user. |
| 493 | .TP 8 |
| 494 | .I SIGTERM |
| 495 | This signal causes the server to exit cleanly. |
| 496 | .TP 8 |
| 497 | .I SIGUSR1 |
| 498 | This signal is used quite differently from either of the above. When the |
| 499 | server starts, it checks to see if it has inherited SIGUSR1 as SIG_IGN |
| 500 | instead of the usual SIG_DFL. In this case, the server sends a SIGUSR1 to |
| 501 | its parent process after it has set up the various connection schemes. |
| 502 | \fIXdm\fP uses this feature to recognize when connecting to the server |
| 503 | is possible. |
| 504 | .SH FONTS |
| 505 | The X server can obtain fonts from directories and/or from font servers. |
| 506 | The list of directories and font servers |
| 507 | the X server uses when trying to open a font is controlled |
| 508 | by the \fIfont path\fP. |
| 509 | .LP |
| 510 | The default font path is |
| 511 | __default_font_path__ . |
| 512 | .LP |
| 513 | A special kind of directory can be specified using the \fBcatalogue\fP: |
| 514 | prefix. Directories specified this way can contain symlinks pointing to the |
| 515 | real font directories. See the FONTPATH.D section for details. |
| 516 | .LP |
| 517 | The font path can be set with the \fB\-fp\fP option or by \fIxset\fP(1) |
| 518 | after the server has started. |
| 519 | .SH "FONTPATH.D" |
| 520 | You can specify a special kind of font path in the form \fBcatalogue:<dir>\fR. |
| 521 | The directory specified after the catalogue: prefix will be scanned for symlinks |
| 522 | and each symlink destination will be added as a local fontfile FPE. |
| 523 | .PP |
| 524 | The symlink can be suffixed by attributes such as '\fBunscaled\fR', which |
| 525 | will be passed through to the underlying fontfile FPE. The only exception is |
| 526 | the newly introduced '\fBpri\fR' attribute, which will be used for ordering |
| 527 | the font paths specified by the symlinks. |
| 528 | |
| 529 | An example configuration: |
| 530 | |
| 531 | .nf |
| 532 | 75dpi:unscaled:pri=20 \-> /usr/share/X11/fonts/75dpi |
| 533 | ghostscript:pri=60 \-> /usr/share/fonts/default/ghostscript |
| 534 | misc:unscaled:pri=10 \-> /usr/share/X11/fonts/misc |
| 535 | type1:pri=40 \-> /usr/share/X11/fonts/Type1 |
| 536 | type1:pri=50 \-> /usr/share/fonts/default/Type1 |
| 537 | .fi |
| 538 | |
| 539 | This will add /usr/share/X11/fonts/misc as the first FPE with the attribute |
| 540 | \N'39'unscaled', second FPE will be /usr/share/X11/fonts/75dpi, also with |
| 541 | the attribute 'unscaled' etc. This is functionally equivalent to setting |
| 542 | the following font path: |
| 543 | |
| 544 | .nf |
| 545 | /usr/share/X11/fonts/misc:unscaled, |
| 546 | /usr/share/X11/fonts/75dpi:unscaled, |
| 547 | /usr/share/X11/fonts/Type1, |
| 548 | /usr/share/fonts/default/Type1, |
| 549 | /usr/share/fonts/default/ghostscript |
| 550 | .fi |
| 551 | |
| 552 | .SH FILES |
| 553 | .TP 30 |
| 554 | .I /etc/X\fBn\fP.hosts |
| 555 | Initial access control list for display number \fBn\fP |
| 556 | .TP 30 |
| 557 | .IR __datadir__/fonts/X11/misc , __datadir__/fonts/X11/75dpi , __datadir__/fonts/X11/100dpi |
| 558 | Bitmap font directories |
| 559 | .TP 30 |
| 560 | .IR __datadir__/fonts/X11/TTF , __datadir__/fonts/X11/Type1 |
| 561 | Outline font directories |
| 562 | .TP 30 |
| 563 | .I /tmp/.X11-unix/X\fBn\fP |
| 564 | Unix domain socket for display number \fBn\fP |
| 565 | .TP 30 |
| 566 | .I /usr/adm/X\fBn\fPmsgs |
| 567 | Error log file for display number \fBn\fP if run from \fIinit\fP(__adminmansuffix__) |
| 568 | .TP 30 |
| 569 | .I __projectroot__/lib/X11/xdm/xdm-errors |
| 570 | Default error log file if the server is run from \fIxdm\fP(1) |
| 571 | .SH "SEE ALSO" |
| 572 | General information: \fIX\fP(__miscmansuffix__) |
| 573 | .PP |
| 574 | Protocols: |
| 575 | .I "X Window System Protocol," |
| 576 | .I "The X Font Service Protocol," |
| 577 | .I "X Display Manager Control Protocol" |
| 578 | .PP |
| 579 | Fonts: \fIbdftopcf\fP(1), \fImkfontdir\fP(1), \fImkfontscale\fP(1), |
| 580 | \fIxfs\fP(1), \fIxlsfonts\fP(1), \fIxfontsel\fP(1), \fIxfd\fP(1), |
| 581 | .I "X Logical Font Description Conventions" |
| 582 | .PP |
| 583 | Keyboards: \fIxkeyboard-config\fP(__miscmansuffix__) |
| 584 | .PP |
| 585 | Security: \fIXsecurity\fP(__miscmansuffix__), \fIxauth\fP(1), \fIXau\fP(1), |
| 586 | \fIxdm\fP(1), \fIxhost\fP(1), \fIxfwp\fP(1), |
| 587 | .I "Security Extension Specification" |
| 588 | .PP |
| 589 | Starting the server: \fIstartx\fP(1), \fIxdm\fP(1), \fIxinit\fP(1) |
| 590 | .PP |
| 591 | Controlling the server once started: \fIxset\fP(1), \fIxsetroot\fP(1), |
| 592 | \fIxhost\fP(1), \fIxinput\fP(1), \fIxrandr\fP(1) |
| 593 | .PP |
| 594 | Server-specific man pages: |
| 595 | \fIXorg\fP(1), \fIXdmx\fP(1), \fIXephyr\fP(1), \fIXnest\fP(1), |
| 596 | \fIXvfb\fP(1), \fIXquartz\fP(1), \fIXWin\fP(1). |
| 597 | .PP |
| 598 | Server internal documentation: |
| 599 | .I "Definition of the Porting Layer for the X v11 Sample Server" |
| 600 | .SH AUTHORS |
| 601 | The sample server was originally written by Susan Angebranndt, Raymond |
| 602 | Drewry, Philip Karlton, and Todd Newman, from Digital Equipment |
| 603 | Corporation, with support from a large cast. It has since been |
| 604 | extensively rewritten by Keith Packard and Bob Scheifler, from MIT. |
| 605 | Dave Wiggins took over post-R5 and made substantial improvements. |