# Xsession.options - configuration options for Xsession (5) - man(5) - [phpMan]

[_Xsession.options_(5)](https://www.chedong.com/phpMan.php/man/Xsession.options/5/markdown)                      File Formats Manual                     [_Xsession.options_(5)](https://www.chedong.com/phpMan.php/man/Xsession.options/5/markdown)

## NAME
       Xsession.options, Xsession.options.d - configuration options for [**Xsession**(5)](https://www.chedong.com/phpMan.php/man/Xsession/5/markdown)

## 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)](https://www.chedong.com/phpMan.php/man/Xsession/5/markdown) Bourne shell  ([**sh**(1)](https://www.chedong.com/phpMan.php/man/sh/1/markdown))  script.   See  the  **Xses‐**
       [**sion**(5)](https://www.chedong.com/phpMan.php/man/sion/5/markdown) 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)](https://www.chedong.com/phpMan.php/man/x-terminal-emulator/1/markdown) 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)](https://www.chedong.com/phpMan.php/man/Xsession/5/markdown)).   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)](https://www.chedong.com/phpMan.php/man/sh/1/markdown).

### 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)](https://www.chedong.com/phpMan.php/man/ssh-agent/1/markdown)  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)](https://www.chedong.com/phpMan.php/man/Xsession/5/markdown) 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)](https://www.chedong.com/phpMan.php/man/Xsession/5/markdown), [**ssh-agent**(1)](https://www.chedong.com/phpMan.php/man/ssh-agent/1/markdown), [**x-terminal-emulator**(1)](https://www.chedong.com/phpMan.php/man/x-terminal-emulator/1/markdown)

Debian Project                               2004-10-31                          [_Xsession.options_(5)](https://www.chedong.com/phpMan.php/man/Xsession.options/5/markdown)