summaryrefslogtreecommitdiffstats
path: root/x11vnc/help.c
diff options
context:
space:
mode:
Diffstat (limited to 'x11vnc/help.c')
-rw-r--r--x11vnc/help.c178
1 files changed, 130 insertions, 48 deletions
diff --git a/x11vnc/help.c b/x11vnc/help.c
index 7a89a32..55ad36a 100644
--- a/x11vnc/help.c
+++ b/x11vnc/help.c
@@ -141,6 +141,34 @@ void print_help(int mode) {
" then the x11vnc -gui is used to prompt the user to\n"
" enter the port number.\n"
"\n"
+#if X11VNC_IPV6
+"-6 IPv6 listening support. In addition to IPv4, the\n"
+" IPv6 address is listened on for incoming connections.\n"
+" The same port as IPv4 is used to listen. If you have\n"
+" trouble compiling for this mode, set -DX11VNC_IPV6=0\n"
+" in CPPFLAGS when configuring.\n"
+"\n"
+" Currently, the machine may need to have some IPv4\n"
+" support, at the least for the loopback interface, for\n"
+" everything to work correctly. However for most usage\n"
+" modes IPv4 support is not required.\n"
+"\n"
+" The -6 mode works for both normal connections and\n"
+" -ssl encrypted ones. Nearly everything is supported\n"
+" for the IPv6 case, but there are a few exceptions.\n"
+" See -stunnel for its IPv6 support.\n"
+"\n"
+"-noipv6 Do not try to use IPv6 for any listening or connecting\n"
+" sockets. This includes both the listening service\n"
+" port(s) and outgoing connections from -connect,\n"
+" -connect_or_exit, or -proxy. Use this if you are having\n"
+" problems due to IPv6.\n"
+"\n"
+"-noipv4 Do not try to use IPv4 for any listening or connecting\n"
+" sockets. This is mainly for exploring the behavior of\n"
+" x11vnc on an IPv6-only system, but may have other uses.\n"
+"\n"
+#endif
"-reopen If the X server connection is disconnected, try to\n"
" reopen the X display (up to one time.) This is of use\n"
" for display managers like GDM (KillInitClients option)\n"
@@ -597,6 +625,13 @@ void print_help(int mode) {
" See also the -proxy option below for additional ways\n"
" to plumb reverse connections.\n"
"\n"
+" IPv6: as of x11vnc 0.9.10 the -connect option should\n"
+" connect to IPv6 hosts properly. If there are problems\n"
+" you can disable IPv6 by setting -DX11VNC_IPV6=0\n"
+" in CPPFLAGS when configuring. If there problems\n"
+" connecting to IPv6 hosts consider a relay like the\n"
+" included inet6to4 script or the -proxy option.\n"
+"\n"
"-connect_or_exit str As with -connect, except if none of the reverse\n"
" connections succeed, then x11vnc shuts down immediately\n"
"\n"
@@ -662,6 +697,13 @@ void print_help(int mode) {
" E.g.: http://host1:port1,socks5://host2:port2 or three\n"
" like: first,second,third\n"
"\n"
+" IPv6: as of x11vnc 0.9.10 the -proxy option should\n"
+" connect to IPv6 hosts properly. If there are problems\n"
+" you can disable IPv6 by setting -DX11VNC_IPV6=0\n"
+" in CPPFLAGS when configuring. If there problems\n"
+" connecting to IPv6 hosts consider a relay like the\n"
+" included inet6to4 script.\n"
+"\n"
"-vncconnect Monitor the VNC_CONNECT X property set by the standard\n"
"-novncconnect VNC program vncconnect(1). When the property is\n"
" set to \"host\" or \"host:port\" establish a reverse\n"
@@ -691,6 +733,9 @@ void print_help(int mode) {
"\n"
" -allow applies in -ssl mode, but not in -stunnel mode.\n"
"\n"
+" IPv6: as of x11vnc 0.9.10 a host can be specified\n"
+" in IPv6 numerical format, e.g. 2001:4860:b009::93.\n"
+"\n"
"-localhost Basically the same as \"-allow 127.0.0.1\".\n"
"\n"
" Note: if you want to restrict which network interface\n"
@@ -710,6 +755,16 @@ void print_help(int mode) {
" or plan to use remote control: -R connect:host), use\n"
" -rfbport 0\n"
"\n"
+" IPv6: if IPv6 is supported, this option automatically\n"
+" implies the IPv6 loopback address '::1' as well.\n"
+"\n"
+#if X11VNC_IPV6
+"-listen6 str When in IPv6 listen mode \"-6\", only listen on the\n"
+" network interface with address \"str\". It currently\n"
+" does not work for link scope addresses or non-numeric\n"
+" hostname strings.\n"
+"\n"
+#endif
"-nolookup Do not use gethostbyname() or gethostbyaddr() to look up\n"
" host names or IP numbers. Use this if name resolution\n"
" is incorrectly set up and leads to long pauses as name\n"
@@ -1266,7 +1321,7 @@ void print_help(int mode) {
"\n"
" This mode only allows one redirected connection.\n"
" The -forever option does not apply. Use -inetd or\n"
-" -loop for persistant service.\n"
+" -loop for persistent service.\n"
"\n"
"-display WAIT:... A special usage mode for the normal -display option.\n"
" Useful with -unixpw, but can be used independently\n"
@@ -1357,6 +1412,10 @@ void print_help(int mode) {
" if the viewer-side supplied value is not completely\n"
" composed of alphanumeric or '_' or '-' characters.\n"
"\n"
+" To troubleshoot the FINDCREATEDISPLAY mechanism,\n"
+" set the following env. var. to an ouput log file,\n"
+" e.g -env CREATE_DISPLAY_OUTPUT=/tmp/mydebug.txt\n"
+"\n"
" To disable the option setting set the environment\n"
" variable X11VNC_NO_UNIXPW_OPTS=1 before starting x11vnc.\n"
" To set any other options, the user can use the gui\n"
@@ -2236,15 +2295,25 @@ void print_help(int mode) {
"\n"
" Set -env STUNNEL_DEBUG=1 for more debugging printout.\n"
"\n"
+" Set -env STUNNEL_PROG=xxx to the full path of stunnel\n"
+" program you want to be used (e.g. /usr/bin/stunnel4).\n"
+"\n"
+" Set -env STUNNEL_LISTEN=xxx to the address of the\n"
+" network interface to listen on (the default is to listen\n"
+" on all interfaces), e.g. STUNNEL_LISTEN=192.168.1.100.\n"
+"\n"
+" A simple way to add IPv6 support is STUNNEL_LISTEN=::\n"
+"\n"
" Your VNC viewer will also need to be able to connect\n"
" via SSL. Unfortunately not too many do this. See the\n"
" information about SSL viewers under the -ssl option.\n"
+" The x11vnc project's SSVNC is an option.\n"
"\n"
" Also, in the x11vnc distribution, patched TightVNC\n"
" and UltraVNC Java applet jar files are provided in\n"
" the classes/ssl directory that do SSL connections.\n"
-" Enable serving them with the -http, -http_ssl, -https,\n"
-" or -httpdir (see the option descriptions for more info.)\n"
+" Enable serving them with the -http, -http_ssl, or\n"
+" -httpdir (see the option descriptions for more info.)\n"
"\n"
" Note that for the Java viewer applet usage the\n"
" \"?PORT=xxxx\" in the various URLs printed at startup\n"
@@ -3815,6 +3884,9 @@ void print_help(int mode) {
"-allinput Have x11vnc read and process all available client input\n"
" before proceeding.\n"
"\n"
+"-input_eagerly Similar to -allinput but use the handleEventsEagerly\n"
+" mechanism built into LibVNCServer.\n"
+"\n"
"-speeds rd,bw,lat x11vnc tries to estimate some speed parameters that\n"
" are used to optimize scheduling (e.g. -pointer_mode\n"
" 4, -wireframe, -scrollcopyrect) and other things.\n"
@@ -4842,6 +4914,13 @@ void print_help(int mode) {
" localhost enable -localhost mode\n"
" nolocalhost disable -localhost mode\n"
" listen:str set -listen to str, empty to disable.\n"
+" noipv6 enable -noipv6 mode.\n"
+" ipv6 disable -noipv6 mode.\n"
+" noipv4 enable -noipv4 mode.\n"
+" ipv4 disable -noipv4 mode.\n"
+" 6 enable -6 IPv6 listening mode.\n"
+" no6 disable -6 IPv6 listening mode.\n"
+" lookup disable -nolookup mode.\n"
" nolookup enable -nolookup mode.\n"
" lookup disable -nolookup mode.\n"
" input:str set -input to \"str\", empty to disable.\n"
@@ -5005,6 +5084,8 @@ void print_help(int mode) {
" input_skip:n set -input_skip to n.\n"
" allinput enable use of -allinput mode.\n"
" noallinput disable use of -allinput mode.\n"
+" input_eagerly enable use of -input_eagerly mode.\n"
+" noinput_eagerly disable use of -input_eagerly mode.\n"
" ssltimeout:n set -ssltimeout to n.\n"
" speeds:str set -speeds to str.\n"
" wmdt:str set -wmdt to str.\n"
@@ -5263,52 +5344,54 @@ void print_help(int mode) {
" 8to24_opts 24to32 no24to32 visual scale scale_cursor\n"
" viewonly noviewonly shared noshared forever noforever\n"
" once timeout tightfilexfer notightfilexfer ultrafilexfer\n"
-" noultrafilexfer rfbversion deny lock nodeny unlock\n"
-" avahi mdns zeroconf noavahi nomdns nozeroconf connect\n"
-" proxy allowonce allow localhost nolocalhost listen\n"
-" lookup nolookup accept afteraccept gone shm noshm\n"
-" flipbyteorder noflipbyteorder onetile noonetile\n"
-" solid_color solid nosolid blackout xinerama noxinerama\n"
-" xtrap noxtrap xrandr noxrandr xrandr_mode rotate padgeom\n"
-" quiet q noquiet modtweak nomodtweak xkb noxkb capslock\n"
-" nocapslock skip_lockkeys noskip_lockkeys skip_keycodes\n"
-" sloppy_keys nosloppy_keys skip_dups noskip_dups\n"
-" add_keysyms noadd_keysyms clear_mods noclear_mods\n"
-" clear_keys noclear_keys clear_all clear_locks keystate\n"
-" remap repeat norepeat fb nofb bell nobell sendbell\n"
-" sel nosel primary noprimary setprimary nosetprimary\n"
-" clipboard noclipboard setclipboard nosetclipboard\n"
-" seldir cursorshape nocursorshape cursorpos nocursorpos\n"
-" cursor_drag nocursor_drag cursor show_cursor\n"
-" noshow_cursor nocursor arrow xfixes noxfixes xdamage\n"
-" noxdamage xd_area xd_mem alphacut alphafrac alpharemove\n"
-" noalpharemove alphablend noalphablend xwarppointer\n"
-" xwarp noxwarppointer noxwarp buttonmap dragging\n"
-" nodragging ncache_cr noncache_cr ncache_no_moveraise\n"
-" noncache_no_moveraise ncache_no_dtchange\n"
-" noncache_no_dtchange ncache_no_rootpixmap\n"
-" noncache_no_rootpixmap ncache_reset_rootpixmap ncrp\n"
-" ncache_keep_anims noncache_keep_anims ncache_old_wm\n"
-" noncache_old_wm ncache_pad ncache noncache ncache_size\n"
-" debug_ncache nodebug_ncache wireframe_mode wireframe wf\n"
-" nowireframe nowf wireframelocal wfl nowireframelocal\n"
-" nowfl wirecopyrect wcr nowirecopyrect nowcr scr_area\n"
+" noultrafilexfer rfbversion deny lock nodeny unlock avahi\n"
+" mdns zeroconf noavahi nomdns nozeroconf connect proxy\n"
+" allowonce allow noipv6 ipv6 noipv4 ipv4 no6 6 localhost\n"
+" nolocalhost listen lookup nolookup accept afteraccept\n"
+" gone shm noshm flipbyteorder noflipbyteorder onetile\n"
+" noonetile solid_color solid nosolid blackout xinerama\n"
+" noxinerama xtrap noxtrap xrandr noxrandr xrandr_mode\n"
+" rotate padgeom quiet q noquiet modtweak nomodtweak xkb\n"
+" noxkb capslock nocapslock skip_lockkeys noskip_lockkeys\n"
+" skip_keycodes sloppy_keys nosloppy_keys skip_dups\n"
+" noskip_dups add_keysyms noadd_keysyms clear_mods\n"
+" noclear_mods clear_keys noclear_keys clear_all\n"
+" clear_locks keystate remap repeat norepeat fb nofb bell\n"
+" nobell sendbell sel nosel primary noprimary setprimary\n"
+" nosetprimary clipboard noclipboard setclipboard\n"
+" nosetclipboard seldir cursorshape nocursorshape\n"
+" cursorpos nocursorpos cursor_drag nocursor_drag cursor\n"
+" show_cursor noshow_cursor nocursor arrow xfixes\n"
+" noxfixes xdamage noxdamage xd_area xd_mem alphacut\n"
+" alphafrac alpharemove noalpharemove alphablend\n"
+" noalphablend xwarppointer xwarp noxwarppointer\n"
+" noxwarp buttonmap dragging nodragging ncache_cr\n"
+" noncache_cr ncache_no_moveraise noncache_no_moveraise\n"
+" ncache_no_dtchange noncache_no_dtchange\n"
+" ncache_no_rootpixmap noncache_no_rootpixmap\n"
+" ncache_reset_rootpixmap ncrp ncache_keep_anims\n"
+" noncache_keep_anims ncache_old_wm noncache_old_wm\n"
+" ncache_pad ncache noncache ncache_size debug_ncache\n"
+" nodebug_ncache wireframe_mode wireframe wf nowireframe\n"
+" nowf wireframelocal wfl nowireframelocal nowfl\n"
+" wirecopyrect wcr nowirecopyrect nowcr scr_area\n"
" scr_skip scr_inc scr_keys scr_term scr_keyrepeat\n"
" scr_parms scrollcopyrect scr noscrollcopyrect\n"
" noscr fixscreen noxrecord xrecord reset_record\n"
-" pointer_mode pm input_skip allinput noallinput input\n"
-" grabkbd nograbkbd grabptr nograbptr grabalways\n"
-" nograbalways grablocal client_input ssltimeout\n"
-" speeds wmdt debug_pointer dp nodebug_pointer nodp\n"
-" debug_keyboard dk nodebug_keyboard nodk keycode keysym\n"
-" ptr fakebuttonevent sleep get_xprop set_xprop wininfo\n"
-" bcx_xattach deferupdate defer setdefer extra_fbur\n"
-" wait_ui wait_bog nowait_bog slow_fb xrefresh wait\n"
-" readtimeout nap nonap sb screen_blank fbpm nofbpm dpms\n"
-" nodpms clientdpms noclientdpms forcedpms noforcedpms\n"
-" noserverdpms serverdpms noultraext ultraext chatwindow\n"
-" nochatwindow chaton chatoff fs gaps grow fuzz snapfb\n"
-" nosnapfb rawfb uinput_accel uinput_thresh uinput_reset\n"
+" pointer_mode pm input_skip allinput noallinput\n"
+" input_eagerly noinput_eagerly input grabkbd nograbkbd\n"
+" grabptr nograbptr grabalways nograbalways grablocal\n"
+" client_input ssltimeout speeds wmdt debug_pointer dp\n"
+" nodebug_pointer nodp debug_keyboard dk nodebug_keyboard\n"
+" nodk keycode keysym ptr fakebuttonevent sleep get_xprop\n"
+" set_xprop wininfo bcx_xattach deferupdate defer\n"
+" setdefer extra_fbur wait_ui wait_bog nowait_bog\n"
+" slow_fb xrefresh wait readtimeout nap nonap sb\n"
+" screen_blank fbpm nofbpm dpms nodpms clientdpms\n"
+" noclientdpms forcedpms noforcedpms noserverdpms\n"
+" serverdpms noultraext ultraext chatwindow nochatwindow\n"
+" chaton chatoff fs gaps grow fuzz snapfb nosnapfb\n"
+" rawfb uinput_accel uinput_thresh uinput_reset\n"
" uinput_always progressive rfbport http nohttp httpport\n"
" httpdir enablehttpproxy noenablehttpproxy alwaysshared\n"
" noalwaysshared nevershared noalwaysshared dontdisconnect\n"
@@ -5340,7 +5423,6 @@ void print_help(int mode) {
" pointer_x pointer_y pointer_same pointer_root bpp depth\n"
" indexed_color dpy_x dpy_y wdpy_x wdpy_y off_x off_y\n"
" cdpy_x cdpy_y coff_x coff_y rfbauth passwd viewpasswd\n"
-"\n"
"-QD variable Just like -query variable, but returns the default\n"
" value for that parameter (no running x11vnc server\n"
" is consulted)\n"
@@ -6087,7 +6169,7 @@ void print_license(void) {
"\n"
"x11vnc: a VNC server for X displays. %s\n"
"\n"
-"Copyright (C) 2002-2009 Karl J. Runge <runge@karlrunge.com>\n"
+"Copyright (C) 2002-2010 Karl J. Runge <runge@karlrunge.com>\n"
"All rights reserved.\n"
"\n"
;