xrdp-sesrun(8)

1xrdp-sesrun(8)                                                  xrdp-sesrun(8)
2
3
4

NAME

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

SYNTAX

10       xrdp-sesrun [ options ] username
11
12

DESCRIPTION

14       xrdp-sesrun starts a session using xrdp-sesman(8).
15       This  is  a  tool  useful for testing, it simply behaves like xrdp when
16       some user logs in a new session and authenticates, thus starting a  new
17       session.
18
19       Default values for the options are set at compile-time. Run the utility
20       without a username to see what the defaults are for your installation.
21
22       The utility prompts for a password if neither -p or -F is used.
23
24

OPTIONS

26       -g <width>x<height>
27              Set session geometry.
28              Note that most configurations will resize the session on connec‐
29              tion, so this option may not do what you expect.
30
31       -b <bits-per-pixel>
32              Set  session  bits-per-pixel  (colour depth). Some session types
33              (i.e. Xorg) will ignore this setting.
34
35       -s <server>
36              Server on which sesman is running (probably 'localhost').
37              Use of this option is discouraged as it will be removed  in  the
38              future.
39
40       -t <session-type>
41              Session  type  - one of Xorg, Xvnc or X11rdp. Alternatively, for
42              testing only, use the numeric session code.
43
44       -D <directory>
45              Directory to run the new session in. Defaults to $HOME  for  the
46              specified user.
47
48       -S <shell>
49              Specify an alternate shell to run, instead of the default window
50              manager.
51
52       -p <password>
53              Password for user. USE FOR TESTING ONLY - the password  will  be
54              visible in the output of the ps command.
55
56       -F <file-descriptor>
57              Specify  a  file descriptor (normally 0) to read the password in
58              from. This is a secure way to pass the password in to the  util‐
59              ity.
60
61       -c <sesman-ini>
62              Specify  a  different sesman.ini file. This file is used to find
63              out how to connect to xrdp-sesman.
64
65

ENVIRONMENT

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

EXAMPLES

73       xrdp-sesrun -F 0 user1 <passwd.txt
74              Create  a  default session for user user1 with a password from a
75              file
76
77       xrdp-sesrun -t Xvnc -S /usr/bin/xterm user1
78              Create an extremely minimal Xvnc session for  user  user1.  This
79              could  be  useful  for debugging why the standard session is not
80              starting properly. Note you would  need  to  install  the  xterm
81              utility  first.  The  gnome-terminal utility probably won't work
82              here.
83
84

FILES

86       /usr/sbin/xrdp-sesman
87       /usr/bin/xrdp-sesrun
88       /etc/xrdp/sesman.ini
89
90

AUTHORS

92       Jay Sorg <jsorg71@users.sourceforge.net>
93       Simone Fedele <ilsimo@users.sourceforge.net>
94
95