c61fc2a0fa
a SAM file is required for the shadow server to work if NLA is activated. Better document that and abort startup if no file is available.
94 lines
2.7 KiB
Groff
94 lines
2.7 KiB
Groff
.de URL
|
|
\\$2 \(laURL: \\$1 \(ra\\$3
|
|
..
|
|
.if \n[.g] .mso www.tmac
|
|
.TH @MANPAGE_NAME@ 1 2017-01-12 "@FREERDP_VERSION_FULL@" "FreeRDP"
|
|
.SH NAME
|
|
@MANPAGE_NAME@ \- A utility for sharing a X display via RDP.
|
|
.SH SYNOPSIS
|
|
.B @MANPAGE_NAME@
|
|
[\fB/port:\fP\fI<port number>\fP]
|
|
[\fB/ipc-socket:\fP\fI<ipc-socket>\fP]
|
|
[\fB/monitors:\fP\fI<0,1,2,...>\fP]
|
|
[\fB/rect:\fP\fI<x,y,w,h>\fP]
|
|
[\fB+auth\fP]
|
|
[\fB-may-view\fP]
|
|
[\fB-may-interact\fP]
|
|
[\fB/sec:\fP\fI<rdp|tls|nla|ext>\fP]
|
|
[\fB-sec-rdp\fP]
|
|
[\fB-sec-tls\fP]
|
|
[\fB-sec-nla\fP]
|
|
[\fB-sec-ext\fP]
|
|
[\fB/sam-file:\fP\fI<file>\fP]
|
|
[\fB/version\fP]
|
|
[\fB/help\fP]
|
|
.SH DESCRIPTION
|
|
.B @MANPAGE_NAME@
|
|
can be used to share a running X display like with VNC but by using the RDP
|
|
instead. It is also possibly to share only parts (rect) of the display.
|
|
.SH OPTIONS
|
|
.IP /ipc-socket:<ipc-socket>
|
|
If this option is set an ipc socket with the path \fIipc-socket\fP is used
|
|
instead of a TCP socket.
|
|
.IP /port:<port>
|
|
Set the port to use. Default is 3389.
|
|
This option is ignored if ipc-socket is used.
|
|
.IP /monitors:<1,2,3,...>
|
|
Select the monitor(s) to share.
|
|
.IP /rect:<x,y,w,h>
|
|
Select rectangle within monitor to share.
|
|
.IP -auth
|
|
Disable authentication. If authentication is enabled PAM is used with the
|
|
X11 subsystem. Running as root is not necessary, however if run as user only
|
|
the same user that started @MANPAGE_NAME@ can authenticate.
|
|
.br
|
|
\fBWarning\fP: If authentication is disabled \fIeveryone\fP can connect.
|
|
.IP -may-view
|
|
Clients may view without prompt.
|
|
.IP -may-interact
|
|
Clients may interact without prompt.
|
|
.IP /sec:<rdp|tls|nla|ext>
|
|
Force a specific protocol security
|
|
.IP -sec-rdp
|
|
Disable RDP security (default:on)
|
|
.IP -sec-tls
|
|
Disable TLS protocol security (default:on)
|
|
.IP -sec-nla
|
|
Disable NLA protocol security (default:on)
|
|
.IP +sec-ext
|
|
Use NLA extended protocol security (default:off)
|
|
.IP /sam-file:<file>
|
|
NTLM SAM file for NLA authentication
|
|
.IP /version
|
|
Print the version and exit.
|
|
.IP /help
|
|
Print the help and exit.
|
|
|
|
.SH USAGE
|
|
|
|
#MANPAGE_NAME@ - start the shadow server on port 3389 with NLA security, SAM database at /etc/winpr/SAM
|
|
.br
|
|
@MANPAGE_NAME@ /sam-file:SAM.db - same as above, but a custom SAM database provided as argument
|
|
.br
|
|
@MANPAGE_NAME@ -sec-nla - start the shadow server on port 3380 with TLS/NLA security. This allows authenticating against PAM with unix users. Be aware that the password is transmitted plain text like with basic HTTP auth
|
|
|
|
.SH EXAMPLES
|
|
@MANPAGE_NAME@ /port:12345
|
|
|
|
When run as user within a X session (for example from an xterm) a socket on
|
|
12345 is opened and the current display is shared via RDP.
|
|
|
|
.SH EXIT STATUS
|
|
.TP
|
|
.B 0
|
|
Successful program execution.
|
|
.TP
|
|
.B 1
|
|
Otherwise.
|
|
|
|
.SH SEE ALSO
|
|
wlog(7)
|
|
|
|
.SH AUTHOR
|
|
FreeRDP <team@freerdp.com>
|