821 lines
29 KiB
HTML
821 lines
29 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XSERVER</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XSERVER</H1>
|
|
Section: User Commands (1)<BR>Updated: xorg-server 1.20.9<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
Xserver - X Window System display server
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>X</B>
|
|
|
|
[option ...]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<I>X</I>
|
|
|
|
is the generic name for the X Window System display server. It is
|
|
frequently a link or a copy of the appropriate server binary for
|
|
driving the most frequently used server on a given machine.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>STARTING THE SERVER</H2>
|
|
|
|
The X server is usually started from the X Display Manager program
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xdm">xdm</A></I>(1) or a similar display manager program.
|
|
This utility is run from the system boot files and takes care of keeping
|
|
the server running, prompting for usernames and passwords, and starting up
|
|
the user sessions.
|
|
<P>
|
|
|
|
Installations that run more than one window system may need to use the
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></I>(1) utility instead of a display manager. However, <I>xinit</I> is
|
|
to be considered a tool for building startup scripts and is not
|
|
intended for use by end users. Site administrators are <B>strongly</B>
|
|
urged to use a display manager, or build other interfaces for novice users.
|
|
<P>
|
|
|
|
The X server may also be started directly by the user, though this
|
|
method is usually reserved for testing and is not recommended for
|
|
normal operation. On some platforms, the user must have special
|
|
permission to start the X server, often because access to certain
|
|
devices (e.g. <I>/dev/mouse</I>) is restricted.
|
|
<P>
|
|
|
|
When the X server starts up, it typically takes over the display. If
|
|
you are running on a workstation whose console is the display, you may
|
|
not be able to log into the console while the server is running.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
Many X servers have device-specific command line options. See the manual
|
|
pages for the individual servers for more details; a list of
|
|
server-specific manual pages is provided in the SEE ALSO section below.
|
|
<P>
|
|
|
|
All of the X servers accept the command line options described below.
|
|
Some X servers may have alternative ways of providing the parameters
|
|
described here, but the values provided via the command line options
|
|
should override values specified via other mechanisms.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>:</B><I>displaynumber</I>
|
|
|
|
<DD>
|
|
The X server runs as the given <I>displaynumber</I>, which by default is 0.
|
|
If multiple X servers are to run simultaneously on a host, each must have
|
|
a unique display number. See the DISPLAY
|
|
NAMES section of the <I><A HREF="/cgi-bin/man/man2html?7+X">X</A></I>(7) manual page to learn how to
|
|
specify which display number clients should try to use.
|
|
<DT id="2"><B>-a </B><I>number</I>
|
|
|
|
<DD>
|
|
sets pointer acceleration (i.e. the ratio of how much is reported to how much
|
|
the user actually moved the pointer).
|
|
<DT id="3"><B>-ac</B>
|
|
|
|
<DD>
|
|
disables host-based access control mechanisms. Enables access by any host,
|
|
and permits any host to modify the access control list.
|
|
Use with extreme caution.
|
|
This option exists primarily for running test suites remotely.
|
|
<DT id="4"><B>-audit </B><I>level</I>
|
|
|
|
<DD>
|
|
sets the audit trail level. The default level is 1, meaning only connection
|
|
rejections are reported. Level 2 additionally reports all successful
|
|
connections and disconnects. Level 4 enables messages from the
|
|
SECURITY extension, if present, including generation and revocation of
|
|
authorizations and violations of the security policy.
|
|
Level 0 turns off the audit trail.
|
|
Audit lines are sent as standard error output.
|
|
<DT id="5"><B>-auth </B><I>authorization-file</I>
|
|
|
|
<DD>
|
|
specifies a file which contains a collection of authorization records used
|
|
to authenticate access. See also the <I><A HREF="/cgi-bin/man/man2html?1+xdm">xdm</A></I>(1) and
|
|
<I><A HREF="/cgi-bin/man/man2html?7+Xsecurity">Xsecurity</A></I>(7) manual pages.
|
|
<DT id="6"><B>-background none</B>
|
|
|
|
<DD>
|
|
Asks the driver not to clear the background on startup, if the driver supports that.
|
|
May be useful for smooth transition with eg. fbdev driver.
|
|
For security reasons this is not the default as the screen contents might
|
|
show a previous user session.
|
|
<DT id="7"><B>-br</B>
|
|
|
|
<DD>
|
|
sets the default root window to solid black instead of the standard root weave
|
|
pattern. This is the default unless -retro or -wr is specified.
|
|
<DT id="8"><B>-bs</B>
|
|
|
|
<DD>
|
|
disables backing store support on all screens.
|
|
<DT id="9"><B>-c</B>
|
|
|
|
<DD>
|
|
turns off key-click.
|
|
<DT id="10"><B>c </B><I>volume</I>
|
|
|
|
<DD>
|
|
sets key-click volume (allowable range: 0-100).
|
|
<DT id="11"><B>-cc </B><I>class</I>
|
|
|
|
<DD>
|
|
sets the visual class for the root window of color screens.
|
|
The class numbers are as specified in the X protocol.
|
|
Not obeyed by all servers.
|
|
<DT id="12"><B>-core</B>
|
|
|
|
<DD>
|
|
causes the server to generate a core dump on fatal errors.
|
|
<DT id="13"><B>-displayfd </B><I>fd</I>
|
|
|
|
<DD>
|
|
specifies a file descriptor in the launching process. Rather than specify
|
|
a display number, the X server will attempt to listen on successively higher
|
|
display numbers, and upon finding a free one, will write the display number back
|
|
on this file descriptor as a newline-terminated string. The -pn option is
|
|
ignored when using -displayfd.
|
|
<DT id="14"><B>-deferglyphs </B><I>whichfonts</I>
|
|
|
|
<DD>
|
|
specifies the types of fonts for which the server should attempt to use
|
|
deferred glyph loading. <I>whichfonts</I> can be all (all fonts),
|
|
none (no fonts), or 16 (16 bit fonts only).
|
|
<DT id="15"><B>-dpi </B><I>resolution</I>
|
|
|
|
<DD>
|
|
sets the resolution for all screens, in dots per inch.
|
|
To be used when the server cannot determine the screen size(s) from the
|
|
hardware.
|
|
<DT id="16"><B>dpms</B>
|
|
|
|
<DD>
|
|
enables DPMS (display power management services), where supported. The
|
|
default state is platform and configuration specific.
|
|
<DT id="17"><B>-dpms</B>
|
|
|
|
<DD>
|
|
disables DPMS (display power management services). The default state
|
|
is platform and configuration specific.
|
|
<DT id="18"><B>-extension</B><I>extensionName</I>
|
|
|
|
<DD>
|
|
disables named extension. If an unknown extension name is specified,
|
|
a list of accepted extension names is printed.
|
|
<DT id="19"><B>+extension</B><I>extensionName</I>
|
|
|
|
<DD>
|
|
enables named extension. If an unknown extension name is specified,
|
|
a list of accepted extension names is printed.
|
|
<DT id="20"><B>-f </B><I>volume</I>
|
|
|
|
<DD>
|
|
sets beep (bell) volume (allowable range: 0-100).
|
|
<DT id="21"><B>-fc </B><I>cursorFont</I>
|
|
|
|
<DD>
|
|
sets default cursor font.
|
|
<DT id="22"><B>-fn </B><I>font</I>
|
|
|
|
<DD>
|
|
sets the default font.
|
|
<DT id="23"><B>-fp </B><I>fontPath</I>
|
|
|
|
<DD>
|
|
sets the search path for fonts. This path is a comma separated list
|
|
of directories which the X server searches for font databases.
|
|
See the FONTS section of this manual page for more information and the default
|
|
list.
|
|
<DT id="24"><B>-help</B>
|
|
|
|
<DD>
|
|
prints a usage message.
|
|
<DT id="25"><B>-I</B>
|
|
|
|
<DD>
|
|
causes all remaining command line arguments to be ignored.
|
|
<DT id="26"><B>-iglx</B>
|
|
|
|
<DD>
|
|
Prohibit creating indirect GLX contexts. Indirect GLX is of limited use,
|
|
since it lacks support for many modern OpenGL features and extensions;
|
|
it's slower than direct contexts; and it opens a large attack surface for
|
|
protocol parsing errors.
|
|
This is the default unless +iglx is specified.
|
|
<DT id="27"><B>+iglx</B>
|
|
|
|
<DD>
|
|
Allow creating indirect GLX contexts.
|
|
<DT id="28"><B>-maxbigreqsize </B><I>size</I>
|
|
|
|
<DD>
|
|
sets the maximum big request to
|
|
<I>size</I>
|
|
|
|
MB.
|
|
<DT id="29"><B>-nocursor</B>
|
|
|
|
<DD>
|
|
disable the display of the pointer cursor.
|
|
<DT id="30"><B>-nolisten </B><I>trans-type</I>
|
|
|
|
<DD>
|
|
disables a transport type. For example, TCP/IP connections can be disabled
|
|
with
|
|
<B>-nolisten tcp</B>.
|
|
|
|
This option may be issued multiple times to disable listening to different
|
|
transport types.
|
|
Supported transport types are platform dependent, but commonly include:
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>tcp TCP over IPv4 or IPv6</TD><TD><BR></TD></TR>
|
|
<TR VALIGN=top><TD>inet TCP over IPv4 only</TD><TD><BR></TD></TR>
|
|
<TR VALIGN=top><TD>inet6 TCP over IPv6 only</TD><TD><BR></TD></TR>
|
|
<TR VALIGN=top><TD>unix UNIX Domain Sockets</TD><TD><BR></TD></TR>
|
|
<TR VALIGN=top><TD>local Platform preferred local connection method</TD><TD><BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<DT id="31"><B>-listen </B><I>trans-type</I>
|
|
|
|
<DD>
|
|
enables a transport type. For example, TCP/IP connections can be enabled
|
|
with
|
|
<B>-listen tcp</B>.
|
|
|
|
This option may be issued multiple times to enable listening to different
|
|
transport types.
|
|
<DT id="32"><B>-noreset</B>
|
|
|
|
<DD>
|
|
prevents a server reset when the last client connection is closed. This
|
|
overrides a previous
|
|
<B>-terminate</B>
|
|
|
|
command line option.
|
|
<DT id="33"><B>-p </B><I>minutes</I>
|
|
|
|
<DD>
|
|
sets screen-saver pattern cycle time in minutes.
|
|
<DT id="34"><B>-pn</B>
|
|
|
|
<DD>
|
|
permits the server to continue running if it fails to establish all of
|
|
its well-known sockets (connection points for clients), but
|
|
establishes at least one. This option is set by default.
|
|
<DT id="35"><B>-nopn</B>
|
|
|
|
<DD>
|
|
causes the server to exit if it fails to establish all of its well-known
|
|
sockets (connection points for clients).
|
|
<DT id="36"><B>-r</B>
|
|
|
|
<DD>
|
|
turns off auto-repeat.
|
|
<DT id="37"><B>r</B>
|
|
|
|
<DD>
|
|
turns on auto-repeat.
|
|
<DT id="38"><B>-retro</B>
|
|
|
|
<DD>
|
|
starts the server with the classic stipple and cursor visible. The default
|
|
is to start with a black root window, and to suppress display of the cursor
|
|
until the first time an application calls XDefineCursor(). For kdrive
|
|
servers, this implies -zap.
|
|
<DT id="39"><B>-s </B><I>minutes</I>
|
|
|
|
<DD>
|
|
sets screen-saver timeout time in minutes.
|
|
<DT id="40"><B>-su</B>
|
|
|
|
<DD>
|
|
disables save under support on all screens.
|
|
<DT id="41"><B>-seat </B><I>seat</I>
|
|
|
|
<DD>
|
|
seat to run on. Takes a string identifying a seat in a platform
|
|
specific syntax. On platforms which support this feature this may be
|
|
used to limit the server to expose only a specific subset of devices
|
|
connected to the system.
|
|
<DT id="42"><B>-t </B><I>number</I>
|
|
|
|
<DD>
|
|
sets pointer acceleration threshold in pixels (i.e. after how many pixels
|
|
pointer acceleration should take effect).
|
|
<DT id="43"><B>-terminate</B>
|
|
|
|
<DD>
|
|
causes the server to terminate at server reset, instead of continuing to run.
|
|
This overrides a previous
|
|
<B>-noreset</B>
|
|
|
|
command line option.
|
|
<DT id="44"><B>-to </B><I>seconds</I>
|
|
|
|
<DD>
|
|
sets default connection timeout in seconds.
|
|
<DT id="45"><B>-tst</B>
|
|
|
|
<DD>
|
|
disables all testing extensions (e.g., XTEST, XTrap, XTestExtension1, RECORD).
|
|
<DT id="46"><B>tty</B><I>xx</I>
|
|
|
|
<DD>
|
|
ignored, for servers started the ancient way (from init).
|
|
<DT id="47"><B>v</B>
|
|
|
|
<DD>
|
|
sets video-off screen-saver preference.
|
|
<DT id="48"><B>-v</B>
|
|
|
|
<DD>
|
|
sets video-on screen-saver preference.
|
|
<DT id="49"><B>-wm</B>
|
|
|
|
<DD>
|
|
forces the default backing-store of all windows to be WhenMapped. This
|
|
is a backdoor way of getting backing-store to apply to all windows.
|
|
Although all mapped windows will have backing store, the backing store
|
|
attribute value reported by the server for a window will be the last
|
|
value established by a client. If it has never been set by a client,
|
|
the server will report the default value, NotUseful. This behavior is
|
|
required by the X protocol, which allows the server to exceed the
|
|
client's backing store expectations but does not provide a way to tell
|
|
the client that it is doing so.
|
|
<DT id="50"><B>-wr</B>
|
|
|
|
<DD>
|
|
sets the default root window to solid white instead of the standard root weave
|
|
pattern.
|
|
<DT id="51"><B>-x </B><I>extension</I>
|
|
|
|
<DD>
|
|
loads the specified extension at init.
|
|
This is a no-op for most implementations.
|
|
<DT id="52"><B>[+-]xinerama</B>
|
|
|
|
<DD>
|
|
enables(+) or disables(-) the XINERAMA extension. The default state is
|
|
platform and configuration specific.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SERVER DEPENDENT OPTIONS</H2>
|
|
|
|
Some X servers accept the following options:
|
|
<DL COMPACT>
|
|
<DT id="53"><B>-ld </B><I>kilobytes</I>
|
|
|
|
<DD>
|
|
sets the data space limit of the server to the specified number of kilobytes.
|
|
A value of zero makes the data size as large as possible. The default value
|
|
of -1 leaves the data space limit unchanged.
|
|
<DT id="54"><B>-lf </B><I>files</I>
|
|
|
|
<DD>
|
|
sets the number-of-open-files limit of the server to the specified number.
|
|
A value of zero makes the limit as large as possible. The default value
|
|
of -1 leaves the limit unchanged.
|
|
<DT id="55"><B>-ls </B><I>kilobytes</I>
|
|
|
|
<DD>
|
|
sets the stack space limit of the server to the specified number of kilobytes.
|
|
A value of zero makes the stack size as large as possible. The default value
|
|
of -1 leaves the stack space limit unchanged.
|
|
<DT id="56"><B>-maxclients</B>
|
|
|
|
<DD>
|
|
<B>64</B>|<B>128</B>|<B>256</B>|<B>512</B>
|
|
|
|
Set the maximum number of clients allowed to connect to the X server.
|
|
Acceptable values are 64, 128, 256 or 512.
|
|
<DT id="57"><B>-render</B>
|
|
|
|
<DD>
|
|
<B>default</B>|<B>mono</B>|<B>gray</B>|<B>color</B>
|
|
|
|
sets the color allocation policy that will be used by the render extension.
|
|
<DL COMPACT><DT id="58"><DD>
|
|
<DL COMPACT>
|
|
<DT id="59"><I>default</I>
|
|
|
|
<DD>
|
|
selects the default policy defined for the display depth of the X
|
|
server.
|
|
<DT id="60"><I>mono</I>
|
|
|
|
<DD>
|
|
don't use any color cell.
|
|
<DT id="61"><I>gray</I>
|
|
|
|
<DD>
|
|
use a gray map of 13 color cells for the X render extension.
|
|
<DT id="62"><I>color</I>
|
|
|
|
<DD>
|
|
use a color cube of at most 4*4*4 colors (that is 64 color cells).
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="63"><B>-dumbSched</B>
|
|
|
|
<DD>
|
|
disables smart scheduling on platforms that support the smart scheduler.
|
|
<DT id="64"><B>-schedInterval </B><I>interval</I>
|
|
|
|
<DD>
|
|
sets the smart scheduler's scheduling interval to
|
|
<I>interval</I>
|
|
|
|
milliseconds.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>XDMCP OPTIONS</H2>
|
|
|
|
X servers that support XDMCP have the following options.
|
|
See the <I>X Display Manager Control Protocol</I> specification for more
|
|
information.
|
|
<DL COMPACT>
|
|
<DT id="65"><B>-query </B><I>hostname</I>
|
|
|
|
<DD>
|
|
enables XDMCP and sends Query packets to the specified
|
|
<I>hostname</I>.
|
|
|
|
<DT id="66"><B>-broadcast</B>
|
|
|
|
<DD>
|
|
enable XDMCP and broadcasts BroadcastQuery packets to the network. The
|
|
first responding display manager will be chosen for the session.
|
|
<DT id="67"><B>-multicast [</B><I>address</I> [<I>hop count</I>]]
|
|
|
|
<DD>
|
|
Enable XDMCP and multicast BroadcastQuery packets to the network.
|
|
The first responding display manager is chosen for the session. If an
|
|
address is specified, the multicast is sent to that address. If no
|
|
address is specified, the multicast is sent to the default XDMCP IPv6
|
|
multicast group. If a hop count is specified, it is used as the maximum
|
|
hop count for the multicast. If no hop count is specified, the multicast
|
|
is set to a maximum of 1 hop, to prevent the multicast from being routed
|
|
beyond the local network.
|
|
<DT id="68"><B>-indirect </B><I>hostname</I>
|
|
|
|
<DD>
|
|
enables XDMCP and send IndirectQuery packets to the specified
|
|
<I>hostname</I>.
|
|
|
|
<DT id="69"><B>-port </B><I>port-number</I>
|
|
|
|
<DD>
|
|
uses the specified <I>port-number</I> for XDMCP packets, instead of the
|
|
default. This option must be specified before any -query, -broadcast,
|
|
-multicast, or -indirect options.
|
|
<DT id="70"><B>-from </B><I>local-address</I>
|
|
|
|
<DD>
|
|
specifies the local address to connect from (useful if the connecting host
|
|
has multiple network interfaces). The <I>local-address</I> may be expressed
|
|
in any form acceptable to the host platform's <I><A HREF="/cgi-bin/man/man2html?3+gethostbyname">gethostbyname</A></I>(3)
|
|
implementation.
|
|
<DT id="71"><B>-once</B>
|
|
|
|
<DD>
|
|
causes the server to terminate (rather than reset) when the XDMCP session
|
|
ends.
|
|
<DT id="72"><B>-class </B><I>display-class</I>
|
|
|
|
<DD>
|
|
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).
|
|
<DT id="73"><B>-cookie </B><I>xdm-auth-bits</I>
|
|
|
|
<DD>
|
|
When testing XDM-AUTHENTICATION-1, a private key is shared between the
|
|
server and the manager. This option sets the value of that private
|
|
data (not that it is very private, being on the command line!).
|
|
<DT id="74"><B>-displayID </B><I>display-id</I>
|
|
|
|
<DD>
|
|
Yet another XDMCP specific value, this one allows the display manager to
|
|
identify each display so that it can locate the shared key.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>XKEYBOARD OPTIONS</H2>
|
|
|
|
X servers that support the XKEYBOARD (a.k.a. "XKB") extension accept the
|
|
following options. All layout files specified on the command line must be
|
|
located in the XKB base directory or a subdirectory, and specified as the
|
|
relative path from the XKB base directory. The default XKB base directory is
|
|
<I>/usr/lib/X11/xkb</I>.
|
|
|
|
<DL COMPACT>
|
|
<DT id="75"><B>[+-]accessx</B> [ <I>timeout</I> [ <I>timeout_mask</I> [ <I>feedback</I> [ <I>options_mask</I> ] ] ] ]
|
|
|
|
<DD>
|
|
enables(+) or disables(-) AccessX key sequences.
|
|
<DT id="76"><B>-xkbdir </B><I>directory</I>
|
|
|
|
<DD>
|
|
base directory for keyboard layout files. This option is not available
|
|
for setuid X servers (i.e., when the X server's real and effective uids
|
|
are different).
|
|
<DT id="77"><B>-ardelay </B><I>milliseconds</I>
|
|
|
|
<DD>
|
|
sets the autorepeat delay (length of time in milliseconds that a key must
|
|
be depressed before autorepeat starts).
|
|
<DT id="78"><B>-arinterval </B><I>milliseconds</I>
|
|
|
|
<DD>
|
|
sets the autorepeat interval (length of time in milliseconds that should
|
|
elapse between autorepeat-generated keystrokes).
|
|
<DT id="79"><B>-xkbmap </B><I>filename</I>
|
|
|
|
<DD>
|
|
loads keyboard description in <I>filename</I> on server startup.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>NETWORK CONNECTIONS</H2>
|
|
|
|
The X server supports client connections via a platform-dependent subset of
|
|
the following transport types: TCP/IP, Unix Domain sockets,
|
|
and several varieties of SVR4 local connections. See the DISPLAY
|
|
NAMES section of the <I><A HREF="/cgi-bin/man/man2html?7+X">X</A></I>(7) manual page to learn how to
|
|
specify which transport type clients should try to use.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>GRANTING ACCESS</H2>
|
|
|
|
The X server implements a platform-dependent subset of the following
|
|
authorization protocols: MIT-MAGIC-COOKIE-1, XDM-AUTHORIZATION-1,
|
|
XDM-AUTHORIZATION-2, SUN-DES-1, and MIT-KERBEROS-5. See the
|
|
<I><A HREF="/cgi-bin/man/man2html?7+Xsecurity">Xsecurity</A></I>(7) manual page for information on the
|
|
operation of these protocols.
|
|
<P>
|
|
|
|
Authorization data required by the above protocols is passed to the
|
|
server in a private file named with the <B>-auth</B> command line
|
|
option. Each time the server is about to accept the first connection
|
|
after a reset (or when the server is starting), it reads this file.
|
|
If this file contains any authorization records, the local host is not
|
|
automatically allowed access to the server, and only clients which
|
|
send one of the authorization records contained in the file in the
|
|
connection setup information will be allowed access. See the
|
|
<I>Xau</I> manual page for a description of the binary format of this
|
|
file. See <I><A HREF="/cgi-bin/man/man2html?1+xauth">xauth</A></I>(1) for maintenance of this file, and distribution
|
|
of its contents to remote hosts.
|
|
<P>
|
|
|
|
The X server also uses a host-based access control list for deciding
|
|
whether or not to accept connections from clients on a particular machine.
|
|
If no other authorization mechanism is being used,
|
|
this list initially consists of the host on which the server is running as
|
|
well as any machines listed in the file <I>/etc/X</I><B>n</B><I>.hosts</I>, where
|
|
<B>n</B> is the display number of the server. Each line of the file should
|
|
contain either an Internet hostname (e.g. expo.lcs.mit.edu)
|
|
or a complete name in the format
|
|
<I>family</I>:<I>name</I> as described in the <I><A HREF="/cgi-bin/man/man2html?1+xhost">xhost</A></I>(1) manual page.
|
|
There should be no leading or trailing spaces on any lines. For example:
|
|
<P>
|
|
|
|
<PRE>
|
|
joesworkstation
|
|
corporate.company.com
|
|
inet:bigcpu
|
|
local:
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
|
|
Users can add or remove hosts from this list and enable or disable access
|
|
control using the <I>xhost</I> command from the same machine as the server.
|
|
<P>
|
|
|
|
If the X FireWall Proxy (<I>xfwp</I>) is being used without a sitepolicy,
|
|
host-based authorization must be turned on for clients to be able to
|
|
connect to the X server via the <I>xfwp</I>. If <I>xfwp</I> is run without
|
|
a configuration file and thus no sitepolicy is defined, if <I>xfwp</I>
|
|
is using an X server where xhost + has been run to turn off host-based
|
|
authorization checks, when a client tries to connect to this X server
|
|
via <I>xfwp</I>, the X server will deny the connection. See <I><A HREF="/cgi-bin/man/man2html?1+xfwp">xfwp</A></I>(1)
|
|
for more information about this proxy.
|
|
<P>
|
|
|
|
The X protocol intrinsically 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.
|
|
X servers that support the SECURITY extension fare better because clients
|
|
can be designated untrusted via the authorization they use to connect; see
|
|
the <I><A HREF="/cgi-bin/man/man2html?1+xauth">xauth</A></I>(1) manual page for details. Restrictions are imposed
|
|
on untrusted clients that curtail the mischief they can do. See the SECURITY
|
|
extension specification for a complete list of these restrictions.
|
|
<P>
|
|
|
|
Sites that have better
|
|
authentication and authorization systems might wish to make
|
|
use of the hooks in the libraries and the server to provide additional
|
|
security models.
|
|
<A NAME="lbAL"> </A>
|
|
<H2>SIGNALS</H2>
|
|
|
|
The X server attaches special meaning to the following signals:
|
|
<DL COMPACT>
|
|
<DT id="80"><I>SIGHUP</I>
|
|
|
|
<DD>
|
|
This signal causes the server to close all existing connections, free all
|
|
resources, and restore all defaults. It is sent by the display manager
|
|
whenever the main user's main application (usually an <I>xterm</I> or window
|
|
manager) exits to force the server to clean up and prepare for the next
|
|
user.
|
|
<DT id="81"><I>SIGTERM</I>
|
|
|
|
<DD>
|
|
This signal causes the server to exit cleanly.
|
|
<DT id="82"><I>SIGUSR1</I>
|
|
|
|
<DD>
|
|
This signal is used quite differently from either of the above. When the
|
|
server starts, it checks to see if it has inherited SIGUSR1 as SIG_IGN
|
|
instead of the usual SIG_DFL. In this case, the server sends a SIGUSR1 to
|
|
its parent process after it has set up the various connection schemes.
|
|
<I>Xdm</I> uses this feature to recognize when connecting to the server
|
|
is possible.
|
|
</DL>
|
|
<A NAME="lbAM"> </A>
|
|
<H2>FONTS</H2>
|
|
|
|
The X server can obtain fonts from directories and/or from font servers.
|
|
The list of directories and font servers
|
|
the X server uses when trying to open a font is controlled
|
|
by the <I>font path</I>.
|
|
<P>
|
|
|
|
The default font path is
|
|
/usr/share/fonts/X11/misc,/usr/share/fonts/X11/cyrillic,/usr/share/fonts/X11/100dpi/:unscaled,/usr/share/fonts/X11/75dpi/:unscaled,/usr/share/fonts/X11/Type1,/usr/share/fonts/X11/100dpi,/usr/share/fonts/X11/75dpi,built-ins .
|
|
<P>
|
|
|
|
A special kind of directory can be specified using the <B>catalogue</B>:
|
|
prefix. Directories specified this way can contain symlinks pointing to the
|
|
real font directories. See the FONTPATH.D section for details.
|
|
<P>
|
|
|
|
The font path can be set with the <B>-fp</B> option or by <I><A HREF="/cgi-bin/man/man2html?1+xset">xset</A></I>(1)
|
|
after the server has started.
|
|
<A NAME="lbAN"> </A>
|
|
<H2>FONTPATH.D</H2>
|
|
|
|
You can specify a special kind of font path in the form <B>catalogue:<dir></B>.
|
|
The directory specified after the catalogue: prefix will be scanned for symlinks
|
|
and each symlink destination will be added as a local fontfile FPE.
|
|
<P>
|
|
|
|
The symlink can be suffixed by attributes such as '<B>unscaled</B>', which
|
|
will be passed through to the underlying fontfile FPE. The only exception is
|
|
the newly introduced '<B>pri</B>' attribute, which will be used for ordering
|
|
the font paths specified by the symlinks.
|
|
<P>
|
|
An example configuration:
|
|
<P>
|
|
<PRE>
|
|
75dpi:unscaled:pri=20 -> /usr/share/X11/fonts/75dpi
|
|
ghostscript:pri=60 -> /usr/share/fonts/default/ghostscript
|
|
misc:unscaled:pri=10 -> /usr/share/X11/fonts/misc
|
|
type1:pri=40 -> /usr/share/X11/fonts/Type1
|
|
type1:pri=50 -> /usr/share/fonts/default/Type1
|
|
</PRE>
|
|
|
|
<P>
|
|
This will add /usr/share/X11/fonts/misc as the first FPE with the attribute
|
|
'unscaled', second FPE will be /usr/share/X11/fonts/75dpi, also with
|
|
the attribute 'unscaled' etc. This is functionally equivalent to setting
|
|
the following font path:
|
|
<P>
|
|
<PRE>
|
|
/usr/share/X11/fonts/misc:unscaled,
|
|
/usr/share/X11/fonts/75dpi:unscaled,
|
|
/usr/share/X11/fonts/Type1,
|
|
/usr/share/fonts/default/Type1,
|
|
/usr/share/fonts/default/ghostscript
|
|
</PRE>
|
|
|
|
<P>
|
|
<A NAME="lbAO"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="83"><I>/etc/X</I><B>n</B>.hosts
|
|
|
|
<DD>
|
|
Initial access control list for display number <B>n</B>
|
|
<DT id="84"><I>/usr/share/fonts/X11/misc</I>,<I>/usr/share/fonts/X11/75dpi</I>,<I>/usr/share/fonts/X11/100dpi</I>
|
|
|
|
<DD>
|
|
Bitmap font directories
|
|
<DT id="85"><I>/usr/share/fonts/X11/TTF</I>,<I>/usr/share/fonts/X11/Type1</I>
|
|
|
|
<DD>
|
|
Outline font directories
|
|
<DT id="86"><I>/tmp/.X11-unix/X</I><B>n</B>
|
|
|
|
<DD>
|
|
Unix domain socket for display number <B>n</B>
|
|
<DT id="87"><I>/usr/adm/X</I><B>n</B>msgs
|
|
|
|
<DD>
|
|
Error log file for display number <B>n</B> if run from <I><A HREF="/cgi-bin/man/man2html?8+init">init</A></I>(8)
|
|
<DT id="88"><I>/usr/lib/X11/xdm/xdm-errors</I>
|
|
|
|
<DD>
|
|
Default error log file if the server is run from <I><A HREF="/cgi-bin/man/man2html?1+xdm">xdm</A></I>(1)
|
|
</DL>
|
|
<A NAME="lbAP"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
General information: <I><A HREF="/cgi-bin/man/man2html?7+X">X</A></I>(7)
|
|
<P>
|
|
|
|
Protocols:
|
|
<I>X Window System Protocol,</I>
|
|
|
|
<I>The X Font Service Protocol,</I>
|
|
|
|
<I>X Display Manager Control Protocol</I>
|
|
|
|
<P>
|
|
|
|
Fonts: <I><A HREF="/cgi-bin/man/man2html?1+bdftopcf">bdftopcf</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+mkfontdir">mkfontdir</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+mkfontscale">mkfontscale</A></I>(1),
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xfs">xfs</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xlsfonts">xlsfonts</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xfontsel">xfontsel</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xfd">xfd</A></I>(1),
|
|
<I>X Logical Font Description Conventions</I>
|
|
|
|
<P>
|
|
|
|
Keyboards: <I><A HREF="/cgi-bin/man/man2html?7+xkeyboard-config">xkeyboard-config</A></I>(7)
|
|
<P>
|
|
|
|
Security: <I><A HREF="/cgi-bin/man/man2html?7+Xsecurity">Xsecurity</A></I>(7), <I><A HREF="/cgi-bin/man/man2html?1+xauth">xauth</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+Xau">Xau</A></I>(1),
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xdm">xdm</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xhost">xhost</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xfwp">xfwp</A></I>(1),
|
|
<I>Security Extension Specification</I>
|
|
|
|
<P>
|
|
|
|
Starting the server: <I><A HREF="/cgi-bin/man/man2html?1+startx">startx</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xdm">xdm</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xinit">xinit</A></I>(1)
|
|
<P>
|
|
|
|
Controlling the server once started: <I><A HREF="/cgi-bin/man/man2html?1+xset">xset</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xsetroot">xsetroot</A></I>(1),
|
|
<I><A HREF="/cgi-bin/man/man2html?1+xhost">xhost</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xinput">xinput</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+xrandr">xrandr</A></I>(1)
|
|
<P>
|
|
|
|
Server-specific man pages:
|
|
<I><A HREF="/cgi-bin/man/man2html?1+Xorg">Xorg</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+Xdmx">Xdmx</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+Xephyr">Xephyr</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+Xnest">Xnest</A></I>(1),
|
|
<I><A HREF="/cgi-bin/man/man2html?1+Xvfb">Xvfb</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+Xquartz">Xquartz</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+XWin">XWin</A></I>(1).
|
|
<P>
|
|
|
|
Server internal documentation:
|
|
<I>Definition of the Porting Layer for the X v11 Sample Server</I>
|
|
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
The sample server was originally written by Susan Angebranndt, Raymond
|
|
Drewry, Philip Karlton, and Todd Newman, from Digital Equipment
|
|
Corporation, with support from a large cast. It has since been
|
|
extensively rewritten by Keith Packard and Bob Scheifler, from MIT.
|
|
Dave Wiggins took over post-R5 and made substantial improvements.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="89"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="90"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="91"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="92"><A HREF="#lbAE">STARTING THE SERVER</A><DD>
|
|
<DT id="93"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DT id="94"><A HREF="#lbAG">SERVER DEPENDENT OPTIONS</A><DD>
|
|
<DT id="95"><A HREF="#lbAH">XDMCP OPTIONS</A><DD>
|
|
<DT id="96"><A HREF="#lbAI">XKEYBOARD OPTIONS</A><DD>
|
|
<DT id="97"><A HREF="#lbAJ">NETWORK CONNECTIONS</A><DD>
|
|
<DT id="98"><A HREF="#lbAK">GRANTING ACCESS</A><DD>
|
|
<DT id="99"><A HREF="#lbAL">SIGNALS</A><DD>
|
|
<DT id="100"><A HREF="#lbAM">FONTS</A><DD>
|
|
<DT id="101"><A HREF="#lbAN">FONTPATH.D</A><DD>
|
|
<DT id="102"><A HREF="#lbAO">FILES</A><DD>
|
|
<DT id="103"><A HREF="#lbAP">SEE ALSO</A><DD>
|
|
<DT id="104"><A HREF="#lbAQ">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|