man-pages/man5/Xsession.options.5.html
2021-03-31 01:06:50 +01:00

142 lines
3.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of Xsession.options</TITLE>
</HEAD><BODY>
<H1>Xsession.options</H1>
Section: File Formats (5)<BR>Updated: 2004-10-31<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
Xsession.options - configuration options for
<B><A HREF="/cgi-bin/man/man2html?5+Xsession">Xsession</A></B>(5)
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
<I>/etc/X11/Xsession.options</I>
contains a set of flags that determine some of the behavior of the
<B><A HREF="/cgi-bin/man/man2html?5+Xsession">Xsession</A></B>(5)
Bourne shell
(<B><A HREF="/cgi-bin/man/man2html?1+sh">sh</A></B>(1))
script.
See the
<B><A HREF="/cgi-bin/man/man2html?5+Xsession">Xsession</A></B>(5)
manpage for further information.
<P>
<I>Xsession.options</I>
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-'.
<P>
Available options are:
<DL COMPACT>
<DT id="1"><B>allow-failsafe</B>
<DD>
If the 'failsafe' argument is passed to the
<I>Xsession</I>
script, an emergency X session is invoked, consisting of only an
<B><A HREF="/cgi-bin/man/man2html?1+x-terminal-emulator">x-terminal-emulator</A></B>(1)
in the upper-left hand corner of the screen.
No window manager is started.
If an
<B>x-terminal-emulator</B>
program is not available, the session exits immediately.
<DT id="2"><B>allow-user-resources</B>
<DD>
If users have a file called
<I>.Xresources</I>
in their home directories, these resources will be merged with the default
X resources when they log in.
<DT id="3"><B>allow-user-xsession</B>
<DD>
If users have an executable file called
<I>.xsession</I>
in their home directories, it can be used as the startup program for the X
session (see
<B><A HREF="/cgi-bin/man/man2html?5+Xsession">Xsession</A></B>(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
<B><A HREF="/cgi-bin/man/man2html?1+sh">sh</A></B>(1).
<DT id="4"><B>use-session-dbus</B>
<DD>
If the
<B>dbus</B>
package is installed, the session bus will be activated at X session
launch.
<DT id="5"><B>use-ssh-agent</B>
<DD>
If the
<B><A HREF="/cgi-bin/man/man2html?1+ssh-agent">ssh-agent</A></B>(1)
program is available and no agent process appears to be running already,
the X session will be invoked by exec'ing
<B>ssh-agent</B>
with the startup command, instead of the startup command directly.
</DL>
<P>
All of the above options are enabled by default.
Additional options may be supported by the local administrator.
<B><A HREF="/cgi-bin/man/man2html?5+Xsession">Xsession</A></B>(5)
describes how this is accomplished.
<A NAME="lbAD">&nbsp;</A>
<H2>AUTHORS</H2>
Stephen Early, Mark Eichin, and Branden Robinson developed Debian's X
session handling scripts.
Branden Robinson wrote this manual page.
<A NAME="lbAE">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?5+Xsession">Xsession</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?1+ssh-agent">ssh-agent</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+x-terminal-emulator">x-terminal-emulator</A></B>(1)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
<DT id="7"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="8"><A HREF="#lbAD">AUTHORS</A><DD>
<DT id="9"><A HREF="#lbAE">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:06 GMT, March 31, 2021
</BODY>
</HTML>