xserver/man/Xserver.man

3 .\" Copyright 1984 - 1991, 1993, 1994, 1998  The Open Group
16 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
31 Xserver \- X Window System display server
38 frequently a link or a copy of the appropriate server binary for
39 driving the most frequently used server on a given machine.
42 \fIxdm\fP(1) or a similar display manager program.
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
51 urged to use a display manager, or build other interfaces for novice users.
60 you are running on a workstation whose console is the display, you may
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.
71 .TP 8
74 If multiple X servers are to run simultaneously on a host, each must have
75 a unique display number.  See the DISPLAY
78 .TP 8
79 .B \-a \fInumber\fP
82 .TP 8
83 .B \-ac
84 disables host-based access control mechanisms.  Enables access by any host,
88 .TP 8
89 .B \-audit \fIlevel\fP
97 .TP 8
98 .B \-auth \fIauthorization-file\fP
99 specifies a file which contains a collection of authorization records used
102 .TP 8
103 .BI \-background\ none
107 show a previous user session.
108 .TP 8
109 .B \-br
111 pattern.   This is the default unless -retro or -wr is specified.
112 .TP 8
113 .B \-bs
115 .TP 8
116 .B \-c
117 turns off key-click.
118 .TP 8
120 sets key-click volume (allowable range: 0-100).
121 .TP 8
122 .B \-cc \fIclass\fP
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
141 .TP 8
142 .B \-dpi \fIresolution\fP
146 .TP 8
150 .TP 8
151 .B \-dpms
154 .TP 8
155 .BI \-extension extensionName
157 a list of accepted extension names is printed.
158 .TP 8
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
168 .TP 8
169 .B \-fn \fIfont\fP
171 .TP 8
172 .B \-fp \fIfontPath\fP
173 sets the search path for fonts.  This path is a comma separated list
177 .TP 8
178 .B \-help
179 prints a usage message.
180 .TP 8
181 .B \-I
183 .TP 8
184 .B \-iglx
187 it's slower than direct contexts; and it opens a large attack surface for
190 .TP 8
193 .TP 8
194 .B \-maxbigreqsize \fIsize\fP
198 .TP 8
199 .B \-nocursor
201 .TP 8
202 .B \-nolisten \fItrans-type\fP
203 disables a transport type.  For example, TCP/IP connections can be disabled
217 .TP 8
218 .B \-listen \fItrans-type\fP
219 enables a transport type.  For example, TCP/IP connections can be enabled
224 .TP 8
225 .B \-noreset
226 prevents a server reset when the last client connection is closed.  This
227 overrides a previous
228 .B \-terminate
230 .TP 8
231 .B \-p \fIminutes\fP
232 sets screen-saver pattern cycle time in minutes.
233 .TP 8
234 .B \-pn
236 its well-known sockets (connection points for clients), but
238 .TP 8
239 .B \-nopn
240 causes the server to exit if it fails to establish all of its well-known
242 .TP 8
243 .B \-r
244 turns off auto-repeat.
245 .TP 8
247 turns on auto-repeat.
248 .TP 8
249 .B -retro
251 is to start with a black root window, and to suppress display of the cursor
253 servers, this implies -zap.
254 .TP 8
255 .B \-s \fIminutes\fP
256 sets screen-saver timeout time in minutes.
257 .TP 8
258 .B \-su
260 .TP 8
261 .B \-seat \fIseat\fP
262 seat to run on. Takes a string identifying a seat in a platform
264 used to limit the server to expose only a specific subset of devices
266 .TP 8
267 .B \-t \fInumber\fP
270 .TP 8
271 .B \-terminate
273 This overrides a previous
274 .B \-noreset
276 .TP 8
277 .B \-to \fIseconds\fP
279 .TP 8
280 .B \-tst
282 .TP 8
285 .TP 8
287 sets video-off screen-saver preference.
288 .TP 8
289 .B \-v
290 sets video-on screen-saver preference.
291 .TP 8
292 .B \-wm
293 forces the default backing-store of all windows to be WhenMapped.  This
294 is a backdoor way of getting backing-store to apply to all windows.
296 attribute value reported by the server for a window will be the last
297 value established by a client.  If it has never been set by a client,
300 client's backing store expectations but does not provide a way to tell
302 .TP 8
303 .B \-wr
306 .TP 8
307 .B \-x \fIextension\fP
309 This is a no-op for most implementations.
310 .TP 8
311 .B [+-]xinerama
312 enables(+) or disables(-) the XINERAMA extension.  The default state is
316 .TP 8
317 .B \-ld \fIkilobytes\fP
319 A value of zero makes the data size as large as possible.  The default value
320 of \-1 leaves the data space limit unchanged.
321 .TP 8
322 .B \-lf \fIfiles\fP
323 sets the number-of-open-files limit of the server to the specified number.
324 A value of zero makes the limit as large as possible.  The default value
325 of \-1 leaves the limit unchanged.
326 .TP 8
327 .B \-ls \fIkilobytes\fP
329 A value of zero makes the stack size as large as possible.  The default value
330 of \-1 leaves the stack space limit unchanged.
331 .TP 8
332 .B \-maxclients
336 .TP 8
337 .B \-render
340 .RS 8
341 .TP 8
345 .TP 8
348 .TP 8
350 use a gray map of 13 color cells for the X render extension.
351 .TP 8
353 use a color cube of at most 4*4*4 colors (that is 64 color cells).
355 .TP 8
356 .B \-dumbSched
359 .B \-schedInterval \fIinterval\fP
367 .TP 8
368 .B \-query \fIhostname\fP
371 .TP 8
372 .B \-broadcast
375 .TP 8
376 .B \-multicast [\fIaddress\fP [\fIhop count\fP]]
381 multicast group.  If a hop count is specified, it is used as the maximum
383 is set to a maximum of 1 hop, to prevent the multicast from being routed
385 .TP 8
386 .B \-indirect \fIhostname\fP
389 .TP 8
390 .B \-port \fIport-number\fP
391 uses the specified \fIport-number\fP for XDMCP packets, instead of the
392 default.  This option must be specified before any \-query, \-broadcast,
393 \-multicast, or \-indirect options.
394 .TP 8
395 .B \-from \fIlocal-address\fP
397 has multiple network interfaces).  The \fIlocal-address\fP may be expressed
400 .TP 8
401 .B \-once
404 .TP 8
405 .B \-class \fIdisplay-class\fP
407 display-specific options.  This option sets that value, by default it
408 is "MIT-unspecified" (not a very useful value).
409 .TP 8
410 .B \-cookie \fIxdm-auth-bits\fP
411 When testing XDM-AUTHENTICATION-1, a private key is shared between the
414 .TP 8
415 .B \-displayID \fIdisplay-id\fP
419 X servers that support the XKEYBOARD (a.k.a. \*qXKB\*q) extension accept the
421 located in the XKB base directory or a subdirectory, and specified as the
424 .TP 8
426 enables(+) or disables(-) AccessX key sequences.
427 .TP 8
428 .B \-xkbdir \fIdirectory\fP
432 .TP 8
433 .B \-ardelay \fImilliseconds\fP
434 sets the autorepeat delay (length of time in milliseconds that a key must
436 .TP 8
437 .B \-arinterval \fImilliseconds\fP
439 elapse between autorepeat-generated keystrokes).
440 .TP 8
441 .B \-xkbmap \fIfilename\fP
444 The X server supports client connections via a platform-dependent subset of
450 The X server implements a platform-dependent subset of the following
451 authorization protocols: MIT-MAGIC-COOKIE-1, XDM-AUTHORIZATION-1,
452 XDM-AUTHORIZATION-2, SUN-DES-1, and MIT-KERBEROS-5.  See the
457 server in a private file named with the \fB\-auth\fP command line
459 after a reset (or when the server is starting), it reads this file.
464 \fIXau\fP manual page for a description of the binary format of this
468 The X server also uses a host-based access control list for deciding
469 whether or not to accept connections from clients on a particular machine.
475 or a complete name in the format
491 If the X FireWall Proxy (\fIxfwp\fP) is being used without a sitepolicy,
492 host-based authorization must be turned on for clients to be able to
494 a configuration file and thus no sitepolicy is defined, if \fIxfwp\fP
495 is using an X server where xhost + has been run to turn off host-based
496 authorization checks, when a client tries to connect to this X server
501 permissions or place any restrictions on what a client can do; if a program can
502 connect to a display, it has full run of the screen.
507 extension specification for a complete list of these restrictions.
515 .TP 8
522 .TP 8
525 .TP 8
529 instead of the usual SIG_DFL.  In this case, the server sends a SIGUSR1 to
536 the X server uses when trying to open a font is controlled
542 A special kind of directory can be specified using the \fBcatalogue\fP:
546 The font path can be set with the \fB\-fp\fP option or by \fIxset\fP(1)
549 You can specify a special kind of font path in the form \fBcatalogue:<dir>\fR.
551 and each symlink destination will be added as a local fontfile FPE.
561     75dpi:unscaled:pri=20 \-> /usr/share/X11/fonts/75dpi
562     ghostscript:pri=60 \-> /usr/share/fonts/default/ghostscript
563     misc:unscaled:pri=10 \-> /usr/share/X11/fonts/misc
564     type1:pri=40 \-> /usr/share/X11/fonts/Type1
565     type1:pri=50 \-> /usr/share/fonts/default/Type1
592 .I /tmp/.X11-unix/X\fBn\fP
598 .I @projectroot@/lib/X11/xdm/xdm-errors
612 Keyboards: \fIxkeyboard-config\fP(@miscmansuffix@)
623 Server-specific man pages:
632 Corporation, with support from a large cast.  It has since been
634 Dave Wiggins took over post-R5 and made substantial improvements.