doc: Man page cleanup

Simlify example sections.
Remove un-needed .LP after section start.
Insert empty line before section start.
ulab-next
Philipp Hahn 12 years ago
parent 3b1897470c
commit e67878cedd

@ -1,10 +1,9 @@
.\" .\"
.TH "sesman.ini" "5" "0.1.0" "xrdp team" "" .TH "sesman.ini" "5" "0.1.0" "xrdp team" ""
.SH "NAME" .SH "NAME"
.LP
\fBsesman.ini\fR \- Configuration file for \fBsesman\fR(8) \fBsesman.ini\fR \- Configuration file for \fBsesman\fR(8)
.SH "DESCRIPTION" .SH "DESCRIPTION"
.LP
This is the man page for \fBsesman.ini\fR, \fBsesman\fR(8) configuration file. This is the man page for \fBsesman.ini\fR, \fBsesman\fR(8) configuration file.
It is composed by a number of sections, each one composed by a section name, enclosed by square brackets, folowed by a list of \fI<parameter>\fR=\fI<value>\fR lines. It is composed by a number of sections, each one composed by a section name, enclosed by square brackets, folowed by a list of \fI<parameter>\fR=\fI<value>\fR lines.
@ -29,49 +28,38 @@ All options and values (except for file names and paths) are case insensitive, a
For any of the following parameter, if it's specified more than one time the last entry encountered will be used. For any of the following parameter, if it's specified more than one time the last entry encountered will be used.
\fBNOTE\fR: if any of these options is specified outside its section, it will be \fIignored\fR. \fBNOTE\fR: if any of these options is specified outside its section, it will be \fIignored\fR.
.SH "GLOBALS"
.LP
.TP .SH "GLOBALS"
The options to be specified in the \fB[globals]\fR section are the following: The options to be specified in the \fB[globals]\fR section are the following:
.br
.TP .TP
\fBListenAddress\fR=\fIip address\fR \fBListenAddress\fR=\fIip address\fR
Specifies sesman listening address. Default is 0.0.0.0 (all interfaces) Specifies sesman listening address. Default is 0.0.0.0 (all interfaces)
.br
.TP .TP
\fBListenPort\fR=\fIport number\fR \fBListenPort\fR=\fIport number\fR
Specifies sesman listening port. Default is 3350 Specifies sesman listening port. Default is 3350
.br
.TP .TP
\fBEnableUserWindowManager\fR=\fI[0|1]\fR \fBEnableUserWindowManager\fR=\fI[0|1]\fR
If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables user specific window manager, that is, anyone can define it's own script executed by sesman when starting a new session, specified by \fBUserWindowManager\fR If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables user specific window manager, that is, anyone can define it's own script executed by sesman when starting a new session, specified by \fBUserWindowManager\fR
.br
.TP .TP
\fBUserWindowManager\fR=\fIstartwm.sh\fR \fBUserWindowManager\fR=\fIstartwm.sh\fR
This option specifies the script run by sesman when starting a session and per\-user window manager is enabled. This option specifies the script run by sesman when starting a session and per\-user window manager is enabled.
.br .br
The path is relative to user's HOME directory The path is relative to user's HOME directory
.br
.TP .TP
\fBDefaultWindowManager\fR=\fI${SESMAN_BIN_DIR}/startwm.sh\fR \fBDefaultWindowManager\fR=\fI${SESMAN_BIN_DIR}/startwm.sh\fR
This contains full path to the default window manager startup script used by sesman to start a session This contains full path to the default window manager startup script used by sesman to start a session
.SH "LOGGING"
.LP
.TP .SH "LOGGING"
The following parameters can be used in the \fB[logging]\fR section: The following parameters can be used in the \fB[logging]\fR section:
.br
.TP .TP
\fBLogFile\fR=\fI${SESMAN_LOG_DIR}/sesman.log\fR \fBLogFile\fR=\fI${SESMAN_LOG_DIR}/sesman.log\fR
This options contains the path to logfile. It can be either absolute or relative, and the default is \fI${SESMAN_LOG_DIR}/sesman.log\fR This options contains the path to logfile. It can be either absolute or relative, and the default is \fI${SESMAN_LOG_DIR}/sesman.log\fR
.br
.TP .TP
\fBLogLevel\fR=\fIlevel\fR \fBLogLevel\fR=\fIlevel\fR
@ -86,41 +74,33 @@ This option can have one of the following values:
\fBINFO\fR or \fB3\fR \- Logs errors, warnings and informational messages \fBINFO\fR or \fB3\fR \- Logs errors, warnings and informational messages
\fBDEBUG\fR or \fB4\fR \- Log everything. If \fBsesman\fR is compiled in debug mode, this options will output many more low\-level message, useful for developers \fBDEBUG\fR or \fB4\fR \- Log everything. If \fBsesman\fR is compiled in debug mode, this options will output many more low\-level message, useful for developers
.br
.TP .TP
\fBEnableSyslog\fR=\fI[0|1]\fR \fBEnableSyslog\fR=\fI[0|1]\fR
If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables logging to syslog. Otherwise syslog is disabled. If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables logging to syslog. Otherwise syslog is disabled.
.br
.TP .TP
\fBSyslogLevel\fR=\fIlevel\fR \fBSyslogLevel\fR=\fIlevel\fR
This option sets the logging level for syslog. It can have the same values of \fBLogLevel\fR. If \fBSyslogLevel\fR is greater than \fBLogLevel\fR, its value is lowered to that of \fBLogLevel\fR. This option sets the logging level for syslog. It can have the same values of \fBLogLevel\fR. If \fBSyslogLevel\fR is greater than \fBLogLevel\fR, its value is lowered to that of \fBLogLevel\fR.
.SH "SESSIONS"
.LP
.TP .SH "SESSIONS"
The following parameters can be used in the \fB[Sessions]\fR section: The following parameters can be used in the \fB[Sessions]\fR section:
.br
.TP .TP
\fBX11DisplayOffset\fR=\fI<number>\fR \fBX11DisplayOffset\fR=\fI<number>\fR
Specifies the first X display number available for \fBsesman\fP(8). This prevents sesman from interfering with real X11 servers. The default is 10. Specifies the first X display number available for \fBsesman\fP(8). This prevents sesman from interfering with real X11 servers. The default is 10.
.br
.TP .TP
\fBMaxSessions\fR=\fI<number>\fR \fBMaxSessions\fR=\fI<number>\fR
Sets the maximum number of simultaneous session on terminal server. Sets the maximum number of simultaneous session on terminal server.
.br .br
If unset or set to \fI0\fR, unlimited session are allowed. If unset or set to \fI0\fR, unlimited session are allowed.
.br
.TP .TP
\fBKillDisconnected\fR=\fI[0|1]\fR \fBKillDisconnected\fR=\fI[0|1]\fR
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, every session will be killed when the user disconnects. If set to \fB1\fR, \fBtrue\fR or \fByes\fR, every session will be killed when the user disconnects.
.br .br
\fI\-this option is currently ignored!\-\fR \fI\-this option is currently ignored!\-\fR
.br
.TP .TP
\fBIdleTimeLimit\fR=\fI<number>\fR \fBIdleTimeLimit\fR=\fI<number>\fR
@ -129,7 +109,6 @@ Sets the the time limit before an idle session is disconnected.
If set to \fI0\fR, automatic disconnection is disabled. If set to \fI0\fR, automatic disconnection is disabled.
.br .br
\fI\-this option is currently ignored!\-\fR \fI\-this option is currently ignored!\-\fR
.br
.TP .TP
\fBDisconnectedTimeLimit\fR=\fI<number>\fR \fBDisconnectedTimeLimit\fR=\fI<number>\fR
@ -138,87 +117,64 @@ Sets the the time limit before a disconnected session is killed.
If set to \fI0\fR, automatic killing is disabled. If set to \fI0\fR, automatic killing is disabled.
.br .br
\fI\-this option is currently ignored!\-\fR \fI\-this option is currently ignored!\-\fR
.br
.SH "SECURITY"
.LP
.TP .SH "SECURITY"
The following parameters can be used in the \fB[Sessions]\fR section: The following parameters can be used in the \fB[Sessions]\fR section:
.br
.TP .TP
\fBAllowRootLogin\fR=\fI[0|1]\fR \fBAllowRootLogin\fR=\fI[0|1]\fR
If set to \fB1\fR, \fBtrue\fR or \fByes\fR enables root login on the terminal server If set to \fB1\fR, \fBtrue\fR or \fByes\fR enables root login on the terminal server
.br
.TP .TP
\fBMaxLoginRetry\fR=\fI[0|1]\fR \fBMaxLoginRetry\fR=\fI[0|1]\fR
The number of login attempts that are allowed on terminal server. If set to \fI0\fR, unlimited attempts are allowed. The default value for this field is \fI3\fR. The number of login attempts that are allowed on terminal server. If set to \fI0\fR, unlimited attempts are allowed. The default value for this field is \fI3\fR.
.br
.TP .TP
\fBTerminalServerUsers\fR=\fItsusers\fR \fBTerminalServerUsers\fR=\fItsusers\fR
Only the users belonging to the group \fItsusers\fR are allowed to login on terminal server. Only the users belonging to the group \fItsusers\fR are allowed to login on terminal server.
.br .br
If unset or set to an invalid or non\-existent group, login for all users is enabled. If unset or set to an invalid or non\-existent group, login for all users is enabled.
.br
.TP .TP
\fBTerminalServerAdmins\fR=\fItsadmins\fR \fBTerminalServerAdmins\fR=\fItsadmins\fR
Sets the group which a user shall belong to have session management rights. Sets the group which a user shall belong to have session management rights.
.br .br
\fI\-this option is currently ignored!\-\fR \fI\-this option is currently ignored!\-\fR
.br
.SH "EXAMPLES" .SH "EXAMPLES"
.LP
This is an example \fBsesman.ini\fR: This is an example \fBsesman.ini\fR:
.nf
[Globals] [Globals]
.br
ListenAddress=127.0.0.1 ListenAddress=127.0.0.1
.br
ListenPort=3350 ListenPort=3350
.br
EnableUserWindowManager=1 EnableUserWindowManager=1
.br
UserWindowManager=startwm.sh UserWindowManager=startwm.sh
.br
DefaultWindowManager=startwm.sh DefaultWindowManager=startwm.sh
[Logging] [Logging]
.br
LogFile=/usr/local/xrdp/sesman.log LogFile=/usr/local/xrdp/sesman.log
.br
LogLevel=DEBUG LogLevel=DEBUG
.br
EnableSyslog=0 EnableSyslog=0
.br
SyslogLevel=DEBUG SyslogLevel=DEBUG
[Sessions] [Sessions]
.br
MaxSessions=10 MaxSessions=10
.br
KillDisconnected=0 KillDisconnected=0
.br
IdleTimeLimit=0 IdleTimeLimit=0
.br
DisconnectedTimeLimit=0 DisconnectedTimeLimit=0
[Security] [Security]
.br
AllowRootLogin=1 AllowRootLogin=1
.br
MaxLoginRetry=3 MaxLoginRetry=3
.br
TerminalServerUsers=tsusers TerminalServerUsers=tsusers
.br
TerminalServerAdmins=tsadmins TerminalServerAdmins=tsadmins
.fi
.SH "FILES" .SH "FILES"
.LP
${SESMAN_CFG_DIR}/sesman.ini ${SESMAN_CFG_DIR}/sesman.ini
.SH "SEE ALSO" .SH "SEE ALSO"
.LP
.BR sesman (8), .BR sesman (8),
.BR sesrun (8), .BR sesrun (8),
.BR xrdp (8), .BR xrdp (8),

