tde-packaging/ubuntu/maverick/tdebase/debian/local/tdm.options.5

.\" $Id: tdm.options.5,v 1.2 2004/02/27 22:45:20 ccheney Exp $
.\"
.\" Copyright 1998, 2002, 2003 Branden Robinson <branden@debian.org>.
.\"
.\" This is free software; you may redistribute it and/or modify
.\" it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; version 2.
.\"
.\" This is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License with
.\" the Debian operating system, in /usr/share/common-licenses/GPL;  if
.\" not, write to the Free Software Foundation, Inc., 59 Temple Place,
.\" Suite 330, Boston, MA 02111-1307 USA
.TH tdm.options 5 "2003\-09\-18" "Debian Project"
.SH NAME
tdm.options \- configuration options for X display manager
.SH DESCRIPTION
.I /etc/trinity/tdm/tdm.options
contains a set of flags that determine some of the behavior of the
X display manager
.BR tdm (1).
.PP
.I /etc/trinity/tdm/tdm.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 \(oqno\-\(cq
prefix, or absent, it is disabled, otherwise it is considered enabled.
.PP
Available options are:
.TP
.B ignore\-nologin
Normally, the contents of the /etc/nologin file will be displayed using
.BR xmessage (1x)
(if
.B xmessage
is available), and the user will be returned to the tdm login screen after
the xmessage is dismissed.  If this option is enabled, tdm starts a session
as usual (after the xmessage is dismissed, if xmessage is available).
.TP
.B restart\-on\-upgrade
Enable this option with caution on \(oqproduction\(cq machines; it causes
the tdm 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 tdm
causes immediate termination of any sessions it manages; in some situations
this could be an unwelcome surprise (for instance, for remote tdm 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 tdm's executable on the
file system has no effect on the copy of tdm in memory).  The tdm
pre\-removal script checks to see if the tdm process has any children; if
it does, it is possible that someone's session would be killed by stopping
tdm, so a warning is issued and an opportunity to abort the upgrade of tdm
is provided.  If this option is disabled (the Debian default), tdm will be
not be stopped or started during an install or upgrade; the administrator
will have to do so by hand (with \(oq/etc/init.d/tdm restart\(cq, or by
rebooting the system) before the newly installed tdm binary is used.
.TP
.B use\-sessreg
If this option is enabled (the Debian default), the sessreg program will be
invoked to register X sessions managed by tdm in the utmp and wtmp files.
Otherwise, it is not, and the utmp and wtmp files will have no record of
tdm sessions.
.PP
Users of older versions of the Debian system should note that the
\(oqrun\-xconsole\(cq option has been removed.  Shell scripts named
.I /etc/trinity/tdm/Xsetup
and
.I /etc/trinity/tdm/Xreset
can be edited to disable or modify the running of xconsole on the tdm
greeter screen; see the
.B tdm
manual page for more information.
.SH AUTHOR
This manpage was written by Branden Robinson for the Debian Project.
.SH SEE ALSO
.BR sessreg (1x),
.BR xmessage (1x),
.BR tdm (1x)