NAME

       Xsession.options - configuration options for Xsession(5)

DESCRIPTION

       /etc/X11/Xsession.options  contains a set of flags that determine some of the behavior of the Xsession(5)
       Bourne shell (sh(1)) script.  See the Xsession(5) manpage for further information.

       Xsession.options may contain comments, which begin with a hash mark (‘#’) and end at  the  next  newline,
       just  like  comments  in  shell scripts.  The rest of the file consists of options which are expressed as
       words separated by hyphens, with only one option per line.  Options are enabled by simply placing them in
       the file; they are disabled by prefixing the option name with ‘no-’.

       Available options are:

       allow-failsafe
              If the ‘failsafe’ argument is passed to the Xsession script, an emergency X  session  is  invoked,
              consisting  of  only  an  x-terminal-emulator(1)  in the upper-left hand corner of the screen.  No
              window manager is started.  If an x-terminal-emulator program is not available, the session  exits
              immediately.

       allow-user-resources
              If  users have a file called .Xresources in their home directories, these resources will be merged
              with the default X resources when they log in.

       allow-user-xsession
              If users have an executable file called .xsession in their home directories, it can be used as the
              startup program for the X session (see Xsession(5)).  If the file is present but  not  executable,
              it may still be used, but is assumed to be a Bourne shell script, and executed with sh(1).

       use-session-dbus
              If the dbus package is installed, the session bus will be activated at X session launch.

       use-ssh-agent
              If the ssh-agent(1) program is available and no agent process appears to be running already, the X
              session  will  be  invoked  by exec'ing ssh-agent with the startup command, instead of the startup
              command directly.

       All of the above options are enabled by default.  Additional  options  may  be  supported  by  the  local
       administrator.  Xsession(5) describes how this is accomplished.

AUTHORS

       Stephen  Early, Mark Eichin, and Branden Robinson developed Debian's X session handling scripts.  Branden
       Robinson wrote this manual page.

SEE ALSO

       Xsession(5), ssh-agent(1), x-terminal-emulator(1)

Debian Project                                     2004-10-31                                Xsession.options(5)