@ -1,19 +1,17 @@
.TH "sesman" "8" "0.1.0" "xrdp team" "" .TH "sesman" "8" "0.1.0" "xrdp team" ""
.SH "NAME" .SH "NAME"
.LP
\fBsesman\fR \- \fBxrdp\fR(8) session manager \fBsesman\fR \- \fBxrdp\fR(8) session manager
.SH "SYNTAX" .SH "SYNTAX"
.LP
.B sesman .B sesman
.RB [ \-\-nodaemon | \-\-kill | \-\-help ] .RB [ \-\-nodaemon | \-\-kill | \-\-help ]
.SH "DESCRIPTION" .SH "DESCRIPTION"
.LP
\fBsesman\fR is \fBxrdp\fR(8) session manager. \fBsesman\fR is \fBxrdp\fR(8) session manager.
.br .br
It manages user sessions by authenticating the user and starting the appropriate Xserver It manages user sessions by authenticating the user and starting the appropriate Xserver
.SH "OPTIONS" .SH "OPTIONS"
.LP
.TP .TP
\fB\-n\fR, \fB\-\-nodaemon\fR \fB\-n\fR, \fB\-\-nodaemon\fR
Starts \fBsesman\fR in foreground instead of starting it as a daemon. Starts \fBsesman\fR in foreground instead of starting it as a daemon.
@ -23,8 +21,8 @@ Kills running \fBsesman\fR daemon.
.TP .TP
\fB\-h\fR, \fB\-\-help\fR \fB\-h\fR, \fB\-\-help\fR
Output help information and exit. Output help information and exit.
.SH "FILES" .SH "FILES"
.LP
${SESMAN_BIN_DIR}/sesman ${SESMAN_BIN_DIR}/sesman
.br .br
${SESMAN_BIN_DIR}/sesrun ${SESMAN_BIN_DIR}/sesrun
@ -34,13 +32,13 @@ ${SESMAN_CFG_DIR}/sesman.ini
${SESMAN_LOG_DIR}/sesman.log ${SESMAN_LOG_DIR}/sesman.log
.br .br
${SESMAN_PID_DIR}/sesman.pid ${SESMAN_PID_DIR}/sesman.pid
.SH "AUTHORS" .SH "AUTHORS"
.LP
Jay Sorg <jsorg71@users.sourceforge.net> Jay Sorg <jsorg71@users.sourceforge.net>
.br .br
Simone Fedele <ilsimo@users.sourceforge.net> Simone Fedele <ilsimo@users.sourceforge.net>
.SH "SEE ALSO" .SH "SEE ALSO"
.LP
.BR sesman.ini (5), .BR sesman.ini (5),
.BR sesrun (8), .BR sesrun (8),
.BR xrdp (8), .BR xrdp (8),

