diff options
Diffstat (limited to 'x11vnc/x11vnc.1')
| -rw-r--r-- | x11vnc/x11vnc.1 | 37 |
1 files changed, 23 insertions, 14 deletions
diff --git a/x11vnc/x11vnc.1 b/x11vnc/x11vnc.1 index 5e08c55..48dc09b 100644 --- a/x11vnc/x11vnc.1 +++ b/x11vnc/x11vnc.1 @@ -2,7 +2,7 @@ .TH X11VNC "1" "March 2009" "x11vnc " "User Commands" .SH NAME x11vnc - allow VNC connections to real X11 displays - version: 0.9.7, lastmod: 2009-03-08 + version: 0.9.7, lastmod: 2009-03-13 .SH SYNOPSIS .B x11vnc [OPTION]... @@ -1207,11 +1207,12 @@ this string and the program will also be run. Any remaining output is taken as XAUTHORITY data. It can be either of the form XAUTHORITY=<file> or raw -xauthority data for the display (e.g. "xauth extract - -$DISPLAY" output). +xauthority data for the display. For example; +.IP +xauth extract - $DISPLAY" .IP In the case of \fB-unixpw\fR (but not \fB-unixpw_nis),\fR then the -above command is run as the user who just authenticated +cmd= command is run as the user who just authenticated via the login and password prompt. .IP Also in the case of \fB-unixpw,\fR the user logging in can @@ -1219,7 +1220,7 @@ place a colon at the end of her username and supply a few options: scale=, scale_cursor= (or sc=), solid (or so), id=, clear_mods (or cm), clear_keys (or ck), repeat, speeds= (or sp=), readtimeout= (or rd=), -rotate= (or ro=), or noncache (or nc) separated by +rotate= (or ro=), or noncache (or nc), all separated by commas if there is more than one. After the user logs in successfully, these options will be applied to the VNC screen. For example, @@ -1270,11 +1271,14 @@ the user as well. Note: there will be a 2nd SSL helper process that will not switch, but it is only encoding and decoding the encrypted stream at that point. .IP +Automatic Finding of User X Sessions: +.IP As a special case, WAIT:cmd=FINDDISPLAY will run a script that works on most Unixes to determine a user's DISPLAY variable and xauthority data (see .IR who (1) ). +.IP The option "\fB-find\fR" is an alias for this mode. .IP To have this default script printed to stdout (e.g. for @@ -1312,6 +1316,8 @@ Ranges n-m e.g. 0-20 can also be supplied. This string can also be set by the connecting user via "nd=" using "+" instead of "," .IP +Automatic Creation of User X Sessions: +.IP An interesting option is WAIT:cmd=FINDCREATEDISPLAY that is like FINDDISPLAY in that is uses the same method to find an existing display. However, if it does not @@ -1363,12 +1369,14 @@ on the machine. E.g. a desktop service: .IP Where /.../x11vnc is the full path to x11vnc. .IP +See the \fB-svc/-service\fR option alias above. +.IP If for some reason you do not want x11vnc to ever try to find an existing display set the env. var X11VNC_FINDDISPLAY_ALWAYS_FAILS=1 (also \fB-env\fR ...) .IP Use WAIT:cmd=FINDCREATEDISPLAY-print to print out the -script used. +script that is used for this. .IP You can specify the preferred X server order via e.g., WAIT:cmd=FINDCREATEDISPLAY-Xdummy,Xvfb,X and/or leave @@ -1390,20 +1398,21 @@ this be a wrapper script if you like (it must handle :N, \fB-geometry,\fR and \fB-depth\fR and other X server options). .IP You can set the environment variable FD_GEOM (or -X11VNC_CREATE_GEOM) to WxH or WxHxD to set the width and -height and optionally the color depth of the created -display. You can also set FD_SESS to be the session -(short name of the windowmanager: kde, gnome, twm, -failsafe, etc.). FD_OPTS as extra options to pass to -the X server. You can also set FD_PROG to be the full -path to the session/windowmanager program. +X11VNC_CREATE_GEOM) to WxH or WxHxD to set the width +and height and optionally the color depth of the +created display. You can also set FD_SESS to be the +session (short name of the windowmanager: kde, gnome, +twm, failsafe, etc.). FD_OPTS contains extra options +to pass to the X server. You can also set FD_PROG to +be the full path to the session/windowmanager program. .IP More FD tricks: FD_CUPS=port or FD_CUPS=host:port will set the cups printing environment. Similarly for FD_ESD=port or FD_ESD=host:port for esddsp sound redirection. FD_XDUMMY_NOROOT means the Xdummy server does not need to be started as root (e.g. it will sudo -automatically) +automatically). Set FD_EXTRA to a command to be run +a few seconds after the X server starts up. .IP If you want the FINDCREATEDISPLAY session to contact an XDMCP login manager (xdm/gdm/kdm) on the same machine, |