Provided by: wdm_1.28-16_amd64 bug

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.