@ -1,19 +1,17 @@
.TH "sesrun" "8" "0.1.0" "xrdp team" "" .TH "sesrun" "8" "0.1.0" "xrdp team" ""
.SH "NAME" .SH "NAME"
.LP
\fBsesrun\fR \- \fBsesman\fR(8) session launcher \fBsesrun\fR \- \fBsesman\fR(8) session launcher
.SH "SYNTAX" .SH "SYNTAX"
.LP
.B sesrun .B sesrun
.I server username password width height bpp .I server username password width height bpp
.SH "DESCRIPTION" .SH "DESCRIPTION"
.LP
\fBsesrun\fR starts a session using \fBsesman\fR(8). \fBsesrun\fR starts a session using \fBsesman\fR(8).
.br .br
This is a tool useful for testing, it simply behaves like xrdp when some user logs in a new session and authenticates, thus starting a new session. This is a tool useful for testing, it simply behaves like xrdp when some user logs in a new session and authenticates, thus starting a new session.
.SH "OPTIONS" .SH "OPTIONS"
.LP
.TP .TP
.I server .I server
Server on which sesman is running Server on which sesman is running
@ -32,18 +30,18 @@ Screen height
.TP .TP
.I bpp .I bpp
Session color depth Session color depth
.SH "FILES" .SH "FILES"
.LP
${SESMAN_BIN_DIR}/sesman ${SESMAN_BIN_DIR}/sesman
.br .br
${SESMAN_BIN_DIR}/sesrun ${SESMAN_BIN_DIR}/sesrun
.SH "AUTHORS" .SH "AUTHORS"
.LP
Jay Sorg <jsorg71@users.sourceforge.net> Jay Sorg <jsorg71@users.sourceforge.net>
.br .br
Simone Fedele <ilsimo@users.sourceforge.net> Simone Fedele <ilsimo@users.sourceforge.net>
.SH "SEE ALSO" .SH "SEE ALSO"
.LP
.BR sesman (8), .BR sesman (8),
.BR sesman.ini (5), .BR sesman.ini (5),
.BR xrdp (8), .BR xrdp (8),

