man > Xsession.options(5)

Xsession.options(5)                      File Formats Manual                     Xsession.options(5)

NAME
       Xsession.options, Xsession.options.d - configuration options for Xsession(5)

DESCRIPTION
       /etc/X11/Xsession.options  and /etc/X11/Xsession.options.d/*.conf contain options that deter‐
       mine some of the behavior of the Xsession(5) Bourne shell  (sh(1))  script.   See  the  Xses‐
       sion(5) manpage for further information.

       These configuration files 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 op‐
       tions which are expressed as words separated by hyphens, with only one option per line.   Op‐
       tions  are enabled by simply placing them in the file; they are disabled by prefixing the op‐
       tion name with ‘no-’.

       Options  are  read  from   /etc/X11/Xsession.options,   followed   by   /etc/X11/Xsession.op‐
       tions.d/*.conf  in  sorted  order;  later occurrences of an option (with or without the ‘no-’
       prefix) take precedence over earlier occurrences.

       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)