Xsession.options, Xsession.options.d - configuration options for
/etc/X11/Xsession.options and
/etc/X11/Xsession.options.d/*.conf
contain options that determine some of the behavior of the
Bourne shell (
sh(1)) script. See the 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 ). 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. describes how this is
accomplished.
Stephen Early, Mark Eichin, and Branden Robinson developed Debian's X session
handling scripts. Branden Robinson wrote this manual page.
,
ssh-agent(1),
x-terminal-emulator(1)