@ -1,19 +1,18 @@
.TH "xrdp" "8" "0.1.0" "xrdp team" "" .TH "xrdp" "8" "0.1.0" "xrdp team" ""
.SH "NAME" .SH "NAME"
.LP
\fBxrdp\fR \- a Remote Desktop Protocol (RDP) server \fBxrdp\fR \- a Remote Desktop Protocol (RDP) server
.SH "SYNTAX" .SH "SYNTAX"
.LP
xrdp [ \-\-nodaemon | \-\-kill | \-\-help ] xrdp [ \-\-nodaemon | \-\-kill | \-\-help ]
.SH "DESCRIPTION" .SH "DESCRIPTION"
.LP
\fBxrdp\fR is a Remote Desktop Protocol (RDP) Server. \fBxrdp\fR is a Remote Desktop Protocol (RDP) Server.
.br .br
Unlike Windows NT/2000/2003 server, \fBxrdp\fR will not display a Windows desktop but an X window desktop to the user. Unlike Windows NT/2000/2003 server, \fBxrdp\fR will not display a Windows desktop but an X window desktop to the user.
It can also be used as a VNC\->RDP bridge. It can also be used as a VNC\->RDP bridge.
.SH "OPTIONS" .SH "OPTIONS"
.LP
.TP .TP
\fB\-n\fR, \fB\-\-nodaemon\fR \fB\-n\fR, \fB\-\-nodaemon\fR
Starts \fBxrdp\fR in foreground instead of starting it as a daemon. Starts \fBxrdp\fR in foreground instead of starting it as a daemon.
@ -23,8 +22,8 @@ Kills running \fBxrdp\fR daemon.
.TP .TP
\fB\-h\fR, \fB\-\-help\fR \fB\-h\fR, \fB\-\-help\fR
Output help information and exit. Output help information and exit.
.SH "FILES" .SH "FILES"
.LP
${XRDP_BIN_DIR}/xrdp ${XRDP_BIN_DIR}/xrdp
.br .br
${XRDP_CFG_DIR}/xrdp.ini ${XRDP_CFG_DIR}/xrdp.ini
@ -32,13 +31,13 @@ ${XRDP_CFG_DIR}/xrdp.ini
${XRDP_LOG_DIR}/xrdp.log ${XRDP_LOG_DIR}/xrdp.log
.br .br
${XRDP_PID_DIR}/xrdp.pid ${XRDP_PID_DIR}/xrdp.pid
.SH "AUTHORS" .SH "AUTHORS"
.LP
Jay Sorg <jsorg71@users.sourceforge.net> Jay Sorg <jsorg71@users.sourceforge.net>
.br .br
Simone Fedele <ilsimo@users.sourceforge.net> Simone Fedele <ilsimo@users.sourceforge.net>
.SH "SEE ALSO" .SH "SEE ALSO"
.LP
.BR xrdp.ini (5), .BR xrdp.ini (5),
.BR sesman (8), .BR sesman (8),
.BR sesman.ini (5), .BR sesman.ini (5),

