NAME
wdm.options - configuration options for WINGs display manager
DESCRIPTION
/etc/X11/wdm/wdm.options contains a set of flags that determine some of
the behavior of the WINGs display manager wdm(1).
/etc/X11/wdm/wdm.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:
auto-update-wmlist
If set, this option will cause wdm always regenerate the
contents of the session menu when starting. It is set by
default but should be disabled if you wish to manually specify
the list of available window managers.
ignore-nologin
Normally, the contents of the /etc/nologin file will be
displayed using xmessage (if xmessage is available), and the
user will be returned to the wdm login screen after the xmessage
is dismissed. If this option is enabled, wdm starts a session
as usual (after the xmessage is dismissed, if xmessage is
available).
restart-on-upgrade
Enable this option with caution on "production" machines; it
causes the wdm daemon to be stopped and restarted on upgrade,
even if the process has children (which means it is managing X
sessions). Typically when a package that contains a daemon is
being installed or upgraded, its maintainer scripts stop a
running daemon process before installing the new binary, and
restart it after the new binary is installed. Stopping wdm
causes immediate termination of any sessions it manages; in some
situations this could be an unwelcome surprise (for instance,
for remote wdm users who had no idea the administrator was
performing system maintenance). On the other hand, for machines
that stay up for long periods of time, leaving the old daemon
running can be a bad idea if the new version has, for instance,
a fix for a security vulnerability (overwriting wdm’s executable
on the file system has no effect on the copy of wdm in memory).
The wdm pre-removal script checks to see if the wdm process has
any children; if it does, it is possible that someone’s session
would be killed by stopping wdm, so a warning is issued and an
opportunity to abort the upgrade of wdm is provided. If this
option is disabled (the Debian default), wdm will be stopped and
restarted during an install or upgrade only if the running wdm
process is found to have no children. In the event the wdm
daemon is not stopped and restarted, the administrator will have
to do so by hand (probably with "/etc/init.d/wdm restart", or by
rebooting the system) before the newly installed wdm binary is
used.
run-xconsole
This option opens an xconsole(1) client to catch messages that
would normally go to the Linux virtual console and thus be
missed in many cases by the user. By default, this option is
only supported in the Xsetup file for display :0
(/etc/X11/xdm/Xsetup_0), but any Xsetup script may use it if
appropriately edited.
use-sessreg
If this option is enabled (the Debian default), the sessreg
program will be invoked to register X sessions managed by wdm in
the utmp and wtmp files. Otherwise, it is not, and the utmp and
wtmp files will have no record of wdm sessions.
HISTORY
Flags controlling wdm used to be kept in /etc/X11/config on Debian/GNU
Linux systems.
SEE ALSO
sessreg(1), xconsole(1), xmessage(1), wdm(1)
AUTHOR
This manpage was written by Branden Robinson for Debian GNU/Linux and
modified by Marcelo Magallon for wdm.