NAME

       xrdp-sesrun - xrdp-sesman(8) session launcher

SYNTAX

       xrdp-sesrun [ options ] username

DESCRIPTION

       xrdp-sesrun starts a session using xrdp-sesman(8).
       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.

       Default values for the options are set at compile-time. Run the utility without a username  to  see  what
       the defaults are for your installation.

       The utility prompts for a password if neither -p or -F is used.

OPTIONS

       -g <width>x<height>
              Set session geometry.
              Note  that  most  configurations  will resize the session on connection, so this option may not do
              what you expect.

       -b <bits-per-pixel>
              Set session bits-per-pixel (colour depth).  Some  session  types  (i.e.  Xorg)  will  ignore  this
              setting.

       -s <server>
              Server on which sesman is running (probably 'localhost').
              Use of this option is discouraged as it will be removed in the future.

       -t <session-type>
              Session  type  -  one  of  Xorg,  Xvnc or X11rdp. Alternatively, for testing only, use the numeric
              session code.

       -D <directory>
              Directory to run the new session in. Defaults to $HOME for the specified user.

       -S <shell>
              Specify an alternate shell to run, instead of the default window manager.

       -p <password>
              Password for user. USE FOR TESTING ONLY - the password will be visible in the  output  of  the  ps
              command.

       -F <file-descriptor>
              Specify  a file descriptor (normally 0) to read the password in from. This is a secure way to pass
              the password in to the utility.

       -c <sesman-ini>
              Specify a different sesman.ini file. This file is used to find out how to connect to xrdp-sesman.

ENVIRONMENT

       SESRUN_LOG_LEVEL
              Override the default logging level. One of "error", "warn", "info", "debug", "trace" or  a  number
              1-5.

EXAMPLES

       xrdp-sesrun -F 0 user1 <passwd.txt
              Create a default session for user user1 with a password from a file

       xrdp-sesrun -t Xvnc -S /usr/bin/xterm user1
              Create  an  extremely  minimal Xvnc session for user user1. This could be useful for debugging why
              the standard session is not starting properly. Note you would need to install  the  xterm  utility
              first. The gnome-terminal utility probably won't work here.

FILES

       /usr/sbin/xrdp-sesman
       /usr/bin/xrdp-sesrun
       /etc/xrdp/sesman.ini

AUTHORS

       Jay Sorg <jsorg71@users.sourceforge.net>
       Simone Fedele <ilsimo@users.sourceforge.net>

SEE ALSO

       xrdp-sesman(8), sesman.ini(5), xrdp(8), xrdp.ini(5)

       For more info on xrdp see http://www.xrdp.org/

xrdp team                                            0.9.24                                       xrdp-sesrun(8)