Xsession.options - configuration options for Xsession(5)

/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. If an option is present with the "no-" prefix, or absent, it is disabled, otherwise it is considered enabled.

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 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 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-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.

use-session-dbus

Starts up a D-BUS session bus for the display and sets environment variables so that applications can connect to it, using dbus-session(1).

xrdb-use-cpp

Invoke xrdb(1) with the -cpp option, to make it use cpp(1) when processing resource files.

Additional options may be supported by the local administrator. See Xsession(5) for how this is accomplished.

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

This manpage was written by Branden Robinson for Debian GNU/Linux.