@ -1,10 +1,8 @@
.\"
.TH "xrdp.ini" "5" "0.1.0" "xrdp team" "" .TH "xrdp.ini" "5" "0.1.0" "xrdp team" ""
.SH "NAME" .SH "NAME"
.LP
\fBxrdp.ini\fR \- Configuration file for \fBxrdp\fR(8) \fBxrdp.ini\fR \- Configuration file for \fBxrdp\fR(8)
.SH "DESCRIPTION" .SH "DESCRIPTION"
.LP
This is the man page for \fBxrdp.ini\fR, \fBxrdp\fR(8) configuration file. This is the man page for \fBxrdp.ini\fR, \fBxrdp\fR(8) configuration file.
It is composed by a number of sections, each one composed by a section name, enclosed by square brackets, followed by a list of \fI<parameter>\fR=\fI<value>\fR lines. It is composed by a number of sections, each one composed by a section name, enclosed by square brackets, followed by a list of \fI<parameter>\fR=\fI<value>\fR lines.
@ -12,88 +10,68 @@ It is composed by a number of sections, each one composed by a section name, enc
.LP .LP
All options and values (except for file names and paths) are case insensitive, and are described in detail below. All options and values (except for file names and paths) are case insensitive, and are described in detail below.
.SH "GLOBALS"
.LP
.TP .SH "GLOBALS"
The options to be specified in the \fB[Globals]\fR section are the following: The options to be specified in the \fB[Globals]\fR section are the following:
.br
.TP .TP
\fBbitmap_cache\fR=\fI[0|1]\fR \fBbitmap_cache\fR=\fI[0|1]\fR
If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables bitmap caching in \fBxrdp\fR(8) If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables bitmap caching in \fBxrdp\fR(8)
.br
.TP .TP
\fBbitmap_compression\fR=\fI[0|1]\fR \fBbitmap_compression\fR=\fI[0|1]\fR
If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables bitmap compression in \fBxrdp\fR(8) If set to \fB1\fR, \fBtrue\fR or \fByes\fR this option enables bitmap compression in \fBxrdp\fR(8)
.SH "CONNECTIONS"
.LP
.TP .SH "CONNECTIONS"
A connection section is made of a section name, enclosed in square brackets, and the following entries: A connection section is made of a section name, enclosed in square brackets, and the following entries:
.br
.TP .TP
\fBname\fR=\fI<session name>\fR \fBname\fR=\fI<session name>\fR
The name displayed in \fBxrdp\fR(8) login window's combo box. The name displayed in \fBxrdp\fR(8) login window's combo box.
.br
.TP .TP
\fBlib\fR=\fI../vnc/libvnc.so\fR \fBlib\fR=\fI../vnc/libvnc.so\fR
Sets the library to be used with this connection. Sets the library to be used with this connection.
.br
.TP .TP
\fBusername\fR=\fI<username>\fR|\fIask\fR \fBusername\fR=\fI<username>\fR|\fIask\fR
Specifies the username used for authenticating in the connection. Specifies the username used for authenticating in the connection.
If set to \fIask\fR, user name should be provided in the login window. If set to \fIask\fR, user name should be provided in the login window.
.br
.TP .TP
\fBpassword\fR=\fI<password>\fR|\fIask\fR \fBpassword\fR=\fI<password>\fR|\fIask\fR
Specifies the password used for authenticating in the connection. Specifies the password used for authenticating in the connection.
If set to \fIask\fR, password should be provided in the login window. If set to \fIask\fR, password should be provided in the login window.
.br
.TP .TP
\fBip\fR=\fI127.0.0.1\fR \fBip\fR=\fI127.0.0.1\fR
Specifies the ip address of the host to connect to. Specifies the ip address of the host to connect to.
.br
.TP .TP
\fBport\fR=\fI<number>\fR|\fI\-1\fR \fBport\fR=\fI<number>\fR|\fI\-1\fR
Specifies the port number to connect to. If set to \fI\-1\fR, the default port for the specified library is used. Specifies the port number to connect to. If set to \fI\-1\fR, the default port for the specified library is used.
.SH "EXAMPLES" .SH "EXAMPLES"
.LP
This is an example \fBxrdp.ini\fR: This is an example \fBxrdp.ini\fR:
.nf
[Globals] [Globals]
.br
bitmap_cache=yes bitmap_cache=yes
.br
bitmap_compression=yes bitmap_compression=yes
[vnc1] [vnc1]
.br
name=sesman name=sesman
.br
lib=../vnc/libvnc.so lib=../vnc/libvnc.so
.br
username=ask username=ask
.br
password=ask password=ask
.br
ip=127.0.0.1 ip=127.0.0.1
.br
port=\-1 port=\-1
.fi
.SH "FILES" .SH "FILES"
.LP
${XRDP_CFG_DIR}/xrdp.ini ${XRDP_CFG_DIR}/xrdp.ini
.SH "SEE ALSO" .SH "SEE ALSO"
.LP
.BR xrdp (8), .BR xrdp (8),
.BR sesman (8), .BR sesman (8),
.BR sesrun (8), .BR sesrun (8),

Loading…
Cancel
Save