Man Linux: Main Page and Category List

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)