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)