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/⟩