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.

Debian GNU/Linux                                 4 December 1998                                  wdm.options(5)