Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xrdp-sesrun(8)							xrdp-sesrun(8)

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

SYNTAX
       xrdp-sesrun --help

       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
       with  the '--help' option to see	what the defaults are for your instal-
       lation.

       If no username is used, the current username is used, and  no  password
       needs to	be provided. In	this instance, it is important that any	neces-
       sary  authentication  tokens for	a GUI session (e.g. a Kerberos ticket)
       have already been acquired.

       If a username is	provided, a password must also be  provided.  In  this
       instance	 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 connec-
	      tion, 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.

       -t <session-type>
	      Session  type  - one of Xorg or Xvnc. 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 util-
	      ity.

       -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
	      Create a default session for the current user.

       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/local/sbin/xrdp-sesman
       /usr/local/bin/xrdp-sesrun
       /usr/local/etc/xrdp-devel/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.10.80.b20241229-4e378c9		xrdp-sesrun(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xrdp-sesrun&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help