aboutsummaryrefslogtreecommitdiffstats
path: root/trunk/man/C/chksession.8
diff options
context:
space:
mode:
Diffstat (limited to 'trunk/man/C/chksession.8')
-rw-r--r--trunk/man/C/chksession.8103
1 files changed, 103 insertions, 0 deletions
diff --git a/trunk/man/C/chksession.8 b/trunk/man/C/chksession.8
new file mode 100644
index 0000000..4ca9b70
--- /dev/null
+++ b/trunk/man/C/chksession.8
@@ -0,0 +1,103 @@
+.\" Written by Camille Bégnis 12/28/99
+.TH CHKSESSION 8 "Aug 2003" "mandrake_desk" "MandrakeSoft"
+.SH NAME
+chksession \- Add/remove sessions from display managers
+.SH SYNOPSIS
+.B chksession
+[\fIOPTIONS\fR]...
+.SH DESCRIPTION
+.PP
+.PP
+\fBchksession\fR allows system root to control the window manager
+lists for sessions initiated by gdm and kdm display managers. It
+modifies respective configuration files to add or remove window
+managers available for the sessions, like kde, gnome, icewm...
+.TP
+\fB\-F\fR, \fB\-\-first\fR
+Print only first available entry of config file.
+.TP
+\fB\-d=DIR\fR, \fB\-\-dir=DIR\fR
+Specifies the directory DIR containing the list of window manager files.
+The default is \fI/etc/X11/wmsession.d/\fR.
+.TP
+\fB\-g\fR, \fB\-\-gdm\fR
+Update window managers list for gdm sessions using default config file or FILE specified by \fB\-d\fR option.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print a short help.
+.TP
+\fB\-k\fR, \fB\-\-kdm\fR
+Update window managers list for kdm sessions using default config file or FILE specified by \fB\-d\fR option.
+.TP
+\fB\-l\fR, \fB\-\-list\fR
+List window managers available in config file.
+.TP
+\fB\-r=ENTRY\fR, \fB\-\-remove=ENTRY\fR
+Print to stdout the list of window managers as in config file, where ENTRY has been removed.
+.TP
+\fB\-t\fR, \fB\-\-test\fR
+Enter test mode. Not to be used unless you know precisely what you are
+doing. See TESTING.
+.TP
+\fB\-x=ENTRY\fR, \fB\-\-xsession=ENTRY\fR
+Print to stdout the script used to launch the ENTRY window manager.
+.SH "WINDOW MANAGERS CONFIGURATION FILES"
+\fBchksession\fR uses a directory containing several window manager
+description files (by default \fI/etc/X11/wmsession.d/\fR unless
+specified by option \fB\-d\fR). Each file contains the information to
+briefly present the window manager and to start a session using it
+(see examples in \fI/etc/X11/wmsession.d/\fR). Each file name usually
+begins with digits (2 digits), which are used to order the list of the
+window managers they describe.
+.br
+Each file contains 4 definitions followed by a script:
+.TP
+.B NAME=<name>
+specifies the name of the session in the displayed list of window managers.
+.TP
+.B ICON=<file>
+icon file (\fI.xpm or .png\fR) used for this window manager.
+.TP
+.B DESC=<text>
+short description of the window manager for a session.
+.TP
+.B EXEC=<path>
+<path> must be the absolute path of an executable file for the window
+manager. It is used only to check that the window manager has
+actually been installed. If this definition is missing, or if the
+file is not executable by effective uid/gid, then this window manager
+description file is ignored.
+.TP
+.B SCRIPT:
+shell script used to run the window manager chosen by the user.
+.br
+This script starts on the next line and may be composed of several
+command lines. It must be the last part of the file, since it will
+include all following lines to the end of file.
+.PP
+All other lines, preceeding the script, are ignored.
+.SH FILES
+\fB\/etc/X11/wmsession.d/\fR default directory of window manager
+description files. It is the reference used by \fBchksession\fR to update
+configuration files of both gdm and kdm display managers.
+.SH "TESTING"
+Option \fB\-t\fR or \fB\-\-test\fR may be used for testing only. When
+this option is active the behaviour may change in various way. For
+example: the default directory DIR containing the list of window
+manager files may then be \fI./wmsession.d/\fR rather than
+\fI/etc/X11/wmsession.d/\fR. Do not use it unless you know precisely
+what you are doing.
+.SH "REPORTING BUGS"
+Report bugs to \fBhttp://www.mandrakeexpert.com/\fR.
+.SH "SEE ALSO"
+\fIxdm\fR(1)
+.SH "AUTHOR"
+Created by Camille Bégnis 12/28/99 - Modified by Bernard Lang 08/09/03.
+.br
+Last modified: August 21, 2003.
+.SH COPYRIGHT
+Copyright \(co 1999-2003 MandrakeSoft.
+.br
+This is a GPL free software; see the source for copying conditions. There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+