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

NAME

       Xsession.options - configuration options for Xsession(5)

DESCRIPTION

       /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.  Options are
       enabled by simply placing them in the file; they are disabled by prefixing the option name with 'no-'.

       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-termi-
	      nal-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)