NAME
Xwrapper.config - configuration options for X server wrapper
DESCRIPTION
/etc/X11/Xwrapper.config contains a set of flags that determine some of
the behavior of Debian's X server wrapper, which is installed on the
system as /usr/bin/X. The purpose of the wrapper, and of this
configuration file, is twofold.
Firstly, it is intended to implement sound security practices. Since
the X server requires superuser privileges, it may be unwise to permit
just any user on the system to execute it. Even if the X server is not
exploitable in the sense of permitting ordinary users to gain elevated
privileges, a poorly-written or insufficiently-tested hardware driver
for the X server may cause bus lockups and freeze the system, an
unpleasant experience for anyone using it at the time.
Secondly, a wrapper is a convenient place to set up an execution
environment for the X server distinct from the configurable parameters
of the X server itself.
Xwrapper.config may be edited by hand, but it is typically configured
via debconf(7), the Debian configuration tool. The X server wrapper is
part of the x11-common Debian package; therefore, the parameters of
Xwrapper.config may be changed with the command
dpkg-reconfigure x11-common.
See dpkg-reconfigure(8) for more information.
The format of Xwrapper.config is a text file containing a series of
lines of the form
name=value
where name is a variable name containing any combination of numbers,
letters, or underscore (_) characters, and value is any combination of
letters, numbers, underscores (_), or dashes (-). value may also
contain spaces as long as there is at least one character from the list
above bounding the space(s) on both sides. Whitespace before and after
name, value, or the equals sign is legal but ignored. Any lines not
matching the above described legal format are ignored. Note that this
specification may change as the X server wrapper develops.
Available options are:
allowed_users
may be set to one of the following values: rootonly, console, or
anybody. rootonly indicates that only the root user may start
the X server; console indicates that root, or any user whose
controlling TTY is a virtual console, may start the X server;
and anybody indicates that any user may start the X server.
AUTHORS
The X server wrapper was written by Stephen Early, Mark Eichin, and
Branden Robinson for the Debian Project, with valuable contributions
from Erik Troan, Topi Miettinen, and Colin Phipps. This manual page
was written by Branden Robinson with sponsorship from Progeny Linux
Systems.
SEE ALSO
debconf(7), dpkg-reconfigure(8)