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
       determine some of the behavior of the Xsession(5) Bourne shell (sh(1))  script.   See  the
       Xsession(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  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-’.

       Options      are      read      from      /etc/X11/Xsession.options,      followed      by
       /etc/X11/Xsession.options.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)