308 lines
9.4 KiB
Groff
308 lines
9.4 KiB
Groff
.\"
|
|
.TH "sesman.ini" "5" "@PACKAGE_VERSION@" "xrdp team" ""
|
|
.SH "NAME"
|
|
\fBsesman.ini\fR \- Configuration file for \fBxrdp-sesman\fR(8)
|
|
|
|
.SH "DESCRIPTION"
|
|
\fBsesman.ini\fR consists of several sections. Each section starts with
|
|
the section name in square brackets, followed by a list of
|
|
\fIparameter\fR=\fIvalue\fR lines. Following sections are recognized:
|
|
|
|
.TP
|
|
\fB[Globals]\fR
|
|
Global configuration
|
|
|
|
.TP
|
|
\fB[Logging]\fR
|
|
Logging subsystem
|
|
|
|
.TP
|
|
\fB[Sessions]\fR
|
|
Session management
|
|
|
|
.TP
|
|
\fB[Security]\fR
|
|
Access control
|
|
|
|
.TP
|
|
\fB[X11rdp]\fR, \fB[Xvnc]\fR, \fB[Xorg]\fR
|
|
X11 server settings for supported servers
|
|
|
|
.TP
|
|
\fB[Chansrv]\fR
|
|
Settings for xrdp-chansrv(8)
|
|
|
|
.TP
|
|
\fB[Chansrv_Logging]\fR
|
|
Logging settings for xrdp-chansrv(8)
|
|
|
|
.TP
|
|
\fB[SessionVariables]\fR
|
|
Environment variables for the session
|
|
|
|
.LP
|
|
All parameters and values (except for file names and paths) are case
|
|
insensitive, and are described in detail below. If any parameter is
|
|
specified more than once, the last entry will be used. Options specified
|
|
outside their proper section will be \fIignored\fR.
|
|
|
|
.SH "GLOBALS"
|
|
Following parameters can be used in the \fB[Globals]\fR section.
|
|
|
|
.TP
|
|
\fBListenAddress\fR=\fIip address\fR
|
|
xrdp-sesman listening address. If not specified, defaults to \fI0.0.0.0\fR
|
|
(all interfaces).
|
|
|
|
.TP
|
|
\fBListenPort\fR=\fIport number\fR
|
|
xrdp-sesman listening port. If not specified, defaults to \fI3350\fR.
|
|
|
|
.TP
|
|
\fBEnableUserWindowManager\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, this option enables user
|
|
specific startup script. That is, xrdp-sesman will execute the script
|
|
specified by \fBUserWindowManager\fR if it exists.
|
|
|
|
.TP
|
|
\fBUserWindowManager\fR=\fIfilename\fR
|
|
Path of the startup script relative to the user's home directory. If
|
|
present and enabled by \fBEnableUserWindowManager\fR, that script is
|
|
executed instead of \fBDefaultWindowManager\fR.
|
|
|
|
.TP
|
|
\fBDefaultWindowManager\fR=\fIfilename\fR
|
|
Full path or relative path of the default startup script used by xrdp-sesman
|
|
to start a session. If the path is not a full path, it will be resolved as
|
|
relative path to \fI@xrdpconfdir@\fR. If not specified, defaults to
|
|
\fI@xrdpconfdir@/startwm.sh\fR.
|
|
|
|
.TP
|
|
\fBReconnectScript\fR=\fIfilename\fR
|
|
Full path or relative path if the script which executed when users reconnects
|
|
to the existing session. If the path is not a full path, it will be resolved as
|
|
relative path to \fI@xrdpconfdir@\fR. If not specified, defaults to
|
|
\fI@xrdpconfdir@/reconnectwm.sh\fR.
|
|
|
|
.SH "LOGGING"
|
|
Following parameters can be used in the \fB[Logging]\fR and \fB[ChansrvLogging]\fR
|
|
sections.
|
|
|
|
.TP
|
|
\fBLogFile\fR=\fIfilename\fR
|
|
Log file path. It can be either absolute or relative. If not specified,
|
|
defaults to \fI./sesman.log\fR It is ignored in the [ChansrvLogging] section
|
|
since the channel server creates one log file per display and instead uses the
|
|
following log file naming convention \fIxrdp-chansrv.${DISPLAY}.log\fR
|
|
|
|
.TP
|
|
\fBLogLevel\fR=\fIlevel\fR
|
|
This option can have one of the following values:
|
|
|
|
\fBCORE\fR or \fB0\fR \- Log only core messages. Those messages are
|
|
logged \fIregardless\fR of the selected logging level.
|
|
|
|
\fBERROR\fR or \fB1\fR \- Log only error messages.
|
|
|
|
\fBWARNING\fR, \fBWARN\fR or \fB2\fR \- Logs warnings and error messages.
|
|
|
|
\fBINFO\fR or \fB3\fR \- Log errors, warnings and informational messages.
|
|
|
|
\fBDEBUG\fR or \fB4\fR \- Log everything. If xrdp-sesman is compiled in
|
|
debug mode, this options will output many more low\-level messages.
|
|
|
|
.TP
|
|
\fBEnableSyslog\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, this option enables logging to
|
|
syslog.
|
|
|
|
.TP
|
|
\fBSyslogLevel\fR=\fIlevel\fR
|
|
Logging level for syslog. It can have the same values as \fBLogLevel\fR.
|
|
Defaults to \fBDEBUG\fR.
|
|
|
|
.TP
|
|
\fBEnableConsole\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, this option enables logging to
|
|
the console (ie. stdout).
|
|
|
|
.TP
|
|
\fBConsoleLevel\fR=\fIlevel\fR
|
|
Logging level for the console. It can have the same values as \fBLogLevel\fR.
|
|
Defaults to \fBDEBUG\fR.
|
|
|
|
.TP
|
|
\fBEnableProcessId\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, this option enables logging the
|
|
process id in all log messages. Defaults to \fBfalse\fR.
|
|
|
|
.SH "SESSIONS"
|
|
Following parameters can be used in the \fB[Sessions]\fR section.
|
|
|
|
.TP
|
|
\fBX11DisplayOffset\fR=\fInumber\fR
|
|
The first X display number available for xrdp-sesman. This prevents
|
|
xrdp-sesman from interfering with real X11 servers. If not specified,
|
|
defaults to \fI10\fR.
|
|
|
|
.TP
|
|
\fBMaxSessions\fR=\fInumber\fR
|
|
Sets the maximum number of simultaneous sessions. If not set or set to
|
|
\fI0\fR, unlimited session are allowed.
|
|
|
|
.TP
|
|
\fBKillDisconnected\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, every session will be killed
|
|
within \fBDisconnectedTimeLimit\fR seconds after the user disconnects.
|
|
This setting currently only works with xorgxrdp sessions.
|
|
|
|
.TP
|
|
\fBDisconnectedTimeLimit\fR=\fInumber\fR
|
|
Sets the time limit for \fBKillDisconnected\fR to a value greater than 60.
|
|
Values less than 60 are to be overridden with 60.
|
|
This setting currently only works with xorgxrdp sessions.
|
|
|
|
.TP
|
|
\fBIdleTimeLimit\fR=\fInumber\fR
|
|
Sets the time limit (in seconds) before an idle session is disconnected.
|
|
Idle means no keyboard inputs and no mouse moves/clicks here.
|
|
If set to \fI0\fR, idle sessions will never be disconnected by timeout.
|
|
This works only with xorgxrdp sessions. Moreover, xorgxrdp must be v0.2.9 or later.
|
|
|
|
.TP
|
|
\fBPolicy\fR=\fI[Default|UBD|UBI|UBC|UBDI|UBDC]\fR
|
|
Session allocation policy. Used to decide when to allocate a
|
|
new session. Set to one of the following values:
|
|
.br
|
|
|
|
.br
|
|
\fBDefault\fR - session per <User,BitPerPixel>
|
|
.br
|
|
\fBUBD\fR - session per <User,BitPerPixel,DisplaySize>
|
|
.br
|
|
\fBUBI\fR - session per <User,BitPerPixel,IPAddr>
|
|
.br
|
|
\fBUBC\fR - session per <User,BitPerPixel,Connection>
|
|
.br
|
|
\fBUBDI\fR - session per <User,BitPerPixel,DisplaySize,IPAddr>
|
|
.br
|
|
\fBUBDC\fR - session per <User,BitPerPixel,DisplaySize,Connection>
|
|
.br
|
|
|
|
.br
|
|
Note that the \fBUser\fR and \fBBitPerPixel\fR criteria cannot be turned
|
|
off. \fBDisplaySize\fR refers to the initial geometry of a connection,
|
|
as actual display sizes can change dynamically.
|
|
.br
|
|
|
|
.SH "SECURITY"
|
|
Following parameters can be used in the \fB[Security]\fR section.
|
|
|
|
.TP
|
|
\fBAllowRootLogin\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, enables root login on the
|
|
terminal server.
|
|
|
|
.TP
|
|
\fBMaxLoginRetry\fR=\fInumber\fR
|
|
The number of login attempts that are allowed on terminal server. If set
|
|
to \fI0\fR, unlimited attempts are allowed. If not specified, defaults to
|
|
\fI3\fR.
|
|
|
|
.TP
|
|
\fBTerminalServerUsers\fR=\fIgroup\fR
|
|
Only the users belonging to the specified group are allowed to login on
|
|
terminal server. If unset or set to an invalid or non\-existent group,
|
|
login for all users is enabled.
|
|
|
|
.TP
|
|
\fBTerminalServerAdmins\fR=\fIgroup\fR
|
|
\fIThis option is currently ignored!\fR Only members of this group can
|
|
have session management rights.
|
|
|
|
.TP
|
|
\fBRestrictOutboundClipboard\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, will restrict the clipboard
|
|
outbound from the server, to prevent data copied inside the xrdp session
|
|
to be be pasted in the client host. Default value is \fBfalse\fR.
|
|
|
|
.TP
|
|
\fBAlwaysGroupCheck\fR=\fI[true|false]\fR
|
|
If set to \fB1\fR, \fBtrue\fR or \fByes\fR, require group membership even
|
|
if the group specified in \fBTerminalServerUsers\fR doesn't exist.
|
|
|
|
.SH "X11 SERVER"
|
|
Following parameters can be used in the \fB[X11rdp]\fR, \fB[Xvnc]\fR and
|
|
\fB[Xorg]\fR sections.
|
|
|
|
.TP
|
|
\fBparam\fR=\fIstring\fR
|
|
Multiple \fIparam\fR lines are supported. This first line specifies the
|
|
path to the X11 server executable. Following lines specify command line
|
|
arguments passed to the X11 server.
|
|
|
|
.SH "CHANSRV"
|
|
Following parameters can be used in the \fB[Chansrv]\fR section.
|
|
|
|
.TP
|
|
\fBFuseMountName\fR=\fIstring\fR
|
|
Directory for drive redirection.
|
|
Created if it doesn't exist. If not specified, defaults to \fIxrdp_client\fR.
|
|
If first character is not a '/', this is relative to $HOME.
|
|
.P
|
|
.RS
|
|
If first character is a '/' this is an absolute path. The following
|
|
substitutions are made in this string:-
|
|
%U - Username
|
|
%u - Numeric UID
|
|
%% - Percent character
|
|
.P
|
|
If this format is used:-
|
|
.HP 3
|
|
1) The directory path permissions MUST be configured correctly by
|
|
the system administrator or the system itself - xrdp-chansrv will not
|
|
do this for you (although it will create the final directories owned by
|
|
the user).
|
|
.HP 3
|
|
2) The desktop may not automatically display a link for the redirected
|
|
drive. To fix this, consult the docs for your chosen desktop.
|
|
.RE
|
|
|
|
.TP
|
|
\fBFileUmask\fR=\fImode\fR
|
|
Additional umask to apply to files in the \fBFuseMountName\fR directory.
|
|
The default value of 077 prevents other users on the system from reading
|
|
files on your redirected drives. This may not be approprate for all
|
|
environents, and so you can change this value to allow other users to
|
|
access your remote files if required.
|
|
|
|
.TP
|
|
\fBEnableFuseMount\fR=\fI[true|false]\fR
|
|
Defaults to \fItrue\fR.
|
|
Set to \fIfalse\fR to disable xrdp-chansrv's use of the FUSE system
|
|
feature, even if it has been built with this feature enabled.
|
|
.P
|
|
.RS
|
|
Setting this value to \fIfalse\fR will disable the following application
|
|
features:-
|
|
.P
|
|
- drive redirection
|
|
.P
|
|
- copying-and-pasting of files
|
|
.RE
|
|
|
|
.SH "SESSIONS VARIABLES"
|
|
All entries in the \fB[SessionVariables]\fR section are set as
|
|
environment variables in the user's session.
|
|
|
|
.SH "FILES"
|
|
@sysconfdir@/xrdp/sesman.ini
|
|
|
|
.SH "SEE ALSO"
|
|
.BR xrdp-sesman (8),
|
|
.BR xrdp-sesrun (8),
|
|
.BR xrdp (8),
|
|
.BR xrdp.ini (5)
|
|
|
|
For more info on \fBxrdp\fR see http://www.xrdp.org/
|