From 00a9a0ea4d0f642b34b4423ea867099b52edf078 Mon Sep 17 00:00:00 2001 From: runge Date: Wed, 2 Dec 2009 22:09:51 -0500 Subject: x11vnc: -appshare mode for sharing an application windows instead of the entire desktop. map port + 5500 in reverse connect. Add id_cmd remote control functions for id (and other) windows. Allow zero port in SSL reverse connections. Adjust delays between multiple reverse connections; X11VNC_REVERSE_SLEEP_MAX env var. Add some missing mutex locks; add INPUT_LOCK and threads_drop_input. More safety in -threads mode for new framebuffer change. Fix some stderr leaking in -inetd mode. --- x11vnc/ChangeLog | 10 + x11vnc/Makefile.am | 2 +- x11vnc/README | 2763 +++++++++++++++++++++++++------------------------- x11vnc/appshare.c | 2116 ++++++++++++++++++++++++++++++++++++++ x11vnc/connections.c | 170 +++- x11vnc/cursor.c | 17 +- x11vnc/help.c | 57 +- x11vnc/keyboard.c | 15 + x11vnc/options.c | 3 + x11vnc/options.h | 3 + x11vnc/pm.c | 10 + x11vnc/pointer.c | 28 +- x11vnc/remote.c | 34 +- x11vnc/screen.c | 367 +++++-- x11vnc/sslhelper.c | 23 +- x11vnc/tkx11vnc | 1 + x11vnc/tkx11vnc.h | 1 + x11vnc/unixpw.c | 2 + x11vnc/user.c | 4 + x11vnc/userinput.c | 2 + x11vnc/util.c | 25 +- x11vnc/util.h | 36 +- x11vnc/win_utils.c | 168 ++- x11vnc/win_utils.h | 3 +- x11vnc/x11vnc.1 | 56 +- x11vnc/x11vnc.c | 117 ++- x11vnc/x11vnc_defs.c | 2 +- x11vnc/xevents.c | 53 +- x11vnc/xinerama.c | 5 + x11vnc/xrandr.c | 12 +- 30 files changed, 4559 insertions(+), 1546 deletions(-) create mode 100644 x11vnc/appshare.c (limited to 'x11vnc') diff --git a/x11vnc/ChangeLog b/x11vnc/ChangeLog index 188fec3..428ce06 100644 --- a/x11vnc/ChangeLog +++ b/x11vnc/ChangeLog @@ -1,3 +1,13 @@ +2009-12-02 Karl Runge + * x11vnc: -appshare mode for sharing an application windows intead + of the entire desktop. map port + 5500 in reverse connect. + Add id_cmd remote control functions for id (and other) windows. + Allow zero port in SSL reverse connections. Adjust delays + between multiple reverse connections; X11VNC_REVERSE_SLEEP_MAX + env var. Add some missing mutex locks; add INPUT_LOCK and + threads_drop_input. More safety in -threads mode for new + framebuffer change. Fix some stderr leaking in -inetd mode. + 2009-11-18 Karl Runge * x11vnc: use -timeout setting for reverse connections too. Delay calling xfixes at the beginning of 1st connection to avoid diff --git a/x11vnc/Makefile.am b/x11vnc/Makefile.am index acf0088..c18f49d 100644 --- a/x11vnc/Makefile.am +++ b/x11vnc/Makefile.am @@ -23,7 +23,7 @@ LD_CYGIPC=-lcygipc endif bin_PROGRAMS=x11vnc -x11vnc_SOURCES = 8to24.c avahi.c cleanup.c connections.c cursor.c gui.c help.c inet.c keyboard.c linuxfb.c macosx.c macosxCG.c macosxCGP.c macosxCGS.c options.c pm.c pointer.c rates.c remote.c scan.c screen.c selection.c solid.c sslcmds.c sslhelper.c uinput.c unixpw.c user.c userinput.c util.c v4l.c win_utils.c x11vnc.c x11vnc_defs.c xdamage.c xevents.c xinerama.c xkb_bell.c xrandr.c xrecord.c xwrappers.c 8to24.h allowed_input_t.h avahi.h blackout_t.h cleanup.h connections.h cursor.h enc.h enums.h gui.h help.h inet.h keyboard.h linuxfb.h macosx.h macosxCG.h macosxCGP.h macosxCGS.h nox11.h nox11_funcs.h options.h params.h pm.h pointer.h rates.h remote.h scan.h screen.h scrollevent_t.h selection.h solid.h sslcmds.h sslhelper.h ssltools.h tkx11vnc.h uinput.h unixpw.h user.h userinput.h util.h v4l.h win_utils.h winattr_t.h x11vnc.h xdamage.h xevents.h xinerama.h xkb_bell.h xrandr.h xrecord.h xwrappers.h +x11vnc_SOURCES = 8to24.c appshare.c avahi.c cleanup.c connections.c cursor.c gui.c help.c inet.c keyboard.c linuxfb.c macosx.c macosxCG.c macosxCGP.c macosxCGS.c options.c pm.c pointer.c rates.c remote.c scan.c screen.c selection.c solid.c sslcmds.c sslhelper.c uinput.c unixpw.c user.c userinput.c util.c v4l.c win_utils.c x11vnc.c x11vnc_defs.c xdamage.c xevents.c xinerama.c xkb_bell.c xrandr.c xrecord.c xwrappers.c 8to24.h allowed_input_t.h avahi.h blackout_t.h cleanup.h connections.h cursor.h enc.h enums.h gui.h help.h inet.h keyboard.h linuxfb.h macosx.h macosxCG.h macosxCGP.h macosxCGS.h nox11.h nox11_funcs.h options.h params.h pm.h pointer.h rates.h remote.h scan.h screen.h scrollevent_t.h selection.h solid.h sslcmds.h sslhelper.h ssltools.h tkx11vnc.h uinput.h unixpw.h user.h userinput.h util.h v4l.h win_utils.h winattr_t.h x11vnc.h xdamage.h xevents.h xinerama.h xkb_bell.h xrandr.h xrecord.h xwrappers.h if HAVE_SYSTEM_LIBVNCSERVER INCLUDES_LIBVNCSERVER = @SYSTEM_LIBVNCSERVER_CFLAGS@ diff --git a/x11vnc/README b/x11vnc/README index 2863b32..50ff446 100644 --- a/x11vnc/README +++ b/x11vnc/README @@ -2,7 +2,7 @@ Copyright (C) 2002-2009 Karl J. Runge All rights reserved. -x11vnc README file Date: Wed Nov 18 11:52:45 EST 2009 +x11vnc README file Date: Wed Dec 2 22:03:06 EST 2009 The following information is taken from these URLs: @@ -945,11 +945,16 @@ make "TMP" special certificate names. The [139]-sslverify and [140]-sslCRL options now work correctly in [141]-stunnel mode. Single port HTTPS connections are also supported for this mode. - * The remote control command [142]-R can be used to instruct x11vnc + * There is an experimental Application Sharing mode that improves + upon the -id/-sid single window sharing: [142]-appshare (run + "x11vnc -appshare -help" for more info.) It is still very + primitive and approximate, but at least it displays multiple + top-level windows. + * The remote control command [143]-R can be used to instruct x11vnc to resend its most recent copy of the Clipboard, Primary, or Cutbuffer selections: "x11vnc -R resend_clipboard", "x11vnc -R resend_primary", and "x11vnc -R resend_cutbuffer". - * The fonts in the GUI ([143]-gui) can now by set via environment + * The fonts in the GUI ([144]-gui) can now by set via environment variables, e.g. -env X11VNC_FONT_BOLD='Helvetica -16 bold' and -env X11VNC_FONT_FIXED='Courier -14'. * The XDAMAGE mechanism is now automatically disabled for a period @@ -959,18 +964,18 @@ make * There is an experimental workaround: "-env X11VNC_WATCH_DX_DY=1" that tries to avoid problems with poorly constructed menu themes that place the initial position of the mouse cursor inside a menu - item's active zone. More information [144]can be found here. + item's active zone. More information [145]can be found here. Here are some features that appeared in the 0.9.8 release: - * Stability improvements to [145]-threads mode. Running x11vnc this + * Stability improvements to [146]-threads mode. Running x11vnc this way is more reliable now. Threaded operation sometimes gives better interactive response and faster updates: try it out. The threaded mode now supports multiple VNC viewers using the same VNC encoding. The threaded mode can also yield a performance enhancement in the many client case (e.g. class-room broadcast.) We have tested with 30 to 50 simultaneous clients. See also - [146]-reflect. + [147]-reflect. For simultaneous clients: the ZRLE encoding is thread safe on all platforms, and the Tight and Zlib encodings are currently only thread safe on Linux where thread local storage, __thread, is @@ -979,12 +984,12 @@ make connected client, all encodings are safe on all platforms. Note that some features (e.g. scroll detection and -ncache) may be disabled or run with reduced functionality in -threads mode. - * Automatically tries to work around an [147]Xorg server bug + * Automatically tries to work around an [148]Xorg server bug involving infinitely repeating keys when turning off key - repeating. Use [148]-repeat if the automatic workaround fails. + repeating. Use [149]-repeat if the automatic workaround fails. * Improved reliability of the Single Port SSL VNC and HTTPS java viewer applet delivery mechanism. - * The [149]-clip mode works under [150]-rawfb. + * The [150]-clip mode works under [151]-rawfb. Here are some features that appeared in the 0.9.7 release: @@ -994,38 +999,38 @@ make case the special file /dev/vcsa2 is used to retrieve vt2's current text. Text and colors are shown, but no graphics. * Support for less than 8 bits per pixel framebuffers (e.g. 4 or 1 - bpp) in the [151]-rawfb mode. + bpp) in the [152]-rawfb mode. * The SSL enabled UltraVNC Java viewer applet now has a [Home] entry in the "drives" drop down menu. This menu can be configured with the ftpDropDown applet parameter. All of the applet parameters are documented in classes/ssl/README. - * Experimental support for [152]VirtualGL's [153]TurboVNC (an + * Experimental support for [153]VirtualGL's [154]TurboVNC (an enhanced TightVNC for fast LAN high framerate usage.) * The CUPS Terminal Services helper mode has been improved. - * Improvements to the [154]-ncache_cr that allows smooth opaque + * Improvements to the [155]-ncache_cr that allows smooth opaque window motions using the 'copyrect' encoding when using - [155]-ncache mode. - * The [156]-rmflag option enables a way to indicate to other + [156]-ncache mode. + * The [157]-rmflag option enables a way to indicate to other processes x11vnc has exited. * Reverse connections using anonymous Diffie Hellman SSL encryption now work. Here are some features that appeared in the 0.9.6 release: - * Support for [157]VeNCrypt SSL/TLS encrypted connections. It is - enabled by default in the [158]-ssl mode. VNC Viewers like - vinagre, gvncviewer/gtk-vnc, the vencrypt package, [159]SSVNC, and + * Support for [158]VeNCrypt SSL/TLS encrypted connections. It is + enabled by default in the [159]-ssl mode. VNC Viewers like + vinagre, gvncviewer/gtk-vnc, the vencrypt package, [160]SSVNC, and others support this encryption mode. It can also be used with the - [160]-unixpw option to enable Unix username and password + [161]-unixpw option to enable Unix username and password authentication (VeNCrypt's "*Plain" modes.) A similar but older VNC security type "ANONTLS" (used by vino) is supported as well. - See the [161]-vencrypt and [162]-anontls options for additional + See the [162]-vencrypt and [163]-anontls options for additional control. The difference between x11vnc's normal -ssl mode and VeNCrypt is that the former wraps the entire VNC connection in SSL (like HTTPS does for HTTP, i.e. "vncs://") while VeNCrypt switches on the SSL/TLS at a certain point during the VNC handshake. Use - [163]-sslonly to disable both VeNCrypt and ANONTLS (vino.) - * The "[164]-ssl ANON" option enables Anonymous Diffie-Hellman (ADH) + [164]-sslonly to disable both VeNCrypt and ANONTLS (vino.) + * The "[165]-ssl ANON" option enables Anonymous Diffie-Hellman (ADH) key exchange for x11vnc's normal SSL/TLS operation. Note that Anonymous Diffie-Hellman uses encryption for privacy, but provides no authentication and so is susceptible to Man-In-The-Middle @@ -1033,17 +1038,17 @@ make SAVE", etc. and have the VNC viewer verify the cert.) The ANONTLS mode (vino) only supports ADH. VeNCrypt mode supports both ADH and regular X509 SSL certificates modes. For these ADH is enabled by - default. See [165]-vencrypt and [166]-anontls for how to disable + default. See [166]-vencrypt and [167]-anontls for how to disable ADH. * For x11vnc's SSL/TLS modes, one can now specify a Certificate - Revocation List (CRL) with the [167]-sslCRL option. This will only + Revocation List (CRL) with the [168]-sslCRL option. This will only be useful for wide deployments: say a company-wide x11vnc SSL access deployment using a central Certificate Authority (CA) via - [168]-sslGenCA and [169]-sslGenCert. This way if a user has his + [169]-sslGenCA and [170]-sslGenCert. This way if a user has his laptop lost or stolen, you only have to revoke his key instead of creating a new Certificate Authority and redeploying new keys to all users. - * The default SSL/TLS mode, "[170]-ssl" (no pem file parameter + * The default SSL/TLS mode, "[171]-ssl" (no pem file parameter supplied), is now the same as "-ssl SAVE" and will save the generated self-signed cert in "~/.vnc/certs/server.pem". Previously "-ssl" would create a temporary self-signed cert that @@ -1053,45 +1058,45 @@ make same x11vnc server. Use "-ssl TMP" to regain the previous behavior. Use "-ssl SAVE_NOPROMPT" to avoid being prompted about using passphrase when the certificate is created. - * The option [171]-http_oneport enables single-port HTTP connections + * The option [172]-http_oneport enables single-port HTTP connections via the Java VNC Viewer. So, for example, the web browser URL "http://myhost.org:5900" works the same as "http://myhost.org:5800", but with the convenience of only involving one port instead of two. This works for both unencrypted - connections and for SSH tunnels (see [172]-httpsredir if the + connections and for SSH tunnels (see [173]-httpsredir if the tunnel port differs.) Note that HTTPS single-port operation in - [173]-ssl SSL encrypted mode has been available since x11vnc + [174]-ssl SSL encrypted mode has been available since x11vnc version 0.8.3. - * For the [174]-avahi/[175]-zeroconf Service Advertizing mode, if + * For the [175]-avahi/[176]-zeroconf Service Advertizing mode, if x11vnc was not compiled with the avahi-client library, then an external helper program, either avahi-publish(1) (on Unix) or dns-sd(1) (on Mac OS X), is used instead. - * The "[176]-rfbport PROMPT" option will prompt the user via the GUI + * The "[177]-rfbport PROMPT" option will prompt the user via the GUI to select the VNC port (e.g. 5901) to listen on, and a few other basic settings. This enables a handy GUI mode for naive users: x11vnc -gui tray=setpass -rfbport PROMPT -logfile $HOME/.x11vnc.log.%VNCDISP LAY suitable for putting in a launcher or menu, e.g. - [177]x11vnc.desktop. The [178]-logfile expansion is new too. In + [178]x11vnc.desktop. The [179]-logfile expansion is new too. In the GUI, the tray=setpass Properties panel has been improved. - * The [179]-solid solid background color option now works for the + * The [180]-solid solid background color option now works for the Mac OS X console. - * The [180]-reopen option instructs x11vnc to try to reopen the X + * The [181]-reopen option instructs x11vnc to try to reopen the X display if it is prematurely closed by, say, the display manager - (e.g. [181]GDM.) + (e.g. [182]GDM.) Here are some features that appeared in the 0.9.5 release: - * Symmetric key [182]encryption ciphers. ARC4, AES-128, AES-256, + * Symmetric key [183]encryption ciphers. ARC4, AES-128, AES-256, blowfish, and 3des are supported. Salt and initialization vector seeding is provided. These compliment the more widely used SSL and - SSH encryption access methods. [183]SSVNC also supports these + SSH encryption access methods. [184]SSVNC also supports these encryption modes. * Scaling differently along the X- and Y-directions. E.g. - "[184]-scale 1280x1024" or "-scale 0.8x0.75" Also, - "[185]-geometry WxH" is an alias for "-scale WxH" + "[185]-scale 1280x1024" or "-scale 0.8x0.75" Also, + "[186]-geometry WxH" is an alias for "-scale WxH" * By having SSVNC version 1.0.21 or later available in your $PATH, - the [186]-chatwindow option allows a UltraVNC Text Chat window to + the [187]-chatwindow option allows a UltraVNC Text Chat window to appear on the local X11 console/display (this way the remote viewer can chat with the person at the physical display; e.g. helpdesk mode.) This also works on the Mac OS X console if the @@ -1103,46 +1108,46 @@ LAY Here are some features that appeared in the 0.9.4 release: - * Improvements to the [187]-find and [188]-create X session finding + * Improvements to the [188]-find and [189]-create X session finding or creating modes: new desktop types and service redirection options. Personal cupsd daemon and SSH port redirection helper for - use with [189]SSVNC's Terminal Services feature. - * Reverse VNC connections via [190]-connect work in the [191]-find, - [192]-create and related [193]-display WAIT:... modes. + use with [190]SSVNC's Terminal Services feature. + * Reverse VNC connections via [191]-connect work in the [192]-find, + [193]-create and related [194]-display WAIT:... modes. * Reverse VNC connections (either normal or SSL) can use a Web Proxy or a SOCKS proxy, or a SSH connection, or even a CGI URL to make - the outgoing connection. See: [194]-proxy. Forward connections can - also use: [195]-ssh. - * Reverse VNC connections via the [196]UltraVNC repeater proxy + the outgoing connection. See: [195]-proxy. Forward connections can + also use: [196]-ssh. + * Reverse VNC connections via the [197]UltraVNC repeater proxy (either normal or SSL) are supported. Use either the - "[197]-connect repeater=ID:NNNN+host:port" or "[198]-connect - repeater://host:port+ID:NNNN" notation. The [199]SSVNC VNC viewer + "[198]-connect repeater=ID:NNNN+host:port" or "[199]-connect + repeater://host:port+ID:NNNN" notation. The [200]SSVNC VNC viewer also supports the UltraVNC repeater. * Support for indexed colormaps (PseudoColor) with depths other than 8 (from 1 to 16 now work) for non-standard hardware. Option - "[200]-advertise_truecolor" to handle some workaround in this + "[201]-advertise_truecolor" to handle some workaround in this mode. * Support for the ZYWRLE encoding, this is the RealVNC ZRLE encoding extended to do motion video and photo regions more efficiently by way of a Wavelet based transformation. - * The [201]-finddpy and [202]-listdpy utilities help to debug and - configure the [203]-find, [204]-create, and [205]-display WAIT:... + * The [202]-finddpy and [203]-listdpy utilities help to debug and + configure the [204]-find, [205]-create, and [206]-display WAIT:... modes. * Some automatic detection of screen resizes are handled even if the - [206]-xrandr option is not supplied. - * The [207]-autoport options gives more control over the VNC port + [207]-xrandr option is not supplied. + * The [208]-autoport options gives more control over the VNC port x11vnc chooses. - * The [208]-ping secs can be used to help keep idle connections + * The [209]-ping secs can be used to help keep idle connections alive. * Pasting of the selection/clipboard into remote applications (e.g. Java) has been improved. * Fixed a bug if a client disconnects during the 'speed-estimation' phase. * To unset Caps_Lock, Num_Lock and raise all keys in the X server - use [209]-clear_all. + use [210]-clear_all. * Usage with dvorak keyboards has been improved. See also: - [210]-xkb. - * The [211]Java Viewer applet source code is now included in the + [211]-xkb. + * The [212]Java Viewer applet source code is now included in the x11vnc-0.9.*.tar.gz tarball. This means you can now build the Java viewer applet jar files from source. If you stopped shipping the Java viewer applet jar files due to lack of source code, you can @@ -1150,7 +1155,7 @@ LAY Here are some features that appeared in the 0.9.3 release: - * [212]Viewer-side pixmap caching. A large area of pixels (at least + * [213]Viewer-side pixmap caching. A large area of pixels (at least 2-3 times as big as the framebuffer itself; the bigger the better... default is 10X) is placed below the framebuffer to act as a buffer/cache area for pixel data. The VNC CopyRect encoding @@ -1158,7 +1163,7 @@ LAY Until we start modifying viewers you will be able to see the cache area if you scroll down (this makes it easier to debug!) For testing the default is "-ncache 10". The unix Enhanced TightVNC - Viewer [213]ssvnc has a nice [214]-ycrop option to help hide the + Viewer [214]ssvnc has a nice [215]-ycrop option to help hide the pixel cache area from view. @@ -1171,14 +1176,14 @@ LAY * If UltraVNC file transfer or chat is detected, then VNC clients are "pinged" more often to prevent these side channels from becoming serviced too infrequently. - * In [215]-unixpw mode in the username and password dialog no text + * In [216]-unixpw mode in the username and password dialog no text will be echoed if the first character sent is "Escape". This enables a convenience feature in SSVNC to send the username and password automatically. Here are some features that appeared in the 0.9.1 release: - * The [216]UltraVNC Java viewer has been enhanced to support SSL (as + * The [217]UltraVNC Java viewer has been enhanced to support SSL (as the TightVNC viewer had been previously.) The UltraVNC Java supports ultravnc filetransfer, and so can be used as a VNC viewer on Unix that supports ultravnc filetransfer. It is in the @@ -1189,12 +1194,12 @@ LAY Some other bugs in the UltraVNC Java viewer were fixed and a few improvements to the UI made. * A new Unix username login mode for VNC Viewers authenticated via a - Client SSL Certificate: "[217]-users sslpeer=". The emailAddress + Client SSL Certificate: "[218]-users sslpeer=". The emailAddress subject field is inspected for username@hostname and then acts as though "-users +username" has been supplied. This way the Unix username is identified by (i.e. simply extracted from) the Client - SSL Certificate. This could be useful with [218]-find, - [219]-create and [220]-svc modes if you are also have set up and + SSL Certificate. This could be useful with [219]-find, + [220]-create and [221]-svc modes if you are also have set up and use VNC Client SSL Certificate authentication. * For external display finding/creating programs (e.g. WAIT:cmd=...) if the VNC Viewer is authenticated via a Client SSL Certificate, @@ -1203,41 +1208,41 @@ LAY Here are some features that appeared in the 0.9 release: - * [221]VNC Service advertising via mDNS / ZeroConf / BonJour with - the [222]Avahi client library. Enable via "[223]-avahi" or - "[224]-zeroconf". + * [222]VNC Service advertising via mDNS / ZeroConf / BonJour with + the [223]Avahi client library. Enable via "[224]-avahi" or + "[225]-zeroconf". * Implementations of UltraVNC's TextChat, SingleWindow, and - ServerInput extensions (requires ultravnc viewer or [225]ssvnc + ServerInput extensions (requires ultravnc viewer or [226]ssvnc Unix viewer.) They toggle the selection of a single window - ([226]-id), and disable (friendly) user input and viewing (monitor + ([227]-id), and disable (friendly) user input and viewing (monitor blank) at the VNC server. - * Short aliases "[227]-find", "[228]-create", "[229]-svc", and - "[230]-xdmsvc" for commonly used FINDCREATEDISPLAY usage modes. + * Short aliases "[228]-find", "[229]-create", "[230]-svc", and + "[231]-xdmsvc" for commonly used FINDCREATEDISPLAY usage modes. * Reverse VNC connections (viewer listening) now work in SSL - ([231]-ssl) mode. + ([232]-ssl) mode. * New options to control the Monitor power state and keyboard/mouse - grabbing: [232]-forcedpms, [233]-clientdpms, [234]-noserverdpms, - and [235]-grabalways. + grabbing: [233]-forcedpms, [234]-clientdpms, [235]-noserverdpms, + and [236]-grabalways. * A simple way to emulate inetd(8) to some degree via the - "[236]-loopbg" option. - * Monitor the accuracy of XDAMAGE and apply "[237]-noxdamage" if it - is not working well. OpenGL applications like like [238]beryl and + "[237]-loopbg" option. + * Monitor the accuracy of XDAMAGE and apply "[238]-noxdamage" if it + is not working well. OpenGL applications like like [239]beryl and MythTv have been shown to make XDAMAGE not work properly. * For Java SSL connections involving a router/firewall port - redirection, an option [239]-httpsredir to spare the user from + redirection, an option [240]-httpsredir to spare the user from needing to include &PORT=NNN in the browser URL. Here are some features that appeared in the 0.8.4 release: - * Native [240]Mac OS X Aqua/Quartz support. (i.e. OSXvnc + * Native [241]Mac OS X Aqua/Quartz support. (i.e. OSXvnc alternative; some activities are faster) - * A [241]new login mode: "-display WAIT:cmd=FINDCREATEDISPLAY + * A [242]new login mode: "-display WAIT:cmd=FINDCREATEDISPLAY -unixpw ..." that will Create a new X session (either virtual or real and with or without a display manager, e.g. kdm) for the user if it cannot find the user's X session display via the FINDDISPLAY - method. See the [242]-svc and the [243]-xdmsvc aliases. - * x11vnc can act as a VNC [244]reflector/repeater using the - "[245]-reflect host:N" option. Instead of polling an X display, + method. See the [243]-svc and the [244]-xdmsvc aliases. + * x11vnc can act as a VNC [245]reflector/repeater using the + "[246]-reflect host:N" option. Instead of polling an X display, the remote VNC Server host:N is connected to and re-exported via VNC. This is intended for use in broadcasting a display to many (e.g. > 16; classroom or large demo) VNC viewers where bandwidth @@ -1245,16 +1250,16 @@ LAY number of repeaters. * Wireframe copyrect detection for local user activity (e.g. someone sitting at the physical display moving windows) Use - [246]-nowireframelocal to disable. - * The "[247]-N" option couples the VNC Display number to the X + [247]-nowireframelocal to disable. + * The "[248]-N" option couples the VNC Display number to the X Display number. E.g. if your X DISPLAY is :2 then the VNC display will be :2 (i.e. using port 5902.) If that port is taken x11vnc will exit. - * Option [248]-nodpms to avoid problems with programs like KDE's + * Option [249]-nodpms to avoid problems with programs like KDE's kdesktop_lock that keep restarting the screen saver every few seconds. * To automatically fix the common mouse motion problem on XINERAMA - (multi-headed) displays, the [249]-xwarppointer option is enabled + (multi-headed) displays, the [250]-xwarppointer option is enabled by default when XINERAMA is active. If you have a Mac please try out the native Mac OS X support, build @@ -1264,62 +1269,62 @@ LAY Here are some features that appeared in the 0.8.3 release: - * The [250]-ssl option provides SSL encryption and authentication - natively via the [251]www.openssl.org library. One can use from a + * The [251]-ssl option provides SSL encryption and authentication + natively via the [252]www.openssl.org library. One can use from a simple self-signed certificate server certificate up to full CA and client certificate authentication schemes. - * Similar to -ssl, the [252]-stunnel option starts up a SSL tunnel + * Similar to -ssl, the [253]-stunnel option starts up a SSL tunnel server stunnel (that must be installed separately on the system: - [253]www.stunnel.org [254]stunnel.mirt.net ) to allow only + [254]www.stunnel.org [255]stunnel.mirt.net ) to allow only encrypted SSL connections from the network. - * The [255]-sslverify option allows for authenticating VNC clients + * The [256]-sslverify option allows for authenticating VNC clients via their certificates in either -ssl or -stunnel modes. * Certificate creation and management tools are provide in the - [256]-sslGenCert, [257]-sslGenCA, and [258]related options. + [257]-sslGenCert, [258]-sslGenCA, and [259]related options. * An SSL enabled Java applet VNC Viewer applet is provided by x11vnc in classes/ssl/VncViewer.jar. In addition to normal HTTP, the applet may be loaded into the web browser via HTTPS (HTTP over SSL.) (one can use the VNC port, e.g. https://host:5900/, or also - the separate [259]-https port option.) A wrapper shell script - [260]ss_vncviewer is also provided that sets up a stunnel - client-side tunnel on Unix systems. See [261]Enhanced TightVNC + the separate [260]-https port option.) A wrapper shell script + [261]ss_vncviewer is also provided that sets up a stunnel + client-side tunnel on Unix systems. See [262]Enhanced TightVNC Viewer (SSVNC) for other SSL/SSH viewer possibilities. - * The [262]-unixpw option supports Unix username and password - authentication (a simpler variant is the [263]-unixpw_nis option + * The [263]-unixpw option supports Unix username and password + authentication (a simpler variant is the [264]-unixpw_nis option that works in environments where the encrypted passwords are - readable, e.g. NIS.) The [264]-ssl or [265]-localhost + - [266]-stunnel options are enforced in this mode to prevent + readable, e.g. NIS.) The [265]-ssl or [266]-localhost + + [267]-stunnel options are enforced in this mode to prevent password sniffing. As a convenience, these requirements are lifted if a SSH tunnel can be deduced (but -localhost still applies.) - * Coupling [267]-unixpw with "[268]-display WAIT:cmd=FINDDISPLAY" or + * Coupling [268]-unixpw with "[269]-display WAIT:cmd=FINDDISPLAY" or "-display WAIT:cmd=FINDCREATEDISPLAY" provides a way to allow a user to login with their UNIX password and have their display - connected to [269]automatically. See the [270]-svc and the - [271]-xdmsvc aliases. - * Hooks are provided in the [272]-unixpw_cmd and "[273]-passwdfile + connected to [270]automatically. See the [271]-svc and the + [272]-xdmsvc aliases. + * Hooks are provided in the [273]-unixpw_cmd and "[274]-passwdfile cmd:,custom:..." options to allow you to supply your own authentication and password lookup programs. * x11vnc can be configured and built to not depend on X11 libraries - "./configure --without-x" for [274]-rawfb only operation (e.g. + "./configure --without-x" for [275]-rawfb only operation (e.g. embedded linux console devices.) - * The [275]-rotate option enables you to rotate or reflect the + * The [276]-rotate option enables you to rotate or reflect the screen before exporting via VNC. This is intended for use on handhelds and other devices where the rotation orientation is not "natural". - * The "[276]-ultrafilexfer" alias is provided and improved UltraVNC + * The "[277]-ultrafilexfer" alias is provided and improved UltraVNC filetransfer rates have been achieved. - * Under the "[277]-connect_or_exit host" option x11vnc will exit + * Under the "[278]-connect_or_exit host" option x11vnc will exit immediately unless the reverse connection to host succeeds. The "-rfbport 0" option disables TCP listening for connections (useful for this mode.) - * The "[278]-rawfb rand" and "-rawfb none" options are useful for + * The "[279]-rawfb rand" and "-rawfb none" options are useful for testing automation scripts, etc., without requiring a full desktop. - * Reduced spewing of information at startup, use "[279]-verbose" + * Reduced spewing of information at startup, use "[280]-verbose" (also "-v") to turn it back on for debugging or if you are going to send me a problem report. - Here are some [280]Previous Release Notes + Here are some [281]Previous Release Notes _________________________________________________________________ Some Notes: @@ -1346,13 +1351,13 @@ LAY protocol.) I suggest using xsetroot, dtstyle or similar utility to set a solid background while using x11vnc. You can turn the pretty background image back on when you are using the display directly. - Update: As of Feb/2005 x11vnc has the [281]-solid [color] option that + Update: As of Feb/2005 x11vnc has the [282]-solid [color] option that works on recent GNOME, KDE, and CDE and also on classic X (background image is on the root window.) Update: As of Oct/2007 x11vnc has the - [282]-ncache option that does a reasonable job caching the background + [283]-ncache option that does a reasonable job caching the background (and other) pixmap data on the viewer side. - I also find the [283]TightVNC encoding gives the best response for my + I also find the [284]TightVNC encoding gives the best response for my usage (Unix <-> Unix over cable modem.) One needs a tightvnc-aware vncviewer to take advantage of this encoding. @@ -1364,17 +1369,17 @@ LAY is X11's default listening port.) Had port 5900 been taken by some other application, x11vnc would have next tried 5901. That would mean the viewer command above should be changed to vncviewer - far-away.east:1. You can force the port with the "[284]-rfbport NNNN" + far-away.east:1. You can force the port with the "[285]-rfbport NNNN" option where NNNN is the desired port number. If that port is already - taken, x11vnc will exit immediately. The "[285]-N" option will try to + taken, x11vnc will exit immediately. The "[286]-N" option will try to match the VNC display number to the X display. (also see the "SunRay Gotcha" note below) Options: x11vnc has (far too) many features that may be activated - via its [286]command line options. Useful options are, e.g., -scale to + via its [287]command line options. Useful options are, e.g., -scale to do server-side scaling, and -rfbauth passwd-file to use VNC password protection (the vncpasswd or storepasswd programs, or the x11vnc - [287]-storepasswd option can be used to create the password file.) + [288]-storepasswd option can be used to create the password file.) Algorithm: How does x11vnc do it? Rather brute-forcedly: it continuously polls the X11 framebuffer for changes using @@ -1402,7 +1407,7 @@ LAY first testing out the programs. You get an interesting recursive/feedback effect where vncviewer images keep popping up each one contained in the previous one and slightly shifted a bit by the - window manager decorations. There will be an [288]even more + window manager decorations. There will be an [289]even more interesting effect if -scale is used. Also, if the XKEYBOARD is supported and the XBell "beeps" once, you get an infinite loop of beeps going off. Although all of this is mildly exciting it is not @@ -1412,8 +1417,8 @@ LAY Sun Ray Notes: - You can run x11vnc on your (connected or disconnected) [289]SunRay - session. Here are some [290]notes on SunRay usage with x11vnc. + You can run x11vnc on your (connected or disconnected) [290]SunRay + session. Here are some [291]notes on SunRay usage with x11vnc. _________________________________________________________________ @@ -1425,7 +1430,7 @@ LAY than you normally do to minimize the effects (e.g. do fullpage paging rather than line-by-line scrolling, and move windows in a single, quick motion.) Recent work has provided the - [291]-scrollcopyrect and [292]-wireframe speedups using the + [292]-scrollcopyrect and [293]-wireframe speedups using the CopyRect VNC encoding and other things, but they only speed up some activities, not all. * A rate limiting factor for x11vnc performance is that graphics @@ -1484,18 +1489,18 @@ LAY but we mention it because it may be of use for special purpose applications. You may need to use the "-cc 4" option to force Xvfb to use a TrueColor visual instead of DirectColor. See also the - description of the [293]-create option that does all of this + description of the [294]-create option that does all of this automatically for you. Also, a faster and more accurate way is to use the "dummy" XFree86/Xorg device driver (or our Xdummy wrapper script.) See - [294]this FAQ for details. + [295]this FAQ for details. * Somewhat surprisingly, the X11 mouse (cursor) shape is write-only and cannot be queried from the X server. So traditionally in x11vnc the cursor shape stays fixed at an arrow. (see the "-cursor - X" and "-cursor some" [295]options, however, for a partial hack + X" and "-cursor some" [296]options, however, for a partial hack for the root window, etc.) However, on Solaris using the SUN_OVL overlay extension, x11vnc can show the correct mouse cursor when - the [296]-overlay option is also supplied. A similar thing is done + the [297]-overlay option is also supplied. A similar thing is done on IRIX as well when -overlay is supplied. More generally, as of Dec/2004 x11vnc supports the new XFIXES extension (in Xorg and Solaris 10) to query the X server for the @@ -1503,18 +1508,18 @@ LAY with transparency (alpha channel) need to approximated to solid RGB values (some cursors look worse than others.) * Audio from applications is of course not redirected (separate - redirectors do exist, e.g. esd, see [297]the FAQ on this below.) + redirectors do exist, e.g. esd, see [298]the FAQ on this below.) The XBell() "beeps" will work if the X server supports the XKEYBOARD extension. (Note that on Solaris XKEYBOARD is disabled by default. Passing +kb to Xsun enables it.) - * The scroll detection algorithm for the [298]-scrollcopyrect option + * The scroll detection algorithm for the [299]-scrollcopyrect option can give choppy or bunched up transient output and occasionally painting errors. * Using -threads can expose some bugs/crashes in libvncserver. - Please feel free to [299]contact me if you have any questions, + Please feel free to [300]contact me if you have any questions, problems, or comments about x11vnc, etc. - Also, some people ask if they can make a donation, see [300]this link + Also, some people ask if they can make a donation, see [301]this link for that. References @@ -1660,165 +1665,166 @@ References 139. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslverify 140. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslCRL 141. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 142. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 143. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 144. http://ubuntuforums.org/showthread.php?t=1223490 - 145. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 146. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reflect - 147. http://bugs.freedesktop.org/show_bug.cgi?id=21454 - 148. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-repeat - 149. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip - 150. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 142. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-appshare + 143. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 144. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 145. http://ubuntuforums.org/showthread.php?t=1223490 + 146. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 147. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reflect + 148. http://bugs.freedesktop.org/show_bug.cgi?id=21454 + 149. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-repeat + 150. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip 151. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 152. http://www.virtualgl.org/ - 153. http://www.karlrunge.com/x11vnc/faq.html#faq-turbovnc - 154. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache_cr - 155. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache - 156. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rmflag - 157. http://sourceforge.net/projects/vencrypt/ - 158. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 159. http://www.karlrunge.com/x11vnc/ssvnc.html - 160. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 161. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vencrypt - 162. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-anontls - 163. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslonly - 164. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 165. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vencrypt - 166. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-anontls - 167. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslCRL - 168. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCA - 169. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCert - 170. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 171. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http_oneport - 172. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir - 173. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 174. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-avahi - 175. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-zeroconf - 176. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport - 177. http://www.karlrunge.com/x11vnc/x11vnc.desktop - 178. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-o - 179. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid - 180. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reopen - 181. http://www.karlrunge.com/x11vnc/faq.html#infaq_gdm - 182. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-enc - 183. http://www.karlrunge.com/x11vnc/ssvnc.html - 184. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 185. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-geometry - 186. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-chatwindow - 187. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 188. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 189. http://www.karlrunge.com/x11vnc/ssvnc.html - 190. http://www.karlrunge.com/x11vnc/faq.html#faq-reverse-connect - 191. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 192. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 193. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 194. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy - 195. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssh - 196. http://www.uvnc.com/addons/repeater.html - 197. http://www.karlrunge.com/x11vnc/faq.html#faq-reverse-connect - 198. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 199. http://www.karlrunge.com/x11vnc/ssvnc.html - 200. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-advertise_truecolor - 201. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-finddpy - 202. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listdpy - 203. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 204. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 205. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 206. http://www.karlrunge.com/x11vnc/faq.html#faq-xrandr - 207. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-autoport - 208. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ping - 209. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all - 210. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 211. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers - 212. http://www.karlrunge.com/x11vnc/faq.html#faq-client-caching - 213. http://www.karlrunge.com/x11vnc/ssvnc.html - 214. http://www.karlrunge.com/x11vnc/ssvnc.html#ycrop - 215. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 216. http://www.ultravnc.com/ - 217. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 152. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 153. http://www.virtualgl.org/ + 154. http://www.karlrunge.com/x11vnc/faq.html#faq-turbovnc + 155. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache_cr + 156. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache + 157. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rmflag + 158. http://sourceforge.net/projects/vencrypt/ + 159. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 160. http://www.karlrunge.com/x11vnc/ssvnc.html + 161. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 162. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vencrypt + 163. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-anontls + 164. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslonly + 165. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 166. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vencrypt + 167. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-anontls + 168. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslCRL + 169. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCA + 170. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCert + 171. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 172. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http_oneport + 173. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir + 174. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 175. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-avahi + 176. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-zeroconf + 177. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport + 178. http://www.karlrunge.com/x11vnc/x11vnc.desktop + 179. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-o + 180. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid + 181. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reopen + 182. http://www.karlrunge.com/x11vnc/faq.html#infaq_gdm + 183. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-enc + 184. http://www.karlrunge.com/x11vnc/ssvnc.html + 185. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 186. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-geometry + 187. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-chatwindow + 188. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 189. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 190. http://www.karlrunge.com/x11vnc/ssvnc.html + 191. http://www.karlrunge.com/x11vnc/faq.html#faq-reverse-connect + 192. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 193. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 194. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 195. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy + 196. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssh + 197. http://www.uvnc.com/addons/repeater.html + 198. http://www.karlrunge.com/x11vnc/faq.html#faq-reverse-connect + 199. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 200. http://www.karlrunge.com/x11vnc/ssvnc.html + 201. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-advertise_truecolor + 202. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-finddpy + 203. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listdpy + 204. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 205. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 206. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 207. http://www.karlrunge.com/x11vnc/faq.html#faq-xrandr + 208. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-autoport + 209. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ping + 210. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all + 211. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 212. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers + 213. http://www.karlrunge.com/x11vnc/faq.html#faq-client-caching + 214. http://www.karlrunge.com/x11vnc/ssvnc.html + 215. http://www.karlrunge.com/x11vnc/ssvnc.html#ycrop + 216. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 217. http://www.ultravnc.com/ + 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users 219. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 221. http://www.karlrunge.com/x11vnc/faq.html#faq-avahi - 222. http://www.avahi.org/ - 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-avahi - 224. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-zeroconf - 225. http://www.karlrunge.com/x11vnc/ssvnc.html - 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 229. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 230. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 231. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 232. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forcedpms - 233. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clientdpms - 234. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noserverdpms - 235. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabalways - 236. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop - 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage - 238. http://www.karlrunge.com/x11vnc/faq.html#faq-beryl - 239. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir - 240. http://www.karlrunge.com/x11vnc/faq.html#faq-macosx - 241. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 243. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 244. http://www.karlrunge.com/x11vnc/faq.html#faq-reflect - 245. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reflect - 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nowireframelocal - 247. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-N - 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodpms - 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer - 250. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 251. http://www.openssl.org/ - 252. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 253. http://www.stunnel.org/ - 254. http://stunnel.mirt.net/ - 255. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslverify - 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCert - 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCA - 258. http://www.karlrunge.com/x11vnc/ssl.html - 259. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https - 260. http://www.karlrunge.com/x11vnc/faq.html#infaq_ss_vncviewer - 261. http://www.karlrunge.com/x11vnc/ssvnc.html - 262. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 263. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_nis - 264. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 266. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 267. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 268. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT - 269. http://www.karlrunge.com/x11vnc/faq.html#faq-userlogin - 270. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 271. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 272. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_cmd - 273. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 274. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 275. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rotate - 276. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ultrafilexfer - 277. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect_or_exit - 278. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 279. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-v, - 280. http://www.karlrunge.com/x11vnc/prevrels.html - 281. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid - 282. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache - 283. http://www.tightvnc.com/ - 284. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport - 285. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-N - 286. http://www.karlrunge.com/x11vnc/x11vnc_opts.html - 287. http://www.karlrunge.com/x11vnc/faq.html#faq-passwd - 288. http://www.karlrunge.com/x11vnc/recurse_x11vnc.jpg - 289. http://www.sun.com/sunray/index.html - 290. http://www.karlrunge.com/x11vnc/sunray.html - 291. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 292. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 293. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 294. http://www.karlrunge.com/x11vnc/faq.html#faq-xvfb - 295. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 297. http://www.karlrunge.com/x11vnc/faq.html#faq-sound - 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 299. mailto:xvml@karlrunge.com - 300. http://www.karlrunge.com/x11vnc/faq.html#faq-thanks + 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 222. http://www.karlrunge.com/x11vnc/faq.html#faq-avahi + 223. http://www.avahi.org/ + 224. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-avahi + 225. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-zeroconf + 226. http://www.karlrunge.com/x11vnc/ssvnc.html + 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 229. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 230. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 231. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 232. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 233. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forcedpms + 234. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clientdpms + 235. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noserverdpms + 236. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabalways + 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop + 238. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 239. http://www.karlrunge.com/x11vnc/faq.html#faq-beryl + 240. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir + 241. http://www.karlrunge.com/x11vnc/faq.html#faq-macosx + 242. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 243. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 244. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 245. http://www.karlrunge.com/x11vnc/faq.html#faq-reflect + 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reflect + 247. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nowireframelocal + 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-N + 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodpms + 250. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer + 251. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 252. http://www.openssl.org/ + 253. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 254. http://www.stunnel.org/ + 255. http://stunnel.mirt.net/ + 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslverify + 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCert + 258. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslGenCA + 259. http://www.karlrunge.com/x11vnc/ssl.html + 260. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https + 261. http://www.karlrunge.com/x11vnc/faq.html#infaq_ss_vncviewer + 262. http://www.karlrunge.com/x11vnc/ssvnc.html + 263. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 264. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_nis + 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 266. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 267. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 268. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 269. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT + 270. http://www.karlrunge.com/x11vnc/faq.html#faq-userlogin + 271. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 272. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 273. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_cmd + 274. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 275. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 276. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rotate + 277. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ultrafilexfer + 278. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect_or_exit + 279. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 280. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-v, + 281. http://www.karlrunge.com/x11vnc/prevrels.html + 282. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid + 283. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache + 284. http://www.tightvnc.com/ + 285. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport + 286. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-N + 287. http://www.karlrunge.com/x11vnc/x11vnc_opts.html + 288. http://www.karlrunge.com/x11vnc/faq.html#faq-passwd + 289. http://www.karlrunge.com/x11vnc/recurse_x11vnc.jpg + 290. http://www.sun.com/sunray/index.html + 291. http://www.karlrunge.com/x11vnc/sunray.html + 292. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 293. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 294. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 295. http://www.karlrunge.com/x11vnc/faq.html#faq-xvfb + 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 297. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 298. http://www.karlrunge.com/x11vnc/faq.html#faq-sound + 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 300. mailto:xvml@karlrunge.com + 301. http://www.karlrunge.com/x11vnc/faq.html#faq-thanks ======================================================================= http://www.karlrunge.com/x11vnc/faq.html: @@ -3205,13 +3211,14 @@ TrueColor defdepth 24 possible workaround in this case is to use the [215]-id option to point x11vnc at the application window itself. If the application is complicated (lots of toplevel windows and popup menus) this may not be - acceptable, and may even crash x11vnc (but not the application.) + acceptable, and may even crash x11vnc (but not the application.) See + also [216]-appshare. It is theoretically possible to solve this problem in general (see xwd(1) for example), but it does not seem trivial or sufficiently fast - for x11vnc to be able to do so in real time. The [216]-8to24 method + for x11vnc to be able to do so in real time. The [217]-8to24 method does this approximately and is somewhat usable. Fortunately the - [217]-overlay option works for Solaris machines with overlay visuals + [218]-overlay option works for Solaris machines with overlay visuals where most of this problem occurs. @@ -3247,9 +3254,9 @@ TrueColor defdepth 24 the desired application window. After clicking, it will print out much information, including the window id (e.g. 0x6000010.) Also, the visual and depth of the window printed out is often useful in - debugging x11vnc [218]color problems. + debugging x11vnc [219]color problems. - Also, as of Dec/2004 you can use "[219]-id pick" to have x11vnc run + Also, as of Dec/2004 you can use "[220]-id pick" to have x11vnc run xwininfo(1) for you and after you click the window it extracts the windowid. Besides "pick" there is also "id:root" to allow you to go back to root window when doing remote-control. @@ -3267,7 +3274,13 @@ TrueColor defdepth 24 you should be able to see these transient windows. If things are not working and you still want to do the single window - polling, try the [220]-sid windowid option ("shifted" windowid.) + polling, try the [221]-sid windowid option ("shifted" windowid.) + + Update: as of Nov/2009 in the 0.9.9 x11vnc developement tarball, there + is an experimental Application Sharing mode that improves upon the + -id/-sid single window sharing: [222]-appshare (run "x11vnc -appshare + -help" for more info.) It is still very primitive and approximate, but + at least it displays multiple top-level windows. Q-28: My X display is depth 24 at 24bpp (instead of the normal depth @@ -3303,7 +3316,7 @@ TrueColor defdepth 24 handle 24bpp from the server, so you may want to use those. They evidently request 32 bpp and libvncserver obliges. - Update: as of Apr/2006 you can use the [221]-24to32 option to have + Update: as of Apr/2006 you can use the [223]-24to32 option to have x11vnc dynamically transform the 24bpp pixel data to 32bpp. This extra transformation could slow things down further however. @@ -3313,7 +3326,7 @@ TrueColor defdepth 24 couldn't find suitable pixmap format" so evidently you cannot use 24bpp for the vncviewers to work on that X display. - Note, however, that the Unix viewer in the [222]Enhanced TightVNC + Note, however, that the Unix viewer in the [224]Enhanced TightVNC Viewer (SSVNC) project can handle 24bpp X displays. It does this by requesting a 16bpp pixel format (or 8bpp if the -bgr233 option has been supplied) from the VNC server, and translates that to 24bpp @@ -3328,9 +3341,9 @@ TrueColor defdepth 24 since you will be polling the X display over the network as opposed to over the local hardware. To do this, run x11vnc on a UNIX machine as close as possible network-wise (e.g. same switch) to the Xterminal - machine. Use the [223]-display option to point the display to that of + machine. Use the [225]-display option to point the display to that of the Xterminal (you'll of course need basic X11 permission to do that) - and finally supply the [224]-noshm option (this enables the polling + and finally supply the [226]-noshm option (this enables the polling over the network.) If the Xterminal's X display is open to the network for connections, @@ -3343,7 +3356,7 @@ TrueColor defdepth 24 The response will likely be sluggish (maybe only one "frame" per second.) This mode is not recommended except for "quick checks" of hard to get to X servers. Use something like "-wait 150" to cut down - on the polling rate. You may also need [225]-flipbyteorder if the + on the polling rate. You may also need [227]-flipbyteorder if the colors get messed up due to endian byte order differences. Q-30: How do I get my X permissions (MIT-MAGIC-COOKIE file) correct @@ -3367,7 +3380,7 @@ TrueColor defdepth 24 copied to the Xterminal. If $HOME/.Xauthority is exported via NFS (this is insecure of course, but has been going on for decades), then x11vnc can simply pick it up via NFS (you may need to use the - [226]-auth option to point to the correct file.) Other options include + [228]-auth option to point to the correct file.) Other options include copying the auth file using scp, or something like: central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - @@ -3379,7 +3392,7 @@ TrueColor defdepth 24 details. If the display name in the cookie file needs to be changed between the - two hosts, see [227]this note on the "xauth add ..." command. + two hosts, see [229]this note on the "xauth add ..." command. A less secure option is to run something like "xhost +127.0.0.1" while sitting at the Xterminal box to allow cookie-free local access for @@ -3393,7 +3406,7 @@ TrueColor defdepth 24 occasional app more efficiently locally on the Xterminal box (e.g. realplayer.) - Not recommended, but as a last resort, you could have x11vnc [228]poll + Not recommended, but as a last resort, you could have x11vnc [230]poll the Xterminal Display over the network. For this you would run a "x11vnc -noshm ..." process on the central-server (and hope the network admin doesn't get angry...) @@ -3422,34 +3435,34 @@ TrueColor defdepth 24 Q-31: I'm having trouble using x11vnc with my Sun Ray session. - The [229]Sun Ray technology is a bit like "VNC done in hardware" (the + The [231]Sun Ray technology is a bit like "VNC done in hardware" (the Sun Ray terminal device, DTU, playing the role of the vncviewer.) Completely independent of that, the SunRay user's session is still an X server that speaks the X11 protocol and so x11vnc simply talks to the X server part to export the SunRay desktop to any place in the world (i.e. not only to a Sun Ray terminal device), creating a sort of - "Soft Ray". Please see [230]this discussion of Sun Ray issues for + "Soft Ray". Please see [232]this discussion of Sun Ray issues for solutions to problems. - Also see the [231]Sun Ray Remote Control Toolkit that uses x11vnc. + Also see the [233]Sun Ray Remote Control Toolkit that uses x11vnc. [Remote Control] Q-32: How do I stop x11vnc once it is running in the background? As of Dec/2004 there is a remote control feature. It can change a huge - number of parameters on the fly: see the [232]-remote and [233]-query + number of parameters on the fly: see the [234]-remote and [235]-query options. To shut down the running x11vnc server just type "x11vnc -R stop". To disconnect all clients do "x11vnc -R disconnect:all", etc. - If the [234]-forever option has not been supplied, x11vnc will + If the [236]-forever option has not been supplied, x11vnc will automatically exit after the first client disconnects. In general if you cannot use the remote control, then you will have to kill the x11vnc process This can be done via: "kill NNNNN" (where NNNNN is the x11vnc process id number found from ps(1)), or "pkill x11vnc", or "killall x11vnc" (Linux only.) - If you have not put x11vnc in the background via the [235]-bg option + If you have not put x11vnc in the background via the [237]-bg option or shell & operator, then simply press Ctrl-C in the shell where x11vnc is running to stop it. @@ -3459,16 +3472,16 @@ TrueColor defdepth 24 down state in the Xserver. Tapping the stuck key (either via a new x11vnc or at the physical console) will release it from the stuck state. If the keyboard seems to be acting strangely it is often fixed - by tapping Ctrl, Shift, and Alt. Alternatively, the [236]-clear_mods - option and [237]-clear_keys option can be used to release pressed keys - at startup and exit. The option [238]-clear_all will also try to unset + by tapping Ctrl, Shift, and Alt. Alternatively, the [238]-clear_mods + option and [239]-clear_keys option can be used to release pressed keys + at startup and exit. The option [240]-clear_all will also try to unset Caps_Lock, Num_Lock, etc. Q-33: Can I change settings in x11vnc without having to restart it? Can I remote control it? - Look at the [239]-remote (an alias is -R) and [240]-query (an alias is + Look at the [241]-remote (an alias is -R) and [242]-query (an alias is -Q) options added in Dec/2004. They allow nearly everything to be changed dynamically and settings to be queried. Examples: "x11vnc -R shared", "x11vnc -R forever", "x11vnc -R scale:3/4", "x11vnc -Q @@ -3479,8 +3492,8 @@ TrueColor defdepth 24 property) is used as the communication channel, so the X permissions and DISPLAY must be set up correctly for communication to be possible. - There is also a simple Tcl/Tk [241]gui based on this remote control - mechanism. See the [242]-gui option for more info. You will need to + There is also a simple Tcl/Tk [243]gui based on this remote control + mechanism. See the [244]-gui option for more info. You will need to have Tcl/Tk (i.e. /usr/bin/wish) installed for it to work. It can also run in the system tray: "-gui tray" or as a standalone small icon window: "-gui icon". Use "-gui tray=setpass" for a naive user "Share @@ -3496,12 +3509,12 @@ TrueColor defdepth 24 vncpasswd(1) program from those packages. As of Jun/2004 x11vnc supports the -storepasswd "pass" "file" - [243]option, which is the same functionality of storepasswd. Be sure + [245]option, which is the same functionality of storepasswd. Be sure to quote the "pass" if it contains shell meta characters, spaces, etc. Example: x11vnc -storepasswd 'sword*fish' $HOME/myvncpasswd - You then use the password via the x11vnc option: "[244]-rfbauth + You then use the password via the x11vnc option: "[246]-rfbauth $HOME/myvncpasswd" As of Jan/2006 if you do not supply any arguments: @@ -3513,11 +3526,11 @@ TrueColor defdepth 24 ~/.mypass", the password you are prompted for will be stored in that file. - x11vnc also has the [245]-passwdfile and -passwd/-viewpasswd plain + x11vnc also has the [247]-passwdfile and -passwd/-viewpasswd plain text (i.e. not obscured like the -rfbauth VNC passwords) password options. - You can use the [246]-usepw option to automatically use any password + You can use the [248]-usepw option to automatically use any password file you have in ~/.vnc/passwd or ~/.vnc/passwdfile (the latter is used with the -passwdfile option.) @@ -3549,14 +3562,14 @@ TrueColor defdepth 24 Q-36: Can I have two passwords for VNC viewers, one for full access and the other for view-only access to the display? - Yes, as of May/2004 there is the [247]-viewpasswd option to supply the - view-only password. Note the full-access password option [248]-passwd + Yes, as of May/2004 there is the [249]-viewpasswd option to supply the + view-only password. Note the full-access password option [250]-passwd must be supplied at the same time. E.g.: -passwd sword -viewpasswd fish. To avoid specifying the passwords on the command line (where they could be observed via the ps(1) command by any user) you can use the - [249]-passwdfile option to specify a file containing plain text + [251]-passwdfile option to specify a file containing plain text passwords. Presumably this file is readable only by you, and ideally it is located on the machine x11vnc is run on (to avoid being snooped on over the network.) The first line of this file is the full-access @@ -3564,7 +3577,7 @@ TrueColor defdepth 24 it is taken as the view-only password. (use "__EMPTY__" to supply an empty one.) - View-only passwords currently do not work for the [250]-rfbauth + View-only passwords currently do not work for the [252]-rfbauth password option (standard VNC password storing mechanism.) FWIW, note that although the output (usually placed in $HOME/.vnc/passwd) by the vncpasswd or storepasswd programs (or from x11vnc -storepasswd) looks @@ -3577,7 +3590,7 @@ TrueColor defdepth 24 Q-37: Can I have as many full-access and view-only passwords as I like? - Yes, as of Jan/2006 in the libvncserver CVS the [251]-passwdfile + Yes, as of Jan/2006 in the libvncserver CVS the [253]-passwdfile option has been extended to handle as many passwords as you like. You put the view-only passwords after a line __BEGIN_VIEWONLY__. @@ -3587,7 +3600,7 @@ TrueColor defdepth 24 Q-38: Does x11vnc support Unix usernames and passwords? Can I further limit the set of Unix usernames who can connect to the VNC desktop? - Update: as of Feb/2006 x11vnc has the [252]-unixpw option that does + Update: as of Feb/2006 x11vnc has the [254]-unixpw option that does this outside of the VNC protocol and libvncserver. The standard su(1) program is used to validate the user's password. A familiar "login:" and "Password:" dialog is presented to the user on a black screen @@ -3597,7 +3610,7 @@ TrueColor defdepth 24 A list of allowed Unix usernames may also be supplied along with per-user settings. - There is also the [253]-unixpw_nis option for non-shadow-password + There is also the [255]-unixpw_nis option for non-shadow-password (typically NIS environments, hence the name) systems where the traditional getpwnam() and crypt() functions are used instead of su(1). The encrypted user passwords must be accessible to the user @@ -3606,11 +3619,11 @@ TrueColor defdepth 24 shadow(5). Two settings are enforced in the -unixpw and -unixpw_nis modes to - provide extra security: the 1) [254]-localhost and 2) [255]-stunnel or - [256]-ssl options. Without these one might send the Unix username and + provide extra security: the 1) [256]-localhost and 2) [257]-stunnel or + [258]-ssl options. Without these one might send the Unix username and password data in clear text over the network which is a very bad idea. They can be relaxed if you want to provide encryption other than - stunnel or [257]-ssl (the constraint is automatically relaxed if + stunnel or [259]-ssl (the constraint is automatically relaxed if SSH_CONNECTION is set and indicates you have ssh-ed in, however the -localhost requirement is still enforced.) @@ -3629,13 +3642,13 @@ TrueColor defdepth 24 approximate at best. One approximate method involves starting x11vnc with the - [258]-localhost option. This basically requires the viewer user to log + [260]-localhost option. This basically requires the viewer user to log into the workstation where x11vnc is running via their Unix username and password, and then somehow set up a port redirection of his vncviewer connection to make it appear to emanate from the local machine. As discussed above, ssh is useful for this: "ssh -L 5900:localhost:5900 user@hostname ..." See the ssh wrapper scripts - mentioned [259]elsewhere on this page. [260]stunnel does this as well. + mentioned [261]elsewhere on this page. [262]stunnel does this as well. Of course a malicious user could allow other users to get in through his channel, but that is a problem with every method. Another thing to @@ -3646,7 +3659,7 @@ TrueColor defdepth 24 traditional way would be to further require a VNC password to supplied (-rfbauth, -passwd, etc) and only tell the people allowed in what the VNC password is. A scheme that avoids a second password involves using - the [261]-accept option that runs a program to examine the connection + the [263]-accept option that runs a program to examine the connection information to determine which user is connecting from the local machine. That may be difficult to do, but, for example, the program could use the ident service on the local machine (normally ident @@ -3682,7 +3695,7 @@ exit 1 # reject it method (e.g. Dynamic/One-time passwords or non-Unix (LDAP) usernames and passwords)? Yes, there are several possibilities. For background see the FAQ on - the [262]-accept where an external program may be run to decide if a + the [264]-accept where an external program may be run to decide if a VNC client should be allowed to try to connect and log in. If the program (or local user prompted by a popup) answers "yes", then -accept proceeds to the normal VNC and x11vnc authentication methods, @@ -3690,26 +3703,26 @@ exit 1 # reject it To provide more direct coupling to the VNC client's username and/or supplied password the following options were added in Sep/2006: - * [263]-unixpw_cmd command - * [264]-passwdfile cmd:command - * [265]-passwdfile custom:command + * [265]-unixpw_cmd command + * [266]-passwdfile cmd:command + * [267]-passwdfile custom:command In each case "command" is an external command run by x11vnc. You supply it. For example, it may couple to your LDAP system or other servers you set up. - For [266]-unixpw_cmd the normal [267]-unixpw Login: and Password: + For [268]-unixpw_cmd the normal [269]-unixpw Login: and Password: prompts are supplied to the VNC viewer and the strings the client returns are then piped into "command" as the first two lines of its standard input. If the command returns success, i.e. exit(0), the VNC client is accepted, otherwise it is rejected. - For "[268]-passwdfile cmd:command" the command is run and it returns a - password list (like a password file, see the [269]-passwdfile + For "[270]-passwdfile cmd:command" the command is run and it returns a + password list (like a password file, see the [271]-passwdfile read:filename mode.) Perhaps a dynamic, one-time password is retrieved from a server this way. - For "[270]-passwdfile custom:command" one gets complete control over + For "[272]-passwdfile custom:command" one gets complete control over the VNC challenge-response dialog with the VNC client. x11vnc sends out a string of random bytes (16 by the VNC spec) and the client returns the same number of bytes in a way the server can verify only @@ -3723,7 +3736,7 @@ exit 1 # reject it accepted, otherwise it is rejected. In all cases the "RFB_*" environment variables are set as under - [271]-accept. These variables can provide useful information for the + [273]-accept. These variables can provide useful information for the externally supplied program to use. @@ -3733,15 +3746,15 @@ exit 1 # reject it These defaults are simple safety measures to avoid someone unknowingly leaving his X11 desktop exposed (to the internet, say) for long - periods of time. Use the [272]-forever option (aka -many) to have + periods of time. Use the [274]-forever option (aka -many) to have x11vnc wait for more connections after the first client disconnects. - Use the [273]-shared option to have x11vnc allow multiple clients to + Use the [275]-shared option to have x11vnc allow multiple clients to connect simultaneously. - Recommended additional safety measures include using ssh ([274]see - above), stunnel, [275]-ssl, or a VPN to authenticate and encrypt the + Recommended additional safety measures include using ssh ([276]see + above), stunnel, [277]-ssl, or a VPN to authenticate and encrypt the viewer connections or to at least use the -rfbauth passwd-file - [276]option to use VNC password protection (or [277]-passwdfile) It is + [278]option to use VNC password protection (or [279]-passwdfile) It is up to YOU to apply these security measures, they will not be done for you automatically. @@ -3749,7 +3762,7 @@ exit 1 # reject it Q-41: Can I limit which machines incoming VNC clients can connect from? - Yes, look at the [278]-allow and [279]-localhost options to limit + Yes, look at the [280]-allow and [281]-localhost options to limit connections by hostname or IP address. E.g. x11vnc -allow 192.168.0.1,192.168.0.2 @@ -3761,7 +3774,7 @@ exit 1 # reject it Note that -localhost achieves the same thing as "-allow 127.0.0.1" For more control, build libvncserver with libwrap support - [280](tcp_wrappers) and then use /etc/hosts.allow See hosts_access(5) + [282](tcp_wrappers) and then use /etc/hosts.allow See hosts_access(5) for complete details. @@ -3781,7 +3794,7 @@ exit 1 # reject it is "vnc", e.g.: vnc: 192.168.100.3 .example.com - Note that if you run x11vnc out of [281]inetd you do not need to build + Note that if you run x11vnc out of [283]inetd you do not need to build x11vnc with libwrap support because the /usr/sbin/tcpd reference in /etc/inetd.conf handles the tcp_wrappers stuff. @@ -3790,15 +3803,15 @@ exit 1 # reject it internal LAN) rather than having it listen on all network interfaces and relying on -allow to filter unwanted connections out? - As of Mar/2005 there is the "[282]-listen ipaddr" option that enables + As of Mar/2005 there is the "[284]-listen ipaddr" option that enables this. For ipaddr either supply the desired network interface's IP address (or use a hostname that resolves to it) or use the string "localhost". For additional filtering simultaneously use the - "[283]-allow host1,..." option to allow only specific hosts in. + "[285]-allow host1,..." option to allow only specific hosts in. This option is useful if you want to insure that no one can even begin a dialog with x11vnc from untrusted network interfaces (e.g. ppp0.) - The option [284]-localhost now implies "-listen localhost" since that + The option [286]-localhost now implies "-listen localhost" since that is what most people expect it to do. @@ -3806,7 +3819,7 @@ exit 1 # reject it interface, how I can occasionally allow in a non-localhost via the -R allowonce remote control command? - To do this specify "[285]-allow localhost". Unlike [286]-localhost + To do this specify "[287]-allow localhost". Unlike [288]-localhost this will leave x11vnc listening on all interfaces (but of course only allowing in local connections, e.g. ssh redirs.) Then you can later run "x11vnc -R allowonce:somehost" or use to gui to permit a one-shot @@ -3817,7 +3830,7 @@ exit 1 # reject it some users just be able to move the mouse, but not click or type anything? - As of Feb/2005, the [287]-input option allows you to do this. "K", + As of Feb/2005, the [289]-input option allows you to do this. "K", "M", "B", "C", and "F" stand for Keystroke, Mouse-motion, Button-clicks, Clipboard, and File-Transfer, respectively. The setting: "-input M" makes attached viewers only able to move the @@ -3833,7 +3846,7 @@ exit 1 # reject it some clients view-only? How about running an arbitrary program to make the decisions? - Yes, look at the "[288]-accept command" option, it allows you to + Yes, look at the "[290]-accept command" option, it allows you to specify an external command that is run for each new client. (use quotes around the command if it contains spaces, etc.) If the external command returns 0 (success) the client is accepted, otherwise with any @@ -3854,7 +3867,7 @@ exit 1 # reject it client press "y" or click mouse on the "Yes" button. To reject the client press "n" or click mouse on the "No" button. To accept the client View-only, press "v" or click mouse on the "View" button. If - the [289]-viewonly option has been supplied, the "View" action will + the [291]-viewonly option has been supplied, the "View" action will not be present: the whole display is view only in that case. The popup window times out after 120 seconds, to change this behavior @@ -3869,7 +3882,7 @@ exit 1 # reject it program to prompt the user whether the client should be accepted or not. This requires that you have xmessage installed and available via PATH. In case it is not already on your system, the xmessage program - is available at [290]ftp://ftp.x.org/ + is available at [292]ftp://ftp.x.org/ (End of Built-in Popup Window:) To include view-only decisions for the external commands, prefix the @@ -3909,7 +3922,7 @@ elif [ $rc = 4 ]; then fi exit 1 - Stefan Radman has written a nice dtksh script [291]dtVncPopup for use + Stefan Radman has written a nice dtksh script [293]dtVncPopup for use in CDE environments to do the same sort of thing. Information on how to use it is found at the top of the file. He encourages you to provide feedback to him to help improve the script. @@ -3918,13 +3931,13 @@ exit 1 popup is being run, so attached clients will not receive screen updates, etc during this period. - To run a command when a client disconnects, use the "[292]-gone + To run a command when a client disconnects, use the "[294]-gone command" option. This is for the user's convenience only: the return code of the command is not interpreted by x11vnc. The same environment variables are set as in "-accept command" (except that RFB_MODE will be "gone".) - As of Jan/2006 the "[293]-afteraccept command" option will run the + As of Jan/2006 the "[295]-afteraccept command" option will run the command only after the VNC client has been accepted and authenticated. Like -gone the return code is not interpreted. RFB_MODE will be "afteraccept".) @@ -3934,7 +3947,7 @@ exit 1 display manager like gdm(1). Can I have x11vnc later switch to a different user? - As of Feb/2005 x11vnc has the [294]-users option that allows things + As of Feb/2005 x11vnc has the [296]-users option that allows things like this. Please read the documentation on it (also in the x11vnc -help output) carefully for features and caveats. It's use can often decrease security unless care is taken. @@ -3959,7 +3972,7 @@ exit 1 In any event, as of Jun/2004 there is an experimental utility to make it more difficult for nosey people to see your x11vnc activities. The - source for it is [295]blockdpy.c The idea behind it is simple (but + source for it is [297]blockdpy.c The idea behind it is simple (but obviously not bulletproof): when a VNC client attaches to x11vnc put the display monitor in the DPMS "off" state, if the DPMS state ever changes immediately start up the screen-lock program. The x11vnc user @@ -3975,8 +3988,8 @@ exit 1 bulletproof. A really robust solution would likely require X server and perhaps even video hardware support. - The blockdpy utility is launched by the [296]-accept option and told - to exit via the [297]-gone option (the vnc client user should + The blockdpy utility is launched by the [298]-accept option and told + to exit via the [299]-gone option (the vnc client user should obviously re-lock the screen before disconnecting!) Instructions can be found in the source code for the utility at the above link. Roughly it is something like this: @@ -3985,17 +3998,17 @@ exit 1 but please read the top of the file. Update: As of Feb/2007 there is some builtin support for this: - [298]-forcedpms and [299]-clientdpms however, they are probably less + [300]-forcedpms and [301]-clientdpms however, they are probably less robust than the above blockdpy.c scheme, since if the person floods the physical machine with mouse or pointer input he can usually see flashes of the screen before the monitor is powered off again. See - also the [300]-grabkbd, [301]-grabptr, and [302]-grabalways options. + also the [302]-grabkbd, [303]-grabptr, and [304]-grabalways options. Q-49: Can I have x11vnc automatically lock the screen when I disconnect the VNC viewer? - Yes, a user mentions he uses the [303]-gone option under CDE to run a + Yes, a user mentions he uses the [305]-gone option under CDE to run a screen lock program: x11vnc -display :0 -forever -gone 'dtaction LockDisplay' @@ -4005,7 +4018,7 @@ exit 1 x11vnc -display :0 -forever -gone 'xlock &' x11vnc -display :0 -forever -gone 'xlock -mode blank &' - Here is a scheme using the [304]-afteraccept option (in version 0.8) + Here is a scheme using the [306]-afteraccept option (in version 0.8) to unlock the screen after the first valid VNC login and to lock the screen after the last valid VNC login disconnects: x11vnc -display :0 -forever -shared -afteraccept ./myxlocker -gone ./myxlocke @@ -4046,21 +4059,21 @@ exec @ARGV; Q-50: How can I tunnel my connection to x11vnc via an encrypted SSH channel between two Unix machines? - See the description earlier on this page on [305]how to tunnel VNC via + See the description earlier on this page on [307]how to tunnel VNC via SSH from Unix to Unix. A number of ways are described along with some issues you may encounter. Other secure encrypted methods exists, e.g. stunnel, IPSEC, various VPNs, etc. - See also the [306]Enhanced TightVNC Viewer (SSVNC) page where much of + See also the [308]Enhanced TightVNC Viewer (SSVNC) page where much of this is now automated. Q-51: How can I tunnel my connection to x11vnc via an encrypted SSH channel from Windows using an SSH client like Putty? - [307]Above we described how to tunnel VNC via SSH from Unix to Unix, + [309]Above we described how to tunnel VNC via SSH from Unix to Unix, you may want to review it. To do this from Windows using Putty it would go something like this: * In the Putty dialog window under 'Session' enter the hostname or @@ -4081,11 +4094,11 @@ exec @ARGV; :0 (plus other cmdline options) in the 'Remote command' Putty setting under 'Connections/SSH'. - See also the [308]Enhanced TightVNC Viewer (SSVNC) page where much of + See also the [310]Enhanced TightVNC Viewer (SSVNC) page where much of this is now automated via the Putty plink utility. - For extra protection feel free to run x11vnc with the [309]-localhost - and [310]-rfbauth/[311]-passwdfile options. + For extra protection feel free to run x11vnc with the [311]-localhost + and [312]-rfbauth/[313]-passwdfile options. If the machine you SSH into via Putty is not the same machine with the X display you wish to view (e.g. your company provides incoming SSH @@ -4093,11 +4106,11 @@ exec @ARGV; dialog setting to: 'Destination: otherhost:5900', Once logged in, you'll need to do a second login (ssh or rsh) to the workstation machine 'otherhost' and then start up x11vnc on it. This can also be - automated by [312]Chaining SSH's. + automated by [314]Chaining SSH's. - As discussed [313]above another option is to first start the VNC + As discussed [315]above another option is to first start the VNC viewer in "listen" mode, and then launch x11vnc with the - "[314]-connect localhost" option to establish the reverse connection. + "[316]-connect localhost" option to establish the reverse connection. In this case a Remote port redirection (not Local) is needed for port 5500 instead of 5900 (i.e. 'Source port: 5500' and 'Destination: localhost:5500' for a Remote connection.) @@ -4107,7 +4120,7 @@ exec @ARGV; channel using an external tool like stunnel? It is possible to use a "lighter weight" encryption setup than SSH or - IPSEC. SSL tunnels such as [315]stunnel (also [316]stunnel.mirt.net) + IPSEC. SSL tunnels such as [317]stunnel (also [318]stunnel.mirt.net) provide an encrypted channel without the need for Unix users, passwords, and key passphrases required for ssh (and at the other extreme SSL can also provide a complete signed certificate chain of @@ -4115,9 +4128,9 @@ exec @ARGV; and firewalls often let its port through, ssh is frequently the path of least resistance (it also nicely manages public keys for you.) - Update: As of Feb/2006 x11vnc has the options [317]-ssl, - [318]-stunnel, and [319]-sslverify to provide integrated SSL schemes. - They are discussed [320]in the Next FAQ (you probably want to skip to + Update: As of Feb/2006 x11vnc has the options [319]-ssl, + [320]-stunnel, and [321]-sslverify to provide integrated SSL schemes. + They are discussed [322]in the Next FAQ (you probably want to skip to it now.) We include these non-built-in method descriptions below for historical @@ -4125,7 +4138,7 @@ exec @ARGV; any VNC (or other type of) server. - Here are some basic examples using [321]stunnel but the general idea + Here are some basic examples using [323]stunnel but the general idea for any SSL tunnel utility is the same: * Start up x11vnc and constrain it to listen on localhost. * Then start up the SSL tunnel running on the same machine to @@ -4149,7 +4162,7 @@ exec @ARGV; The above two commands are run on host "far-away.east". The stunnel.pem is the self-signed PEM file certificate created when - stunnel is built. One can also create certificates [322]signed by + stunnel is built. One can also create certificates [324]signed by Certificate Authorities or self-signed if desired using the x11vnc utilities described there. @@ -4163,21 +4176,21 @@ exec @ARGV; Then point the viewer to the local tunnel on port 5902: vncviewer -encodings "copyrect tight zrle hextile" localhost:2 - That's it. Note that the [323]ss_vncviewer script can automate this - easily, and so can the [324]Enhanced TightVNC Viewer (SSVNC) package. + That's it. Note that the [325]ss_vncviewer script can automate this + easily, and so can the [326]Enhanced TightVNC Viewer (SSVNC) package. Be sure to use a VNC password because unlike ssh by default the encrypted SSL channel provides no authentication (only privacy.) With some extra configuration one could also set up certificates to provide authentication of either or both sides as well (and hence avoid man-in-the-middle attacks.) See the stunnel and openssl documentation - and also [325]the key management section for details. + and also [327]the key management section for details. stunnel has also been ported to Windows, and there are likely others to choose from for that OS. Much info for using it on Windows can be - found at the stunnel site and in this [326]article The article also + found at the stunnel site and in this [328]article The article also shows the detailed steps to set up all the authentication - certificates. (for both server and clients, see also the [327]x11vnc + certificates. (for both server and clients, see also the [329]x11vnc utilities that do this.) The default Windows client setup (no certs) is simpler and only 4 files are needed in a folder: stunnel.exe, stunnel.conf, libssl32.dll, libeay32.dll. We used an stunnel.conf @@ -4198,7 +4211,7 @@ connect = far-away.east:5901 As an aside, if you don't like the little "gap" of unencrypted TCP traffic (and a localhost listening socket) on the local machine between stunnel and x11vnc it can actually be closed by having stunnel - start up x11vnc in [328]-inetd mode: + start up x11vnc in [330]-inetd mode: stunnel -p /path/to/stunnel.pem -P none -d 5900 -l ./x11vnc_sh Where the script x11vnc_sh starts up x11vnc: @@ -4235,28 +4248,28 @@ connect = 5900 SSL VNC Viewers: Regarding VNC viewers that "natively" do SSL unfortunately there do - not seem to be many. The [329]SingleClick UltraVNC Java Viewer is SSL - and is compatible with x11vnc's [330]-ssl option and stunnel.) + not seem to be many. The [331]SingleClick UltraVNC Java Viewer is SSL + and is compatible with x11vnc's [332]-ssl option and stunnel.) Commercial versions of VNC seem to have some SSL-like encryption built in, but we haven't tried those either and they probably wouldn't work since their (proprietary) SSL-like negotiation is likely embedded in the VNC protocol unlike our case where it is external. - Note: as of Mar/2006 libvncserver/x11vnc provides a [331]SSL-enabled - Java applet that can be served up via the [332]-httpdir or [333]-http - options when [334]-ssl is enabled. It will also be served via HTTPS + Note: as of Mar/2006 libvncserver/x11vnc provides a [333]SSL-enabled + Java applet that can be served up via the [334]-httpdir or [335]-http + options when [336]-ssl is enabled. It will also be served via HTTPS via either the VNC port (e.g. https://host:5900/) or a 2nd port via - the [335]-https option. + the [337]-https option. In general current SSL VNC solutions are not particularly "seemless". But it can be done, and with a wrapper script on the viewer side and - the [336]-stunnel or [337]-ssl option on the server side it works well - and is convenient. Here is a simple script [338]ss_vncviewer that + the [338]-stunnel or [339]-ssl option on the server side it works well + and is convenient. Here is a simple script [340]ss_vncviewer that automates running stunnel on the VNC viewer side on Unix a little more carefully than the commands printed above. (One could probably do a similar thing with a .BAT file on Windows in the stunnel folder.) - Update Jul/2006: we now provide an [339]Enhanced TightVNC Viewer + Update Jul/2006: we now provide an [341]Enhanced TightVNC Viewer (SSVNC) package that starts up STUNNEL automatically along with some other features. All binaries (stunnel, vncviewer, and some utilities) are provided in the package. It works on Unix, Mac OS X, and Windows. @@ -4264,7 +4277,7 @@ connect = 5900 Q-53: Does x11vnc have built-in SSL tunneling? - You can read about non-built-in methods [340]in the Previous FAQ for + You can read about non-built-in methods [342]in the Previous FAQ for background. SSL tunnels provide an encrypted channel without the need for Unix @@ -4276,12 +4289,12 @@ connect = 5900 Built-in SSL x11vnc options: - As of Feb/2006 the x11vnc [341]-ssl option automates the SSL tunnel - creation on the x11vnc server side. An [342]SSL-enabled Java Viewer + As of Feb/2006 the x11vnc [343]-ssl option automates the SSL tunnel + creation on the x11vnc server side. An [344]SSL-enabled Java Viewer applet is also provided that can be served via HTTP or HTTPS to automate SSL on the client side. - The [343]-ssl mode uses the [344]www.openssl.org library if available + The [345]-ssl mode uses the [346]www.openssl.org library if available at build time. The mode requires an SSL certificate and key (i.e. .pem file.) These @@ -4307,11 +4320,11 @@ connect = 5900 "-ssl SAVE_NOPROMPT" to not be prompted. Use "-ssl TMP" to create a temporary self-signed cert that will be discarded when x11vnc exits. - Update: As of Nov/2008 x11vnc also supports the [345]VeNCrypt SSL/TLS + Update: As of Nov/2008 x11vnc also supports the [347]VeNCrypt SSL/TLS tunnel extension to the VNC protocol. The older ANONTLS method (vino) is also supported. This support is on by default when the -ssl option - is in use and can be fine-tuned using these options: [346]-vencrypt - and [347]-anontls. + is in use and can be fine-tuned using these options: [348]-vencrypt + and [349]-anontls. The normal x11vnc -ssl operation is somewhat like a URL method vncs://hostname if vnc://hostname indicates a standard unencrypted VNC @@ -4323,7 +4336,7 @@ connect = 5900 SSL VNC Viewers:. Viewer-side will need to use SSL as well. See the - [348]next FAQ and [349]here for SSL enabled VNC Viewers, including + [350]next FAQ and [351]here for SSL enabled VNC Viewers, including SSVNC, to connect to the above x11vnc via SSL. @@ -4338,12 +4351,12 @@ connect = 5900 is to encrypt the key with a passphrase (note however this requires supplying the passphrase each time x11vnc is started up.) - See the discussion on [350]x11vnc Key Management for some utilities + See the discussion on [352]x11vnc Key Management for some utilities provided for creating and managing certificates and keys and even for creating your own Certificate Authority (CA) for signing VNC server and client certificates. This may be done by importing the certificate into Web Browser or Java plugin keystores, or pointing stunnel to it. - The wrapper script [351]ss_vncviewer provides an example on unix (see + The wrapper script [353]ss_vncviewer provides an example on unix (see the -verify option.) Here are some notes on the simpler default (non-CA) operation. To have @@ -4357,7 +4370,7 @@ connect = 5900 the possibility of copying the server.crt to machines where the VNC Viewer will be run to enable authenticating the x11vnc SSL VNC server to the clients. When authentication takes place this way (or via the - more sophisticated CA signing described [352]here), then + more sophisticated CA signing described [354]here), then Man-In-The-Middle-Attacks are prevented. Otherwise, the SSL encryption only provides protection against passive network traffic "sniffing" (i.e. you are not protected against M-I-T-M attacks.) Nowadays, most @@ -4389,11 +4402,11 @@ connect = 5900 The older -stunnel option: Before the -ssl option there was a - convenience option [353]-stunnel that would start an external SSL + convenience option [355]-stunnel that would start an external SSL tunnel for you using stunnel. The -ssl method is the preferred way, but for historical reference we keep the -stunnel info here. - The [354]-stunnel mode requires the [355]www.stunnel.org command + The [356]-stunnel mode requires the [357]www.stunnel.org command stunnel(8) to be installed on the system. Some -stunnel examples: @@ -4424,8 +4437,8 @@ connect = 5900 There aren't any native VNC Viewers that do SSL (ask your VNC viewer developer to add the feature.) So a tunnel must be setup that you point the VNC Viewer to. This is often STUNNEL. You can do this - [356]manually, or use the [357]ss_vncviewer script on Unix, or our - [358]Enhanced TightVNC Viewer (SSVNC) package on Unix, Windows, or + [358]manually, or use the [359]ss_vncviewer script on Unix, or our + [360]Enhanced TightVNC Viewer (SSVNC) package on Unix, Windows, or MacOSX. See the next section for Java Web browser SSL VNC Viewers (you only need a Java-enabled Web browser for it to work.) @@ -4437,13 +4450,13 @@ connect = 5900 The SSL enabled Java VNC Viewer (VncViewer.jar) in the x11vnc package supports only SSL based connections by default. As mentioned above the - [359]-httpdir can be used to specify the path to .../classes/ssl. A + [361]-httpdir can be used to specify the path to .../classes/ssl. A typical location might be /usr/local/share/x11vnc/classes/ssl. Or - [360]-http can be used to try to have it find the directory + [362]-http can be used to try to have it find the directory automatically. - Also note that the [361]SingleClick UltraVNC Java Viewer is compatible - with x11vnc's [362]-ssl SSL mode. (We tested it this way: "java -cp + Also note that the [363]SingleClick UltraVNC Java Viewer is compatible + with x11vnc's [364]-ssl SSL mode. (We tested it this way: "java -cp ./VncViewer.jar VncViewer HOST far-away.east PORT 5900 USESSL 1 TRUSTALL 1") @@ -4478,13 +4491,13 @@ connect = 5900 If you are using a router/firewall with port-redirection, and you are redirecting ports other than the default ones (5800, 5900) listed - above [363]see here. + above [365]see here. The https service provided thru the actual VNC port (5900 in the above example) can occasionally be slow or unreliable (it has to read some input and try to guess if the connection is VNC or HTTP.) If it is unreliable for you and you still want to serve the Java applet via - https, use the [364]-https option to get an additional port dedicated + https, use the [366]-https option to get an additional port dedicated to https (its URL will also be printed in the output.) Another possibility is to add the GET applet parameter: @@ -4497,7 +4510,7 @@ connect = 5900 You may also use "urlPrefix=somestring" to have /somestring prepended to /request.https.vnc.connection". Perhaps you are using a web server - [365]proxy scheme to enter a firewall or otherwise have rules applied + [367]proxy scheme to enter a firewall or otherwise have rules applied to the URL. If you need to have any slashes "/" in "somestring" use "_2F_" (a deficiency in libvncserver prevents using the more natural "%2F".) @@ -4590,12 +4603,12 @@ connect = 5900 Then, if you plan to use them, enable "fancy stuff" like "-svc" or "-unixpw", etc, etc. Be sure to add a password either "-rfbauth" or "-unixpw" or both. If you need to have the web browser use a corporate - [366]Web Proxy (i.e. it cannot connect directly) work on that last. - Ditto for the [367]Apache portal. + [368]Web Proxy (i.e. it cannot connect directly) work on that last. + Ditto for the [369]Apache portal. Router/Firewall port redirs: If you are doing port redirection at - your [368]router to an internal machine running x11vnc AND the + your [370]router to an internal machine running x11vnc AND the internet facing port is different from the internal machine's VNC port, you will need to apply the PORT applet parameter to indicate to the applet the Internet facing port number (otherwise by default the @@ -4605,7 +4618,7 @@ connect = 5900 So in this example the user configures his router to redirect connections to port 443 on his Internet side to, say, port 5900 on the - internal machine running x11vnc. See also the [369]-httpsredir option + internal machine running x11vnc. See also the [371]-httpsredir option that will try to automate this for you. To configure your router to do port redirection, see its instructions. @@ -4616,7 +4629,7 @@ connect = 5900 or Unix system acting as your firewall/router, see its firewall configuration. - You can also use x11vnc options [370]-rfbport NNNNN and [371]-httpport + You can also use x11vnc options [372]-rfbport NNNNN and [373]-httpport NNNNN to match the ports that your firewall will be redirecting to the machine where x11vnc is run. @@ -4645,12 +4658,12 @@ connect = 5900 NOT linger at. If you see in the x11vnc output a request for VncViewer.class instead of VncViewer.jar it is too late... you will need to completely restart the Web browser to get it to try for the - jar again. You can use the [372]-https option if you want a dedicated + jar again. You can use the [374]-https option if you want a dedicated port for HTTPS connections instead of sharing the VNC port. To see example x11vnc output for a successful https://host:5900/ - connection with the Java Applet see [373]This Page. And here is a - newer example [374]including the Java Console output. + connection with the Java Applet see [375]This Page. And here is a + newer example [376]including the Java Console output. All of the x11vnc Java Viewer applet parameters are described in the file classes/ssl/README @@ -4661,10 +4674,10 @@ connect = 5900 If you want to use a native VNC Viewer with the SSL enabled x11vnc you will need to run an external SSL tunnel on the Viewer side. There do not seem to be any native SSL VNC Viewers outside of our x11vnc and - [375]SSVNC packages. The basic ideas of doing this were discussed - [376]for external tunnel utilities here. + [377]SSVNC packages. The basic ideas of doing this were discussed + [378]for external tunnel utilities here. - The [377]ss_vncviewer script provided with x11vnc and SSVNC can set up + The [379]ss_vncviewer script provided with x11vnc and SSVNC can set up the stunnel tunnel automatically on unix as long as the stunnel command is installed on the Viewer machine and available in PATH (and vncviewer too of course.) Note that on a Debian based system you will @@ -4698,14 +4711,14 @@ connect = 5900 The fifth one shows that Web proxies can be used if that is the only way to get out of the firewall. If the "double proxy" situation arises - separate the two by commas. See [378]this page for more information on + separate the two by commas. See [380]this page for more information on how Web proxies come into play. - If one uses a Certificate Authority (CA) scheme described [379]here, + If one uses a Certificate Authority (CA) scheme described [381]here, the wrapper script would use the CA cert instead of the server cert: 3') ss_vncviewer -verify ./cacert.crt far-away.east:0 - Update Jul/2006: we now provide an [380]Enhanced TightVNC Viewer + Update Jul/2006: we now provide an [382]Enhanced TightVNC Viewer (SSVNC) package that starts up STUNNEL automatically along with some other features. All binaries (stunnel, vncviewer, and some utilities) are provided in the package. It works on Unix, Mac OS X, and Windows. @@ -4768,20 +4781,20 @@ connect = 5900 https://yourmachine.com/proxy.vnc?PORT=443 this is cleaner because it avoids editing the file, but requires more - parameters in the URL. See also the [381]-httpsredir x11vnc option - that will try to automate this for you. To use the GET [382]trick + parameters in the URL. See also the [383]-httpsredir x11vnc option + that will try to automate this for you. To use the GET [384]trick discussed above, do: https://yourmachine.com/proxy.vnc?GET=1&PORT=443 All of the x11vnc Java Viewer applet parameters are described in the file classes/ssl/README - Here is an example of Java Console and x11vnc output for the [383]Web + Here is an example of Java Console and x11vnc output for the [385]Web proxy case. - Note that both the [384]ss_vncviewer stunnel Unix wrapper script and - [385]Enhanced TightVNC Viewer (SSVNC) can use Web proxies as well even + Note that both the [386]ss_vncviewer stunnel Unix wrapper script and + [387]Enhanced TightVNC Viewer (SSVNC) can use Web proxies as well even though they do not involve a Web browser. @@ -4789,7 +4802,7 @@ connect = 5900 SSL from the Internet with a Web browser to x11vnc running on their workstations behind a firewall? Yes. You will need to configure apache to forward these connections. - It is discussed [386]here. This provides a clean alternative to the + It is discussed [388]here. This provides a clean alternative to the traditional method where the user uses SSH to log in through the gateway to create the encrypted port redirection to x11vnc running on her desktop. @@ -4797,7 +4810,7 @@ connect = 5900 Q-57: Can I create and use my own SSL Certificate Authority (CA) with x11vnc? - Yes, see [387]this page for how to do this and the utility commands + Yes, see [389]this page for how to do this and the utility commands x11vnc provides to create and manage many types of certificates and private keys. @@ -4816,14 +4829,14 @@ connect = 5900 need to have sufficient permissions to connect to the X display. Here are some ideas: - * Use the description under "Continuously" in the [388]FAQ on x11vnc + * Use the description under "Continuously" in the [390]FAQ on x11vnc and Display Managers - * Use the description in the [389]FAQ on x11vnc and inetd(8) - * Use the description in the [390]FAQ on Unix user logins and + * Use the description in the [391]FAQ on x11vnc and inetd(8) + * Use the description in the [392]FAQ on Unix user logins and inetd(8) * Start x11vnc from your $HOME/.xsession (or $HOME/.xinitrc or autostart script or ...) - * Although less reliable, see the [391]x11vnc_loop rc.local hack + * Although less reliable, see the [393]x11vnc_loop rc.local hack below. The display manager scheme will not be specific to which user has the @@ -4845,9 +4858,9 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg X startup scripts (traditionally .xsession/.xinitrc) may have to be in a different directory or have a different basename. One user recommends the description under 'Running Scripts Automatically' at - [392]this link. + [394]this link. - Firewalls: note all methods will require the host-level [393]firewall + Firewalls: note all methods will require the host-level [395]firewall to be configured to allow connections in on a port. E.g. 5900 (default VNC port) or 22 (default SSH port for tunnelling VNC.) Most systems these days have firewalls turned on by default, so you will actively @@ -4869,7 +4882,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg while running x11vnc as root, e.g. for the gnome display manager, gdm: x11vnc -auth /var/gdm/:0.Xauth -display :0 - (the [394]-auth option sets the XAUTHORITY variable for you.) + (the [396]-auth option sets the XAUTHORITY variable for you.) There will be a similar thing for xdm using however a different auth directory path (perhaps something like @@ -4897,10 +4910,10 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg (BTW, the auth file should be in /var/dt), you'll also need to add something like Dtlogin*grabServer:False to the Xconfig file (/etc/dt/config/Xconfig or /usr/dt/config/Xconfig on Solaris, see - [395]the example at the end of this FAQ.) Then restart dtlogin, e.g.: + [397]the example at the end of this FAQ.) Then restart dtlogin, e.g.: /etc/init.d/dtlogin stop; /etc/init.d/dtlogin start or reboot. - Update Nov/2008: Regarding GDM KillInitClients: see the [396]-reopen + Update Nov/2008: Regarding GDM KillInitClients: see the [398]-reopen option for another possible workaround. Update Oct/2009: Regarding GDM KillInitClients: starting with x11vnc @@ -4927,7 +4940,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg Please consider the security implications of this! The VNC display for the X session always accessible (but hopefully password protected.) - Add [397]-localhost if you only plan to access via a [398]SSH tunnel. + Add [399]-localhost if you only plan to access via a [400]SSH tunnel. The name of the display manager startup script file depends on desktop used and seem to be: @@ -4961,7 +4974,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg -forever -bg where you should customize the exact command to your needs (e.g. - [399]-localhost for SSH tunnel-only access; [400]-ssl SAVE for SSL + [401]-localhost for SSH tunnel-only access; [402]-ssl SAVE for SSL access; etc.) Happy, happy, joy, joy: Note that we do not need to specify -display @@ -4969,7 +4982,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg and XAUTHORITY environment variables for the Xsetup script!!! You may also want to force the VNC port with something like "-rfbport - 5900" (or [401]-N) to avoid autoselecting one if 5900 is already + 5900" (or [403]-N) to avoid autoselecting one if 5900 is already taken. _________________________________________________________________ @@ -4985,7 +4998,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg Then restart: /usr/sbin/gdm-restart (or reboot.) The KillInitClients=false setting is important: without it x11vnc will be - killed immediately after the user logs in. Here are [402]full details + killed immediately after the user logs in. Here are [404]full details on how to configure gdm _________________________________________________________________ @@ -5027,16 +5040,16 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg If you do not want to deal with any display manager startup scripts, here is a kludgey script that can be run manually or out of a boot - file like rc.local: [403]x11vnc_loop It will need some local + file like rc.local: [405]x11vnc_loop It will need some local customization before running. Because the XAUTHORITY auth file must be guessed by this script, use of the display manager script method - described above is greatly preferred. There is also the [404]-loop + described above is greatly preferred. There is also the [406]-loop option that does something similar. If the machine is a traditional Xterminal you may want to read - [405]this FAQ. + [407]this FAQ. - Firewalls: note all methods will require the host-level [406]firewall + Firewalls: note all methods will require the host-level [408]firewall to be configured to allow connections in on a port. E.g. 5900 (default VNC port) or 22 (default SSH port for tunnelling VNC.) Most systems these days have firewalls turned on by default, so you will actively @@ -5052,7 +5065,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg 5900 stream tcp nowait root /usr/sbin/tcpd /usr/local/bin/x11vnc_sh - where the shell script /usr/local/bin/x11vnc_sh uses the [407]-inetd + where the shell script /usr/local/bin/x11vnc_sh uses the [409]-inetd option and looks something like (you'll need to customize to your settings.) #!/bin/sh @@ -5065,7 +5078,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg and that confuses it greatly, causing it to abort.) If you do not use a wrapper script as above but rather call x11vnc directly in /etc/inetd.conf and do not redirect stderr to a file, then you must - specify the -q (aka [408]-quiet) option: "/usr/local/bin/x11vnc -q + specify the -q (aka [410]-quiet) option: "/usr/local/bin/x11vnc -q -inetd ...". When you supply both -q and -inet and no "-o logfile" then stderr will automatically be closed (to prevent, e.g. library stderr messages leaking out to the viewer.) The recommended practice @@ -5073,12 +5086,12 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg script with "2>logfile" redirection because the errors and warnings printed out are very useful in troubleshooting problems. - Note also the need to set XAUTHORITY via [409]-auth to point to the + Note also the need to set XAUTHORITY via [411]-auth to point to the MIT-COOKIE auth file to get permission to connect to the X display (setting and exporting the XAUTHORITY variable accomplishes the same thing.) See the x11vnc_loop file in the previous question for more ideas on what that auth file may be, etc. The scheme described in the - [410]FAQ on Unix user logins and inetd(8) works around the XAUTHORITY + [412]FAQ on Unix user logins and inetd(8) works around the XAUTHORITY issue nicely. Note: On Solaris you cannot have the bare number 5900 in @@ -5163,9 +5176,9 @@ exec /usr/local/bin/x11vnc -inetd -o /var/log/x11vnc.log -find -env FD_XDM=1 it automatically? Yes, as of Feb/2007 x11vnc supports mDNS / Zeroconf advertising of its - service via the Avahi client library. Use the option [411]-avahi (same - as [412]-mdns or [413]-zeroconf) to enable it. Depending on your setup - you may need to install [414]Avahi (including the development/build + service via the Avahi client library. Use the option [413]-avahi (same + as [414]-mdns or [415]-zeroconf) to enable it. Depending on your setup + you may need to install [416]Avahi (including the development/build packages), enable the server: avahi-daemon and avahi-dnsconfd, and possibly open up UDP port 5353 on your firewall. @@ -5194,32 +5207,32 @@ exec /usr/local/bin/x11vnc -inetd -o /var/log/x11vnc.log -find -env FD_XDM=1 machine and then connect to it? How about starting an X session if one cannot be found? - The easiest way to do this is via [415]inetd(8) using the [416]-unixpw - and [417]-display WAIT options. The reason inetd(8) makes this easier + The easiest way to do this is via [417]inetd(8) using the [418]-unixpw + and [419]-display WAIT options. The reason inetd(8) makes this easier is that it starts a new x11vnc process for each new user connection. Otherwise a wrapper would have to listen for connections and spawn new - x11vnc's (see [418]this example and also the [419]-loopbg option.) + x11vnc's (see [420]this example and also the [421]-loopbg option.) Also with inetd(8) users always connect to a fixed VNC display, say hostname:0, and do not need to memorize a special VNC display number just for their personal use, etc. - Update: Use the [420]-find, [421]-create, [422]-svc, and [423]-xdmsvc + Update: Use the [422]-find, [423]-create, [424]-svc, and [425]-xdmsvc options that are shorthand for common FINDCREATEDISPLAY usage modes (e.g. terminal services) described below. (i.e. just use "-svc" instead of "-display WAIT:cmd=FINDCREATEDISPLAY-Xvfb -unixpw -users unixpw= -ssl SAVE") - The [424]-display WAIT option makes x11vnc wait until a VNC viewer is + The [426]-display WAIT option makes x11vnc wait until a VNC viewer is connected before attaching to the X display. Additionally it can be used to run an external command that returns the DISPLAY and XAUTHORITY data. We provide some useful builtin ones (FINDDISPLAY and FINDCREATEDISPLAY below), but in principle one could supply "-display WAIT:cmd=/path/to/find_display" where the script find_display might - look something like [425]this. + look something like [427]this. A default script somewhat like the above is used under "-display - WAIT:cmd=FINDDISPLAY" (same as [426]-find) (use + WAIT:cmd=FINDDISPLAY" (same as [428]-find) (use "WAIT:cmd=FINDDISPLAY-print" to print out the gnarly script.) The format for any such command is that it returns DISPLAY=:disp as the first line and any remaining lines are either XAUTHORITY=file or raw @@ -5231,10 +5244,10 @@ exec /usr/local/bin/x11vnc -inetd -o /var/log/x11vnc.log -find -env FD_XDM=1 only X server process ID is known it appends ",XPID=n" (a chvt will be attempted by x11vnc.) - Tip: Note that the [427]-find option is an alias for "-display + Tip: Note that the [429]-find option is an alias for "-display WAIT:cmd=FINDDISPLAY". Use it! - The [428]-unixpw option allows [429]UNIX password logins. It + The [430]-unixpw option allows [431]UNIX password logins. It conveniently knows the Unix username whose X display should be found. Here are a couple /etc/inetd.conf examples for this: 5900 stream tcp nowait nobody /usr/sbin/tcpd /usr/local/bin/x11vnc -inetd @@ -5248,16 +5261,16 @@ xpw= Note the very long lines have been split. An alternative is to use a wrapper script, e.g. /usr/local/bin/x11vnc.sh that has all of the - options. (see also the [430]-svc alias.) + options. (see also the [432]-svc alias.) In the first one x11vnc is run as user "nobody" and stays user nobody during the whole session. The permissions of the log files and certs directory will need to be set up to allow "nobody" to use them. In the second one x11vnc is run as root and switches to the user that - logs in due to the "[431]-users unixpw=" option. + logs in due to the "[433]-users unixpw=" option. - Note that [432]SSL is required for this mode because otherwise the + Note that [434]SSL is required for this mode because otherwise the Unix password would be passed in clear text over the network. In general -unixpw is not required for this sort of scheme, but it is convenient because it determines exactly who the Unix user is whose @@ -5265,17 +5278,17 @@ xpw= to use some method to work out DISPLAY, XAUTHORITY, etc (perhaps you use multiple inetd ports and hardwire usernames for different ports.) - If you really want to disable the SSL or SSH [433]-localhost + If you really want to disable the SSL or SSH [435]-localhost constraints (this is not recommended unless you really know what you are doing: Unix passwords sent in clear text is a very bad idea...) - read the [434]-unixpw documentation. + read the [436]-unixpw documentation. A inetd(8) scheme for a fixed user that doesn't use SSL or unix passwds could be: /usr/local/bin/x11vnc -inetd -users =fred -find -rfbauth /home/fred/.vnc/passwd -o /var/log/x11vnc.log - The "[435]-users =fred" option will cause x11vnc to switch to user + The "[437]-users =fred" option will cause x11vnc to switch to user fred and then find his X display. @@ -5284,7 +5297,7 @@ xpw= FINDDISPLAY method it will create an X server session for the user (i.e. desktop/terminal server.) This is the only time x11vnc actually tries to start up an X server. By default it will only try to start up - virtual (non-hardware) X servers: first [436]Xdummy and if that is not + virtual (non-hardware) X servers: first [438]Xdummy and if that is not available then Xvfb. Note that Xdummy requires root permission and only works on Linux whereas Xvfb works just about everywhere. @@ -5294,13 +5307,13 @@ xpw= -ssl SAVE -unixpw -users unixpw= -display WAIT:cmd=FINDCREATEDISPLAY Where the very long lines have been split. This will allow direct SSL - (e.g. [437]ss_vncviewer) access and also Java Web browers access via: + (e.g. [439]ss_vncviewer) access and also Java Web browers access via: https://hostname:5900/. - Tip: Note that the [438]-create option is an alias for "-display + Tip: Note that the [440]-create option is an alias for "-display WAIT:cmd=FINDCREATEDISPLAY-Xvfb". - Tip: Note that [439]-svc is a short hand for the long "-ssl SAVE + Tip: Note that [441]-svc is a short hand for the long "-ssl SAVE -unixpw -users unixpw= -display WAIT:cmd=FINDCREATEDISPLAY" part. Unlike -create, this alias also sets up SSL encryption and Unix password login. The above example then simplifies to: @@ -5308,7 +5321,7 @@ xpw= -o /var/log/x11vnc.log -http -prog /usr/local/bin/x11vnc -svc Tip: In addition to the usual unixpw parameters, the user can specify - after his username (following a ":" see [440]-display WAIT for + after his username (following a ":" see [442]-display WAIT for details) for FINDCREATEDISPLAY they can add "geom=WxH" or "geom=WxHxD" to specify the width, height, and optionally the color depth. E.g. "fred:geom=800x600" at the login: prompt. Also if the env. var @@ -5349,7 +5362,7 @@ bin/x11vnc -svc WAIT:cmd=FINDCREATEDISPLAY-X,Xvfb,Xdummy". The "X" one means to try to start up a real, hardware X server, e.g. startx(1) (if there is already a real X server running this may only work on Linux and the - chvt program may [441]need to be run to switch to the correct Linux + chvt program may [443]need to be run to switch to the correct Linux virtual terminal.) x11vnc will try to run chvt automatically if it can determine which VT should be switched to. @@ -5376,7 +5389,7 @@ bin/x11vnc -svc will also typically block UDP (port 177 for XDMCP) by default effectively limiting the UDP connections to localhost. - Tip: Note that [442]-xdmsvc is a short hand for the long "-ssl SAVE + Tip: Note that [444]-xdmsvc is a short hand for the long "-ssl SAVE -unixpw -users unixpw= -display WAIT:cmd=FINDCREATEDISPLAY-Xvfb.xdmcp" part. E.g.: service x11vnc @@ -5443,15 +5456,15 @@ t:5 Q-63: Can I have x11vnc restart itself after it terminates? One could do this in a shell script, but now there is an option - [443]-loop that makes it easier. Of course when x11vnc restarts it + [445]-loop that makes it easier. Of course when x11vnc restarts it needs to have permissions to connect to the (potentially new) X display. This mode could be useful if the X server restarts often. Use e.g. "-loop5000" to sleep 5000 ms between restarts. Also "-loop2000,5" to sleep 2000 ms and only restart 5 times. - One can also use the [444]-loopbg to emulate inetd(8) to some degree, + One can also use the [446]-loopbg to emulate inetd(8) to some degree, where each connected process runs in the background. It could be - combined, say, with the [445]-svc option to provide simple terminal + combined, say, with the [447]-svc option to provide simple terminal services without using inetd(8). @@ -5459,7 +5472,7 @@ t:5 web browser? To have x11vnc serve up a Java VNC viewer applet to any web browsers - that connect to it, run x11vnc with this [446]option: + that connect to it, run x11vnc with this [448]option: -httpdir /path/to/the/java/classes/dir (this directory will contain the files index.vnc and, for example, @@ -5478,7 +5491,7 @@ t:5 then you can connect to that URL with any Java enabled browser. Feel free to customize the default index.vnc file in the classes directory. - As of May/2005 the [447]-http option will try to guess where the Java + As of May/2005 the [449]-http option will try to guess where the Java classes jar file is by looking in expected locations and ones relative to the x11vnc binary. @@ -5487,7 +5500,7 @@ t:5 either the java or appletviewer commands to run the program. java -cp ./VncViewer.jar VncViewer HOST far-away.east PORT 5900 - Proxies: See the [448]discussion here if the web browser must use a + Proxies: See the [450]discussion here if the web browser must use a web proxy to connect to the internet. It is tricky to get Java applets to work in this case: a signed applet must be used so it can connect to the proxy and ask for the redirection to the VNC server. One way to @@ -5503,7 +5516,7 @@ t:5 As of Mar/2004 x11vnc supports reverse connections. On Unix one starts the VNC viewer in listen mode: "vncviewer -listen" (see your documentation for Windows, etc), and then starts up x11vnc with the - [449]-connect option. To connect immediately at x11vnc startup time + [451]-connect option. To connect immediately at x11vnc startup time use the "-connect host:port" option (use commas for a list of hosts to connect to.) The ":port" is optional (default is VNC listening port is 5500.) @@ -5512,11 +5525,11 @@ t:5 file is checked periodically (about once a second) for new hosts to connect to. - The [450]-remote control option (aka -R) can also be used to do this + The [452]-remote control option (aka -R) can also be used to do this during an active x11vnc session, e.g.: x11vnc -display :0 -R connect:hostname.domain - Use the "[451]-connect_or_exit" option to have x11vnc exit if the + Use the "[453]-connect_or_exit" option to have x11vnc exit if the reverse connection fails. Also, note the "-rfbport 0" option disables TCP listening for connections (potentially useful for reverse connection mode, assuming you do not want any "forward" connections.) @@ -5529,7 +5542,7 @@ x11vnc -display :0 -R connect:hostname.domain X11VNC_REVERSE_CONNECTION_NO_AUTH=1" to x11vnc. Vncconnect command: To use the vncconnect(1) program (from the core - VNC package at www.realvnc.com) specify the [452]-vncconnect option to + VNC package at www.realvnc.com) specify the [454]-vncconnect option to x11vnc (Note: as of Dec/2004 -vncconnect is now the default.) vncconnect(1) must be pointed to the same X11 DISPLAY as x11vnc (since it uses X properties to communicate with x11vnc.) If you do not have @@ -5548,7 +5561,7 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" proxy or SSH? Yes, as of Oct/2007 x11vnc supports reverse connections through - proxies: use the "[453]-proxy host:port" option. The default is to + proxies: use the "[455]-proxy host:port" option. The default is to assume the proxy is a Web proxy. Note that most Web proxies only allow proxy destination connections to ports 443 (HTTPS) and 563 (SNEWS) and so this might not be too useful unless the proxy has been modified @@ -5568,11 +5581,11 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" connections. An experimental mode is "-proxy http://host:port/..." where the URL - (e.g. a CGI script) is retrieved via the GET method. See [454]-proxy + (e.g. a CGI script) is retrieved via the GET method. See [456]-proxy for more info. Another experimental mode is "-proxy ssh://user@host" in which case a - SSH tunnel is used for the proxying. See [455]-proxy for more info. + SSH tunnel is used for the proxying. See [457]-proxy for more info. Up to 3 proxies may be chained together by listing them by commas e.g.: "-proxy http://host1:port1,socks5://host2:port2" in case one @@ -5595,10 +5608,10 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" Driver in XFree86/Xorg (see below.) In either case, one can view this desktop both remotely and also - [456]locally using vncviewer. Make sure vncviewer's "-encodings raw" + [458]locally using vncviewer. Make sure vncviewer's "-encodings raw" is in effect for local viewing (compression seems to slow things down locally.) For local viewing you set up a "bare" window manager that - just starts up vncviewer and nothing else ([457]See how below.) + just starts up vncviewer and nothing else ([459]See how below.) Here is one way to start up Xvfb: xinit -- /usr/X11R6/bin/Xvfb :1 -cc 4 -screen 0 1024x768x16 @@ -5618,19 +5631,19 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" "screen scrape" it very efficiently (more than, say, 100X faster than normal video hardware.) - Update Nov/2006: See the [458]FINDCREATEDISPLAY discussion of the - "[459]-display WAIT:cmd=FINDDISPLAY" option where virtual (Xvfb or + Update Nov/2006: See the [460]FINDCREATEDISPLAY discussion of the + "[461]-display WAIT:cmd=FINDDISPLAY" option where virtual (Xvfb or Xdummy, or even real ones by changing an option) X servers are started automatically for new users connecting. This provides a "desktop service" for the machine. You either get your real X session or your virtual (Xvfb/Xdummy) one whenever you connect to the machine - (inetd(8) is a nice way to provide this service.) The [460]-find, - [461]-create, [462]-svc, and [463]-xdmsvc aliases can also come in + (inetd(8) is a nice way to provide this service.) The [462]-find, + [463]-create, [464]-svc, and [465]-xdmsvc aliases can also come in handy here. There are some annoyances WRT Xvfb however. The default keyboard mapping seems to be very poor. One should run x11vnc with - [464]-add_keysyms option to have keysyms added automatically. Also, to + [466]-add_keysyms option to have keysyms added automatically. Also, to add the Shift_R and Control_R modifiers something like this is needed: #!/bin/sh xmodmap -e "keycode any = Shift_R" @@ -5642,7 +5655,7 @@ xmodmap -e "keycode any = Alt_R" xmodmap -e "keycode any = Meta_L" xmodmap -e "add Mod1 = Alt_L Alt_R Meta_L" - (note: these are applied automatically in the [465]FINDCREATEDISPLAY + (note: these are applied automatically in the [467]FINDCREATEDISPLAY mode of x11vnc.) Perhaps the Xvfb options -xkbdb or -xkbmap could be used to get a better default keyboard mapping... @@ -5657,11 +5670,11 @@ xmodmap -e "add Mod1 = Alt_L Alt_R Meta_L" The main drawback to this method (besides requiring extra configuration and possibly root permission) is that it also does the - Linux Virtual Console/Terminal (VC/VT) [466]switching even though it + Linux Virtual Console/Terminal (VC/VT) [468]switching even though it does not need to (since it doesn't use a real framebuffer.) There are some "dual headed" (actually multi-headed/multi-user) patches to the X server that turn off the VT usage in the X server. Update: As of - Jul/2005 we have an LD_PRELOAD script [467]Xdummy that allows you to + Jul/2005 we have an LD_PRELOAD script [469]Xdummy that allows you to use a stock (i.e. unpatched) Xorg or XFree86 server with the "dummy" driver and not have any VT switching problems! Currently Xdummy needs to be run as root, but with some luck that may be relaxed in the @@ -5689,7 +5702,7 @@ x11vnc -display :5 -rfbport 5905 -bg vncviewer -geometry +0+0 -encodings raw -passwd $HOME/.vnc/passwd localhost:5 The display numbers (VNC and X) will likely be different (you could - also try [468]-find), and you may not need the -passwd. Recent RealVNC + also try [470]-find), and you may not need the -passwd. Recent RealVNC viewers might be this: #!/bin/sh x11vnc -display :5 -rfbport 5905 -bg @@ -5705,7 +5718,7 @@ t:5 For the general replacement of Xvnc by Xvfb+x11vnc, one user describes - a similar setup he created [469]here. + a similar setup he created [471]here. Q-68: How can I use x11vnc on "headless" machines? Why might I want @@ -5720,7 +5733,7 @@ t:5 An X server can be started on the headless machine (sometimes this requires configuring the X server to not fail if it cannot detect a keyboard or mouse, see the next paragraph.) Then you can export that X - display via x11vnc (e.g. see [470]this FAQ) and access it from + display via x11vnc (e.g. see [472]this FAQ) and access it from anywhere on the network via a VNC viewer. Some tips on getting X servers to start on machines without keyboard @@ -5744,10 +5757,10 @@ t:5 cards as it can hold to provide multiple simultaneous access or testing on different kinds of video hardware. - See also the [471]FINDCREATEDISPLAY discussion of the "[472]-display + See also the [473]FINDCREATEDISPLAY discussion of the "[474]-display WAIT:cmd=FINDDISPLAY" option where virtual Xvfb or Xdummy, or real X servers are started automatically for new users connecting. The - [473]-find, [474]-create, [475]-svc, and [476]-xdmsvc aliases can also + [475]-find, [476]-create, [477]-svc, and [478]-xdmsvc aliases can also come in handy here. [Resource Usage and Performance] @@ -5770,7 +5783,7 @@ t:5 19/03/2004 10:10:58 error creating tile-row shm for len=4 19/03/2004 10:10:58 reverting to single_copytile mode - Here is a shell script [477]shm_clear to list and prompt for removal + Here is a shell script [479]shm_clear to list and prompt for removal of your unattached shm segments (attached ones are skipped.) I use it while debugging x11vnc (I use "shm_clear -y" to assume "yes" for each prompt.) If x11vnc is regularly not cleaning up its shm segments, @@ -5804,44 +5817,44 @@ ied) in /etc/system. See the next paragraph for more workarounds. To minimize the number of shm segments used by x11vnc try using the - [478]-onetile option (corresponds to only 3 shm segments used, and + [480]-onetile option (corresponds to only 3 shm segments used, and adding -fs 1.0 knocks it down to 2.) If you are having much trouble with shm segments, consider disabling shm completely via the - [479]-noshm option. Performance will be somewhat degraded but when + [481]-noshm option. Performance will be somewhat degraded but when done over local machine sockets it should be acceptable (see an - [480]earlier question discussing -noshm.) + [482]earlier question discussing -noshm.) Q-70: How can I make x11vnc use less system resources? - The [481]-nap (now on by default; use -nonap to disable) and - "[482]-wait n" (where n is the sleep between polls in milliseconds, + The [483]-nap (now on by default; use -nonap to disable) and + "[484]-wait n" (where n is the sleep between polls in milliseconds, the default is 30 or so) option are good places to start. In addition, - something like "[483]-sb 15" will cause x11vnc to go into a deep-sleep + something like "[485]-sb 15" will cause x11vnc to go into a deep-sleep mode after 15 seconds of no activity (instead of the default 60.) Reducing the X server bits per pixel depth (e.g. to 16bpp or even 8bpp) will further decrease memory I/O and network I/O. The ShadowFB X server setting will make x11vnc's screen polling less severe. Using - the [484]-onetile option will use less memory and use fewer shared - memory slots (add [485]-fs 1.0 for one less slot.) + the [486]-onetile option will use less memory and use fewer shared + memory slots (add [487]-fs 1.0 for one less slot.) Q-71: How can I make x11vnc use MORE system resources? - You can try [486]-threads (note this mode can be unstable and/or + You can try [488]-threads (note this mode can be unstable and/or crash; and as of May/2008 is strongly discouraged, see the option description) or dial down the wait time (e.g. -wait 1) and possibly - dial down [487]-defer as well. Note that if you try to increase the + dial down [489]-defer as well. Note that if you try to increase the "frame rate" too much you can bog down the server end with the extra work it needs to do compressing the framebuffer data, etc. That said, it is possible to "stream" video via x11vnc if the video window is small enough. E.g. a 256x192 xawtv TV capture window (using - the x11vnc [488]-id option) can be streamed over a LAN or wireless at + the x11vnc [490]-id option) can be streamed over a LAN or wireless at a reasonable frame rate. If the graphics card's framebuffer read rate - is [489]faster than normal then the video window size and frame rate - can be much higher. The use of [490]TurboVNC and/or TurboJPEG can make + is [491]faster than normal then the video window size and frame rate + can be much higher. The use of [492]TurboVNC and/or TurboJPEG can make the frame rate somewhat higher still (but most of this hinges on the graphics card's read rate.) @@ -5858,7 +5871,7 @@ ied) * Use a smaller desktop size (e.g. 1024x768 instead of 1280x1024) * Make sure the desktop background is a solid color (the background is resent every time it is re-exposed.) Consider using the - [491]-solid [color] option to try to do this automatically. + [493]-solid [color] option to try to do this automatically. * Configure your window manager or desktop "theme" to not use fancy images, shading, and gradients for the window decorations, etc. Disable window animations, etc. Maybe your desktop has a "low @@ -5867,9 +5880,9 @@ ied) -> Use Smooth Scrolling (deselect it.) * Avoid small scrolls of large windows using the Arrow keys or scrollbar. Try to use PageUp/PageDown instead. (not so much of a - problem in x11vnc 0.7.2 if [492]-scrollcopyrect is active and + problem in x11vnc 0.7.2 if [494]-scrollcopyrect is active and detecting scrolls for the application.) - * If the [493]-wireframe option is not available (earlier than + * If the [495]-wireframe option is not available (earlier than x11vnc 0.7.2 or you have disabled it via -nowireframe) then Disable Opaque Moves and Resizes in the window manager/desktop. * However if -wireframe is active (on by default in x11vnc 0.7.2) @@ -5892,7 +5905,7 @@ ied) noticed. VNC viewer parameters: - * Use a [494]TightVNC enabled viewer! (Actually, RealVNC 4.x viewer + * Use a [496]TightVNC enabled viewer! (Actually, RealVNC 4.x viewer with ZRLE encoding is not too bad either; some claim it is faster.) * Make sure the tight (or zrle) encoding is being used (look at @@ -5900,7 +5913,7 @@ ied) * Request 8 bits per pixel using -bgr233 (up to 4X speedup over depth 24 TrueColor (32bpp), but colors will be off) * RealVNC 4.x viewer has some extremely low color modes (only 64 and - even 8 colors.) [495]SSVNC does too. The colors are poor, but it + even 8 colors.) [497]SSVNC does too. The colors are poor, but it is usually noticeably faster than bgr233 (256 colors.) * Try increasing the TightVNC -compresslevel (compresses more on server side before sending, but uses more CPU) @@ -5914,37 +5927,39 @@ ied) file. x11vnc parameters: - * Make sure the [496]-wireframe option is active (it should be on by + * Make sure the [498]-wireframe option is active (it should be on by default) and you have Opaque Moves/Resizes Enabled in the window manager. - * Make sure the [497]-scrollcopyrect option is active (it should be + * Make sure the [499]-scrollcopyrect option is active (it should be on by default.) This detects scrolls in many (but not all) applications an applies the CopyRect encoding for a big speedup. * Enforce a solid background when VNC viewers are connected via - [498]-solid - * Specify [499]-speeds modem to force the wireframe and + [500]-solid + * Try x11vnc's client-side caching [501]client-side caching scheme: + [502]-ncache + * Specify [503]-speeds modem to force the wireframe and scrollcopyrect heuristic parameters (and any future ones) to those of a dialup modem connection (or supply the rd,bw,lat numerical values that characterize your link.) * If wireframe and scrollcopyrect aren't working, try using the more - drastic [500]-nodragging (no screen updates when dragging mouse, + drastic [504]-nodragging (no screen updates when dragging mouse, but sometimes you miss visual feedback) - * Set [501]-fs 1.0 (disables fullscreen updates) - * Try increasing [502]-wait or [503]-defer (reduces the maximum + * Set [505]-fs 1.0 (disables fullscreen updates) + * Try increasing [506]-wait or [507]-defer (reduces the maximum "frame rate", but won't help much for large screen changes) - * Try the [504]-progressive pixelheight mode with the block + * Try the [508]-progressive pixelheight mode with the block pixelheight 100 or so (delays sending vertical blocks since they may change while viewer is receiving earlier ones) - * If you just want to watch one (simple) window use [505]-id (cuts - down extraneous polling and updates, but can be buggy or - insufficient) - * Set [506]-nosel (disables all clipboard selection exchange) - * Use [507]-nocursor and [508]-nocursorpos (repainting the remote + * If you just want to watch one (simple) window use [509]-id or + [510]-appshare (cuts down extraneous polling and updates, but can + be buggy or insufficient) + * Set [511]-nosel (disables all clipboard selection exchange) + * Use [512]-nocursor and [513]-nocursorpos (repainting the remote cursor position and shape takes resources and round trips) * On very slow links (e.g. <= 28.8) you may need to increase the - [509]-readtimeout n setting if it sometimes takes more than 20sec + [514]-readtimeout n setting if it sometimes takes more than 20sec to paint the full screen, etc. - * Do not use [510]-fixscreen to automatically refresh the whole + * Do not use [515]-fixscreen to automatically refresh the whole screen, tap three Alt_L's then the screen has painting errors (rare problem.) @@ -6013,7 +6028,7 @@ ied) Note that the DAMAGE extension does not speed up the actual reading of pixels from the video card framebuffer memory, by, say, mirroring them - in main memory. So reading the fb is still painfully [511]slow (e.g. + in main memory. So reading the fb is still painfully [516]slow (e.g. 5MB/sec), and so even using X DAMAGE when large changes occur on the screen the bulk of the time is still spent retrieving them. Not ideal, but use of the ShadowFB XFree86/Xorg option speeds up the reading @@ -6031,45 +6046,45 @@ ied) DAMAGE rectangles to contain real damage. The larger rectangles are only used as hints to focus the traditional scanline polling (i.e. if a scanline doesn't intersect a recent DAMAGE rectangle, the scan is - skipped.) You can use the "[512]-xd_area A" option to adjust the size + skipped.) You can use the "[517]-xd_area A" option to adjust the size of the trusted DAMAGE rectangles. The default is 20000 pixels (e.g. a 140x140 square, etc.) Use "-xd_area 0" to disable the cutoff and trust all DAMAGE rectangles. - The option "[513]-xd_mem f" may also be of use in tuning the - algorithm. To disable using DAMAGE entirely use "[514]-noxdamage". + The option "[518]-xd_mem f" may also be of use in tuning the + algorithm. To disable using DAMAGE entirely use "[519]-noxdamage". Q-74: My OpenGL application shows no screen updates unless I supply the -noxdamage option to x11vnc. One user reports in his environment (MythTV using the NVIDIA OpenGL drivers) he gets no updates after the initial screen is drawn unless - he uses the "[515]-noxdamage" option. + he uses the "[520]-noxdamage" option. This seems to be a bug in the X DAMAGE implementation of that driver. You may have to use -noxdamage as well. A way to autodetect this will be tried, probably the best it will do is automatically stop using X DAMAGE. - A developer for [516]MiniMyth reports that the 'alphapulse' tag of the + A developer for [521]MiniMyth reports that the 'alphapulse' tag of the theme G.A.N.T. can also cause problems, and should be avoided when using VNC. - Update: see [517]this FAQ too. + Update: see [522]this FAQ too. Q-75: When I drag windows around with the mouse or scroll up and down things really bog down (unless I do the drag in a single, quick motion.) Is there anything to do to improve things? - This problem is primarily due to [518]slow hardware read rates from + This problem is primarily due to [523]slow hardware read rates from video cards: as you scroll or move a large window around the screen changes are much too rapid for x11vnc to keep up them (it can usually only read the video card at about 5-10 MB/sec, so it can take a good fraction of a second to read the changes induce from moving a large window, if this to be done a number of times in succession the window or scroll appears to "lurch" forward.) See the description in the - [519]-pointer_mode option for more info. The next bottleneck is + [524]-pointer_mode option for more info. The next bottleneck is compressing all of these changes and sending them out to connected viewers, however the VNC protocol is pretty much self-adapting with respect to that (updates are only packaged and sent when viewers ask @@ -6079,27 +6094,27 @@ ied) default should now be much better than before and dragging small windows around should no longer be a huge pain. If for some reason these changes make matters worse, you can go back to the old way via - the "[520]-pointer_mode 1" option. + the "[525]-pointer_mode 1" option. - Also added was the [521]-nodragging option that disables all screen + Also added was the [526]-nodragging option that disables all screen updates while dragging with the mouse (i.e. mouse motion with a button held down.) This gives the snappiest response, but might be undesired in some circumstances when you want to see the visual feedback while dragging (e.g. menu traversal or text selection.) - As of Dec/2004 the [522]-pointer_mode n option was introduced. n=1 is + As of Dec/2004 the [527]-pointer_mode n option was introduced. n=1 is the original mode, n=2 an improvement, etc.. See the -pointer_mode n help for more info. - Also, in some circumstances the [523]-threads option can improve + Also, in some circumstances the [528]-threads option can improve response considerably. Be forewarned that if more than one vncviewer is connected at the same time then libvncserver may not be thread safe (try to get the viewers to use different VNC encodings, e.g. tight and ZRLE.) This option can be unstable and so as of Feb/2008 it is disabled by default. Set env. X11VNC_THREADED=1 to re-enable. - As of Apr/2005 two new options (see the [524]wireframe FAQ and - [525]scrollcopyrect FAQ below) provide schemes to sweep this problem + As of Apr/2005 two new options (see the [529]wireframe FAQ and + [530]scrollcopyrect FAQ below) provide schemes to sweep this problem under the rug for window moves or resizes and for some (but not all) window scrolls. These are the preferred way of avoiding the "lurching" problem, contact me if they are not working. Note on SuSE and some @@ -6123,8 +6138,8 @@ EndSection the window move/resize stops, it returns to normal processing: you should only see the window appear in the new position. This spares you from interacting with a "lurching" window between all of the - intermediate steps. BTW the lurching is due to [526]slow video card - read rates (see [527]here too.) A displacement, even a small one, of a + intermediate steps. BTW the lurching is due to [531]slow video card + read rates (see [532]here too.) A displacement, even a small one, of a large window requires a non-negligible amount of time, a good fraction of a second, to read in from the hardware framebuffer. @@ -6132,7 +6147,7 @@ EndSection for -wireframe to do any good. The mode is currently on by default because most people are afflicted - with the problem. It can be disabled with the [528]-nowireframe option + with the problem. It can be disabled with the [533]-nowireframe option (aka -nowf.) Why might one want to turn off the wireframing? Since x11vnc is merely guessing when windows are being moved/resized, it may guess poorly for your window-manager or desktop, or even for the way @@ -6178,13 +6193,13 @@ EndSection * Maximum time to show a wireframe animation. * Minimum time between sending wireframe outlines. - See the [529]"-wireframe tweaks" option for more details. On a slow + See the [534]"-wireframe tweaks" option for more details. On a slow link, e.g. dialup modem, the parameters may be automatically adjusted for better response. CopyRect encoding: In addition to the above there is the - [530]"-wirecopyrect mode" option. It is also on by default. This + [535]"-wirecopyrect mode" option. It is also on by default. This instructs x11vnc to not only show the wireframe animation, but to also instruct all connected VNC viewers to locally translate the window image data from the original position to the new position on the @@ -6232,7 +6247,7 @@ EndSection requiring the image data to be transmitted over the network. For fast links the speedup is primarily due to x11vnc not having to read the scrolled framebuffer data from the X server (recall that reading from - the hardware framebuffer is [531]slow.) + the hardware framebuffer is [536]slow.) To do this x11vnc uses the RECORD X extension to snoop the X11 protocol between the X client with the focus window and the X server. @@ -6259,10 +6274,10 @@ EndSection the X server display: if one falls too far behind it could become a mess... - The initial implementation of [532]-scrollcopyrect option is useful in + The initial implementation of [537]-scrollcopyrect option is useful in that it detects many scrolls and thus gives a much nicer working - environment (especially when combined with the [533]-wireframe - [534]-wirecopyrect [535]options, which are also on by default; and if + environment (especially when combined with the [538]-wireframe + [539]-wirecopyrect [540]options, which are also on by default; and if you are willing to enable the ShadowFB things are very fast.) The fact that there aren't long delays or lurches during scrolling is the primary improvement. @@ -6295,10 +6310,10 @@ EndSection One can tap the Alt_L key (Left "Alt" key) 3 times in a row to signal x11vnc to refresh the screen to all viewers. Your VNC-viewer may have its own screen refresh hot-key or button. See - also: [536]-fixscreen + also: [541]-fixscreen * Some applications, notably OpenOffice, do XCopyArea scrolls in weird ways that assume ancestor window clipping is taking place. - See the [537]-scr_skip option for ways to tweak this on a + See the [542]-scr_skip option for ways to tweak this on a per-application basis. * Selecting text while dragging the mouse may be slower, especially if the Button-down event happens near the window's edge. This is @@ -6315,7 +6330,7 @@ EndSection because it fails to detect scrolls in it. Sometimes clicking inside the application window or selecting some text in it to force the focus helps. - * When using the [538]-scale option there will be a quick CopyRect + * When using the [543]-scale option there will be a quick CopyRect scroll, but it needs to be followed by a slower "cleanup" update. This is because for a fixed finite screen resolution (e.g. 75 dpi) scaling and copyrect-ing are not exactly independent. Scaling @@ -6328,7 +6343,7 @@ EndSection If you find the -scrollcopyrect behavior too approximate or distracting you can go back to the standard polling-only update method - with the [539]-noscrollcopyrect (or -noscr for short.) If you find + with the [544]-noscrollcopyrect (or -noscr for short.) If you find some extremely bad and repeatable behavior for -scrollcopyrect please report a bug. @@ -6353,9 +6368,9 @@ EndSection that pixel data is needed again it does not have to be retransmitted over the network. - As of Dec/2006 in the [540]0.9 development tarball there is an + As of Dec/2006 in the [545]0.9 development tarball there is an experimental client-side caching implementation enabled by the - "[541]-ncache n" option. In fact, during the test period it was on by + "[546]-ncache n" option. In fact, during the test period it was on by default with n set to 10. To disable it use "-noncache". It is a simple scheme where a (very large) lower portion of the @@ -6382,7 +6397,7 @@ EndSection there is a bug: you can scroll down in your viewer and see a strange "history" of windows on your desktop. This is working as intended. One will need to try to adjust the size of his VNC Viewer window so the - cache area cannot be seen. [542]SSVNC (see below) can do this + cache area cannot be seen. [547]SSVNC (see below) can do this automatically. At some point LibVNCServer may implement a "rfbFBCrop" pseudoencoding @@ -6392,7 +6407,7 @@ EndSection rendering...) The Enhanced TightVNC Viewer (SSVNC) Unix viewer has a nice - [543]-ycrop option to help hide the pixel cache area from view. It + [548]-ycrop option to help hide the pixel cache area from view. It will turn on automatically if the framebuffer appears to be very tall (height more than twice the width), or you can supply the actual value for the height. If the screen is resized by scaling, etc, the ycrop @@ -6423,7 +6438,7 @@ EndSection an additional factor of 2 in memory use. However, even in the smallest usage mode with n equal 2 and - [544]-ncache_no_rootpixmap set (this requires only 2X additional + [549]-ncache_no_rootpixmap set (this requires only 2X additional framebuffer memory) there is still a noticable improvement for many activities, although it is not as dramatic as with, say n equal 12 and rootpixmap (desktop background) caching enabled. @@ -6434,7 +6449,7 @@ EndSection be tuned to use less, or the VNC community will extend the protocol to allow caching and replaying of compressed blobs of data. - Another option to experiment with is "[545]-ncache_cr". By specifying + Another option to experiment with is "[550]-ncache_cr". By specifying it, x11vnc will try to do smooth opaque window moves instead of its wireframe. This can give a very nice effect (note: on Unix the realvnc viewer seems to be smoother than the tightvnc viewer), but can lead to @@ -6491,24 +6506,24 @@ EndSection As of Feb/2009 (development tarball) there is an experimental kludge to let you build x11vnc using TurboVNC's modified TightVNC encoding. - [546]TurboVNC is part of the [547]VirtualGL project. It does two main + [551]TurboVNC is part of the [552]VirtualGL project. It does two main things to speed up the TightVNC encoding: * It eliminates bottlenecks, overheads, wait-times in the TightVNC encoding implementation and instead only worries about sending very well (and quickly) compressed JPEG data. * A fast proprietary JPEG implemention is used (Intel IPP on x86) - instead of the usual libjpeg implementation. [548]TurboJPEG is an + instead of the usual libjpeg implementation. [553]TurboJPEG is an interface library, libturbojpeg, provided by the project that achieves this. TurboVNC works very well over LAN and evidently fast Broadband too. When using it with x11vnc in such a situation you may want to dial - down the delays, e.g. "[549]-wait 5" and "[550]-defer 5" (or even a + down the delays, e.g. "[554]-wait 5" and "[555]-defer 5" (or even a smaller setting) to poll and pump things out more quickly. See the instructions in "x11vnc/misc/turbovnc/README" for how to build x11vnc with TurboVNC support. You will also need to download the - [551]TurboJPEG software. + [556]TurboJPEG software. In brief, the steps look like this: cd x11vnc-x.y.z/x11vnc/misc/turbovnc @@ -6520,22 +6535,22 @@ EndSection where you replace "/DIR" with the directory containing libturbojpeg.so you downloaded separately. If it works out well enough TurboVNC support will be integrated into x11vnc and more of its tuning features - will be implemented. Support for TurboVNC in [552]SSVNC viewer has + will be implemented. Support for TurboVNC in [557]SSVNC viewer has been added as an experiment as well. If you try either one, let us know how it went. There also may be some Linux.i686 and Darwin.i386 x11vnc binaries with - TurboVNC support in the [553]misc. bins directory. For other platforms + TurboVNC support in the [558]misc. bins directory. For other platforms you will need to compile yourself. On relatively cheap and old hardware (Althon64 X2 5000+ / GeForce - 6200) x11vnc and [554]SSVNC, both TurboVNC enabled, were able to + 6200) x11vnc and [559]SSVNC, both TurboVNC enabled, were able to sustain 13.5 frames/sec (fps) and 15 Megapixels/sec using the VirtualGL supplied OpenGL benchmark program glxspheres. VirtualGL on - higher-end hardware can sustain [555]20-30 fps with the glxspheres + higher-end hardware can sustain [560]20-30 fps with the glxspheres benchmark. - Potential Slowdown: As we describe [556]elsewhere, unless you use + Potential Slowdown: As we describe [561]elsewhere, unless you use x11vnc with an X server using, say, NVidia proprietary drivers (or a virtual X server like Xvfb or Xdummy, or in ShadowFB mode), then the read rate from the graphics card can be rather slow (e.g. 10 MB/sec) @@ -6575,23 +6590,23 @@ EndSection this is because the cursor shape is often downloaded to the graphics hardware (video card), but I could be mistaken. - A simple kludge is provided by the "[557]-cursor X" option that + A simple kludge is provided by the "[562]-cursor X" option that changes the cursor when the mouse is on the root background (or any window has the same cursor as the root background.) Note that desktops like GNOME or KDE often cover up the root background, so this won't - work for those cases. Also see the "[558]-cursor some" option for + work for those cases. Also see the "[563]-cursor some" option for additional kludges. Note that as of Aug/2004 on Solaris using the SUN_OVL overlay extension and IRIX, x11vnc can show the correct mouse cursor when the - [559]-overlay option is supplied. See [560]this FAQ for more info. + [564]-overlay option is supplied. See [565]this FAQ for more info. Also as of Dec/2004 XFIXES X extension support has been added to allow exact extraction of the mouse cursor shape. XFIXES fixes the problem of the cursor-shape being write-only: x11vnc can now query the X server for the current shape and send it back to the connected viewers. XFIXES is available on recent Linux Xorg based distros and - [561]Solaris 10. + [566]Solaris 10. The only XFIXES issue is the handling of alpha channel transparency in cursors. If a cursor has any translucency then in general it must be @@ -6599,7 +6614,7 @@ EndSection situations where the cursor transparency can also handled exactly: when the VNC Viewer requires the cursor shape be drawn into the VNC framebuffer or if you apply a patch to your VNC Viewer to extract - hidden alpha channel data under 32bpp. [562]Details can be found here. + hidden alpha channel data under 32bpp. [567]Details can be found here. Q-81: When using XFIXES cursorshape mode, some of the cursors look @@ -6632,17 +6647,17 @@ EndSection for most cursor themes and you don't have to worry about it. In case it still looks bad for your cursor theme, there are (of - course!) some tunable parameters. The "[563]-alphacut n" option lets + course!) some tunable parameters. The "[568]-alphacut n" option lets you set the threshold "n" (between 0 and 255): cursor pixels with alpha values below n will be considered completely transparent while values equal to or above n will be completely opaque. The default is - 240. The "[564]-alphafrac f" option tries to correct individual + 240. The "[569]-alphafrac f" option tries to correct individual cursors that did not fare well with the default -alphacut value: if a cursor has less than fraction f (between 0.0 and 1.0) of its pixels selected by the default -alphacut, the threshold is lowered until f of its pixels are selected. The default fraction is 0.33. - Finally, there is an option [565]-alpharemove that is useful for + Finally, there is an option [570]-alpharemove that is useful for themes where many cursors are light colored (e.g. "whiteglass".) XFIXES returns the cursor data with the RGB values pre-multiplied by the alpha value. If the white cursors look too grey, specify @@ -6668,10 +6683,10 @@ EndSection alpha channel data to libvncserver. However, this data will only be used for VNC clients that do not support the CursorShapeUpdates VNC extension (or have disabled it.) It can be disabled for all clients - with the [566]-nocursorshape x11vnc option. In this case the cursor is + with the [571]-nocursorshape x11vnc option. In this case the cursor is drawn, correctly blended with the background, into the VNC framebuffer before being sent out to the client. So the alpha blending is done on - the x11vnc side. Use the [567]-noalphablend option to disable this + the x11vnc side. Use the [572]-noalphablend option to disable this behavior (always approximate transparent cursors with opaque RGB values.) @@ -6695,7 +6710,7 @@ EndSection example on how to change the Windows TightVNC viewer to achieve the same thing (send me the patch if you get that working.) - This patch is applied to the [568]Enhanced TightVNC Viewer (SSVNC) + This patch is applied to the [573]Enhanced TightVNC Viewer (SSVNC) package we provide. [Mouse Pointer] @@ -6703,9 +6718,9 @@ EndSection Q-83: Why does the mouse arrow just stay in one corner in my vncviewer, whereas my cursor (that does move) is just a dot? - This default takes advantage of a [569]tightvnc extension + This default takes advantage of a [574]tightvnc extension (CursorShapeUpdates) that allows specifying a cursor image shape for - the local VNC viewer. You may disable it with the [570]-nocursor + the local VNC viewer. You may disable it with the [575]-nocursor option to x11vnc if your viewer does not have this extension. Note: as of Aug/2004 this should be fixed: the default for @@ -6719,17 +6734,17 @@ EndSection clients (i.e. passive viewers can see the mouse cursor being moved around by another viewer)? - Use the [571]-cursorpos option when starting x11vnc. A VNC viewer must + Use the [576]-cursorpos option when starting x11vnc. A VNC viewer must support the Cursor Positions Updates for the user to see the mouse motions (the TightVNC viewers support this.) As of Aug/2004 -cursorpos - is the default. See also [572]-nocursorpos and [573]-nocursorshape. + is the default. See also [577]-nocursorpos and [578]-nocursorshape. Q-85: Is it possible to swap the mouse buttons (e.g. left-handed operation), or arbitrarily remap them? How about mapping button clicks to keystrokes, e.g. to partially emulate Mouse wheel scrolling? - You can remap the mouse buttons via something like: [574]-buttonmap + You can remap the mouse buttons via something like: [579]-buttonmap 13-31 (or perhaps 12-21.) Also, note that xmodmap(1) lets you directly adjust the X server's button mappings, but in some circumstances it might be more desirable to have x11vnc do it. @@ -6737,7 +6752,7 @@ EndSection One user had an X server with only one mouse button(!) and was able to map all of the VNC client mouse buttons to it via: -buttonmap 123-111. - Note that the [575]-debug_pointer option prints out much info for + Note that the [580]-debug_pointer option prints out much info for every mouse/pointer event and is handy in solving problems. To map mouse button clicks to keystrokes you can use the alternate @@ -6759,7 +6774,7 @@ EndSection Exactly what keystroke "scrolling" events they should be bound to depends on one's taste. If this method is too approximate, one could - consider not using [576]-buttonmap but rather configuring the X server + consider not using [581]-buttonmap but rather configuring the X server to think it has a mouse with 5 buttons even though the physical mouse does not. (e.g. 'Option "ZAxisMapping" "4 5"'.) @@ -6789,7 +6804,7 @@ EndSection Q-86: How can I get my AltGr and Shift modifiers to work between keyboards for different languages? - The option [577]-modtweak should help here. It is a mode that monitors + The option [582]-modtweak should help here. It is a mode that monitors the state of the Shift and AltGr Modifiers and tries to deduce the correct keycode to send, possibly by sending fake modifier key presses and releases in addition to the actual keystroke. @@ -6798,20 +6813,20 @@ EndSection to get the old behavior.) This was done because it was noticed on newer XFree86 setups even on bland "us" keyboards like "pc104 us" XFree86 included a "ghost" key with both "<" and ">" it. This key does - not exist on the keyboard (see [578]this FAQ for more info.) Without + not exist on the keyboard (see [583]this FAQ for more info.) Without -modtweak there was then an ambiguity in the reverse map keysym => keycode, making it so the "<" symbol could not be typed. - Also see the [579]FAQ about the -xkb option for a more powerful method + Also see the [584]FAQ about the -xkb option for a more powerful method of modifier tweaking for use on X servers with the XKEYBOARD extension. When trying to resolve keyboard mapping problems, note that the - [580]-debug_keyboard option prints out much info for every keystroke + [585]-debug_keyboard option prints out much info for every keystroke and so can be useful debugging things. Note that one user had a strange setup and none of the above helped. - His solution was to disable all of the above and use [581]-nomodtweak. + His solution was to disable all of the above and use [586]-nomodtweak. This is the simplest form of keystroke insertion and it actually solved the problem. Try it if the other options don't help. @@ -6824,9 +6839,9 @@ EndSection (e.g. pc105 in the XF86Config file when it should be something else, say pc104.) - Short Cut: Try the [582]-xkb or [583]-sloppy_keys options and see if + Short Cut: Try the [587]-xkb or [588]-sloppy_keys options and see if that helps the situation. The discussion below is a bit outdated (e.g. - [584]-modtweak is now the default) but it is useful reference for + [589]-modtweak is now the default) but it is useful reference for various tricks and so is kept. @@ -6869,17 +6884,17 @@ EndSection -remap less-comma These are convenient in that they do not modify the actual X server - settings. The former ([585]-modtweak) is a mode that monitors the + settings. The former ([590]-modtweak) is a mode that monitors the state of the Shift and AltGr modifiers and tries to deduce the correct keycode sequence to send. Since Jul/2004 -modtweak is now the default. - The latter ([586]-remap less-comma) is an immediate remapping of the + The latter ([591]-remap less-comma) is an immediate remapping of the keysym less to the keysym comma when it comes in from a client (so when Shift is down the comma press will yield "<".) - See also the [587]FAQ about the -xkb option as a possible workaround + See also the [592]FAQ about the -xkb option as a possible workaround using the XKEYBOARD extension. - Note that the [588]-debug_keyboard option prints out much info for + Note that the [593]-debug_keyboard option prints out much info for every keystroke to aid debugging keyboard problems. @@ -6887,7 +6902,7 @@ EndSection less than) instead I get "<," (i.e. an extra comma.) This is likely because you press "Shift" then "<" but then released - the Shift key before releasing the "<". Because of a [589]keymapping + the Shift key before releasing the "<". Because of a [594]keymapping ambiguity the last event "< up" is interpreted as "," because that key unshifted is the comma. @@ -6895,9 +6910,9 @@ EndSection characters: in general it can happen whenever the Shift key is released early. - This should not happen in [590]-xkb mode, because it works hard to + This should not happen in [595]-xkb mode, because it works hard to resolve the ambiguities. If you do not want to use -xkb, try the - option [591]-sloppy_keys to attempt a similar type of algorithm. + option [596]-sloppy_keys to attempt a similar type of algorithm. One user had this problem for Italian and German keyboards with the key containing ":" and "." When he typed ":" he would get an extra "." @@ -6925,7 +6940,7 @@ EndSection In both cases no AltGr is sent to the VNC server, but we know AltGr is needed on the physical international keyboard to type a "@". - This all worked fine with x11vnc running with the [592]-modtweak + This all worked fine with x11vnc running with the [597]-modtweak option (it figures out how to adjust the Modifier keys (Shift or AltGr) to get the "@".) However it fails under recent versions of XFree86 (and the X.org fork.) These run the XKEYBOARD extension by @@ -6942,7 +6957,7 @@ EndSection * there is a new option -xkb to use the XKEYBOARD extension API to do the Modifier key tweaking. - The [593]-xkb option seems to fix all of the missing keys: "@", "<", + The [598]-xkb option seems to fix all of the missing keys: "@", "<", ">", etc.: it is recommended that you try it if you have this sort of problem. Let us know if there are any remaining problems (see the next paragraph for some known problems.) If you specify the -debug_keyboard @@ -6950,7 +6965,7 @@ EndSection debugging output (send it along with any problems you report.) Update: as of Jun/2005 x11vnc will try to automatically enable - [594]-xkb if it appears that would be beneficial (e.g. if it sees any + [599]-xkb if it appears that would be beneficial (e.g. if it sees any of "@", "<", ">", "[" and similar keys are mapped in a way that needs the -xkb to access them.) To disable this automatic check use -noxkb. @@ -6965,7 +6980,7 @@ EndSection was attached to keycode 93 (no physical key generates this keycode) while ISO_Level3_Shift was attached to keycode 113. The keycode skipping option was used to disable the ghost key: - [595]-skip_keycodes 93 + [600]-skip_keycodes 93 * In implementing -xkb we noticed that some characters were still not getting through, e.g. "~" and "^". This is not really an XKEYBOARD problem. What was happening was the VNC viewer was @@ -6983,16 +6998,16 @@ EndSection What to do? In general the VNC protocol has not really solved this problem: what should be done if the VNC viewer sends a keysym not recognized by the VNC server side? Workarounds can possibly be - created using the [596]-remap x11vnc option: + created using the [601]-remap x11vnc option: -remap asciitilde-dead_tilde,asciicircum-dead_circumflex etc. Use -remap filename if the list is long. Please send us your workarounds for this problem on your keyboard. Perhaps we can have x11vnc adjust automatically at some point. Also see the - [597]-add_keysyms option in the next paragraph. - Update: for convenience "[598]-remap DEAD" does many of these + [602]-add_keysyms option in the next paragraph. + Update: for convenience "[603]-remap DEAD" does many of these mappings at once. - * To complement the above workaround using the [599]-remap, an - option [600]-add_keysyms was added. This option instructs x11vnc + * To complement the above workaround using the [604]-remap, an + option [605]-add_keysyms was added. This option instructs x11vnc to bind any unknown Keysyms coming in from VNC viewers to unused Keycodes in the X server. This modifies the global state of the X server. When x11vnc exits it removes the extra keymappings it @@ -7011,7 +7026,7 @@ EndSection Short answer: disable key autorepeating by running the command "xset r off" on the Xserver where x11vnc is run (restore via "xset r on") or - use the new (Jul/2004) [601]-norepeat x11vnc option. You will still + use the new (Jul/2004) [606]-norepeat x11vnc option. You will still have autorepeating because that is taken care of on your VNC viewer side. @@ -7035,7 +7050,7 @@ EndSection off", does the problem go away? The workaround is to manually apply "xset r off" and "xset r on" as - needed, or to use the [602]-norepeat (which has since Dec/2004 been + needed, or to use the [607]-norepeat (which has since Dec/2004 been made the default.) Note that with X server autorepeat turned off the VNC viewer side of the connection will (nearly always) do its own autorepeating so there is no big loss here, unless someone is also @@ -7046,7 +7061,7 @@ EndSection keystrokes!! Are you using x11vnc to log in to an X session via display manager? - (as described in [603]this FAQ) If so, x11vnc is starting before your + (as described in [608]this FAQ) If so, x11vnc is starting before your session and it disables autorepeat when you connect, but then after you log in your session startup (GNOME, KDE, ...) could be resetting the autorepeat to be on. Or it could be something inside your desktop @@ -7107,11 +7122,11 @@ EndSection desktop manages these "warps". If the viewer is not notified it cannot know it needs to release the modifiers. - You can also use the [604]-clear_mods option to try to clear all of + You can also use the [609]-clear_mods option to try to clear all of the modifier keys at x11vnc startup. You will still have to be careful that you do not leave the modifier key pressed down during your session. It is difficult to prevent this problem from occurring (short - of using [605]-remap to prevent sending all of the problem modifier + of using [610]-remap to prevent sending all of the problem modifier keys, which would make the destkop pretty unusable.) During a session these x11vnc remote control commands can also help: @@ -7124,16 +7139,16 @@ EndSection Num_Lock down. When these are locked on the remote side it can sometimes lead to strange desktop behavior (e.g. cannot drag or click on windows.) As above you may not notice this because the lock isn't - down on the local (Viewer) side. See [606]this FAQ on lock keys - problem. These options may help avoid the problem: [607]-skip_lockkeys - and [608]-capslock. See also [609]-clear_all. + down on the local (Viewer) side. See [611]this FAQ on lock keys + problem. These options may help avoid the problem: [612]-skip_lockkeys + and [613]-capslock. See also [614]-clear_all. Q-93: The machine where I run x11vnc has an AltGr key, but the local machine where I run the VNC viewer does not. Is there a way I can map a local unused key to send an AltGr? How about a Compose key as well? - Something like "[610]-remap Super_R-Mode_switch" x11vnc option may + Something like "[615]-remap Super_R-Mode_switch" x11vnc option may work. Note that Super_R is the "Right Windoze(tm) Flaggie" key; you may want to choose another. The -debug_keyboard option comes in handy in finding keysym names (so does xev(1).) @@ -7156,7 +7171,7 @@ EndSection Since xmodmap(1) modifies the X server mappings you may not want to do this (because it affects local work on that machine.) Something like - the [611]-remap Alt_L-Meta_L to x11vnc may be sufficient for ones + the [616]-remap Alt_L-Meta_L to x11vnc may be sufficient for ones needs, and does not modify the X server environment. Note that you cannot send Alt_L in this case, maybe -remap Super_L-Meta_L would be a better choice if the Super_L key is typically unused in Unix. @@ -7176,7 +7191,7 @@ EndSection and similar triple mappings (with two in the AltGr/Mode_switch group) of a keysum to a single keycode. - Use the [612]-nomodtweak option as a workaround. You can also use + Use the [617]-nomodtweak option as a workaround. You can also use xmodmap to correct these mappings in the server, e.g.: xmodmap -e "keycode 47 = 3 numbersign" @@ -7190,7 +7205,7 @@ EndSection This can be done directly in some X servers using AccessX and Pointer_EnableKeys, but is a bit awkward. It may be more convenient to - have x11vnc do the remapping. This can be done via the [613]-remap + have x11vnc do the remapping. This can be done via the [618]-remap option using the fake "keysyms" Button1, Button2, etc. as the "to" keys (i.e. the ones after the "-") @@ -7199,7 +7214,7 @@ EndSection button "paste" because (using XFree86/Xorg Emulate3Buttons) you have to click both buttons on the touch pad at the same time. This remapping: - [614]-remap Super_R-Button2 + [619]-remap Super_R-Button2 maps the Super_R "flag" key press to the Button2 click, thereby making X pasting a bit easier. @@ -7218,13 +7233,13 @@ EndSection Caps_Lock in the viewer your local machine goes into the Caps_Lock on state and sends keysym "A" say when you press "a". x11vnc will then fake things up so that Shift is held down to generate "A". The - [615]-skip_lockkeys option should help to accomplish this. For finer - grain control use something like: "[616]-remap Caps_Lock-None". + [620]-skip_lockkeys option should help to accomplish this. For finer + grain control use something like: "[621]-remap Caps_Lock-None". - Also try the [617]-nomodtweak and [618]-capslock options. + Also try the [622]-nomodtweak and [623]-capslock options. Another useful option that turns off any Lock keys on the remote side - at startup and end is the [619]-clear_all option. During a session you + at startup and end is the [624]-clear_all option. During a session you can run these remote control commands to modify the Lock keys: x11vnc -R clear_locks x11vnc -R clear_all @@ -7253,7 +7268,7 @@ EndSection There may also be scaling viewers out there (e.g. TightVNC or UltraVNC on Windows) that automatically shrink or expand the remote framebuffer to fit the local display. Especially for hand-held devices. See also - [620]the next FAQ on x11vnc scaling. + [625]the next FAQ on x11vnc scaling. Q-99: Does x11vnc support server-side framebuffer scaling? (E.g. to @@ -7261,7 +7276,7 @@ EndSection As of Jun/2004 x11vnc provides basic server-side scaling. It is a global scaling of the desktop, not a per-client setting. To enable it - use the "[621]-scale fraction" option. "fraction" can either be a + use the "[626]-scale fraction" option. "fraction" can either be a floating point number (e.g. -scale 0.75) or the alternative m/n fraction notation (e.g. -scale 3/4.) Note that if fraction is greater than one the display is magnified. @@ -7286,7 +7301,7 @@ EndSection One can also use the ":nb" with an integer scale factor (say "-scale 2:nb") to use x11vnc as a screen magnifier for vision impaired - [622]applications. Since with integer scale factors the framebuffers + [627]applications. Since with integer scale factors the framebuffers become huge and scaling operations time consuming, be sure to use ":nb" for the fastest response. @@ -7312,7 +7327,7 @@ EndSection If one desires per-client scaling for something like 1:1 from a workstation and 1:2 from a smaller device (e.g. handheld), currently the only option is to run two (or more) x11vnc processes with - different scalings listening on separate ports ([623]-rfbport option, + different scalings listening on separate ports ([628]-rfbport option, etc.) Update: As of May/2006 x11vnc also supports the UltraVNC server-side @@ -7322,8 +7337,8 @@ EndSection "-rfbversion 3.6" for this to be recognized by UltraVNC viewers. BTW, whenever you run two or more x11vnc's on the same X display and - use the [624]GUI, then to avoid all of the x11vnc's simultaneously - answering the gui you will need to use something like [625]"-connect + use the [629]GUI, then to avoid all of the x11vnc's simultaneously + answering the gui you will need to use something like [630]"-connect file1 -gui ..." with different connect files for each x11vnc you want to control via the gui (or remote-control.) The "-connect file1" usage gives separate communication channels between a x11vnc process and the @@ -7332,7 +7347,7 @@ EndSection Update: As of Mar/2005 x11vnc now scales the mouse cursor with the same scale factor as the screen. If you don't want that, use the - [626]"-scale_cursor frac" option to set the cursor scaling to a + [631]"-scale_cursor frac" option to set the cursor scaling to a different factor (e.g. use "-scale_cursor 1" to keep the cursor at its natural unscaled size.) @@ -7360,21 +7375,21 @@ EndSection screen is not rectangular (e.g. 1280x1024 and 1024x768 monitors joined together), then there will be "non-existent" areas on the screen. The X server will return "garbage" image data for these areas and so they - may be distracting to the viewer. The [627]-blackout x11vnc option + may be distracting to the viewer. The [632]-blackout x11vnc option allows you to blacken-out rectangles by manually specifying their WxH+X+Y geometries. If your system has the libXinerama library, the - [628]-xinerama x11vnc option can be used to have it automatically + [633]-xinerama x11vnc option can be used to have it automatically determine the rectangles to be blackened out. (Note on 8bpp PseudoColor displays the fill color may not be black.) Update: - [629]-xinerama is now on by default. + [634]-xinerama is now on by default. Some users have reported that the mouse does not behave properly for their Xinerama display: i.e. the mouse cannot be moved to all regions - of the large display. If this happens try using the [630]-xwarppointer + of the large display. If this happens try using the [635]-xwarppointer option. This instructs x11vnc to fake mouse pointer motions using the XWarpPointer function instead of the XTestFakeMotionEvent XTEST function. (This may be due to a bug in the X server for XTEST when - Xinerama is enabled.) Update: As of Dec/2006 [631]-xwarppointer will + Xinerama is enabled.) Update: As of Dec/2006 [636]-xwarppointer will be applied automatically if Xinerama is detected. To disable use: -noxwarppointer @@ -7397,23 +7412,23 @@ EndSection Note: if you are running on Solaris 8 or earlier you can easily hit up against the maximum of 6 shm segments per process (for Xsun in this case) from running multiple x11vnc processes. You should modify - /etc/system as mentioned in another [632]FAQ to increase the limit. It - is probably also a good idea to run with the [633]-onetile option in + /etc/system as mentioned in another [637]FAQ to increase the limit. It + is probably also a good idea to run with the [638]-onetile option in this case (to limit each x11vnc to 3 shm segments), or even - [634]-noshm to use no shm segments. + [639]-noshm to use no shm segments. Q-102: Can x11vnc show only a portion of the display? (E.g. for a special purpose application or a very large screen.) - As of Mar/2005 x11vnc has the "[635]-clip WxH+X+Y" option to select a + As of Mar/2005 x11vnc has the "[640]-clip WxH+X+Y" option to select a rectangle of width W, height H and offset (X, Y). Thus the VNC screen will be the clipped sub-region of the display and be only WxH in size. - One user used -clip to split up a large [636]Xinerama screen into two + One user used -clip to split up a large [641]Xinerama screen into two more managable smaller screens. This also works to view a sub-region of a single application window if - the [637]-id or [638]-sid options are used. The offset is measured + the [642]-id or [643]-sid options are used. The offset is measured from the upper left corner of the selected window. @@ -7422,7 +7437,7 @@ EndSection just seems to crash. As of Dec/2004 x11vnc supports XRANDR. You enable it with the - [639]-xrandr option to make x11vnc monitor XRANDR events and also trap + [644]-xrandr option to make x11vnc monitor XRANDR events and also trap X server errors if the screen change occurred in the middle of an X call like XGetImage. Once it traps the screen change it will create a new framebuffer using the new screen. @@ -7432,9 +7447,9 @@ EndSection then the viewer will automatically resize. Otherwise, the new framebuffer is fit as best as possible into the original viewer size (portions of the screen may be clipped, unused, etc.) For these - viewers you can try the [640]-padgeom option to make the region big + viewers you can try the [645]-padgeom option to make the region big enough to hold all resizes and rotations. We have fixed this problem - for the TightVNC Viewer on Unix: [641]SSVNC + for the TightVNC Viewer on Unix: [646]SSVNC If you specify "-xrandr newfbsize" then vnc viewers that do not support NewFBSize will be disconnected before the resize. If you @@ -7446,7 +7461,7 @@ EndSection reflect the screen that the VNC viewers see? (e.g. for a handheld whose screen is rotated 90 degrees.) - As of Jul/2006 there is the [642]-rotate option allow this. E.g's: + As of Jul/2006 there is the [647]-rotate option allow this. E.g's: "-rotate +90", "-rotate -90", "-rotate x", etc. @@ -7511,13 +7526,13 @@ EndSection This may be a bug in kdesktop_lock. For now the only workaround is to disable the screensaver. You can try using another one such as - straight xscreensaver (see the instructions [643]here for how to + straight xscreensaver (see the instructions [648]here for how to disable kdesktop_lock.) If you have more info on this or see it outside of KDE please let us know. Update: It appears this is due to kdesktop_lock enabling the screen saver when the Monitor is in DPMS low-power state (e.g. standby, - suspend, or off.) In Nov/2006 the x11vnc [644]-nodpms option was added + suspend, or off.) In Nov/2006 the x11vnc [649]-nodpms option was added as a workaround. Normally it is a good thing that the monitor powers down (since x11vnc can still poll the framebuffer in this state), but if you experience the kdesktop_lock problem you can specify the @@ -7533,16 +7548,16 @@ EndSection This appears to be because the 3D OpenGL/GLX hardware screen updates do not get reported via the XDAMAGE mechanism. So this is a bug in - [645]beryl/compiz or XDAMAGE/Xorg or the (possibly 3rd party) video + [650]beryl/compiz or XDAMAGE/Xorg or the (possibly 3rd party) video card driver. - As a workaround apply the [646]-noxdamage option. As of Feb/2007 + As a workaround apply the [651]-noxdamage option. As of Feb/2007 x11vnc will try to autodetect the problem and disable XDAMAGE if is appears to be missing a lot of updates. But if you know you are using - beryl you might as well always supply -noxdamage. Thanks to [647]this + beryl you might as well always supply -noxdamage. Thanks to [652]this user who reported the problem and discovered the workaround. - A developer for [648]MiniMyth reports that the 'alphapulse' tag of the + A developer for [653]MiniMyth reports that the 'alphapulse' tag of the theme G.A.N.T. can also cause problems, and should be avoided when using VNC. @@ -7562,9 +7577,9 @@ EndSection * Fullscreen mode The way VMWare does Fullscreen mode on Linux is to display the Guest - desktop in a separate Virtual Terminal (e.g. VT 8) (see [649]this FAQ + desktop in a separate Virtual Terminal (e.g. VT 8) (see [654]this FAQ on VT's for background.) Unfortunately, this Fullscreen VT is not an X - server. So x11vnc cannot access it (however, [650]see this discussion + server. So x11vnc cannot access it (however, [655]see this discussion of -rawfb for a possible workaround.) x11vnc works fine with "Normal X application window" and "Quick-Switch mode" because these use X. @@ -7585,13 +7600,13 @@ EndSection improve response. One can also cut the display depth (e.g. to 16bpp) in this 2nd X session to improve video performance. This 2nd X session emulates Fullscreen mode to some degree and can be viewed via x11vnc - as long as the VMWare X session [651]is in the active VT. + as long as the VMWare X session [656]is in the active VT. Also note that with a little bit of playing with "xwininfo -all -children" output one can extract the (non-toplevel) window-id of the of the Guest desktop only when VMWare is running as a normal X application. Then one can export just the guest desktop (i.e. without - the VMWare menu buttons) by use of the [652]-id windowid option. The + the VMWare menu buttons) by use of the [657]-id windowid option. The caveats are the X session VMWare is in must be in the active VT and the window must be fully visible, so this mode is not terribly convenient, but could be useful in some circumstances (e.g. running @@ -7607,10 +7622,10 @@ EndSection controlled) via VNC with x11vnc? As of Apr/2005 there is support for this. Two options were added: - "[653]-rawfb string" (to indicate the raw frame buffer device, file, - etc. and its parameters) and "[654]-pipeinput command" (to provide an + "[658]-rawfb string" (to indicate the raw frame buffer device, file, + etc. and its parameters) and "[659]-pipeinput command" (to provide an external program that will inject or otherwise process mouse and - keystroke input.) Some useful [655]-pipeinput schemes, VID, CONSOLE, + keystroke input.) Some useful [660]-pipeinput schemes, VID, CONSOLE, and UINPUT, have since been built into x11vnc for convenience. This non-X mode for x11vnc is somewhat experimental because it is so @@ -7650,9 +7665,9 @@ EndSection access method.) Only use file if map isn't working. BTW, "mmap" is an alias for "map" and if you do not supply a type and the file exists, map is assumed (see the -help output and below for some exceptions to - this.) The "snap:" setting applies the [656]-snapfb option with + this.) The "snap:" setting applies the [661]-snapfb option with "file:" type reading (this is useful for exporting webcams or TV tuner - video; see [657]the next FAQ for more info.) + video; see [662]the next FAQ for more info.) Also, if the string is of the form "setup:cmd" then cmd is run and the first line of its output retrieved and used as the rawfb string. This @@ -7697,7 +7712,7 @@ EndSection screen to either shm or a mapped file. The format of these is XWD and so the initial header should be skipped. BTW, since XWD is not strictly RGB the view will only be approximate, but usable. Of course - for the case of Xvfb x11vnc can poll it much better via the [658]X + for the case of Xvfb x11vnc can poll it much better via the [663]X API, but you get the idea. By default in -rawfb mode x11vnc will actually close any X display it @@ -7728,13 +7743,13 @@ minal #2) tty1-tty6), or X graphical display (usually starting at tty7.) In addition to the text console other graphical ones may be viewed and interacted with as well, e.g. DirectFB or SVGAlib apps, VMWare non-X - fullscreen, or [659]Qt-embedded apps (PDAs/Handhelds.) By default the + fullscreen, or [664]Qt-embedded apps (PDAs/Handhelds.) By default the pipeinput mechanisms UINPUT and CONSOLE (keystrokes only) are automatically attempted in this mode under "-rawfb console". The Video4Linux Capture device, /dev/video0, etc is either a Webcam or a TV capture device and needs to have its driver enabled in the - kernel. See [660]this FAQ for details. If specified via "-rawfb Video" + kernel. See [665]this FAQ for details. If specified via "-rawfb Video" then the pipeinput method "VID" is applied (it lets you change video parameters dynamically via keystrokes.) @@ -7742,10 +7757,10 @@ minal #2) also useful in testing. - All of the above [661]-rawfb options are just for viewing the raw + All of the above [666]-rawfb options are just for viewing the raw framebuffer (although some of the aliases do imply keystroke and mouse pipeinput methods.) That may be enough for certain applications of - this feature (e.g. suppose a [662]video camera mapped its framebuffer + this feature (e.g. suppose a [667]video camera mapped its framebuffer into memory and you just wanted to look at it via VNC.) To handle the pointer and keyboard input from the viewer users the "-pipeinput cmd" option was added to indicate a helper program to @@ -7783,7 +7798,7 @@ minal #2) keystrokes into the Linux console (e.g. the virtual consoles: /dev/tty1, /dev/tty2, etc) in x11vnc/misc/vcinject.pl. It is based on the vncterm/LinuxVNC.c program also in the libvncserver CVS. So to - view and interact with VT #2 (assuming it is the [663]active VT) one + view and interact with VT #2 (assuming it is the [668]active VT) one can run something like: x11vnc -rawfb map:/dev/fb0@1024x768x16 -pipeinput './vcinject.pl 2' @@ -7838,7 +7853,7 @@ minal #2) better to use the more accurate and faster LinuxVNC program. The advantage x11vnc -rawfb might have is that it can allow interaction with a non-text application, e.g. one based on SVGAlib or - [664]Qt-embedded Also, for example the [665]VMWare Fullscreen mode is + [669]Qt-embedded Also, for example the [670]VMWare Fullscreen mode is actually viewable under -rawfb and can be interacted with if uinput is enabled. @@ -7903,9 +7918,9 @@ minal #2) Q-113: Can I export via VNC a Webcam or TV tuner framebuffer using x11vnc? - Yes, this is possible to some degree with the [666]-rawfb option. + Yes, this is possible to some degree with the [671]-rawfb option. There is no X11 involved: snapshots from the video capture device are - used for the screen image data. See the [667]previous FAQ on -rawfb + used for the screen image data. See the [672]previous FAQ on -rawfb for background. For best results, use x11vnc version 0.8.1 or later. Roughly, one would do something like this: @@ -7917,7 +7932,7 @@ minal #2) snapshot to a file that you point -rawfb to; ask me if it is not clear what to do.) - The "snap:" enforces [668]-snapfb mode which appears to be necessary. + The "snap:" enforces [673]-snapfb mode which appears to be necessary. The read pointer for video capture devices cannot be repositioned (which would be needed for scanline polling), but you can read a full frame of data from the device. @@ -7939,7 +7954,7 @@ minal #2) Many video4linux drivers tend to set the framebuffer to be 24bpp (as opposed to 32bpp.) Since this can cause problems with VNC viewers, - etc, the [669]-24to32 option will be automatically imposed when in + etc, the [674]-24to32 option will be automatically imposed when in 24bpp. Note that by its very nature, video capture involves rapid change in @@ -7947,7 +7962,7 @@ minal #2) wavering in brightness is always happening. This can lead to much network bandwidth consumption for the VNC traffic and also local CPU and I/O resource usage. You may want to experiment with "dialing down" - the framerate via the [670]-wait, [671]-slow_fb, or [672]-defer + the framerate via the [675]-wait, [676]-slow_fb, or [677]-defer options. Decreasing the window size and bpp also helps. @@ -8036,7 +8051,7 @@ minal #2) format to HI240, RGB565, RGB24, RGB32, RGB555, and GREY respectively. See -rawfb video for details. - See also the [673]-freqtab option to supply your own xawtv channel to + See also the [678]-freqtab option to supply your own xawtv channel to frequency mappings for your country (only ntsc-cable-us is built into x11vnc.) @@ -8045,7 +8060,7 @@ minal #2) running on my handheld or PC using the Linux console framebuffer (i.e. not X11)? - Yes, the basic method for this is the [674]-rawfb scheme where the + Yes, the basic method for this is the [679]-rawfb scheme where the Linux console framebuffer (usually /dev/fb0) is polled and the uinput driver is used to inject keystrokes and mouse input. Often you will just have to type: @@ -8058,7 +8073,7 @@ minal #2) x11vnc -rawfb /dev/fb0@640x480x16 Also, to force usage of the uinput injection method use "-pipeinput - UINPUT". See the [675]-pipeinput description for tunable parameters, + UINPUT". See the [680]-pipeinput description for tunable parameters, etc. One problem with the x11vnc uinput scheme is that it cannot guess the @@ -8074,7 +8089,7 @@ minal #2) Even with the correct acceleration setting there is still some drift (probably because of the mouse threshold where the acceleration kicks in) and so x11vnc needs to reposition the cursor from 0,0 about 5 - times a second. See the [676]-pipeinput UINPUT option for tuning + times a second. See the [681]-pipeinput UINPUT option for tuning parameters that can be set (there are some experimental thresh=N tuning parameters as well) @@ -8109,7 +8124,7 @@ minal #2) Q-115: Now that non-X11 devices can be exported via VNC using x11vnc, can I build it with no dependencies on X11 header files and libraries? - Yes, as of Jul/2006 x11vnc enables building for [677]-rawfb only + Yes, as of Jul/2006 x11vnc enables building for [682]-rawfb only support. Just do something like when building: ./configure --without-x (plus any other flags) make @@ -8125,11 +8140,11 @@ minal #2) Yes, since Nov/2006 in the development tree (x11vnc-0.8.4 tarball) there is support for native Mac OS X Aqua/Quartz displays using the - [678]-rawfb mechanism described above. The mouse and keyboard input is + [683]-rawfb mechanism described above. The mouse and keyboard input is achieved via Mac OS X API's. - So you can use x11vnc as an alternative to [679]OSXvnc (aka Vine - Server), or [680]Apple Remote Desktop (ARD). Perhaps there is some + So you can use x11vnc as an alternative to [684]OSXvnc (aka Vine + Server), or [685]Apple Remote Desktop (ARD). Perhaps there is some x11vnc feature you'd like to use on Mac OS X, etc. For a number of activities (e.g. window drags) it seems to be faster than OSXvnc. @@ -8139,7 +8154,7 @@ minal #2) (XDarwin) running on Mac OS X (people often install this software to display remote X11 apps on their Mac OS X system, or use some old favorites locally such as xterm.) However in this case x11vnc will - only work reasonably in single window [681]-id windowid mode (and the + only work reasonably in single window [686]-id windowid mode (and the window may need to have mouse focus.) If you do not have the DISPLAY env. variable set, x11vnc will assume @@ -8157,9 +8172,9 @@ minal #2) ./configure --without-x make - Win2VNC/x2vnc: One handy use is to use the [682]-nofb mode to + Win2VNC/x2vnc: One handy use is to use the [687]-nofb mode to redirect mouse and keyboard input to a nearby Mac (i.e. one to the - side of your desk) via [683]x2vnc or Win2VNC. See [684]this FAQ for + side of your desk) via [688]x2vnc or Win2VNC. See [689]this FAQ for more info. Options: Here are the Mac OS X specific x11vnc options: @@ -8233,13 +8248,13 @@ rm -f $tmp performance for the case of a large number of simultaneous VNC viewers (e.g. classroom broadcasting or a large demo)? - Yes, as of Feb/2007 there is the "[685]-reflect host:N" option to + Yes, as of Feb/2007 there is the "[690]-reflect host:N" option to connect to the VNC server "host:N" (either another x11vnc or any other VNC server) and re-export it. VNC viewers then connect to the x11vnc(s) running -reflect. The -reflect option is the same as: "-rawfb vnc:host:N". See the - [686]-rawfb description under "VNC HOST" for more details. + [691]-rawfb description under "VNC HOST" for more details. You can replace "host:N" with "listen" or "listen:port" for reverse connections. @@ -8300,18 +8315,18 @@ rm -f $tmp re-exports via VNC to its clients C.) However, CopyRect and CursorShape encodings are preserved in the reflection and that helps. Dragging windows with the mouse can be a problem (especially if S is - not doing wireframing somehow, consider [687]-nodragging if the + not doing wireframing somehow, consider [692]-nodragging if the problem is severe) For a really fast reflector/repeater it would have to be implemented from scratch with performance in mind. See these other projects: - [688]http://sourceforge.net/projects/vnc-reflector/, - [689]http://www.tightvnc.com/projector/ (closed source?), + [693]http://sourceforge.net/projects/vnc-reflector/, + [694]http://www.tightvnc.com/projector/ (closed source?), Automation via Reverse Connections: Instead of having the R's connect directly to S and then the C's connect directly to the R they should use, some convenience can be achieved by using reverse - connections (the x11vnc "[690]"-connect host1,host2,..." option.) + connections (the x11vnc "[695]"-connect host1,host2,..." option.) Suppose all the clients "C" are started up in Listen mode: client1> vncviewer -listen client2> vncviewer -listen @@ -8370,7 +8385,7 @@ rm -f $tmp If the Solaris install is an older X-based one, there will be a menu for you to get a terminal window. From that window you might be able to retrieve x11vnc.static via wget, scp, or ftp. Remember to do "chmod - 755 ./x11vnc.static" and then find the -auth file as in [691]this FAQ. + 755 ./x11vnc.static" and then find the -auth file as in [696]this FAQ. If it is a Linux install that uses an X server (e.g. SuSE and probably Fedora), then you can often get a shell by pressing Ctrl-Alt-F2 or @@ -8379,7 +8394,7 @@ rm -f $tmp wget http://192.168.0.22/x11vnc.static chmod 755 ./x11vnc.static - Find the name of the auth file as in [692]this FAQ. (maybe run "ps + Find the name of the auth file as in [697]this FAQ. (maybe run "ps wwwwaux | grep auth".) Then run it like this: ./x11vnc.static -forever -nopw -display :0 -auth /tmp/wherever/the/authfile @@ -8388,7 +8403,7 @@ rm -f $tmp the display being :1, etc. If there is a firewall blocking incoming connections during the - install, use the [693]"-connect hostname" option option for a reverse + install, use the [698]"-connect hostname" option option for a reverse connection to the hostname running the VNC viewer in listen mode. Debian based installs are either console-text or console-framebuffer @@ -8450,7 +8465,7 @@ rm -f $tmp as 'for power users' or 'an Easter Egg'. As soon as text is highlighted it is set to the PRIMARY selection and so it is immediately ready for pasting, usually via the Middle Mouse Button or - "Shift+Insert". See [694]this jwz link for more information. + "Shift+Insert". See [699]this jwz link for more information. x11vnc's default behavior is to watch both CLIPBOARD and PRIMARY and whenever one of them changes, it sends the new text to connected @@ -8467,18 +8482,18 @@ rm -f $tmp You may not like these defaults. Here are ways to change the behavior: * If you don't want the Clipboard/Selection exchanged at all use the - [695]-nosel option. + [700]-nosel option. * If you want changes in PRIMARY to be ignored use the - [696]-noprimary option. + [701]-noprimary option. * If you want changes in CLIPBOARD to be ignored use the - [697]-noclipboard option. + [702]-noclipboard option. * If you don't want x11vnc to set PRIMARY to the "CutText" received - from viewers use the [698]-nosetprimary option. + from viewers use the [703]-nosetprimary option. * If you don't want x11vnc to set CLIPBOARD to the "CutText" - received from viewers use the [699]-nosetclipboard option. + received from viewers use the [704]-nosetclipboard option. - You can also fine-tune it a bit with the [700]-seldir dir option and - also [701]-input. + You can also fine-tune it a bit with the [705]-seldir dir option and + also [706]-input. You may need to watch out for desktop utilities such as KDE's "Klipper" that do odd things with the selection, clipboard, and @@ -8490,7 +8505,7 @@ rm -f $tmp Yes, it is possible with a number of tools that record VNC and transform it to swf format or others. One such popular tool is - [702]pyvnc2swf. There are a number of [703]tutorials (broken link?) on + [707]pyvnc2swf. There are a number of [708]tutorials (broken link?) on how to do this. Another option is to use the vnc2mpg that comes in the LibVNCServer package. An important thing to remember when doing this is that tuning @@ -8505,11 +8520,11 @@ rm -f $tmp (and Windows viewers only support filetransfer it appears... but they do work to some degree under Wine on Linux.) - The [704]SSVNC Unix VNC viewer supports UltraVNC file transfer by use + The [709]SSVNC Unix VNC viewer supports UltraVNC file transfer by use of a Java helper program. TightVNC file transfer is off by default, if you want to enable it use - the [705]-tightfilexfer option. + the [710]-tightfilexfer option. UltraVNC file transfer is off by default, to enable it use something like "-rfbversion 3.6 -permitfiletransfer" @@ -8532,7 +8547,7 @@ rm -f $tmp IMPORTANT: please understand if -ultrafilexfer or -tightfilexfer is specified and you run x11vnc as root for, say, inetd or display manager (gdm, kdm, ...) access and you do not have it switch users via - the [706]-users option, then VNC Viewers that connect are able to do + the [711]-users option, then VNC Viewers that connect are able to do filetransfer reads and writes as *root*. The UltraVNC and TightVNC settings can be toggled on and off inside @@ -8551,7 +8566,7 @@ rm -f $tmp these extensions you will need to supply this option to x11vnc: -rfbversion 3.6 - Or use [707]-ultrafilexfer which is an alias for the above option and + Or use [712]-ultrafilexfer which is an alias for the above option and "-permitfiletransfer". UltraVNC evidently treats any other RFB version number as non-UltraVNC. @@ -8563,14 +8578,14 @@ rm -f $tmp * 1/n Server Scaling * rfbEncodingUltra compression encoding - The [708]SSVNC Unix VNC viewer supports these UltraVNC extensions. + The [713]SSVNC Unix VNC viewer supports these UltraVNC extensions. - To disable SingleWindow and ServerInput use [709]-noultraext (the + To disable SingleWindow and ServerInput use [714]-noultraext (the others are managed by LibVNCServer.) See this option too: - [710]-noserverdpms. + [715]-noserverdpms. - Also, the [711]UltraVNC repeater proxy is supported for use with - reverse connections: "[712]-connect repeater://host:port+ID:NNNN". Use + Also, the [716]UltraVNC repeater proxy is supported for use with + reverse connections: "[717]-connect repeater://host:port+ID:NNNN". Use it for both plaintext and SSL connections. This mode can send any string before switching to the VNC protocol, and so could be used with other proxy/gateway tools. @@ -8581,12 +8596,12 @@ rm -f $tmp reverse vnc connection from their Unix desktop to a helpdesk operator's VNC Viewer. - Yes, UltraVNC's [713]Single Click (SC) mode can be emulated fairly + Yes, UltraVNC's [718]Single Click (SC) mode can be emulated fairly well on Unix. We use the term "helpdesk" below, but it could be any sort of remote assistance you want to set up, e.g. something for Unix-using friends - or family to use. This includes [714]Mac OS X. + or family to use. This includes [719]Mac OS X. Assume you create a helpdesk directory "hd" on your website: http://www.mysite.com/hd (any website that you can upload files to @@ -8642,7 +8657,7 @@ chmod 755 ./x11vnc # platform, use $webhost/`uname`/x11vnc So I guess this is about 3-4 clicks (start a terminal and paste) and pressing "Enter" instead of "single click"... - See [715]this page for some variations on this method, e.g. how to add + See [720]this page for some variations on this method, e.g. how to add a password, SSL Certificates, etc. @@ -8654,11 +8669,11 @@ chmod 755 ./x11vnc # platform, use $webhost/`uname`/x11vnc A bit of obscurity security could be put in with a -passwd, -rfbauth options, etc. (note that x11vnc will require a password even for - reverse connections.) More info [716]here. + reverse connections.) More info [721]here. Firewalls: If the helpdesk (you) with the vncviewer is behind a - NAT/Firewall/Router the [717]router will have to be configured to + NAT/Firewall/Router the [722]router will have to be configured to redirect a port (i.e. 5500 or maybe different one if you like) to the vncviewer machine. If the vncviewer machine also has its own host-level firewall, you will have to open up the port there as well. @@ -8668,7 +8683,7 @@ chmod 755 ./x11vnc # platform, use $webhost/`uname`/x11vnc configuring a router to do a port redirection (i.e. on your side, the HelpDesk.) To avoid modifying either firewall/router, one would need some public (IP address reachable on the internet) redirection/proxy - service. Perhaps such a thing exists. [718]http://sc.uvnc.com provides + service. Perhaps such a thing exists. [723]http://sc.uvnc.com provides this service for their UltraVNC Single Click users. @@ -8704,7 +8719,7 @@ chmod 755 ./x11vnc # platform, use $webhost/`uname`/x11vnc As of Apr/2007 x11vnc supports reverse connections in SSL and so we can do this. On the Helpdesk side (Viewer) you will need STUNNEL or - better use the [719]Enhanced TightVNC Viewer (SSVNC) package we + better use the [724]Enhanced TightVNC Viewer (SSVNC) package we provide that automates all of the SSL for you. To do this create a file named "vncs" in the website "hd" directory @@ -8734,11 +8749,11 @@ chmod 755 ./x11vnc # platform, use $webhost/`uname`/x11vnc with the hostnames or IP addresses customized to your case. - The only change from the "vnc" above is the addition of the [720]-ssl + The only change from the "vnc" above is the addition of the [725]-ssl option to x11vnc. This will create a temporary SSL cert: openssl(1) will need to be installed on the user's end. A fixed SSL cert file could be used to avoid this (and provide some authentication; more - info [721]here.) + info [726]here.) The naive user will be doing this: wget -qO - http://www.mysite.com/hd/vncs | sh - @@ -8747,7 +8762,7 @@ chmod 755 ./x11vnc # platform, use $webhost/`uname`/x11vnc But before that, the helpdesk operator needs to have "vncviewer -listen" running as before, however he needs an SSL tunnel at his end. - The easiest way to do this is use [722]Enhanced TightVNC Viewer + The easiest way to do this is use [727]Enhanced TightVNC Viewer (SSVNC). Start it, and select Options -> 'Reverse VNC Connection (-listen)'. Then UN-select 'Verify All Certs' (this can be enabled later if you want; you'll need the x11vnc SSL certificate), and click @@ -8777,7 +8792,7 @@ connect = localhost:5501 answer the prompts with whatever you want; you can take the default for all of them if you like. The openssl(1) package must be installed. - See [723]this link and [724]this one too for more info on SSL certs. + See [728]this link and [729]this one too for more info on SSL certs. This creates $HOME/.vnc/certs/server-self:mystunnel.pem, then you would change the "stunnel.cfg" to look something like: foreground = yes @@ -8798,7 +8813,7 @@ connect = localhost:5501 then all bets are off!. More SSL variations and info about certificates can be found - [725]here. + [730]here. OpenSSL libssl.so.0.9.7 problems: @@ -8808,7 +8823,7 @@ connect = localhost:5501 distros are currently a bit of a mess regarding which version of libssl is installed. - You will find the [726]details here. + You will find the [731]details here. Q-124: Can I (temporarily) mount my local (viewer-side) Windows/Samba @@ -8817,7 +8832,7 @@ connect = localhost:5501 You will have to use an external network redirection for this. Filesystem mounting is not part of the VNC protocol. - We show a simple [727]Samba example here. + We show a simple [732]Samba example here. First you will need a tunnel to redirect the SMB requests from the remote machine to the one you sitting at. We use an ssh tunnel: @@ -8857,7 +8872,7 @@ d,ip=127.0.0.1,port=1139 far-away> smbumount /home/fred/smb-haystack-pub At some point we hope to fold some automation for SMB ssh redir setup - into the [728]Enhanced TightVNC Viewer (SSVNC) package we provide (as + into the [733]Enhanced TightVNC Viewer (SSVNC) package we provide (as of Sep 2006 it is there for testing.) @@ -8867,7 +8882,7 @@ d,ip=127.0.0.1,port=1139 You will have to use an external network redirection for this. Printing is not part of the VNC protocol. - We show a simple Unix to Unix [729]CUPS example here. Non-CUPS port + We show a simple Unix to Unix [734]CUPS example here. Non-CUPS port redirections (e.g. LPD) should also be possible, but may be a bit more tricky. If you are viewing on Windows SMB and don't have a local cups server it may be trickier still (see below.) @@ -8949,7 +8964,7 @@ d,ip=127.0.0.1,port=1139 "localhost". At some point we hope to fold some automation for CUPS ssh redir setup - into the [730]Enhanced TightVNC Viewer (SSVNC) package we provide (as + into the [735]Enhanced TightVNC Viewer (SSVNC) package we provide (as of Sep 2006 it is there for testing.) @@ -9050,7 +9065,7 @@ or: the applications will fail to run because LD_PRELOAD will point to libraries of the wrong wordsize. * At some point we hope to fold some automation for esd or artsd ssh - redir setup into the [731]Enhanced TightVNC Viewer (SSVNC) package + redir setup into the [736]Enhanced TightVNC Viewer (SSVNC) package we provide (as of Sep/2006 it is there for testing.) @@ -9062,14 +9077,14 @@ or: in Solaris, see Xserver(1) for how to turn it on via +kb), and so you won't hear them if the extension is not present. - If you don't want to hear the beeps use the [732]-nobell option. If + If you don't want to hear the beeps use the [737]-nobell option. If you want to hear the audio from the remote applications, consider - trying a [733]redirector such as esd. + trying a [738]redirector such as esd. Q-128: Does x11vnc work with IPv6? - Currently the only way to do this is via [734]inetd. You configure + Currently the only way to do this is via [739]inetd. You configure x11vnc to be run from inetd or xinetd and instruct it to listen on an IPv6 address. For xinetd the setting "flags = IPv6" will be needed. @@ -9078,7 +9093,7 @@ or: connection.) Some sort of ipv4-to-ipv6 redirector tool (perhaps even a perl script) could be useful to avoid this. - Also note that not all VNC Viewers are [735]IPv6 enabled, so a + Also note that not all VNC Viewers are [740]IPv6 enabled, so a redirector could even be needed on the client side. @@ -9311,526 +9326,531 @@ References 213. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen 214. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-8to24 215. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 216. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-8to24 - 217. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 218. http://www.karlrunge.com/x11vnc/faq.html#faq-overlays - 219. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sid - 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-24to32 - 222. http://www.karlrunge.com/x11vnc/ssvnc.html - 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display - 224. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 225. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flipbyteorder - 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 227. http://www.karlrunge.com/x11vnc/faq.html#infaq_xauth_pain - 228. http://www.karlrunge.com/x11vnc/faq.html#faq-noshm - 229. http://www.sun.com/sunray/index.html - 230. http://www.karlrunge.com/x11vnc/sunray.html - 231. http://wiki.sun-rays.org/index.php/Remote_Control_Toolkit - 232. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 233. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query - 234. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever - 235. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg - 236. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods - 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_keys - 238. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all - 239. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 240. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query - 241. http://www.karlrunge.com/x11vnc/faq.html#faq-config-file - 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 243. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd - 244. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 245. http://www.karlrunge.com/x11vnc/faq.html#faq-passwdfile - 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-usepw - 247. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewpasswd - 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwd - 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 250. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 216. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-appshare + 217. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-8to24 + 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 219. http://www.karlrunge.com/x11vnc/faq.html#faq-overlays + 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sid + 222. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-appshare + 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-24to32 + 224. http://www.karlrunge.com/x11vnc/ssvnc.html + 225. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display + 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flipbyteorder + 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 229. http://www.karlrunge.com/x11vnc/faq.html#infaq_xauth_pain + 230. http://www.karlrunge.com/x11vnc/faq.html#faq-noshm + 231. http://www.sun.com/sunray/index.html + 232. http://www.karlrunge.com/x11vnc/sunray.html + 233. http://wiki.sun-rays.org/index.php/Remote_Control_Toolkit + 234. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 235. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query + 236. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever + 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg + 238. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods + 239. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_keys + 240. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all + 241. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query + 243. http://www.karlrunge.com/x11vnc/faq.html#faq-config-file + 244. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 245. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd + 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 247. http://www.karlrunge.com/x11vnc/faq.html#faq-passwdfile + 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-usepw + 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewpasswd + 250. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwd 251. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 252. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 253. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_nis - 254. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 255. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 258. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 259. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 260. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-ext - 261. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 262. http://www.karlrunge.com/x11vnc/faq.html#faq-accept-opt - 263. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_cmd - 264. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 266. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_cmd - 267. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 268. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 269. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 252. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 253. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 254. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 255. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_nis + 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 258. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 259. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 260. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 261. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 262. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-ext + 263. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 264. http://www.karlrunge.com/x11vnc/faq.html#faq-accept-opt + 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_cmd + 266. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 267. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 268. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw_cmd + 269. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw 270. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 271. http://www.karlrunge.com/x11vnc/faq.html#faq-accept-opt - 272. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever - 273. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-shared - 274. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 275. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 276. http://www.karlrunge.com/x11vnc/faq.html#faq-passwd - 277. http://www.karlrunge.com/x11vnc/faq.html#faq-passwdfile - 278. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 279. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 280. http://www.karlrunge.com/x11vnc/faq.html#faq-tcp_wrappers - 281. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd - 282. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen - 283. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 284. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 271. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 272. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 273. http://www.karlrunge.com/x11vnc/faq.html#faq-accept-opt + 274. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever + 275. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-shared + 276. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 277. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 278. http://www.karlrunge.com/x11vnc/faq.html#faq-passwd + 279. http://www.karlrunge.com/x11vnc/faq.html#faq-passwdfile + 280. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 281. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 282. http://www.karlrunge.com/x11vnc/faq.html#faq-tcp_wrappers + 283. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd + 284. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen 285. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow 286. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 287. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input - 288. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 289. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewonly - 290. ftp://ftp.x.org/ - 291. http://www.karlrunge.com/x11vnc/dtVncPopup - 292. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 293. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-afteraccept - 294. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 295. http://www.karlrunge.com/x11vnc/blockdpy.c - 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 297. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forcedpms - 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clientdpms - 300. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabkbd - 301. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabptr - 302. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabptr - 303. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 304. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-afteraccept - 305. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 306. http://www.karlrunge.com/x11vnc/ssvnc.html + 287. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 288. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 289. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input + 290. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 291. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewonly + 292. ftp://ftp.x.org/ + 293. http://www.karlrunge.com/x11vnc/dtVncPopup + 294. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 295. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-afteraccept + 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 297. http://www.karlrunge.com/x11vnc/blockdpy.c + 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 300. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forcedpms + 301. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clientdpms + 302. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabkbd + 303. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabptr + 304. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-grabptr + 305. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 306. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-afteraccept 307. http://www.karlrunge.com/x11vnc/index.html#tunnelling 308. http://www.karlrunge.com/x11vnc/ssvnc.html - 309. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 310. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 311. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 312. http://www.karlrunge.com/x11vnc/chainingssh.html#gateway_double_ssh - 313. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 314. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 315. http://www.stunnel.org/ - 316. http://stunnel.mirt.net/ - 317. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 318. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 319. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslverify - 320. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-int - 321. http://www.stunnel.org/ - 322. http://www.karlrunge.com/x11vnc/ssl.html - 323. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer - 324. http://www.karlrunge.com/x11vnc/ssvnc.html - 325. http://www.karlrunge.com/x11vnc/ssl.html - 326. http://www.securityfocus.com/infocus/1677 + 309. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 310. http://www.karlrunge.com/x11vnc/ssvnc.html + 311. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 312. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 313. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 314. http://www.karlrunge.com/x11vnc/chainingssh.html#gateway_double_ssh + 315. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 316. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 317. http://www.stunnel.org/ + 318. http://stunnel.mirt.net/ + 319. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 320. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 321. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sslverify + 322. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-int + 323. http://www.stunnel.org/ + 324. http://www.karlrunge.com/x11vnc/ssl.html + 325. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 326. http://www.karlrunge.com/x11vnc/ssvnc.html 327. http://www.karlrunge.com/x11vnc/ssl.html - 328. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd - 329. http://sc.uvnc.com/javaviewer/index.html - 330. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 331. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers - 332. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir - 333. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http - 334. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 335. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https - 336. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 337. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 338. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer - 339. http://www.karlrunge.com/x11vnc/ssvnc.html - 340. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-ext - 341. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 342. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers + 328. http://www.securityfocus.com/infocus/1677 + 329. http://www.karlrunge.com/x11vnc/ssl.html + 330. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd + 331. http://sc.uvnc.com/javaviewer/index.html + 332. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 333. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers + 334. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir + 335. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http + 336. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 337. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https + 338. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 339. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 340. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 341. http://www.karlrunge.com/x11vnc/ssvnc.html + 342. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-ext 343. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 344. http://www.openssl.org/ - 345. http://sourceforge.net/projects/vencrypt/ - 346. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vencrypt - 347. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-anontls - 348. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers - 349. http://www.karlrunge.com/x11vnc/faq.html#infaq_ssl-vnc-viewers - 350. http://www.karlrunge.com/x11vnc/ssl.html - 351. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 344. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers + 345. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 346. http://www.openssl.org/ + 347. http://sourceforge.net/projects/vencrypt/ + 348. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vencrypt + 349. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-anontls + 350. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers + 351. http://www.karlrunge.com/x11vnc/faq.html#infaq_ssl-vnc-viewers 352. http://www.karlrunge.com/x11vnc/ssl.html - 353. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 354. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel - 355. http://www.stunnel.org/ - 356. http://www.karlrunge.com/x11vnc/faq.html#infaq_viewer-side-stunnel - 357. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer - 358. http://www.karlrunge.com/x11vnc/ssvnc.html - 359. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir - 360. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http - 361. http://sc.uvnc.com/javaviewer/index.html - 362. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 363. http://www.karlrunge.com/x11vnc/faq.html#infaq_ssl-router-redir - 364. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https - 365. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-portal - 366. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-java-viewer-proxy + 353. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 354. http://www.karlrunge.com/x11vnc/ssl.html + 355. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 356. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-stunnel + 357. http://www.stunnel.org/ + 358. http://www.karlrunge.com/x11vnc/faq.html#infaq_viewer-side-stunnel + 359. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 360. http://www.karlrunge.com/x11vnc/ssvnc.html + 361. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir + 362. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http + 363. http://sc.uvnc.com/javaviewer/index.html + 364. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 365. http://www.karlrunge.com/x11vnc/faq.html#infaq_ssl-router-redir + 366. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https 367. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-portal - 368. http://www.karlrunge.com/x11vnc/index.html#firewalls - 369. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir - 370. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport - 371. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpport - 372. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https - 373. http://www.karlrunge.com/x11vnc/ssl-output.html - 374. http://www.karlrunge.com/x11vnc/java_console_direct.html - 375. http://www.karlrunge.com/x11vnc/ssvnc.html - 376. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-ext - 377. http://www.karlrunge.com/x11vnc/ss_vncviewer - 378. http://www.karlrunge.com/x11vnc/ssl-portal.html - 379. http://www.karlrunge.com/x11vnc/ssl.html - 380. http://www.karlrunge.com/x11vnc/ssvnc.html - 381. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir - 382. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers - 383. http://www.karlrunge.com/x11vnc/java_console_proxy.html - 384. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer - 385. http://www.karlrunge.com/x11vnc/ssvnc.html - 386. http://www.karlrunge.com/x11vnc/ssl-portal.html - 387. http://www.karlrunge.com/x11vnc/ssl.html - 388. http://www.karlrunge.com/x11vnc/faq.html#infaq_display-manager-continuously - 389. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd - 390. http://www.karlrunge.com/x11vnc/faq.html#faq-userlogin - 391. http://www.karlrunge.com/x11vnc/faq.html#infaq_x11vnc_loop - 392. http://club.mandriva.com/xwiki/bin/view/KB/XwinXset - 393. http://www.karlrunge.com/x11vnc/index.html#firewalls - 394. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 395. http://www.karlrunge.com/x11vnc/faq.html#infaq_dtlogin_solaris - 396. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reopen - 397. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 398. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 368. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-java-viewer-proxy + 369. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-portal + 370. http://www.karlrunge.com/x11vnc/index.html#firewalls + 371. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir + 372. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport + 373. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpport + 374. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-https + 375. http://www.karlrunge.com/x11vnc/ssl-output.html + 376. http://www.karlrunge.com/x11vnc/java_console_direct.html + 377. http://www.karlrunge.com/x11vnc/ssvnc.html + 378. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-ext + 379. http://www.karlrunge.com/x11vnc/ss_vncviewer + 380. http://www.karlrunge.com/x11vnc/ssl-portal.html + 381. http://www.karlrunge.com/x11vnc/ssl.html + 382. http://www.karlrunge.com/x11vnc/ssvnc.html + 383. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpsredir + 384. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-viewers + 385. http://www.karlrunge.com/x11vnc/java_console_proxy.html + 386. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 387. http://www.karlrunge.com/x11vnc/ssvnc.html + 388. http://www.karlrunge.com/x11vnc/ssl-portal.html + 389. http://www.karlrunge.com/x11vnc/ssl.html + 390. http://www.karlrunge.com/x11vnc/faq.html#infaq_display-manager-continuously + 391. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd + 392. http://www.karlrunge.com/x11vnc/faq.html#faq-userlogin + 393. http://www.karlrunge.com/x11vnc/faq.html#infaq_x11vnc_loop + 394. http://club.mandriva.com/xwiki/bin/view/KB/XwinXset + 395. http://www.karlrunge.com/x11vnc/index.html#firewalls + 396. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 397. http://www.karlrunge.com/x11vnc/faq.html#infaq_dtlogin_solaris + 398. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reopen 399. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 400. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl - 401. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-N - 402. http://www.jirka.org/gdm-documentation/x241.html - 403. http://www.karlrunge.com/x11vnc/x11vnc_loop - 404. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop - 405. http://www.karlrunge.com/x11vnc/faq.html#faq-xterminal-xauth - 406. http://www.karlrunge.com/x11vnc/index.html#firewalls - 407. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd - 408. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q, - 409. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 410. http://www.karlrunge.com/x11vnc/faq.html#faq-userlogin - 411. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-avahi - 412. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-mdns - 413. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-zeroconf - 414. http://www.avahi.org/ - 415. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd - 416. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 417. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT - 418. http://www.karlrunge.com/x11vnc/faq.html#infaq_stunnel-inetd - 419. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop - 420. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 421. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 422. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 423. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 424. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT - 425. http://www.karlrunge.com/x11vnc/find_display.html - 426. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 427. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 428. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 429. http://www.karlrunge.com/x11vnc/faq.html#faq-unix-passwords - 430. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 431. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 432. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-int - 433. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 434. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw - 435. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 436. http://www.karlrunge.com/x11vnc/faq.html#faq-xvfb - 437. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer - 438. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 439. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 440. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT - 441. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc - 442. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 443. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop - 444. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop - 445. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 446. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir - 447. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http - 448. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-java-viewer-proxy - 449. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 450. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 451. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect_or_exit - 452. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vncconnect - 453. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy - 454. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy + 400. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 401. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 402. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 403. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-N + 404. http://www.jirka.org/gdm-documentation/x241.html + 405. http://www.karlrunge.com/x11vnc/x11vnc_loop + 406. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop + 407. http://www.karlrunge.com/x11vnc/faq.html#faq-xterminal-xauth + 408. http://www.karlrunge.com/x11vnc/index.html#firewalls + 409. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd + 410. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q, + 411. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 412. http://www.karlrunge.com/x11vnc/faq.html#faq-userlogin + 413. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-avahi + 414. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-mdns + 415. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-zeroconf + 416. http://www.avahi.org/ + 417. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd + 418. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 419. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT + 420. http://www.karlrunge.com/x11vnc/faq.html#infaq_stunnel-inetd + 421. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop + 422. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 423. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 424. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 425. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 426. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT + 427. http://www.karlrunge.com/x11vnc/find_display.html + 428. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 429. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 430. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 431. http://www.karlrunge.com/x11vnc/faq.html#faq-unix-passwords + 432. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 433. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 434. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-tunnel-int + 435. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 436. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-unixpw + 437. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 438. http://www.karlrunge.com/x11vnc/faq.html#faq-xvfb + 439. http://www.karlrunge.com/x11vnc/faq.html#ss_vncviewer + 440. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 441. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 442. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT + 443. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc + 444. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 445. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop + 446. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-loop + 447. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 448. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir + 449. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http + 450. http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-java-viewer-proxy + 451. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 452. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 453. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect_or_exit + 454. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vncconnect 455. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy - 456. http://www.karlrunge.com/x11vnc/faq.html#infaq_localaccess - 457. http://www.karlrunge.com/x11vnc/faq.html#infaq_localaccess - 458. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 459. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT - 460. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 461. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 462. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 463. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 464. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 465. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 466. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc - 467. http://www.karlrunge.com/x11vnc/Xdummy - 468. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 469. http://www.karlrunge.com/x11vnc/xdm_one_shot.html - 470. http://www.karlrunge.com/x11vnc/faq.html#infaq_display-manager-continuously - 471. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay - 472. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT - 473. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find - 474. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create - 475. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc - 476. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc - 477. http://www.karlrunge.com/x11vnc/shm_clear - 478. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 479. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 480. http://www.karlrunge.com/x11vnc/faq.html#faq-noshm - 481. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nap - 482. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 483. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sb - 484. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 485. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs - 486. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 487. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 488. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 489. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 490. http://www.karlrunge.com/x11vnc/faq.html#faq-turbovnc - 491. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid - 492. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 493. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 494. http://www.tightvnc.com/ - 495. http://www.karlrunge.com/x11vnc/ssvnc.html - 496. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 497. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 498. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid - 499. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-speeds - 500. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 501. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs - 502. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 503. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 504. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-progressive - 505. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 506. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel - 507. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor - 508. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos - 509. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-readtimeout - 510. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen - 511. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 512. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_area - 513. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_mem - 514. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage - 515. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage - 516. http://minimyth.org/ - 517. http://www.karlrunge.com/x11vnc/faq.html#faq-beryl - 518. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 519. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 520. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 521. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 522. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 523. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 524. http://www.karlrunge.com/x11vnc/faq.html#faq-wireframe - 525. http://www.karlrunge.com/x11vnc/faq.html#faq-scrollcopyrect - 526. http://www.karlrunge.com/x11vnc/faq.html#faq-pointer-mode - 527. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 528. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 529. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 530. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 531. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 532. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 456. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy + 457. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-proxy + 458. http://www.karlrunge.com/x11vnc/faq.html#infaq_localaccess + 459. http://www.karlrunge.com/x11vnc/faq.html#infaq_localaccess + 460. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 461. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT + 462. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 463. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 464. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 465. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 466. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 467. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 468. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc + 469. http://www.karlrunge.com/x11vnc/Xdummy + 470. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 471. http://www.karlrunge.com/x11vnc/xdm_one_shot.html + 472. http://www.karlrunge.com/x11vnc/faq.html#infaq_display-manager-continuously + 473. http://www.karlrunge.com/x11vnc/faq.html#infaq_findcreatedisplay + 474. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display_WAIT + 475. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-find + 476. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-create + 477. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-svc + 478. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xdmsvc + 479. http://www.karlrunge.com/x11vnc/shm_clear + 480. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 481. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 482. http://www.karlrunge.com/x11vnc/faq.html#faq-noshm + 483. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nap + 484. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 485. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sb + 486. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 487. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs + 488. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 489. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 490. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 491. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 492. http://www.karlrunge.com/x11vnc/faq.html#faq-turbovnc + 493. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid + 494. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 495. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 496. http://www.tightvnc.com/ + 497. http://www.karlrunge.com/x11vnc/ssvnc.html + 498. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 499. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 500. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid + 501. http://www.karlrunge.com/x11vnc/faq.html#faq-client-caching + 502. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache + 503. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-speeds + 504. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 505. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs + 506. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 507. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 508. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-progressive + 509. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 510. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-appshare + 511. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel + 512. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor + 513. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos + 514. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-readtimeout + 515. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen + 516. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 517. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_area + 518. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_mem + 519. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 520. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 521. http://minimyth.org/ + 522. http://www.karlrunge.com/x11vnc/faq.html#faq-beryl + 523. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 524. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 525. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 526. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 527. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 528. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 529. http://www.karlrunge.com/x11vnc/faq.html#faq-wireframe + 530. http://www.karlrunge.com/x11vnc/faq.html#faq-scrollcopyrect + 531. http://www.karlrunge.com/x11vnc/faq.html#faq-pointer-mode + 532. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow 533. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 534. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wirecopyrect - 535. http://www.karlrunge.com/x11vnc/faq.html#faq-wireframe - 536. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen - 537. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scr_skip - 538. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 539. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 540. http://www.karlrunge.com/x11vnc/index.html#beta-test - 541. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache - 542. http://www.karlrunge.com/x11vnc/ssvnc.html - 543. http://www.karlrunge.com/x11vnc/ssvnc.html#ycrop - 544. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache_no_rootpixmap - 545. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache_cr - 546. http://www.virtualgl.org/About/TurboVNC - 547. http://www.virtualgl.org/ - 548. http://sourceforge.net/project/showfiles.php?group_id=117509&package_id=166100 - 549. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 550. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 551. http://sourceforge.net/project/showfiles.php?group_id=117509&package_id=166100 - 552. http://www.karlrunge.com/x11vnc/ssvnc.html - 553. http://www.karlrunge.com/x11vnc/bins - 554. http://www.karlrunge.com/x11vnc/ssvnc.html - 555. http://www.virtualgl.org/About/Reports - 556. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 557. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 558. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 559. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 560. http://www.karlrunge.com/x11vnc/faq.html#infaq_the-overlay-mode - 561. http://www.karlrunge.com/x11vnc/index.html#solaris10-build - 562. http://www.karlrunge.com/x11vnc/faq.html#faq-xfixes-alpha-hacks - 563. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphacut - 564. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphafrac - 565. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alpharemove - 566. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape - 567. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noalphablend - 568. http://www.karlrunge.com/x11vnc/ssvnc.html - 569. http://www.tightvnc.com/ - 570. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor - 571. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursorpos - 572. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos - 573. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape - 574. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap - 575. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_pointer - 576. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap - 577. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 578. http://www.karlrunge.com/x11vnc/faq.html#faq-greaterless - 579. http://www.karlrunge.com/x11vnc/faq.html#faq-xkbmodtweak - 580. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard - 581. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 582. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 583. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys - 584. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 585. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 586. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 587. http://www.karlrunge.com/x11vnc/faq.html#faq-xkbmodtweak - 588. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard - 589. http://www.karlrunge.com/x11vnc/faq.html#faq-greaterless - 590. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 591. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys - 592. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 593. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 594. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 595. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_keycodes - 596. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 597. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 598. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 599. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 600. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 601. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat - 602. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat - 603. http://www.karlrunge.com/x11vnc/faq.html#faq-display-manager - 604. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods - 605. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 606. http://www.karlrunge.com/x11vnc/faq.html#faq-remap-capslock - 607. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_lockkeys - 608. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-capslock - 609. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all + 534. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 535. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 536. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 537. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 538. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 539. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wirecopyrect + 540. http://www.karlrunge.com/x11vnc/faq.html#faq-wireframe + 541. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen + 542. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scr_skip + 543. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 544. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 545. http://www.karlrunge.com/x11vnc/index.html#beta-test + 546. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache + 547. http://www.karlrunge.com/x11vnc/ssvnc.html + 548. http://www.karlrunge.com/x11vnc/ssvnc.html#ycrop + 549. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache_no_rootpixmap + 550. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ncache_cr + 551. http://www.virtualgl.org/About/TurboVNC + 552. http://www.virtualgl.org/ + 553. http://sourceforge.net/project/showfiles.php?group_id=117509&package_id=166100 + 554. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 555. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 556. http://sourceforge.net/project/showfiles.php?group_id=117509&package_id=166100 + 557. http://www.karlrunge.com/x11vnc/ssvnc.html + 558. http://www.karlrunge.com/x11vnc/bins + 559. http://www.karlrunge.com/x11vnc/ssvnc.html + 560. http://www.virtualgl.org/About/Reports + 561. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 562. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 563. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 564. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 565. http://www.karlrunge.com/x11vnc/faq.html#infaq_the-overlay-mode + 566. http://www.karlrunge.com/x11vnc/index.html#solaris10-build + 567. http://www.karlrunge.com/x11vnc/faq.html#faq-xfixes-alpha-hacks + 568. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphacut + 569. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphafrac + 570. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alpharemove + 571. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape + 572. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noalphablend + 573. http://www.karlrunge.com/x11vnc/ssvnc.html + 574. http://www.tightvnc.com/ + 575. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor + 576. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursorpos + 577. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos + 578. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape + 579. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap + 580. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_pointer + 581. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap + 582. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 583. http://www.karlrunge.com/x11vnc/faq.html#faq-greaterless + 584. http://www.karlrunge.com/x11vnc/faq.html#faq-xkbmodtweak + 585. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 586. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 587. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 588. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys + 589. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 590. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 591. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 592. http://www.karlrunge.com/x11vnc/faq.html#faq-xkbmodtweak + 593. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 594. http://www.karlrunge.com/x11vnc/faq.html#faq-greaterless + 595. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 596. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys + 597. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 598. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 599. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 600. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_keycodes + 601. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 602. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 603. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 604. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 605. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 606. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat + 607. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat + 608. http://www.karlrunge.com/x11vnc/faq.html#faq-display-manager + 609. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods 610. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 611. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 612. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nomodtweak - 613. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 614. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 615. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_lockkeys + 611. http://www.karlrunge.com/x11vnc/faq.html#faq-remap-capslock + 612. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_lockkeys + 613. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-capslock + 614. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all + 615. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap 616. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap 617. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nomodtweak - 618. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-capslock - 619. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all - 620. http://www.karlrunge.com/x11vnc/faq.html#faq-scaling - 621. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 622. http://people.pwf.cam.ac.uk/ssb22/setup/vnc-magnification.html - 623. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport - 624. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 625. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 626. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale_cursor - 627. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-blackout - 628. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama - 629. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama - 630. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer - 631. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer - 632. http://www.karlrunge.com/x11vnc/faq.html#faq-solshm - 633. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 634. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 635. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip - 636. http://www.karlrunge.com/x11vnc/faq.html#faq-xinerama - 637. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 638. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 639. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xrandr - 640. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-padgeom - 641. http://www.karlrunge.com/x11vnc/ssvnc.html - 642. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rotate - 643. http://www.jwz.org/xscreensaver/man1.html - 644. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodpms - 645. http://www.beryl-project.org/ - 646. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage - 647. http://www.dslinux.org/blogs/pepsiman/?p=73 - 648. http://minimyth.org/ - 649. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc - 650. http://www.karlrunge.com/x11vnc/faq.html#faq-rawfb - 651. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc - 652. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 653. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 654. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput - 655. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput - 656. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-snapfb - 657. http://www.karlrunge.com/x11vnc/faq.html#faq-video - 658. http://www.karlrunge.com/x11vnc/faq.html#faq-xvfb - 659. http://www.karlrunge.com/x11vnc/faq.html#faq-qt-embedded - 660. http://www.karlrunge.com/x11vnc/faq.html#faq-video - 661. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 618. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 619. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 620. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_lockkeys + 621. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 622. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nomodtweak + 623. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-capslock + 624. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_all + 625. http://www.karlrunge.com/x11vnc/faq.html#faq-scaling + 626. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 627. http://people.pwf.cam.ac.uk/ssb22/setup/vnc-magnification.html + 628. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport + 629. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 630. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 631. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale_cursor + 632. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-blackout + 633. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama + 634. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama + 635. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer + 636. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer + 637. http://www.karlrunge.com/x11vnc/faq.html#faq-solshm + 638. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 639. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 640. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip + 641. http://www.karlrunge.com/x11vnc/faq.html#faq-xinerama + 642. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 643. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 644. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xrandr + 645. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-padgeom + 646. http://www.karlrunge.com/x11vnc/ssvnc.html + 647. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rotate + 648. http://www.jwz.org/xscreensaver/man1.html + 649. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodpms + 650. http://www.beryl-project.org/ + 651. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 652. http://www.dslinux.org/blogs/pepsiman/?p=73 + 653. http://minimyth.org/ + 654. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc + 655. http://www.karlrunge.com/x11vnc/faq.html#faq-rawfb + 656. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc + 657. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 658. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 659. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput + 660. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput + 661. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-snapfb 662. http://www.karlrunge.com/x11vnc/faq.html#faq-video - 663. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc + 663. http://www.karlrunge.com/x11vnc/faq.html#faq-xvfb 664. http://www.karlrunge.com/x11vnc/faq.html#faq-qt-embedded - 665. http://www.karlrunge.com/x11vnc/faq.html#faq-vmware + 665. http://www.karlrunge.com/x11vnc/faq.html#faq-video 666. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 667. http://www.karlrunge.com/x11vnc/faq.html#faq-rawfb - 668. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-snapfb - 669. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-24to32 - 670. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 671. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-slow_fb - 672. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 673. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-freqtab - 674. http://www.karlrunge.com/x11vnc/faq.html#faq-rawfb - 675. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput - 676. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput - 677. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 678. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 679. http://www.testplant.com/products/vine_server/OS_X - 680. http://www.apple.com/remotedesktop/ - 681. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 682. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 683. http://fredrik.hubbe.net/x2vnc.html - 684. http://www.karlrunge.com/x11vnc/faq.html#faq-win2vnc - 685. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reflect - 686. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb - 687. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 688. http://sourceforge.net/projects/vnc-reflector/ - 689. http://www.tightvnc.com/projector/ - 690. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 691. http://www.karlrunge.com/x11vnc/faq.html#faq-display-manager - 692. http://www.karlrunge.com/x11vnc/faq.html#faq-display-manager - 693. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 694. http://www.jwz.org/doc/x-cut-and-paste.html - 695. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel - 696. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noprimary - 697. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noclipboard - 698. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosetprimary - 699. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosetclipboard - 700. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-seldir - 701. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input - 702. http://www.unixuser.org/~euske/vnc2swf/ - 703. http://wolphination.com/linux/2006/06/30/how-to-record-videos-of-your-desktop/ - 704. http://www.karlrunge.com/x11vnc/ssvnc.html - 705. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-tightfilexfer - 706. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 707. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ultrafilexfer - 708. http://www.karlrunge.com/x11vnc/ssvnc.html - 709. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noultraext - 710. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noserverdpms - 711. http://www.uvnc.com/addons/repeater.html - 712. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 713. http://www.uvnc.com/addons/singleclick.html - 714. http://www.karlrunge.com/x11vnc/faq.html#faq-macosx - 715. http://www.karlrunge.com/x11vnc/single-click.html - 716. http://www.karlrunge.com/x11vnc/single-click.html - 717. http://www.karlrunge.com/x11vnc/index.html#firewalls - 718. http://sc.uvnc.com/ - 719. http://www.karlrunge.com/x11vnc/ssvnc.html - 720. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 667. http://www.karlrunge.com/x11vnc/faq.html#faq-video + 668. http://www.karlrunge.com/x11vnc/faq.html#faq-linuxvc + 669. http://www.karlrunge.com/x11vnc/faq.html#faq-qt-embedded + 670. http://www.karlrunge.com/x11vnc/faq.html#faq-vmware + 671. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 672. http://www.karlrunge.com/x11vnc/faq.html#faq-rawfb + 673. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-snapfb + 674. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-24to32 + 675. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 676. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-slow_fb + 677. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 678. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-freqtab + 679. http://www.karlrunge.com/x11vnc/faq.html#faq-rawfb + 680. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput + 681. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pipeinput + 682. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 683. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 684. http://www.testplant.com/products/vine_server/OS_X + 685. http://www.apple.com/remotedesktop/ + 686. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 687. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nofb + 688. http://fredrik.hubbe.net/x2vnc.html + 689. http://www.karlrunge.com/x11vnc/faq.html#faq-win2vnc + 690. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-reflect + 691. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rawfb + 692. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 693. http://sourceforge.net/projects/vnc-reflector/ + 694. http://www.tightvnc.com/projector/ + 695. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 696. http://www.karlrunge.com/x11vnc/faq.html#faq-display-manager + 697. http://www.karlrunge.com/x11vnc/faq.html#faq-display-manager + 698. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 699. http://www.jwz.org/doc/x-cut-and-paste.html + 700. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel + 701. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noprimary + 702. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noclipboard + 703. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosetprimary + 704. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosetclipboard + 705. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-seldir + 706. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input + 707. http://www.unixuser.org/~euske/vnc2swf/ + 708. http://wolphination.com/linux/2006/06/30/how-to-record-videos-of-your-desktop/ + 709. http://www.karlrunge.com/x11vnc/ssvnc.html + 710. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-tightfilexfer + 711. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 712. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ultrafilexfer + 713. http://www.karlrunge.com/x11vnc/ssvnc.html + 714. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noultraext + 715. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noserverdpms + 716. http://www.uvnc.com/addons/repeater.html + 717. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 718. http://www.uvnc.com/addons/singleclick.html + 719. http://www.karlrunge.com/x11vnc/faq.html#faq-macosx + 720. http://www.karlrunge.com/x11vnc/single-click.html 721. http://www.karlrunge.com/x11vnc/single-click.html - 722. http://www.karlrunge.com/x11vnc/ssvnc.html - 723. http://www.karlrunge.com/x11vnc/single-click.html - 724. http://www.karlrunge.com/x11vnc/ssl.html - 725. http://www.karlrunge.com/x11vnc/single-click.html - 726. http://www.karlrunge.com/x11vnc/single-click.html#libssl-problems - 727. http://www.samba.org/ - 728. http://www.karlrunge.com/x11vnc/ssvnc.html - 729. http://www.cups.org/ - 730. http://www.karlrunge.com/x11vnc/ssvnc.html - 731. http://www.karlrunge.com/x11vnc/ssvnc.html - 732. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nobell - 733. http://www.karlrunge.com/x11vnc/faq.html#faq-sound - 734. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd - 735. http://jungla.dit.upm.es/~acosta/paginas/vncIPv6.html + 722. http://www.karlrunge.com/x11vnc/index.html#firewalls + 723. http://sc.uvnc.com/ + 724. http://www.karlrunge.com/x11vnc/ssvnc.html + 725. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-ssl + 726. http://www.karlrunge.com/x11vnc/single-click.html + 727. http://www.karlrunge.com/x11vnc/ssvnc.html + 728. http://www.karlrunge.com/x11vnc/single-click.html + 729. http://www.karlrunge.com/x11vnc/ssl.html + 730. http://www.karlrunge.com/x11vnc/single-click.html + 731. http://www.karlrunge.com/x11vnc/single-click.html#libssl-problems + 732. http://www.samba.org/ + 733. http://www.karlrunge.com/x11vnc/ssvnc.html + 734. http://www.cups.org/ + 735. http://www.karlrunge.com/x11vnc/ssvnc.html + 736. http://www.karlrunge.com/x11vnc/ssvnc.html + 737. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nobell + 738. http://www.karlrunge.com/x11vnc/faq.html#faq-sound + 739. http://www.karlrunge.com/x11vnc/faq.html#faq-inetd + 740. http://jungla.dit.upm.es/~acosta/paginas/vncIPv6.html ======================================================================= http://www.karlrunge.com/x11vnc/chainingssh.html: @@ -12874,100 +12894,100 @@ x11vnc: a VNC server for real X displays Here are all of x11vnc command line options: % x11vnc -opts (see below for -help long descriptions) -x11vnc: allow VNC connections to real X11 displays. 0.9.9 lastmod: 2009-11-18 +x11vnc: allow VNC connections to real X11 displays. 0.9.9 lastmod: 2009-12-02 x11vnc options: -display disp -auth file -N -autoport n -rfbport str -reopen -reflect host:N -id windowid -sid windowid - -clip WxH+X+Y -flashcmap -shiftcmap n - -notruecolor -advertise_truecolor -visual n - -overlay -overlay_nocursor -8to24 [opts] - -24to32 -scale fraction -geometry WxH - -scale_cursor frac -viewonly -shared - -once -forever -loop - -timeout n -sleepin n -inetd - -tightfilexfer -ultrafilexfer -http - -http_ssl -avahi -mdns - -zeroconf -connect string -connect_or_exit str - -proxy string -vncconnect -novncconnect - -allow host1[,host2..] -localhost -nolookup - -input string -grabkbd -grabptr - -grabalways -viewpasswd string -passwdfile filename - -showrfbauth filename -unixpw [list] -unixpw_nis [list] - -unixpw_cmd cmd -find -finddpy - -listdpy -findauth [disp] -create - -xdummy -xvnc -xvnc_redirect - -svc -svc_xdummy -svc_xvnc - -xdmsvc -sshxdmsvc -unixpw_system_greeter - -redirect port -display WAIT:... -vencrypt mode - -anontls mode -sslonly -dhparams file - -nossl -ssl [pem] -ssltimeout n - -sslnofail -ssldir [dir] -sslverify [path] - -sslCRL path -sslGenCA [dir] -sslGenCert type name - -sslEncKey [pem] -sslCertInfo [pem] -sslDelCert [pem] - -stunnel [pem] -stunnel3 [pem] -enc cipher:keyfile - -https [port] -httpsredir [port] -http_oneport - -ssh user@host:disp -usepw -storepasswd pass file - -nopw -accept string -afteraccept string - -gone string -users list -noshm - -flipbyteorder -onetile -solid [color] - -blackout string -xinerama -noxinerama - -xtrap -xrandr [mode] -rotate string - -padgeom WxH -o logfile -flag file - -rmflag file -rc filename -norc - -env VAR=VALUE -prog /path/to/x11vnc -h, -help - -?, -opts -V, -version -license - -dbg -q, -quiet -v, -verbose - -bg -modtweak -nomodtweak - -xkb -noxkb -capslock - -skip_lockkeys -noskip_lockkeys -skip_keycodes string - -sloppy_keys -skip_dups -noskip_dups - -add_keysyms -noadd_keysyms -clear_mods - -clear_keys -clear_all -remap string - -norepeat -repeat -nofb - -nobell -nosel -noprimary - -nosetprimary -noclipboard -nosetclipboard - -seldir string -cursor [mode] -nocursor - -cursor_drag -arrow n -noxfixes - -alphacut n -alphafrac fraction -alpharemove - -noalphablend -nocursorshape -cursorpos - -nocursorpos -xwarppointer -noxwarppointer - -buttonmap string -nodragging -ncache n - -ncache_cr -ncache_no_moveraise -ncache_no_dtchange - -ncache_no_rootpixmap -ncache_keep_anims -ncache_old_wm - -ncache_pad n -debug_ncache -wireframe [str] - -nowireframe -nowireframelocal -wirecopyrect mode - -nowirecopyrect -debug_wireframe -scrollcopyrect mode - -noscrollcopyrect -scr_area n -scr_skip list - -scr_inc list -scr_keys list -scr_term list - -scr_keyrepeat lo-hi -scr_parms string -fixscreen string - -debug_scroll -noxrecord -grab_buster - -nograb_buster -debug_grabs -debug_sel - -pointer_mode n -input_skip n -allinput - -speeds rd,bw,lat -wmdt string -debug_pointer - -debug_keyboard -defer time -wait time - -extra_fbur n -wait_ui factor -setdefer n - -nowait_bog -slow_fb time -xrefresh time - -nap -nonap -sb time - -readtimeout n -ping n -nofbpm - -fbpm -nodpms -dpms - -forcedpms -clientdpms -noserverdpms - -noultraext -chatwindow -noxdamage - -xd_area A -xd_mem f -sigpipe string - -threads -nothreads -fs f - -gaps n -grow n -fuzz n - -debug_tiles -snapfb -rawfb string - -freqtab file -pipeinput cmd -macnodim - -macnosleep -macnosaver -macnowait - -macwheel n -macnoswap -macnoresize - -maciconanim n -macmenu -macuskbd - -gui [gui-opts] -remote command -query variable - -QD variable -sync -query_retries str - -remote_prefix str -noremote -yesremote - -unsafe -safer -privremote - -nocmds -allowedcmds list -deny_all - + -appshare -clip WxH+X+Y -flashcmap + -shiftcmap n -notruecolor -advertise_truecolor + -visual n -overlay -overlay_nocursor + -8to24 [opts] -24to32 -scale fraction + -geometry WxH -scale_cursor frac -viewonly + -shared -once -forever + -loop -timeout n -sleepin n + -inetd -tightfilexfer -ultrafilexfer + -http -http_ssl -avahi + -mdns -zeroconf -connect string + -connect_or_exit str -proxy string -vncconnect + -novncconnect -allow host1[,host2..] -localhost + -nolookup -input string -grabkbd + -grabptr -grabalways -viewpasswd string + -passwdfile filename -showrfbauth filename -unixpw [list] + -unixpw_nis [list] -unixpw_cmd cmd -find + -finddpy -listdpy -findauth [disp] + -create -xdummy -xvnc + -xvnc_redirect -svc -svc_xdummy + -svc_xvnc -xdmsvc -sshxdmsvc + -unixpw_system_greeter -redirect port -display WAIT:... + -vencrypt mode -anontls mode -sslonly + -dhparams file -nossl -ssl [pem] + -ssltimeout n -sslnofail -ssldir [dir] + -sslverify [path] -sslCRL path -sslGenCA [dir] + -sslGenCert type name -sslEncKey [pem] -sslCertInfo [pem] + -sslDelCert [pem] -stunnel [pem] -stunnel3 [pem] + -enc cipher:keyfile -https [port] -httpsredir [port] + -http_oneport -ssh user@host:disp -usepw + -storepasswd pass file -nopw -accept string + -afteraccept string -gone string -users list + -noshm -flipbyteorder -onetile + -solid [color] -blackout string -xinerama + -noxinerama -xtrap -xrandr [mode] + -rotate string -padgeom WxH -o logfile + -flag file -rmflag file -rc filename + -norc -env VAR=VALUE -prog /path/to/x11vnc + -h, -help -?, -opts -V, -version + -license -dbg -q, -quiet + -v, -verbose -bg -modtweak + -nomodtweak -xkb -noxkb + -capslock -skip_lockkeys -noskip_lockkeys + -skip_keycodes string -sloppy_keys -skip_dups + -noskip_dups -add_keysyms -noadd_keysyms + -clear_mods -clear_keys -clear_all + -remap string -norepeat -repeat + -nofb -nobell -nosel + -noprimary -nosetprimary -noclipboard + -nosetclipboard -seldir string -cursor [mode] + -nocursor -cursor_drag -arrow n + -noxfixes -alphacut n -alphafrac fraction + -alpharemove -noalphablend -nocursorshape + -cursorpos -nocursorpos -xwarppointer + -noxwarppointer -buttonmap string -nodragging + -ncache n -ncache_cr -ncache_no_moveraise + -ncache_no_dtchange -ncache_no_rootpixmap -ncache_keep_anims + -ncache_old_wm -ncache_pad n -debug_ncache + -wireframe [str] -nowireframe -nowireframelocal + -wirecopyrect mode -nowirecopyrect -debug_wireframe + -scrollcopyrect mode -noscrollcopyrect -scr_area n + -scr_skip list -scr_inc list -scr_keys list + -scr_term list -scr_keyrepeat lo-hi -scr_parms string + -fixscreen string -debug_scroll -noxrecord + -grab_buster -nograb_buster -debug_grabs + -debug_sel -pointer_mode n -input_skip n + -allinput -speeds rd,bw,lat -wmdt string + -debug_pointer -debug_keyboard -defer time + -wait time -extra_fbur n -wait_ui factor + -setdefer n -nowait_bog -slow_fb time + -xrefresh time -nap -nonap + -sb time -readtimeout n -ping n + -nofbpm -fbpm -nodpms + -dpms -forcedpms -clientdpms + -noserverdpms -noultraext -chatwindow + -noxdamage -xd_area A -xd_mem f + -sigpipe string -threads -nothreads + -fs f -gaps n -grow n + -fuzz n -debug_tiles -snapfb + -rawfb string -freqtab file -pipeinput cmd + -macnodim -macnosleep -macnosaver + -macnowait -macwheel n -macnoswap + -macnoresize -maciconanim n -macmenu + -macuskbd -gui [gui-opts] -remote command + -query variable -QD variable -sync + -query_retries str -remote_prefix str -noremote + -yesremote -unsafe -safer + -privremote -nocmds -allowedcmds list + -deny_all libvncserver options: -rfbport port TCP port for RFB protocol @@ -13001,7 +13021,7 @@ libvncserver-tight-extension options: % x11vnc -help -x11vnc: allow VNC connections to real X11 displays. 0.9.9 lastmod: 2009-11-18 +x11vnc: allow VNC connections to real X11 displays. 0.9.9 lastmod: 2009-12-02 (type "x11vnc -opts" to just list the options.) @@ -13127,6 +13147,14 @@ Options: shifts a root view to it: this shows SaveUnders menus, etc, although they will be clipped if they extend beyond the window. + +-appshare Simple application sharing based on the -id/-sid + mechanism. Every new toplevel window that the + application creates induces a new viewer window via + a reverse connection. The -id/-sid and -connect + options are required. Run 'x11vnc -appshare -help' + for more info. + -clip WxH+X+Y Only show the sub-region of the full display that corresponds to the rectangle geometry with size WxH and offset +X+Y. The VNC display has size WxH (i.e. smaller @@ -15721,7 +15749,7 @@ t "debug crash shell" when fatal errors are trapped. -q, -quiet Be quiet by printing less informational output to - stderr. + stderr. (use -noquiet to undo an earlier -quiet.) -v, -verbose Print out more information to stderr. -bg Go into the background after screen setup. Messages to @@ -16117,7 +16145,7 @@ t (an integer) times that of the full display is allocated below the actual framebuffer to cache screen contents for rapid retrieval. So a W x H frambuffer is expanded - to a W x (n+1)*H one. Use 0 to disable. Default: XXX. + to a W x (n+1)*H one. Use 0 to disable. The "n" is actually optional, the default is 10. @@ -16125,13 +16153,17 @@ t abbreviate "-ncache" with "-nc". Also, "-nonc" is the same as "-ncache 0" - This is an experimental option, currently implemented - in an awkward way in that in the VNC Viewer you can - see the cache contents if you scroll down, etc. So you + This is an experimental option, currently implemented in + an awkward way in that in the VNC Viewer you can see the + pixel cache contents if you scroll down, etc. So you will have to set things up so you can't see that region. If this method is successful, the changes required for clients to do this less awkwardly will be investigated. + The SSVNC viewer does a good job at automatically hiding + the pixel cache region. Or use SSVNC's -ycrop option + to explicitly hide the region. + Note that this mode consumes a huge amount of memory, both on the x11vnc server side and on the VNC Viewer side. If n=2 then the amount of RAM used is roughly @@ -16838,10 +16870,7 @@ t for output) are created to handle each new client. Default: -nothreads. - NOTE: The -threads mode may be disabled due to its - unstable behavior. If it is disabled, a warning is - printed out. Stability has been improved in version - 0.9.8 and so the feature has been re-enabled. + Thread stability is much improved in version 0.9.8. Multiple clients in threaded mode should be stable for the ZRLE encoding on all platforms. The Tight and @@ -16849,9 +16878,15 @@ t multiple clients. Compile with -DTLS=__thread if your OS and compiler and linker support it. + For resizes (randr, etc.) set this env. var. to the numb +er + of milliseconds to sleep: X11VNC_THREADS_NEW_FB_SLEEP + at various places in the do_new_fb() action. This is to + let various activities settle. Default is about 500ms. + Multiple clients in threaded mode could yield better - performance for 'class-room' broadcasting usage. - See also the -reflect option. + performance for 'class-room' broadcasting usage; also in + -appshare broadcast mode. See also the -reflect option. -fs f If the fraction of changed tiles in a poll is greater than f, the whole screen is updated. Default: 0.75 @@ -17542,6 +17577,12 @@ n id:windowid set -id window to "windowid". empty or "root" to go back to root window sid:windowid set -sid window to "windowid" + id_cmd:cmd cmds: raise, lower, map, unmap, iconify, + move:dXdY, resize:dWdH, geom:WxH+X+Y. dX + dY, dW, and dH must have a leading "+" + or "-" e.g.: move:-30+10 resize:+20+35 + also: wm_delete, wm_name:string and + icon_name:string. Also id_cmd:win=N:cmd waitmapped wait until subwin is mapped. nowaitmapped do not wait until subwin is mapped. clip:WxH+X+Y set -clip mode to "WxH+X+Y" @@ -18018,8 +18059,8 @@ n file use "qry=..." instead of "cmd=..." ans= stop quit exit shutdown ping resend_cutbuffer - resend_clipboard resend_primary blacken zero - refresh reset close disconnect id sid waitmapped + resend_clipboard resend_primary blacken zero refresh + reset close disconnect id_cmd id sid waitmapped nowaitmapped clip flashcmap noflashcmap shiftcmap truecolor notruecolor overlay nooverlay overlay_cursor overlay_yescursor nooverlay_nocursor nooverlay_cursor @@ -18161,6 +18202,10 @@ n The returned output is also prefixed with "str". Example: -remote_prefix DO_THIS: + Note that enabling -remote_prefix allows the remote + VNC viewers to run x11vnc -remote commands. Do not + use this option if they are not to be trusted. + -noremote Do not process any remote control commands or queries. -yesremote Do process remote control commands or queries. Default: -yesremote diff --git a/x11vnc/appshare.c b/x11vnc/appshare.c new file mode 100644 index 0000000..72c2bdd --- /dev/null +++ b/x11vnc/appshare.c @@ -0,0 +1,2116 @@ +/* + Copyright (C) 2002-2009 Karl J. Runge + All rights reserved. + +This file is part of x11vnc. + +x11vnc is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or (at +your option) any later version. + +x11vnc is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with x11vnc; if not, write to the Free Software +Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA +or see . + +In addition, as a special exception, Karl J. Runge +gives permission to link the code of its release of x11vnc with the +OpenSSL project's "OpenSSL" library (or with modified versions of it +that use the same license as the "OpenSSL" library), and distribute +the linked executables. You must obey the GNU General Public License +in all respects for all of the code used other than "OpenSSL". If you +modify this file, you may extend this exception to your version of the +file, but you are not obligated to do so. If you do not wish to do +so, delete this exception statement from your version. +*/ + +/* -- appshare.c -- */ + +#include "x11vnc.h" + +extern int pick_windowid(unsigned long *num); +extern char *get_xprop(char *prop, Window win); +extern int set_xprop(char *prop, Window win, char *value); +extern void set_env(char *name, char *value); +extern double dnow(void); + +static char *usage = +"\n" +" x11vnc -appshare: an experiment in application sharing via x11vnc.\n" +"\n" +" Usage: x11vnc -appshare -id windowid -connect viewer_host:0\n" +" x11vnc -appshare -id pick -connect viewer_host:0\n" +"\n" +" Both the -connect option and the -id (or -sid) option are required.\n" +" (However see the -control option below that can replace -connect.)\n" +"\n" +" The VNC viewer at viewer_host MUST be in 'listen' mode. This is because\n" +" a new VNC connection (and viewer window) is established for each new\n" +" toplevel window that the application creates. For example:\n" +"\n" +" vncviewer -listen 0\n" +"\n" +" The '-connect viewer_host:0' indicates the listening viewer to connect to.\n" +"\n" +" No password should be used, otherwise it will need to be typed for each\n" +" new window (or one could use vncviewer -passwd file if the viewer supports\n" +" that.) For security an SSH tunnel can be used:\n" +"\n" +" ssh -R 5500:localhost:5500 user@server_host\n" +"\n" +" (then use -connect localhost:0)\n" +"\n" +" The -id/-sid option is as in x11vnc(1). It is either a numerical window\n" +" id or the string 'pick' which will ask the user to click on an app window.\n" +" To track more than one application at the same time, list their window ids\n" +" separated by commas (see also the 'add_app' command below.)\n" +"\n" +" Additional options:\n" +"\n" +" -h, -help Print this help.\n" +" -debug Print debugging output (same as X11VNC_APPSHARE_DEBUG=1)\n" +" -showmenus Create a new viewer window even if a new window is\n" +" completely inside of an existing one. Default is to\n" +" try to not show them in a new viewer window.\n" +" -noexit Do not exit if the main app (windowid/pick) window\n" +" goes away. Default is to exit.\n" +" -display dpy X DISPLAY to use.\n" +" -trackdir dir Set tracking directory to 'dir'. x11vnc -appshare does\n" +" better if it can communicate with the x11vnc's via a\n" +" file channel. By default a dir in /tmp is used, -trackdir\n" +" specifies another directory, or use 'none' to disable.\n" +" -args 'string' Pass options 'string' to x11vnc (e.g. -scale 3/4,\n" +" -viewonly, -wait, -once, etc.)\n" +" -env VAR=VAL Set environment variables on cmdline as in x11vnc.\n" +"\n" +" -control file This is a file that one edits to manage the appshare\n" +" mode. It replaces -connect. Lines beginning with '#'\n" +" are ignored. Initially start off with all of the\n" +" desired clients in the file, one per line. If you add\n" +" a new client-line, that client is connected to. If you\n" +" delete (or comment out) a client-line, that client is\n" +" disconnected (for this to work, do not disable trackdir.)\n" +"\n" +" You can also put cmd= lines in the control file to perform\n" +" different actions. These are supported:\n" +"\n" +" cmd=quit Disconnect all clients and exit.\n" +" cmd=restart Restart all of the x11vnc's.\n" +" cmd=noop Do nothing (e.g. ping)\n" +" cmd=x11vnc Run ps(1) looking for x11vnc's\n" +" cmd=help Print out help text.\n" +" cmd=add_window:win Add a window to be watched.\n" +" cmd=del_window:win Delete a window.\n" +" cmd=add_app:win Add an application to be watched.\n" +" cmd=del_app:win Delete an application.\n" +" cmd=add_client:host Add client ('internal' mode only)\n" +" cmd=del_client:host Del client ('internal' mode only)\n" +" cmd=list_windows List all tracked windows.\n" +" cmd=list_apps List all tracked applications.\n" +" cmd=list_clients List all connected clients.\n" +" cmd=list_all List all three.\n" +" cmd=print_logs Print out the x11vnc logfiles.\n" +" cmd=debug:n Set -debug to n (0 or 1).\n" +" cmd=showmenus:n Set -showmenus to n (0 or 1).\n" +" cmd=noexit:n Set -noexit to n (0 or 1).\n" +"\n" +" See the '-command internal' mode described below for a way\n" +" that tracks connected clients internally (not in a file.)\n" +"\n" +" In '-shell' mode (see below) you can type in the above\n" +" without the leading 'cmd='.\n" +"\n" +" For 'add_window' and 'del_window' the 'win' can be a\n" +" numerical window id or 'pick'. Same for 'add_app'. Be\n" +" sure to remove or comment out the add/del line quickly\n" +" (e.g. before picking) or it will be re-run the next time\n" +" the file is processed.\n" +"\n" +" If a file with the same name as the control file but\n" +" ending with suffix '.cmd' is found, then commands in it\n" +" (cmd=...) are processed and then the file is truncated.\n" +" This allows 'one time' command actions to be run. Any\n" +" client hostnames in the '.cmd' file are ignored. Also\n" +" see below for the X11VNC_APPSHARE_COMMAND X property\n" +" which is similar to '.cmd'\n" +"\n" +" -control internal Manage connected clients internally, see below.\n" +" -control shell Same as: -shell -control internal\n" +"\n" +" -delay secs Maximum timeout delay before re-checking the control file.\n" +" It can be a fraction, e.g. -delay 0.25 Default 0.5\n" +"\n" +" -shell Simple command line for '-control internal' mode (see the\n" +" details of this mode below.) Enter '?' for command list.\n" +"\n" +" To stop x11vnc -appshare press Ctrl-C, or (if -noexit not supplied) delete\n" +" the initial app window or exit the application. Or cmd=quit in -control mode.\n" +"\n" +#if 0 +" If you want your setup to survive periods of time where there are no clients\n" +" connected you will need to supply -args '-forever' otherwise the x11vnc's\n" +" will exit when the last client disconnects. Howerver, _starting_ with no\n" +" clients (e.g. empty control file) will work without -args '-forever'.\n" +"\n" +#endif +" In addition to the '.cmd' file channel, for faster response you can set\n" +" X11VNC_APPSHARE_COMMAND X property on the root window to the string that\n" +" would go into the '.cmd' file. For example:\n" +"\n" +" xprop -root -f X11VNC_APPSHARE_COMMAND 8s -set X11VNC_APPSHARE_COMMAND cmd=quit\n" +"\n" +" The property value will be set to 'DONE' after the command(s) is processed.\n" +"\n" +" If -control file is specified as 'internal' then no control file is used\n" +" and client tracking is done internally. You must add and delete clients\n" +" with the cmd=add_client: and cmd=del_client: commands.\n" +" Note that '-control internal' is required for '-shell' mode. Using\n" +" '-control shell' implies internal mode and -shell.\n" +"\n" +" Limitations:\n" +"\n" +" This is a quick lash-up, many things will not work properly.\n" +"\n" +" The main idea is to provide simple application sharing for two or more\n" +" parties to collaborate without needing to share the entire desktop. It\n" +" provides an improvement over -id/-sid that only shows a single window.\n" +"\n" +" Only reverse connections can be done. (Note: one can specify multiple\n" +" viewing hosts via: -connect host1,host2,host3 or add/remove them\n" +" dynamically as described above.)\n" +"\n" +" If a new window obscures an old one, you will see some or all of the\n" +" new window in the old one. The hope is this is a popup dialog or menu\n" +" that will go away soon. Otherwise a user at the physical display will\n" +" need to move it. (See also the SSVNC viewer features described below.) \n" +"\n" +" The viewer side cannot resize or make windows move on the physical\n" +" display. Again, a user at the physical display may need to help, or\n" +" use the SSVNC viewer (see Tip below.)\n" +"\n" +" Tip: If the application has its own 'resize corner', then dragging\n" +" it may successfully resize the application window.\n" +" Tip: Some desktop environments enable moving a window via, say,\n" +" Alt+Left-Button-Drag. One may be able to move a window this way.\n" +" Also, e.g., Alt+Right-Button-Drag may resize a window.\n" +" Tip: Clicking on part of an obscured window may raise it to the top.\n" +" Also, e.g., Alt+Middle-Button may toggle Raise/Lower.\n" +"\n" +" Tip: The SSVNC 1.0.25 unix and macosx vncviewer has 'EscapeKeys' hot\n" +" keys that will move, resize, raise, and lower the window via the\n" +" x11vnc -remote_prefix X11VNC_APPSHARE_CMD: feature. So in the\n" +" viewer while holding down Shift_L+Super_L+Alt_L the arrow keys\n" +" move the window, PageUp/PageDn/Home/End resize it, and - and +\n" +" raise and lower it. Key 'M' or Button1 moves the remote window\n" +" to the +X+Y of the viewer window. Key 'D' or Button3 deletes\n" +" the remote window.\n" +"\n" +" You can run the SSVNC vncviewer with options '-escape default',\n" +" '-multilisten' and '-env VNCVIEWER_MIN_TITLE=1'; or just run\n" +" with option '-appshare' to enable these and automatic placement.\n" +"\n" +" If any part of a window goes off of the display screen, then x11vnc\n" +" may be unable to poll it (without crashing), and so the window will\n" +" stop updating until the window is completely on-screen again.\n" +"\n" +" The (stock) vnc viewer does not know where to best position each new\n" +" viewer window; it likely centers each one (including when resized.)\n" +" Note: The SSVNC viewer in '-appshare' mode places them correctly.\n" +"\n" +" Deleting a viewer window does not delete the real window.\n" +" Note: The SSVNC viewer Shift+EscapeKeys+Button3 deletes it.\n" +"\n" +" Sometimes new window detection fails.\n" +"\n" +" Sometimes menu/popup detection fails.\n" +"\n" +" Sometimes the contents of a menu/popup window have blacked-out regions.\n" +" Try -sid or -showmenus as a workaround.\n" +"\n" +" If the application starts up a new application (a different process)\n" +" that new application will not be tracked (but, unfortunately, it may\n" +" cover up existing windows that are being tracked.) See cmd=add_window\n" +" and cmd=add_app described above.\n" +"\n" +; + +#include +#include +#include + +#define WMAX 192 +#define CMAX 128 +#define AMAX 32 + +static Window root = None; +static Window watch[WMAX]; +static Window apps[WMAX]; +static int state[WMAX]; +static char *clients[CMAX]; +static XWindowAttributes attr; +static char *ticker_atom_str = "X11VNC_APPSHARE_TICKER"; +static Atom ticker_atom = None; +static char *cmd_atom_str = "X11VNC_APPSHARE_COMMAND"; +static Atom cmd_atom = None; +static char *connect_to = NULL; +static char *x11vnc_args = ""; +static char *id_opt = "-id"; +static int skip_menus = 1; +static int exit_no_app_win = 1; +static int shell = 0; +static int tree_depth = 3; +static char *prompt = "appshare> "; +static char *x11vnc = "x11vnc"; +static char *control = NULL; +static char *trackdir = "unset"; +static char *trackpre = "/tmp/x11vnc-appshare-trackdir-tmp"; +static char *tracktmp = NULL; +static char unique_tag[100]; +static int use_forever = 1; +static int last_event_type = 0; +static pid_t helper_pid = 0; +static pid_t parent_pid = 0; +static double helper_delay = 0.5; +static int appshare_debug = 0; +static double start_time = 0.0; + +static void get_wm_name(Window win, char **name); +static int win_attr(Window win); +static int get_xy(Window win, int *x, int *y); +static Window check_inside(Window win); +static int ours(Window win); +static void destroy_win(Window win); +static int same_app(Window win, Window app); + +static void ff(void) { + fflush(stdout); + fflush(stderr); +} + +static int find_win(Window win) { + int i; + for (i=0; i < WMAX; i++) { + if (watch[i] == win) { + return i; + } + } + return -1; +} + +static int find_app(Window app) { + int i; + for (i=0; i < AMAX; i++) { + if (apps[i] == app) { + return i; + } + } + return -1; +} + +static int find_client(char *cl) { + int i; + for (i=0; i < CMAX; i++) { + if (cl == NULL) { + if (clients[i] == NULL) { + return i; + } + continue; + } + if (clients[i] == NULL) { + continue; + } + if (!strcmp(clients[i], cl)) { + return i; + } + } + return -1; +} + +static int trackdir_pid(Window win) { + FILE *f; + int ln = 0, pid = 0; + char line[1024]; + + if (!trackdir) { + return 0; + } + sprintf(tracktmp, "%s/0x%lx.log", trackdir, win); + f = fopen(tracktmp, "r"); + if (!f) { + return 0; + } + while (fgets(line, sizeof(line), f) != NULL) { + if (ln++ > 30) { + break; + } + if (strstr(line, "x11vnc version:")) { + char *q = strstr(line, "pid:"); + if (q) { + int p; + if (sscanf(q, "pid: %d", &p) == 1) { + if (p > 0) { + pid = p; + break; + } + } + } + } + } + fclose(f); + return pid; +} + +static void trackdir_cleanup(Window win) { + char *suffix[] = {"log", "connect", NULL}; + int i=0; + if (!trackdir) { + return; + } + while (suffix[i] != NULL) { + sprintf(tracktmp, "%s/0x%lx.%s", trackdir, win, suffix[i]); + if (appshare_debug && !strcmp(suffix[i], "log")) { + fprintf(stderr, "keeping: %s\n", tracktmp); + ff(); + } else { + if (appshare_debug) { + fprintf(stderr, "removing: %s\n", tracktmp); + ff(); + } + unlink(tracktmp); + } + i++; + } +} + +static void launch(Window win) { + char *cmd, *tmp, *connto, *name; + int len, timeo = 30, uf = use_forever; + int w = 0, h = 0, x = 0, y = 0; + + if (win_attr(win)) { + /* maybe switch to debug only. */ + w = attr.width; + h = attr.height; + get_xy(win, &x, &y); + } + + get_wm_name(win, &name); + + if (strstr(x11vnc_args, "-once")) { + uf = 0; + } + + if (control) { + int i = 0; + len = 0; + for (i=0; i < CMAX; i++) { + if (clients[i] != NULL) { + len += strlen(clients[i]) + 2; + } + } + connto = (char *) calloc(len, 1); + for (i=0; i < CMAX; i++) { + if (clients[i] != NULL) { + if (connto[0] != '\0') { + strcat(connto, ","); + } + strcat(connto, clients[i]); + } + } + } else { + connto = strdup(connect_to); + } + if (!strcmp(connto, "")) { + timeo = 0; + } + if (uf) { + timeo = 0; + } + + len = 1000 + strlen(x11vnc) + strlen(connto) + strlen(x11vnc_args) + + 3 * (trackdir ? strlen(trackdir) : 100); + + cmd = (char *) calloc(len, 1); + tmp = (char *) calloc(len, 1); + + sprintf(cmd, "%s %s 0x%lx -bg -quiet %s -nopw -rfbport 0 " + "-timeout %d -noxdamage -noxinerama -norc -repeat -speeds dsl " + "-env X11VNC_AVOID_WINDOWS=never -env X11VNC_APPSHARE_ACTIVE=1 " + "-env X11VNC_NO_CHECK_PM=1 -env %s -novncconnect -shared -nonap " + "-remote_prefix X11VNC_APPSHARE_CMD:", + x11vnc, id_opt, win, use_forever ? "-forever" : "-once", timeo, unique_tag); + + if (trackdir) { + FILE *f; + sprintf(tracktmp, " -noquiet -o %s/0x%lx.log", trackdir, win); + strcat(cmd, tracktmp); + sprintf(tracktmp, "%s/0x%lx.connect", trackdir, win); + f = fopen(tracktmp, "w"); + if (f) { + fprintf(f, "%s", connto); + fclose(f); + sprintf(tmp, " -connect_or_exit '%s'", tracktmp); + strcat(cmd, tmp); + } else { + sprintf(tmp, " -connect_or_exit '%s'", connto); + strcat(cmd, tmp); + } + } else { + if (!strcmp(connto, "")) { + sprintf(tmp, " -connect '%s'", connto); + } else { + sprintf(tmp, " -connect_or_exit '%s'", connto); + } + strcat(cmd, tmp); + } + if (uf) { + char *q = strstr(cmd, "-connect_or_exit"); + if (q) q = strstr(q, "_or_exit"); + if (q) { + int i; + for (i=0; i < strlen("_or_exit"); i++) { + *q = ' '; + q++; + } + } + } + + strcat(cmd, " "); + strcat(cmd, x11vnc_args); + + fprintf(stdout, "launching: x11vnc for window 0x%08lx %dx%d+%d+%d \"%s\"\n", + win, w, h, x, y, name); + + if (appshare_debug) { + fprintf(stderr, "\nrunning: %s\n\n", cmd); + } + ff(); + + system(cmd); + + free(cmd); + free(tmp); + free(connto); + free(name); +} + +static void stop(Window win) { + char *cmd; + int pid = -1; + int f = find_win(win); + if (f < 0 || win == None) { + return; + } + if (state[f] == 0) { + return; + } + if (trackdir) { + pid = trackdir_pid(win); + if (pid > 0) { + if (appshare_debug) {fprintf(stderr, + "sending SIGTERM to: %d\n", pid); ff();} + kill((pid_t) pid, SIGTERM); + } + } + + cmd = (char *) malloc(1000 + strlen(x11vnc)); + sprintf(cmd, "pkill -TERM -f '%s %s 0x%lx -bg'", x11vnc, id_opt, win); + if (appshare_debug) { + fprintf(stdout, "stopping: 0x%08lx - %s\n", win, cmd); + } else { + fprintf(stdout, "stopping: x11vnc for window 0x%08lx " + "(pid: %d)\n", win, pid); + } + ff(); + system(cmd); + + sprintf(cmd, "(sleep 0.25 2>/dev/null || sleep 1; pkill -KILL -f '%s " + "%s 0x%lx -bg') &", x11vnc, id_opt, win); + system(cmd); + + if (trackdir) { + trackdir_cleanup(win); + } + + free(cmd); +} + +static void kill_helper_pid(void) { + int status; + if (helper_pid <= 0) { + return; + } + fprintf(stderr, "stopping: helper_pid: %d\n", (int) helper_pid); + kill(helper_pid, SIGTERM); + usleep(50 * 1000); + kill(helper_pid, SIGKILL); + usleep(25 * 1000); +#if LIBVNCSERVER_HAVE_SYS_WAIT_H && LIBVNCSERVER_HAVE_WAITPID + waitpid(helper_pid, &status, WNOHANG); +#endif +} + +static void be_helper_pid(char *dpy_str) { + int cnt = 0; + int ms = (int) (1000 * helper_delay); + double last_check = 0.0; + + if (ms < 50) ms = 50; + + dpy = XOpenDisplay(dpy_str); + ticker_atom = XInternAtom(dpy, ticker_atom_str, False); + + while (1) { + char tmp[32]; + sprintf(tmp, "HELPER_CNT_%08d", cnt++); + XChangeProperty(dpy, DefaultRootWindow(dpy), ticker_atom, XA_STRING, 8, + PropModeReplace, (unsigned char *) tmp, strlen(tmp)); + XFlush(dpy); + usleep(ms*1000); + if (parent_pid > 0) { + if(dnow() > last_check + 1.0) { + last_check = dnow(); + if (kill(parent_pid, 0) != 0) { + fprintf(stderr, "be_helper_pid: parent %d is gone.\n", (int) parent_pid); + break; + } + } + } + } + exit(0); +} + +static void print_logs(void) { + if (trackdir) { + DIR *dir = opendir(trackdir); + if (dir) { + struct dirent *dp; + while ( (dp = readdir(dir)) != NULL) { + FILE *f; + char *name = dp->d_name; + if (!strcmp(name, ".") || !strcmp(name, "..")) { + continue; + } + if (strstr(name, "0x") != name) { + continue; + } + if (strstr(name, ".log") == NULL) { + continue; + } + sprintf(tracktmp, "%s/%s", trackdir, name); + f = fopen(tracktmp, "r"); + if (f) { + char line[1024]; + fprintf(stderr, "===== x11vnc log %s =====\n", tracktmp); + while (fgets(line, sizeof(line), f) != NULL) { + fprintf(stderr, "%s", line); + } + fprintf(stderr, "\n"); + ff(); + fclose(f); + } + } + closedir(dir); + } + } +} + +static void appshare_cleanup(int s) { + int i; + if (s) {} + + if (use_forever) { + /* launch this backup in case they kill -9 us before we terminate everything */ + char cmd[1000]; + sprintf(cmd, "(sleep 3; pkill -TERM -f '%s') &", unique_tag); + if (appshare_debug) fprintf(stderr, "%s\n", cmd); + system(cmd); + } + + for (i=0; i < WMAX; i++) { + if (watch[i] != None) { + stop(watch[i]); + } + } + + if (trackdir) { + DIR *dir = opendir(trackdir); + if (dir) { + struct dirent *dp; + while ( (dp = readdir(dir)) != NULL) { + char *name = dp->d_name; + if (!strcmp(name, ".") || !strcmp(name, "..")) { + continue; + } + if (strstr(name, "0x") != name) { + fprintf(stderr, "skipping: %s\n", name); + continue; + } + if (!appshare_debug) { + fprintf(stderr, "removing: %s\n", name); + sprintf(tracktmp, "%s/%s", trackdir, name); + unlink(tracktmp); + } else { + if (appshare_debug) fprintf(stderr, "keeping: %s\n", name); + } + } + closedir(dir); + } + if (!appshare_debug) { + if (strstr(trackdir, trackpre) == trackdir) { + if (appshare_debug) fprintf(stderr, "removing: %s\n", trackdir); + rmdir(trackdir); + } + } + ff(); + } + + kill_helper_pid(); + +#if !NO_X11 + XCloseDisplay(dpy); +#endif + fprintf(stdout, "done.\n"); + ff(); + exit(0); +} + +static int trap_xerror(Display *d, XErrorEvent *error) { + if (d || error) {} + return 0; +} + +#if 0 +typedef struct { + int x, y; /* location of window */ + int width, height; /* width and height of window */ + int border_width; /* border width of window */ + int depth; /* depth of window */ + Visual *visual; /* the associated visual structure */ + Window root; /* root of screen containing window */ + int class; /* InputOutput, InputOnly*/ + int bit_gravity; /* one of bit gravity values */ + int win_gravity; /* one of the window gravity values */ + int backing_store; /* NotUseful, WhenMapped, Always */ + unsigned long backing_planes;/* planes to be preserved if possible */ + unsigned long backing_pixel;/* value to be used when restoring planes */ + Bool save_under; /* boolean, should bits under be saved? */ + Colormap colormap; /* color map to be associated with window */ + Bool map_installed; /* boolean, is color map currently installed*/ + int map_state; /* IsUnmapped, IsUnviewable, IsViewable */ + long all_event_masks; /* set of events all people have interest in*/ + long your_event_mask; /* my event mask */ + long do_not_propagate_mask; /* set of events that should not propagate */ + Bool override_redirect; /* boolean value for override-redirect */ + Screen *screen; /* back pointer to correct screen */ +} XWindowAttributes; +#endif + +static void get_wm_name(Window win, char **name) { + int ok; + +#if !NO_X11 + XErrorHandler old_handler = XSetErrorHandler(trap_xerror); + ok = XFetchName(dpy, win, name); + XSetErrorHandler(old_handler); +#endif + + if (!ok || *name == NULL) { + *name = strdup("unknown"); + } +} + +static int win_attr(Window win) { + int ok = 0; +#if !NO_X11 + XErrorHandler old_handler = XSetErrorHandler(trap_xerror); + ok = XGetWindowAttributes(dpy, win, &attr); + XSetErrorHandler(old_handler); +#endif + + if (ok) { + return 1; + } else { + return 0; + } +} + +static void win_select(Window win, int ignore) { +#if !NO_X11 + XErrorHandler old_handler = XSetErrorHandler(trap_xerror); + if (ignore) { + XSelectInput(dpy, win, 0); + } else { + XSelectInput(dpy, win, SubstructureNotifyMask); + } + XSync(dpy, False); + XSetErrorHandler(old_handler); +#endif +} + +static Window get_parent(Window win) { + int ok; + Window r, parent = None, *list = NULL; + unsigned int nchild; + +#if !NO_X11 + XErrorHandler old_handler = XSetErrorHandler(trap_xerror); + ok = XQueryTree(dpy, win, &r, &parent, &list, &nchild); + XSetErrorHandler(old_handler); + + if (!ok) { + return None; + } + if (list) { + XFree(list); + } +#endif + return parent; +} + +static int get_xy(Window win, int *x, int *y) { + Window cr; + Bool rc = False; +#if !NO_X11 + XErrorHandler old_handler = XSetErrorHandler(trap_xerror); + + rc = XTranslateCoordinates(dpy, win, root, 0, 0, x, y, &cr); + XSetErrorHandler(old_handler); +#endif + + if (!rc) { + return 0; + } else { + return 1; + } +} + +static Window check_inside(Window win) { + int i, nwin = 0; + int w, h, x, y; + int Ws[WMAX], Hs[WMAX], Xs[WMAX], Ys[WMAX]; + Window wins[WMAX]; + + if (!win_attr(win)) { + return None; + } + + /* store them first to give the win app more time to settle. */ + for (i=0; i < WMAX; i++) { + int X, Y; + Window wchk = watch[i]; + if (wchk == None) { + continue; + } + if (state[i] == 0) { + continue; + } + if (!win_attr(wchk)) { + continue; + } + if (!get_xy(wchk, &X, &Y)) { + continue; + } + + Xs[nwin] = X; + Ys[nwin] = Y; + Ws[nwin] = attr.width; + Hs[nwin] = attr.height; + wins[nwin] = wchk; + nwin++; + } + + if (nwin == 0) { + return None; + } + + if (!win_attr(win)) { + return None; + } + w = attr.width; + h = attr.height; + + get_xy(win, &x, &y); + if (!get_xy(win, &x, &y)) { + return None; + } + + for (i=0; i < nwin; i++) { + int X, Y, W, H; + Window wchk = wins[i]; + X = Xs[i]; + Y = Ys[i]; + W = Ws[i]; + H = Hs[i]; + + if (appshare_debug) fprintf(stderr, "check inside: 0x%lx %dx%d+%d+%d %dx%d+%d+%d\n", wchk, w, h, x, y, W, H, X, Y); + + if (X <= x && Y <= y) { + if (x + w <= X + W && y + h < Y + H) { + return wchk; + } + } + } + + return None; +} + +static void add_win(Window win) { + int idx = find_win(win); + int free = find_win(None); + if (idx >= 0) { + if (appshare_debug) {fprintf(stderr, "already watching window: 0x%lx\n", win); ff();} + return; + } + if (free < 0) { + fprintf(stderr, "ran out of slots for window: 0x%lx\n", win); ff(); + return; + } + + if (appshare_debug) {fprintf(stderr, "watching: 0x%lx at %d\n", win, free); ff();} + + watch[free] = win; + state[free] = 0; + + win_select(win, 0); +} + +static void delete_win(Window win) { + int i; + for (i=0; i < WMAX; i++) { + if (watch[i] == win) { + watch[i] = None; + state[i] = 0; + if (appshare_debug) {fprintf(stderr, "deleting: 0x%lx at %d\n", win, i); ff();} + } + } +} + +static void recurse_search(int level, int level_max, Window top, Window app, int *nw) { + Window w, r, parent, *list = NULL; + unsigned int nchild; + int ok; + + if (appshare_debug > 1) { + fprintf(stderr, "level: %d level_max: %d top: 0x%lx app: 0x%lx\n", level, level_max, top, app); + } + if (level >= level_max) { + return; + } + + ok = XQueryTree(dpy, top, &r, &parent, &list, &nchild); + if (ok) { + int i; + for (i=0; i < nchild; i++) { + w = list[i]; + if (w == None || find_win(w) >= 0) { + continue; + } + if (ours(w) && w != app) { + if (appshare_debug) fprintf(stderr, "add level %d 0x%lx %d/%d\n", + level, w, i, nchild); + add_win(w); + (*nw)++; + } + } + for (i=0; i < nchild; i++) { + w = list[i]; + if (w == None || ours(w)) { + continue; + } + recurse_search(level+1, level_max, w, app, nw); + } + } + if (list) { + XFree(list); + } +} + +static void add_app(Window app) { + int i, nw = 0, free = -1; + XErrorHandler old_handler; + +#if !NO_X11 + i = find_app(app); + if (i >= 0) { + fprintf(stderr, "already tracking app: 0x%lx\n", app); + return; + } + for (i=0; i < AMAX; i++) { + if (same_app(apps[i], app)) { + fprintf(stderr, "already tracking app: 0x%lx via 0x%lx\n", app, apps[i]); + return; + } + } + free = find_app(None); + if (free < 0) { + fprintf(stderr, "ran out of app slots.\n"); + return; + } + apps[free] = app; + + add_win(app); + + old_handler = XSetErrorHandler(trap_xerror); + recurse_search(0, tree_depth, root, app, &nw); + XSetErrorHandler(old_handler); +#endif + fprintf(stderr, "tracking %d windows related to app window 0x%lx\n", nw, app); +} + +static void del_app(Window app) { + int i; + for (i=0; i < WMAX; i++) { + Window win = watch[i]; + if (win != None) { + if (same_app(app, win)) { + destroy_win(win); + } + } + } + for (i=0; i < AMAX; i++) { + Window app2 = apps[i]; + if (app2 != None) { + if (same_app(app, app2)) { + apps[i] = None; + } + } + } +} + +static void wait_until_empty(char *file) { + double t = 0.0, dt = 0.05; + while (t < 1.0) { + struct stat sb; + if (stat(file, &sb) != 0) { + return; + } + if (sb.st_size == 0) { + return; + } + t += dt; + usleep( (int) (dt * 1000 * 1000) ); + } +} + +static void client(char *client, int add) { + DIR *dir; + struct dirent *dp; + + if (!client) { + return; + } + if (!trackdir) { + fprintf(stderr, "no trackdir, cannot %s client: %s\n", + add ? "add" : "disconnect", client); + ff(); + return; + } + fprintf(stdout, "%s client: %s\n", add ? "adding " : "deleting", client); + + dir = opendir(trackdir); + if (!dir) { + fprintf(stderr, "could not opendir trackdir: %s\n", trackdir); + return; + } + while ( (dp = readdir(dir)) != NULL) { + char *name = dp->d_name; + if (!strcmp(name, ".") || !strcmp(name, "..")) { + continue; + } + if (strstr(name, "0x") != name) { + continue; + } + if (strstr(name, ".connect")) { + FILE *f; + char *tmp; + Window twin; + + if (scan_hexdec(name, &twin)) { + int f = find_win(twin); + if (appshare_debug) { + fprintf(stderr, "twin: 0x%lx name=%s f=%d\n", twin, name, f); + ff(); + } + if (f < 0) { + continue; + } + } + + tmp = (char *) calloc(100 + strlen(client), 1); + sprintf(tracktmp, "%s/%s", trackdir, name); + if (add) { + sprintf(tmp, "%s\n", client); + } else { + sprintf(tmp, "cmd=close:%s\n", client); + } + wait_until_empty(tracktmp); + f = fopen(tracktmp, "w"); + if (f) { + if (appshare_debug) { + fprintf(stderr, "%s client: %s + %s", + add ? "add" : "disconnect", tracktmp, tmp); + ff(); + } + fprintf(f, "%s", tmp); + fclose(f); + } + free(tmp); + } + } + closedir(dir); +} + +static void mapped(Window win) { + int f; + if (win == None) { + return; + } + f = find_win(win); + if (f < 0) { + if (win_attr(win)) { + if (get_parent(win) == root) { + /* XXX more cases? */ + add_win(win); + } + } + } +} + +static void unmapped(Window win) { + int f = find_win(win); + if (f < 0 || win == None) { + return; + } + stop(win); + state[f] = 0; +} + +static void destroy_win(Window win) { + stop(win); + delete_win(win); +} + +static Window parse_win(char *str) { + Window win = None; + if (!str) { + return None; + } + if (!strcmp(str, "pick") || !strcmp(str, "p")) { + static double last_pick = 0.0; + if (dnow() < start_time + 15) { + ; + } else if (dnow() < last_pick + 2) { + return None; + } else { + last_pick = dnow(); + } + if (!pick_windowid(&win)) { + fprintf(stderr, "parse_win: bad window pick.\n"); + win = None; + } + if (win == root) { + fprintf(stderr, "parse_win: ignoring pick of rootwin 0x%lx.\n", win); + win = None; + } + ff(); + } else if (!scan_hexdec(str, &win)) { + win = None; + } + return win; +} + +static void add_or_del_app(char *str, int add) { + Window win = parse_win(str); + + if (win != None) { + if (add) { + add_app(win); + } else { + del_app(win); + } + } else if (!strcmp(str, "all")) { + if (!add) { + int i; + for (i=0; i < AMAX; i++) { + if (apps[i] != None) { + del_app(apps[i]); + } + } + } + } +} + +static void add_or_del_win(char *str, int add) { + Window win = parse_win(str); + + if (win != None) { + int f = find_win(win); + if (add) { + if (f < 0 && win_attr(win)) { + add_win(win); + } + } else { + if (f >= 0) { + destroy_win(win); + } + } + } else if (!strcmp(str, "all")) { + if (!add) { + int i; + for (i=0; i < WMAX; i++) { + if (watch[i] != None) { + destroy_win(watch[i]); + } + } + } + } +} + +static void add_or_del_client(char *str, int add) { + int i; + + if (!str) { + return; + } + if (strcmp(control, "internal")) { + return; + } + if (add) { + int idx = find_client(str); + int free = find_client(NULL); + + if (idx >=0) { + fprintf(stderr, "already tracking client: %s in slot %d\n", str, idx); + ff(); + return; + } + if (free < 0) { + static int cnt = 0; + if (cnt++ < 10) { + fprintf(stderr, "ran out of client slots.\n"); + ff(); + } + return; + } + clients[free] = strdup(str); + client(str, 1); + } else { + if (str[0] == '#' || str[0] == '%') { + if (sscanf(str+1, "%d", &i) == 1) { + i--; + if (0 <= i && i < CMAX) { + if (clients[i] != NULL) { + client(clients[i], 0); + free(clients[i]); + clients[i] = NULL; + return; + } + } + } + } else if (!strcmp(str, "all")) { + for (i=0; i < CMAX; i++) { + if (clients[i] == NULL) { + continue; + } + client(clients[i], 0); + free(clients[i]); + clients[i] = NULL; + } + return; + } + + i = find_client(str); + if (i >= 0) { + free(clients[i]); + clients[i] = NULL; + client(str, 0); + } + } +} + +static void restart_x11vnc(void) { + int i, n = 0; + Window win, active[WMAX]; + for (i=0; i < WMAX; i++) { + win = watch[i]; + if (win == None) { + continue; + } + if (state[i]) { + active[n++] = win; + stop(win); + } + } + if (n) { + usleep(1500 * 1000); + } + for (i=0; i < n; i++) { + win = active[i]; + launch(win); + } +} + +static unsigned long cmask = 0x3fc00000; /* 00111111110000000000000000000000 */ + +static void init_cmask(void) { + /* dependent on the X server implementation; XmuClientWindow better? */ + /* xc/programs/Xserver/include/resource.h */ + int didit = 0, res_cnt = 29, client_bits = 8; + + if (getenv("X11VNC_APPSHARE_CLIENT_MASK")) { + unsigned long cr; + if (sscanf(getenv("X11VNC_APPSHARE_CLIENT_MASK"), "0x%lx", &cr) == 1) { + cmask = cr; + didit = 1; + } + } else if (getenv("X11VNC_APPSHARE_CLIENT_BITS")) { + int cr = atoi(getenv("X11VNC_APPSHARE_CLIENT_BITS")); + if (cr > 0) { + client_bits = cr; + } + } + if (!didit) { + cmask = (((1 << client_bits) - 1) << (res_cnt-client_bits)); + } + fprintf(stderr, "client_mask: 0x%08lx\n", cmask); +} + +static int same_app(Window win, Window app) { + if ( (win & cmask) == (app & cmask) ) { + return 1; + } else { + return 0; + } +} + +static int ours(Window win) { + int i; + for (i=0; i < AMAX; i++) { + if (apps[i] != None) { + if (same_app(win, apps[i])) { + return 1; + } + } + } + return 0; +} + +static void list_clients(void) { + int i, n = 0; + for (i=0; i < CMAX; i++) { + if (clients[i] == NULL) { + continue; + } + fprintf(stdout, "client[%02d] %s\n", ++n, clients[i]); + } + fprintf(stdout, "total clients: %d\n", n); + ff(); +} + +static void list_windows(void) { + int i, n = 0; + for (i=0; i < WMAX; i++) { + char *name; + Window win = watch[i]; + if (win == None) { + continue; + } + get_wm_name(win, &name); + fprintf(stdout, "window[%02d] 0x%08lx state: %d slot: %03d \"%s\"\n", + ++n, win, state[i], i, name); + free(name); + } + fprintf(stdout, "total windows: %d\n", n); + ff(); +} + +static void list_apps(void) { + int i, n = 0; + for (i=0; i < AMAX; i++) { + char *name; + Window win = apps[i]; + if (win == None) { + continue; + } + get_wm_name(win, &name); + fprintf(stdout, "app[%02d] 0x%08lx state: %d slot: %03d \"%s\"\n", + ++n, win, state[i], i, name); + free(name); + } + fprintf(stdout, "total apps: %d\n", n); + ff(); +} + +static int process_control(char *file, int check_clients) { + int i, nnew = 0, seen[CMAX]; + char line[1024], *new[CMAX]; + FILE *f; + + f = fopen(file, "r"); + if (!f) { + return 1; + } + if (check_clients) { + for (i=0; i < CMAX; i++) { + seen[i] = 0; + } + } + while (fgets(line, sizeof(line), f) != NULL) { + char *q = strchr(line, '\n'); + if (q) *q = '\0'; + + if (appshare_debug) { + fprintf(stderr, "check_control: %s\n", line); + ff(); + } + + q = lblanks(line); + if (q[0] == '#') { + continue; + } + if (!strcmp(q, "")) { + continue; + } + if (strstr(q, "cmd=") == q) { + char *cmd = q + strlen("cmd="); + if (!strcmp(cmd, "quit")) { + if (strcmp(control, file) && strstr(file, ".cmd")) { + FILE *f2 = fopen(file, "w"); + if (f2) fclose(f2); + } + appshare_cleanup(0); + } else if (!strcmp(cmd, "wait")) { + return 0; + } else if (strstr(cmd, "bcast:") == cmd) { + ; + } else if (strstr(cmd, "del_window:") == cmd) { + add_or_del_win(cmd + strlen("del_window:"), 0); + } else if (strstr(cmd, "add_window:") == cmd) { + add_or_del_win(cmd + strlen("add_window:"), 1); + } else if (strstr(cmd, "del:") == cmd) { + add_or_del_win(cmd + strlen("del:"), 0); + } else if (strstr(cmd, "add:") == cmd) { + add_or_del_win(cmd + strlen("add:"), 1); + } else if (strstr(cmd, "del_client:") == cmd) { + add_or_del_client(cmd + strlen("del_client:"), 0); + } else if (strstr(cmd, "add_client:") == cmd) { + add_or_del_client(cmd + strlen("add_client:"), 1); + } else if (strstr(cmd, "-") == cmd) { + add_or_del_client(cmd + strlen("-"), 0); + } else if (strstr(cmd, "+") == cmd) { + add_or_del_client(cmd + strlen("+"), 1); + } else if (strstr(cmd, "del_app:") == cmd) { + add_or_del_app(cmd + strlen("del_app:"), 0); + } else if (strstr(cmd, "add_app:") == cmd) { + add_or_del_app(cmd + strlen("add_app:"), 1); + } else if (strstr(cmd, "debug:") == cmd) { + appshare_debug = atoi(cmd + strlen("debug:")); + } else if (strstr(cmd, "showmenus:") == cmd) { + skip_menus = atoi(cmd + strlen("showmenus:")); + skip_menus = !(skip_menus); + } else if (strstr(cmd, "noexit:") == cmd) { + exit_no_app_win = atoi(cmd + strlen("noexit:")); + exit_no_app_win = !(exit_no_app_win); + } else if (strstr(cmd, "use_forever:") == cmd) { + use_forever = atoi(cmd + strlen("use_forever:")); + } else if (strstr(cmd, "tree_depth:") == cmd) { + tree_depth = atoi(cmd + strlen("tree_depth:")); + } else if (strstr(cmd, "x11vnc_args:") == cmd) { + x11vnc_args = strdup(cmd + strlen("x11vnc_args:")); + } else if (strstr(cmd, "env:") == cmd) { + putenv(cmd + strlen("env:")); + } else if (strstr(cmd, "noop") == cmd) { + ; + } else if (!strcmp(cmd, "restart")) { + restart_x11vnc(); + } else if (!strcmp(cmd, "list_clients") || !strcmp(cmd, "lc")) { + list_clients(); + } else if (!strcmp(cmd, "list_windows") || !strcmp(cmd, "lw")) { + list_windows(); + } else if (!strcmp(cmd, "list_apps") || !strcmp(cmd, "la")) { + list_apps(); + } else if (!strcmp(cmd, "list_all") || !strcmp(cmd, "ls")) { + list_windows(); + fprintf(stderr, "\n"); + list_apps(); + fprintf(stderr, "\n"); + list_clients(); + } else if (!strcmp(cmd, "print_logs") || !strcmp(cmd, "pl")) { + print_logs(); + } else if (!strcmp(cmd, "?") || !strcmp(cmd, "h") || !strcmp(cmd, "help")) { + fprintf(stderr, "available commands:\n"); + fprintf(stderr, "\n"); + fprintf(stderr, " quit restart noop x11vnc help ? ! !!\n"); + fprintf(stderr, "\n"); + fprintf(stderr, " add_window:win (add:win, add:pick)\n"); + fprintf(stderr, " del_window:win (del:win, del:pick, del:all)\n"); + fprintf(stderr, " add_app:win (add_app:pick)\n"); + fprintf(stderr, " del_app:win (del_app:pick, del_app:all)\n"); + fprintf(stderr, " add_client:host (+host)\n"); + fprintf(stderr, " del_client:host (-host, -all)\n"); + fprintf(stderr, "\n"); + fprintf(stderr, " list_windows (lw)\n"); + fprintf(stderr, " list_apps (la)\n"); + fprintf(stderr, " list_clients (lc)\n"); + fprintf(stderr, " list_all (ls)\n"); + fprintf(stderr, " print_logs (pl)\n"); + fprintf(stderr, "\n"); + fprintf(stderr, " debug:n showmenus:n noexit:n\n"); + } else { + fprintf(stderr, "unrecognized %s\n", q); + } + continue; + } + if (check_clients) { + int idx = find_client(q); + if (idx >= 0) { + seen[idx] = 1; + } else { + new[nnew++] = strdup(q); + } + } + } + fclose(f); + + if (check_clients) { + for (i=0; i < CMAX; i++) { + if (clients[i] == NULL) { + continue; + } + if (!seen[i]) { + client(clients[i], 0); + free(clients[i]); + clients[i] = NULL; + } + } + for (i=0; i < nnew; i++) { + int free = find_client(NULL); + if (free < 0) { + static int cnt = 0; + if (cnt++ < 10) { + fprintf(stderr, "ran out of client slots.\n"); + ff(); + break; + } + continue; + } + clients[free] = new[i]; + client(new[i], 1); + } + } + return 1; +} + +static int check_control(void) { + static int last_size = -1; + static time_t last_mtime = 0; + struct stat sb; + char *control_cmd; + + if (!control) { + return 1; + } + + if (!strcmp(control, "internal")) { + return 1; + } + + control_cmd = (char *)malloc(strlen(control) + strlen(".cmd") + 1); + sprintf(control_cmd, "%s.cmd", control); + if (stat(control_cmd, &sb) == 0) { + FILE *f; + if (sb.st_size > 0) { + process_control(control_cmd, 0); + } + f = fopen(control_cmd, "w"); + if (f) { + fclose(f); + } + } + free(control_cmd); + + if (stat(control, &sb) != 0) { + return 1; + } + if (last_size == (int) sb.st_size && last_mtime == sb.st_mtime) { + return 1; + } + last_size = (int) sb.st_size; + last_mtime = sb.st_mtime; + + return process_control(control, 1); +} + +static void update(void) { + int i, app_ok = 0; + if (last_event_type != PropertyNotify) { + if (appshare_debug) fprintf(stderr, "\nupdate ...\n"); + } else if (appshare_debug > 1) { + fprintf(stderr, "update ... propertynotify\n"); + } + if (!check_control()) { + return; + } + for (i=0; i < WMAX; i++) { + Window win = watch[i]; + if (win == None) { + continue; + } + if (!win_attr(win)) { + destroy_win(win); + continue; + } + if (find_app(win) >= 0) { + app_ok++; + } + if (state[i] == 0) { + if (attr.map_state == IsViewable) { + if (skip_menus) { + Window inside = check_inside(win); + if (inside != None) { + if (appshare_debug) {fprintf(stderr, "skip_menus: window 0x%lx is inside of 0x%lx, not tracking it.\n", win, inside); ff();} + delete_win(win); + continue; + } + } + launch(win); + state[i] = 1; + } + } else if (state[i] == 1) { + if (attr.map_state != IsViewable) { + stop(win); + state[i] = 0; + } + } + } + if (exit_no_app_win && !app_ok) { + for (i=0; i < AMAX; i++) { + if (apps[i] != None) { + fprintf(stdout, "main application window is gone: 0x%lx\n", apps[i]); + } + } + ff(); + appshare_cleanup(0); + } + if (last_event_type != PropertyNotify) { + if (appshare_debug) {fprintf(stderr, "update done.\n"); ff();} + } +} + +static void exiter(char *msg, int rc) { + fprintf(stderr, "%s", msg); + ff(); + kill_helper_pid(); + exit(rc); +} + +static void set_trackdir(void) { + char tmp[256]; + struct stat sb; + if (!strcmp(trackdir, "none")) { + trackdir = NULL; + return; + } + if (!strcmp(trackdir, "unset")) { + int fd; + sprintf(tmp, "%s.XXXXXX", trackpre); + fd = mkstemp(tmp); + if (fd < 0) { + strcat(tmp, ": failed to create file.\n"); + exiter(tmp, 1); + } + /* XXX race */ + close(fd); + unlink(tmp); + if (mkdir(tmp, 0700) != 0) { + strcat(tmp, ": failed to create dir.\n"); + exiter(tmp, 1); + } + trackdir = strdup(tmp); + } + if (stat(trackdir, &sb) != 0) { + if (mkdir(trackdir, 0700) != 0) { + exiter("could not make trackdir.\n", 1); + } + } else if (! S_ISDIR(sb.st_mode)) { + exiter("trackdir not a directory.\n", 1); + } + tracktmp = (char *) calloc(1000 + strlen(trackdir), 1); +} + +static void process_string(char *str) { + FILE *f; + char *file; + if (trackdir) { + sprintf(tracktmp, "%s/0xprop.cmd", trackdir); + file = strdup(tracktmp); + } else { + char tmp[] = "/tmp/x11vnc-appshare.cmd.XXXXXX"; + int fd = mkstemp(tmp); + if (fd < 0) { + return; + } + file = strdup(tmp); + close(fd); + } + f = fopen(file, "w"); + if (f) { + fprintf(f, "%s", str); + fclose(f); + process_control(file, 0); + } + unlink(file); + free(file); +} + +static void handle_shell(void) { + struct timeval tv; + static char lastline[1000]; + static int first = 1; + fd_set rfds; + int fd0 = fileno(stdin); + + if (first) { + memset(lastline, 0, sizeof(lastline)); + first = 0; + } + + FD_ZERO(&rfds); + FD_SET(fd0, &rfds); + tv.tv_sec = 0; + tv.tv_usec = 0; + select(fd0+1, &rfds, NULL, NULL, &tv); + if (FD_ISSET(fd0, &rfds)) { + char line[1000], line2[1010]; + if (fgets(line, sizeof(line), stdin) != NULL) { + char *str = lblanks(line); + char *q = strrchr(str, '\n'); + if (q) *q = '\0'; + if (strcmp(str, "")) { + if (!strcmp(str, "!!")) { + sprintf(line, "%s", lastline); + fprintf(stderr, "%s\n", line); + str = line; + } + if (strstr(str, "!") == str) { + system(str+1); + } else if (!strcmp(str, "x11vnc") || !strcmp(str, "ps")) { + char *cmd = "ps -elf | egrep 'PID|x11vnc' | grep -v egrep"; + fprintf(stderr, "%s\n", cmd); + system(cmd); + } else { + sprintf(line2, "cmd=%s", str); + process_string(line2); + } + sprintf(lastline, "%s", str); + } + } + fprintf(stderr, "\n%s", prompt); ff(); + } +} + +static void handle_prop_cmd(void) { + char *value, *str, *done = "DONE"; + + if (cmd_atom == None) { + return; + } + + value = get_xprop(cmd_atom_str, root); + if (value == NULL) { + return; + } + + str = lblanks(value); + if (!strcmp(str, done)) { + free(value); + return; + } + if (strstr(str, "cmd=quit") == str || strstr(str, "\ncmd=quit")) { + set_xprop(cmd_atom_str, root, done); + appshare_cleanup(0); + } + + process_string(str); + + free(value); + set_xprop(cmd_atom_str, root, done); +} + +#define PREFIX if(appshare_debug) fprintf(stderr, " %8.2f 0x%08lx : ", dnow() - start, ev.xany.window); + +static void monitor(void) { +#if !NO_X11 + XEvent ev; + double start = dnow(); + int got_prop_cmd = 0; + + if (shell) { + update(); + fprintf(stderr, "\n\n"); + process_string("cmd=help"); + fprintf(stderr, "\n%s", prompt); ff(); + } + + while (1) { + int t; + + if (XEventsQueued(dpy, QueuedAlready) == 0) { + update(); + if (got_prop_cmd) { + handle_prop_cmd(); + } + got_prop_cmd = 0; + if (shell) { + handle_shell(); + } + } + + XNextEvent(dpy, &ev); + + last_event_type = ev.type; + + switch (ev.type) { + case Expose: + PREFIX + if(appshare_debug) fprintf(stderr, "Expose %04dx%04d+%04d+%04d\n", ev.xexpose.width, ev.xexpose.height, ev.xexpose.x, ev.xexpose.y); + break; + case ConfigureNotify: +#if 0 + PREFIX + if(appshare_debug) fprintf(stderr, "ConfigureNotify %04dx%04d+%04d+%04d above: 0x%lx\n", ev.xconfigure.width, ev.xconfigure.height, ev.xconfigure.x, ev.xconfigure.y, ev.xconfigure.above); +#endif + break; + case VisibilityNotify: + PREFIX + if (appshare_debug) { + fprintf(stderr, "VisibilityNotify: "); + t = ev.xvisibility.state; + if (t == VisibilityFullyObscured) fprintf(stderr, "VisibilityFullyObscured\n"); + if (t == VisibilityPartiallyObscured) fprintf(stderr, "VisibilityPartiallyObscured\n"); + if (t == VisibilityUnobscured) fprintf(stderr, "VisibilityUnobscured\n"); + } + break; + case MapNotify: + PREFIX + if(appshare_debug) fprintf(stderr, "MapNotify win: 0x%lx\n", ev.xmap.window); + if (ours(ev.xmap.window)) { + mapped(ev.xmap.window); + } + break; + case UnmapNotify: + PREFIX + if(appshare_debug) fprintf(stderr, "UnmapNotify win: 0x%lx\n", ev.xmap.window); + if (ours(ev.xmap.window)) { + unmapped(ev.xmap.window); + } + break; + case MapRequest: + PREFIX + if(appshare_debug) fprintf(stderr, "MapRequest\n"); + break; + case CreateNotify: + PREFIX + if(appshare_debug) fprintf(stderr, "CreateNotify parent: 0x%lx win: 0x%lx\n", ev.xcreatewindow.parent, ev.xcreatewindow.window); + if (ev.xcreatewindow.parent == root && ours(ev.xcreatewindow.window)) { + if (find_win(ev.xcreatewindow.window) >= 0) { + destroy_win(ev.xcreatewindow.window); + } + add_win(ev.xcreatewindow.window); + } + break; + case DestroyNotify: + PREFIX + if(appshare_debug) fprintf(stderr, "DestroyNotify win: 0x%lx\n", ev.xdestroywindow.window); + if (ours(ev.xdestroywindow.window)) { + destroy_win(ev.xdestroywindow.window); + } + break; + case ConfigureRequest: + PREFIX + if(appshare_debug) fprintf(stderr, "ConfigureRequest\n"); + break; + case CirculateRequest: +#if 0 + PREFIX + if(appshare_debug) fprintf(stderr, "CirculateRequest parent: 0x%lx win: 0x%lx\n", ev.xcirculaterequest.parent, ev.xcirculaterequest.window); +#endif + break; + case CirculateNotify: +#if 0 + PREFIX + if(appshare_debug) fprintf(stderr, "CirculateNotify\n"); +#endif + break; + case PropertyNotify: +#if 0 + PREFIX + if(appshare_debug) fprintf(stderr, "PropertyNotify\n"); +#endif + if (cmd_atom != None && ev.xproperty.atom == cmd_atom) { + got_prop_cmd++; + } + break; + case ReparentNotify: + PREFIX + if(appshare_debug) fprintf(stderr, "ReparentNotify parent: 0x%lx win: 0x%lx\n", ev.xreparent.parent, ev.xreparent.window); + if (ours(ev.xreparent.window)) { + if (ours(ev.xreparent.parent)) { + destroy_win(ev.xreparent.window); + } else if (ev.xreparent.parent == root) { + /* ??? */ + } + } + break; + default: + PREFIX + if(appshare_debug) fprintf(stderr, "Unknown: %d\n", ev.type); + break; + } + } +#endif +} + +int appshare_main(int argc, char *argv[]) { + int i; + char *app_str = NULL; + char *dpy_str = NULL; + long xselectinput = 0; +#if NO_X11 + exiter("not compiled with X11\n", 1); +#else + for (i=0; i < WMAX; i++) { + watch[i] = None; + state[i] = 0; + } + for (i=0; i < AMAX; i++) { + apps[i] = None; + } + for (i=0; i < CMAX; i++) { + clients[i] = NULL; + } + + x11vnc = strdup(argv[0]); + + for (i=1; i < argc; i++) { + int end = (i == argc-1) ? 1 : 0; + char *s = argv[i]; + if (strstr(s, "--") == s) { + s++; + } + + if (!strcmp(s, "-h") || !strcmp(s, "-help")) { + fprintf(stdout, "%s", usage); + exit(0); + } else if (!strcmp(s, "-id")) { + id_opt = "-id"; + if (end) exiter("no -id value supplied\n", 1); + app_str = strdup(argv[++i]); + } else if (!strcmp(s, "-sid")) { + id_opt = "-sid"; + if (end) exiter("no -sid value supplied\n", 1); + app_str = strdup(argv[++i]); + } else if (!strcmp(s, "-connect") || !strcmp(s, "-connect_or_exit")) { + if (end) exiter("no -connect value supplied\n", 1); + connect_to = strdup(argv[++i]); + } else if (!strcmp(s, "-control")) { + if (end) exiter("no -control value supplied\n", 1); + control = strdup(argv[++i]); + if (!strcmp(control, "shell")) { + free(control); + control = strdup("internal"); + shell = 1; + } + } else if (!strcmp(s, "-trackdir")) { + if (end) exiter("no -trackdir value supplied\n", 1); + trackdir = strdup(argv[++i]); + } else if (!strcmp(s, "-display")) { + if (end) exiter("no -display value supplied\n", 1); + dpy_str = strdup(argv[++i]); + set_env("DISPLAY", dpy_str); + } else if (!strcmp(s, "-delay")) { + if (end) exiter("no -delay value supplied\n", 1); + helper_delay = atof(argv[++i]); + } else if (!strcmp(s, "-args")) { + if (end) exiter("no -args value supplied\n", 1); + x11vnc_args = strdup(argv[++i]); + } else if (!strcmp(s, "-env")) { + if (end) exiter("no -env value supplied\n", 1); + putenv(argv[++i]); + } else if (!strcmp(s, "-debug")) { + appshare_debug++; + } else if (!strcmp(s, "-showmenus")) { + skip_menus = 0; + } else if (!strcmp(s, "-noexit")) { + exit_no_app_win = 0; + } else if (!strcmp(s, "-shell")) { + shell = 1; + } else if (!strcmp(s, "-nocmds") || !strcmp(s, "-safer")) { + fprintf(stderr, "ignoring %s in -appshare mode.\n", s); + } else if (!strcmp(s, "-appshare")) { + ; + } else { + fprintf(stderr, "unrecognized 'x11vnc -appshare' option: %s\n", s); + exiter("", 1); + } + } + + if (getenv("X11VNC_APPSHARE_DEBUG")) { + appshare_debug = atoi(getenv("X11VNC_APPSHARE_DEBUG")); + } + + /* let user override name for multiple instances: */ + if (getenv("X11VNC_APPSHARE_COMMAND_PROPNAME")) { + cmd_atom_str = strdup(getenv("X11VNC_APPSHARE_COMMAND_PROPNAME")); + } + if (getenv("X11VNC_APPSHARE_TICKER_PROPNAME")) { + ticker_atom_str = strdup(getenv("X11VNC_APPSHARE_TICKER_PROPNAME")); + } + + if (shell) { + if (!control || strcmp(control, "internal")) { + exiter("mode -shell requires '-control internal'\n", 1); + } + } + + if (connect_to == NULL && control != NULL) { + struct stat sb; + if (stat(control, &sb) == 0) { + int len = 100 + sb.st_size; + FILE *f = fopen(control, "r"); + + if (f) { + char *line = (char *) malloc(len); + connect_to = (char *) calloc(2 * len, 1); + while (fgets(line, len, f) != NULL) { + char *q = strchr(line, '\n'); + if (q) *q = '\0'; + q = lblanks(line); + if (q[0] == '#') { + continue; + } + if (connect_to[0] != '\0') { + strcat(connect_to, ","); + } + strcat(connect_to, q); + } + fclose(f); + } + fprintf(stderr, "set -connect to: %s\n", connect_to); + } + } + if (0 && connect_to == NULL && control == NULL) { + exiter("no -connect host or -control file specified.\n", 1); + } + + if (control) { + pid_t pid; + parent_pid = getpid(); + pid = fork(); + if (pid == (pid_t) -1) { + ; + } else if (pid == 0) { + be_helper_pid(dpy_str); + exit(0); + } else { + helper_pid = pid; + } + } + + dpy = XOpenDisplay(dpy_str); + if (!dpy) { + exiter("cannot open display\n", 1); + } + + root = DefaultRootWindow(dpy); + + xselectinput = SubstructureNotifyMask; + if (helper_pid > 0) { + ticker_atom = XInternAtom(dpy, ticker_atom_str, False); + xselectinput |= PropertyChangeMask; + } + XSelectInput(dpy, root, xselectinput); + + cmd_atom = XInternAtom(dpy, cmd_atom_str, False); + + init_cmask(); + + sprintf(unique_tag, "X11VNC_APPSHARE_TAG=%d-tag", getpid()); + + start_time = dnow(); + + if (app_str == NULL) { + exiter("no -id/-sid window specified.\n", 1); + } else { + char *p, *str = strdup(app_str); + char *alist[AMAX]; + int i, n = 0; + + p = strtok(str, ","); + while (p) { + if (n >= AMAX) { + fprintf(stderr, "ran out of app slots: %s\n", app_str); + exiter("", 1); + } + alist[n++] = strdup(p); + p = strtok(NULL, ","); + } + free(str); + + for (i=0; i < n; i++) { + Window app = None; + p = alist[i]; + app = parse_win(p); + free(p); + + if (app != None) { + if (!ours(app)) { + add_app(app); + } + } + } + } + + set_trackdir(); + + signal(SIGINT, appshare_cleanup); + signal(SIGTERM, appshare_cleanup); + + rfbLogEnable(0); + + if (connect_to) { + char *p, *str = strdup(connect_to); + int n = 0; + p = strtok(str, ","); + while (p) { + clients[n++] = strdup(p); + p = strtok(NULL, ","); + } + free(str); + } else { + connect_to = strdup(""); + } + + for (i=0; i < AMAX; i++) { + if (apps[i] == None) { + continue; + } + fprintf(stdout, "Using app win: 0x%08lx root: 0x%08lx\n", apps[i], root); + } + fprintf(stdout, "\n"); + + monitor(); + + appshare_cleanup(0); + +#endif + return 0; +} + diff --git a/x11vnc/connections.c b/x11vnc/connections.c index 9f8431a..97d4c19 100644 --- a/x11vnc/connections.c +++ b/x11vnc/connections.c @@ -53,6 +53,7 @@ so, delete this exception statement from your version. #include "macosxCG.h" #include "userinput.h" #include "pointer.h" +#include "xrandr.h" /* * routines for handling incoming, outgoing, etc connections @@ -257,10 +258,10 @@ static rfbClientPtr *client_match(char *str) { i = 0; iter = rfbGetClientIterator(screen); while( (cl = rfbClientIteratorNext(iter)) ) { + ClientData *cd = (ClientData *) cl->clientData; if (strstr(str, "0x") == str) { unsigned int in; int id; - ClientData *cd = (ClientData *) cl->clientData; if (! cd) { continue; } @@ -277,25 +278,52 @@ static rfbClientPtr *client_match(char *str) { cl_list[i++] = cl; } } else { - char *rstr = str; + int port = -1; + char *rstr = strdup(str); + char *q = strrchr(rstr, ':'); + if (q) { + port = atoi(q+1); + *q = '\0'; + if (port == 0 && q[1] != '0') { + port = -1; + } else if (port < 0) { + port = -port; + } else if (port < 200) { + port = 5500 + port; + } + } if (! dotted_ip(str)) { - rstr = host2ip(str); + char *orig = rstr; + rstr = host2ip(rstr); + free(orig); if (rstr == NULL || *rstr == '\0') { if (host_warn++) { continue; } - rfbLog("skipping bad lookup: \"%s\"\n", - str); + rfbLog("skipping bad lookup: \"%s\"\n", str); continue; } - rfbLog("lookup: %s -> %s\n", str, rstr); + rfbLog("lookup: %s -> %s port=%d\n", str, rstr, port); } if (!strcmp(rstr, cl->host)) { - cl_list[i++] = cl; - } - if (rstr != str) { - free(rstr); + int ok = 1; + if (port > 0) { + if (cd != NULL && cd->client_port > 0) { + if (cd->client_port != port) { + ok = 0; + } + } else { + int cport = get_remote_port(cl->sock); + if (cport != port) { + ok = 0; + } + } + } + if (ok) { + cl_list[i++] = cl; + } } + free(rstr); } if (i >= n - 1) { break; @@ -766,6 +794,7 @@ void client_gone(rfbClientPtr client) { if (unixpw_in_progress && unixpw_client) { if (client == unixpw_client) { unixpw_in_progress = 0; + /* mutex */ screen->permitFileTransfer = unixpw_file_xfer_save; if ((tightfilexfer = unixpw_tightvnc_xfer_save)) { #ifdef LIBVNCSERVER_WITH_TIGHTVNC_FILETRANSFER @@ -1670,14 +1699,20 @@ static void check_connect_file(char *file) { FILE *in; char line[VNC_CONNECT_MAX], host[VNC_CONNECT_MAX]; static int first_warn = 1, truncate_ok = 1; - static time_t last_time = 0; - time_t now = time(NULL); - - if (last_time == 0) { - last_time = now; + static double last_time = 0.0, delay = 0.5; + double now = dnow(); + struct stat sbuf; + + if (last_time == 0.0) { + if (!getenv("X11VNC_APPSHARE_ACTIVE")) { + /* skip first */ + last_time = now; + } else { + delay = 0.25; + } } - if (now - last_time < 1) { - /* check only once a second */ + if (now - last_time < delay) { + /* check only about once a second */ return; } last_time = now; @@ -1691,6 +1726,13 @@ static void check_connect_file(char *file) { } } + if (stat(file, &sbuf) == 0) { + /* skip empty file directly */ + if (sbuf.st_size == 0) { + return; + } + } + in = fopen(file, "r"); if (in == NULL) { if (first_warn) { @@ -2567,6 +2609,12 @@ void reverse_connect(char *str) { int nclients0 = client_count; int lcnt, j; char **list; + int do_appshare = 0; + + if (!getenv("X11VNC_REVERSE_USE_OLD_SLEEP")) { + sleep_min = 500; + sleep_max = 2500; + } if (unixpw_in_progress) return; @@ -2582,19 +2630,56 @@ void reverse_connect(char *str) { } free(tmp); + if (subwin && getenv("X11VNC_APPSHARE_ACTIVE")) { + do_appshare = 1; + sleep_between_host = 0; /* too agressive??? */ + } + if (getenv("X11VNC_REVERSE_SLEEP_BETWEEN_HOST")) { + sleep_between_host = atoi(getenv("X11VNC_REVERSE_SLEEP_BETWEEN_HOST")); + } + + if (do_appshare) { + if (screen && dpy) { + char *s = choose_title(DisplayString(dpy)); + + /* mutex */ + screen->desktopName = s; + if (rfb_desktop_name) { + free(rfb_desktop_name); + } + rfb_desktop_name = strdup(s); + } + } + for (j = 0; j < lcnt; j++) { p = list[j]; if ((n = do_reverse_connect(p)) != 0) { + int i; progress_client(); - rfbPE(-1); + for (i=0; i < 3; i++) { + rfbPE(-1); + } } cnt += n; if (list[j+1] != NULL) { t = 0; while (t < sleep_between_host) { + double t1, t2; + int i; + t1 = dnow(); + for (i=0; i < 8; i++) { + rfbPE(-1); + if (do_appshare && t == 0) { + rfbPE(-1); + } + } + t2 = dnow(); + t += (int) (1000 * (t2 - t1)); + if (t >= sleep_between_host) { + break; + } usleep(dt * 1000); - rfbPE(-1); t += dt; } } @@ -2616,6 +2701,9 @@ void reverse_connect(char *str) { } clean_up_exit(0); } + if (xrandr || xrandr_maybe) { + check_xrandr_event("reverse_connect1"); + } return; } @@ -2623,6 +2711,8 @@ void reverse_connect(char *str) { * XXX: we need to process some of the initial handshaking * events, otherwise the client can get messed up (why??) * so we send rfbProcessEvents() all over the place. + * + * How much is this still needed? */ n = cnt; @@ -2632,17 +2722,42 @@ void reverse_connect(char *str) { t = sleep_max - sleep_min; tot = sleep_min + ((n-1) * t) / (n_max-1); + if (do_appshare) { + tot /= 3; + if (tot < dt) { + tot = dt; + } + tot = 0; /* too agressive??? */ + } + + if (getenv("X11VNC_REVERSE_SLEEP_MAX")) { + tot = atoi(getenv("X11VNC_REVERSE_SLEEP_MAX")); + } + t = 0; while (t < tot) { - rfbPE(-1); - rfbPE(-1); + int i; + double t1, t2; + t1 = dnow(); + for (i=0; i < 8; i++) { + rfbPE(-1); + if (t == 0) rfbPE(-1); + } + t2 = dnow(); + t += (int) (1000 * (t2 - t1)); + if (t >= tot) { + break; + } usleep(dt * 1000); t += dt; } if (connect_or_exit) { if (client_count <= nclients0) { for (t = 0; t < 10; t++) { - rfbPE(-1); + int i; + for (i=0; i < 3; i++) { + rfbPE(-1); + } usleep(100 * 1000); } } @@ -2656,6 +2771,9 @@ void reverse_connect(char *str) { clean_up_exit(0); } } + if (xrandr || xrandr_maybe) { + check_xrandr_event("reverse_connect2"); + } } /* @@ -2857,7 +2975,9 @@ static void pmove(int x, int y) { } rfbLog("pmove: x y: %d %d\n", x, y); pointer(0, x, y, NULL); + X_LOCK; XFlush_wr(dpy); + X_UNLOCK; } @@ -3472,6 +3592,7 @@ static void turn_off_truecolor_ad(rfbClientPtr client) { if (client) {} if (turn_off_truecolor) { rfbLog("turning off truecolor advertising.\n"); + /* mutex */ screen->serverFormat.trueColour = FALSE; screen->displayHook = NULL; screen->serverFormat.redShift = 0; @@ -3639,6 +3760,7 @@ enum rfbNewClientAction new_client(rfbClientPtr client) { } } else if (strstr(passwdfile, "custom:") == passwdfile) { if (screen) { + /* mutex */ screen->passwordCheck = custom_passwd_check; } } @@ -3683,8 +3805,9 @@ enum rfbNewClientAction new_client(rfbClientPtr client) { cd->cmp_bytes_sent = 0; cd->raw_bytes_sent = 0; - rfbLog("incr accepted_client for %s:%d sock=%d\n", client->host, get_remote_port(client->sock), client->sock); accepted_client++; + rfbLog("incr accepted_client=%d for %s:%d sock=%d\n", accepted_client, + client->host, get_remote_port(client->sock), client->sock); last_client = time(NULL); if (ncache) { @@ -3720,6 +3843,7 @@ enum rfbNewClientAction new_client(rfbClientPtr client) { rfbSetTranslateFunction(client); + /* mutex */ screen->serverFormat.trueColour = TRUE; screen->serverFormat.redShift = rs; screen->serverFormat.greenShift = gs; diff --git a/x11vnc/cursor.c b/x11vnc/cursor.c index 7ac0302..2ec93c3 100644 --- a/x11vnc/cursor.c +++ b/x11vnc/cursor.c @@ -576,7 +576,9 @@ void first_cursor(void) { return; } if (! show_cursor) { + LOCK(screen->cursorMutex); screen->cursor = NULL; + UNLOCK(screen->cursorMutex); } else { got_xfixes_cursor_notify++; set_rfb_cursor(get_which_cursor()); @@ -591,7 +593,7 @@ static void setup_cursors(void) { int w_in = 0, h_in = 0; static int first = 1; - if (verbose) { + if (verbose || use_threads) { rfbLog("setting up %d cursors...\n", CURS_MAX); } @@ -603,8 +605,8 @@ static void setup_cursors(void) { first = 0; if (screen) { - screen->cursor = NULL; LOCK(screen->cursorMutex); + screen->cursor = NULL; } for (i=0; icursorMutex); screen->cursor = NULL; + UNLOCK(screen->cursorMutex); set_cursor_was_changed(screen); } } @@ -1656,9 +1659,11 @@ static void set_cursor_was_changed(rfbScreenInfoPtr s) { return; } iter = rfbGetClientIterator(s); + LOCK(screen->cursorMutex); while( (cl = rfbClientIteratorNext(iter)) ) { cl->cursorWasChanged = TRUE; } + UNLOCK(screen->cursorMutex); rfbReleaseClientIterator(iter); } diff --git a/x11vnc/help.c b/x11vnc/help.c index 4b81efe..279c964 100644 --- a/x11vnc/help.c +++ b/x11vnc/help.c @@ -176,6 +176,21 @@ void print_help(int mode) { " shifts a root view to it: this shows SaveUnders menus,\n" " etc, although they will be clipped if they extend beyond\n" " the window.\n" +"\n" +"-appshare Simple application sharing based on the -id/-sid\n" +" mechanism. Every new toplevel window that the\n" +" application creates induces a new viewer window via\n" +" a reverse connection. The -id/-sid and -connect\n" +" options are required. Run 'x11vnc -appshare -help'\n" +" for more info.\n" +"\n" +#if 0 +"-freeze_when_obscured Probably only of use in -appshare mode: if the -id/-sid\n" +" window is partially or fully obscured by other windows,\n" +" stop checking for framebuffer updates. Mouse and\n" +" keyboard events are still processed and injected.\n" +"\n" +#endif "-clip WxH+X+Y Only show the sub-region of the full display that\n" " corresponds to the rectangle geometry with size WxH and\n" " offset +X+Y. The VNC display has size WxH (i.e. smaller\n" @@ -2779,7 +2794,7 @@ void print_help(int mode) { " \"debug crash shell\" when fatal errors are trapped.\n" "\n" "-q, -quiet Be quiet by printing less informational output to\n" -" stderr.\n" +" stderr. (use -noquiet to undo an earlier -quiet.)\n" "-v, -verbose Print out more information to stderr.\n" "\n" "-bg Go into the background after screen setup. Messages to\n" @@ -3175,7 +3190,7 @@ void print_help(int mode) { " (an integer) times that of the full display is allocated\n" " below the actual framebuffer to cache screen contents\n" " for rapid retrieval. So a W x H frambuffer is expanded\n" -" to a W x (n+1)*H one. Use 0 to disable. Default: XXX.\n" +" to a W x (n+1)*H one. Use 0 to disable.\n" "\n" " The \"n\" is actually optional, the default is 10.\n" "\n" @@ -3183,13 +3198,17 @@ void print_help(int mode) { " abbreviate \"-ncache\" with \"-nc\". Also, \"-nonc\"\n" " is the same as \"-ncache 0\"\n" "\n" -" This is an experimental option, currently implemented\n" -" in an awkward way in that in the VNC Viewer you can\n" -" see the cache contents if you scroll down, etc. So you\n" +" This is an experimental option, currently implemented in\n" +" an awkward way in that in the VNC Viewer you can see the\n" +" pixel cache contents if you scroll down, etc. So you\n" " will have to set things up so you can't see that region.\n" " If this method is successful, the changes required for\n" " clients to do this less awkwardly will be investigated.\n" "\n" +" The SSVNC viewer does a good job at automatically hiding\n" +" the pixel cache region. Or use SSVNC's -ycrop option\n" +" to explicitly hide the region.\n" +"\n" " Note that this mode consumes a huge amount of memory,\n" " both on the x11vnc server side and on the VNC Viewer\n" " side. If n=2 then the amount of RAM used is roughly\n" @@ -3896,10 +3915,7 @@ void print_help(int mode) { " for output) are created to handle each new client.\n" " Default: %s.\n" "\n" -" NOTE: The -threads mode may be disabled due to its\n" -" unstable behavior. If it is disabled, a warning is\n" -" printed out. Stability has been improved in version\n" -" 0.9.8 and so the feature has been re-enabled.\n" +" Thread stability is much improved in version 0.9.8.\n" "\n" " Multiple clients in threaded mode should be stable\n" " for the ZRLE encoding on all platforms. The Tight and\n" @@ -3907,9 +3923,14 @@ void print_help(int mode) { " multiple clients. Compile with -DTLS=__thread if your\n" " OS and compiler and linker support it.\n" "\n" +" For resizes (randr, etc.) set this env. var. to the number\n" +" of milliseconds to sleep: X11VNC_THREADS_NEW_FB_SLEEP\n" +" at various places in the do_new_fb() action. This is to\n" +" let various activities settle. Default is about 500ms.\n" +"\n" " Multiple clients in threaded mode could yield better\n" -" performance for 'class-room' broadcasting usage.\n" -" See also the -reflect option.\n" +" performance for 'class-room' broadcasting usage; also in\n" +" -appshare broadcast mode. See also the -reflect option.\n" "\n" "-fs f If the fraction of changed tiles in a poll is greater\n" " than f, the whole screen is updated. Default: %.2f\n" @@ -4599,6 +4620,12 @@ void print_help(int mode) { " id:windowid set -id window to \"windowid\". empty\n" " or \"root\" to go back to root window\n" " sid:windowid set -sid window to \"windowid\"\n" +" id_cmd:cmd cmds: raise, lower, map, unmap, iconify,\n" +" move:dXdY, resize:dWdH, geom:WxH+X+Y. dX\n" +" dY, dW, and dH must have a leading \"+\"\n" +" or \"-\" e.g.: move:-30+10 resize:+20+35\n" +" also: wm_delete, wm_name:string and\n" +" icon_name:string. Also id_cmd:win=N:cmd\n" " waitmapped wait until subwin is mapped.\n" " nowaitmapped do not wait until subwin is mapped.\n" " clip:WxH+X+Y set -clip mode to \"WxH+X+Y\"\n" @@ -5081,8 +5108,8 @@ void print_help(int mode) { " file use \"qry=...\" instead of \"cmd=...\"\n" "\n" " ans= stop quit exit shutdown ping resend_cutbuffer\n" -" resend_clipboard resend_primary blacken zero\n" -" refresh reset close disconnect id sid waitmapped\n" +" resend_clipboard resend_primary blacken zero refresh\n" +" reset close disconnect id_cmd id sid waitmapped\n" " nowaitmapped clip flashcmap noflashcmap shiftcmap\n" " truecolor notruecolor overlay nooverlay overlay_cursor\n" " overlay_yescursor nooverlay_nocursor nooverlay_cursor\n" @@ -5224,6 +5251,10 @@ void print_help(int mode) { " The returned output is also prefixed with \"str\".\n" " Example: -remote_prefix DO_THIS:\n" "\n" +" Note that enabling -remote_prefix allows the remote\n" +" VNC viewers to run x11vnc -remote commands. Do not\n" +" use this option if they are not to be trusted.\n" +"\n" "-noremote Do not process any remote control commands or queries.\n" "-yesremote Do process remote control commands or queries.\n" " Default: %s\n" diff --git a/x11vnc/keyboard.c b/x11vnc/keyboard.c index 9aee9ca..3713210 100644 --- a/x11vnc/keyboard.c +++ b/x11vnc/keyboard.c @@ -3056,6 +3056,10 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { static double max_keyrepeat_last_time = 0.0; static double max_keyrepeat_always = -1.0; + if (threads_drop_input) { + return; + } + dtime0(&tnow); got_keyboard_calls++; @@ -3125,6 +3129,8 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { } } + INPUT_LOCK; + last_down = down; last_keysym = keysym; last_keyboard_time = tnow; @@ -3215,6 +3221,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { if (db) rfbLog("--- scroll keyrate skipping 0x%lx %s " "%.4f %.4f\n", keysym, down ? "down":"up ", tnow - x11vnc_start, tnow - max_keyrepeat_last_time); + INPUT_UNLOCK; return; } } @@ -3237,6 +3244,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { tnow - x11vnc_start, tnow - max_keyrepeat_last_time); max_keyrepeat_last_keysym = keysym; skipped_last_down = 1; + INPUT_UNLOCK; return; } else { if (db) rfbLog("--- scroll keyrate KEEPING 0x%lx %s " @@ -3267,15 +3275,18 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { got_user_input++; got_keyboard_input++; } + INPUT_UNLOCK; return; } } if (view_only) { + INPUT_UNLOCK; return; } get_allowed_input(client, &input); if (! input.keystroke) { + INPUT_UNLOCK; return; } @@ -3327,6 +3338,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { char *b, bstr[32]; if (! down) { + INPUT_UNLOCK; return; /* nothing to send */ } if (debug_keyboard) { @@ -3360,6 +3372,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { } XFlush_wr(dpy); X_UNLOCK; + INPUT_UNLOCK; return; } @@ -3368,6 +3381,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { X_LOCK; XFlush_wr(dpy); X_UNLOCK; + INPUT_UNLOCK; return; } @@ -3394,6 +3408,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { } X_UNLOCK; + INPUT_UNLOCK; } diff --git a/x11vnc/options.c b/x11vnc/options.c index 2003225..5ec1a19 100644 --- a/x11vnc/options.c +++ b/x11vnc/options.c @@ -206,6 +206,8 @@ int macosx_icon_anim_time = 450; unsigned long subwin = 0x0; /* -id, -sid */ int subwin_wait_mapped = 0; +int freeze_when_obscured = 0; +int subwin_obscured = 0; int debug_xevents = 0; /* -R debug_xevents:1 */ int debug_xdamage = 0; /* -R debug_xdamage:1 or 2 ... */ @@ -472,6 +474,7 @@ int verbose = 0; /* threaded vs. non-threaded (default) */ int use_threads = 0; int started_rfbRunEventLoop = 0; +int threads_drop_input = 0; /* info about command line opts */ int got_noxwarppointer = 0; diff --git a/x11vnc/options.h b/x11vnc/options.h index e6dea7a..5866e87 100644 --- a/x11vnc/options.h +++ b/x11vnc/options.h @@ -178,6 +178,8 @@ extern int macosx_icon_anim_time; extern unsigned long subwin; extern int subwin_wait_mapped; +extern int freeze_when_obscured; +extern int subwin_obscured; extern int debug_xevents; extern int debug_xdamage; @@ -367,6 +369,7 @@ extern int verbose; extern int use_threads; extern int started_rfbRunEventLoop; +extern int threads_drop_input; extern int got_noxwarppointer; extern int got_rfbport; diff --git a/x11vnc/pm.c b/x11vnc/pm.c index 6b67bec..5b31d84 100644 --- a/x11vnc/pm.c +++ b/x11vnc/pm.c @@ -49,6 +49,16 @@ static void check_dpms(void); #endif void check_pm(void) { + static int skip = -1; + if (skip < 0) { + skip = 0; + if (getenv("X11VNC_NO_CHECK_PM")) { + skip = 1; + } + } + if (skip) { + return; + } check_fbpm(); check_dpms(); /* someday dpms activities? */ diff --git a/x11vnc/pointer.c b/x11vnc/pointer.c index 70d2b8e..c509b3b 100644 --- a/x11vnc/pointer.c +++ b/x11vnc/pointer.c @@ -76,9 +76,6 @@ typedef struct ptrremap { int up; } prtremap_t; -#ifdef LIBVNCSERVER_HAVE_LIBPTHREAD -MUTEX(pointerMutex); -#endif #define MAX_BUTTON_EVENTS 50 static prtremap_t pointer_map[MAX_BUTTONS+1][MAX_BUTTON_EVENTS]; @@ -674,6 +671,10 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { int sent = 0, buffer_it = 0; double now; + if (threads_drop_input) { + return; + } + if (mask >= 0) { got_pointer_calls++; } @@ -721,6 +722,8 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { y = nfix(y, dpy_y); } + INPUT_LOCK; + if ((pipeinput_fh != NULL || pipeinput_int) && mask >= 0) { pipe_pointer(mask, x, y, client); /* MACOSX here. */ if (! pipeinput_tee) { @@ -739,11 +742,13 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { if (!view_only && (input.motion || input.button)) { last_rfb_ptr_injected = dnow(); } + INPUT_UNLOCK; return; } } if (view_only) { + INPUT_UNLOCK; return; } @@ -755,6 +760,7 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { * to flush the event queue; there is no real pointer event. */ if (! input.motion && ! input.button) { + INPUT_UNLOCK; return; } @@ -786,6 +792,7 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { blackr[b].x1, blackr[b].y1, blackr[b].x2, blackr[b].y2); } + INPUT_UNLOCK; return; } } @@ -800,18 +807,12 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { if ((use_threads && pointer_mode != 1) || pointer_flush_delay > 0.0) { # define NEV 32 /* storage for the event queue */ - static int mutex_init = 0; static int nevents = 0; static int ev[NEV][3]; int i; /* timer things */ static double dt = 0.0, tmr = 0.0, maxwait = 0.4; - if (! mutex_init) { - INIT_MUTEX(pointerMutex); - mutex_init = 1; - } - if (pointer_flush_delay > 0.0) { maxwait = pointer_flush_delay; } @@ -821,7 +822,7 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { } } - LOCK(pointerMutex); + POINTER_LOCK; /* * If the framebuffer is being copied in another thread @@ -856,11 +857,12 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { ev[i][1] = -1; ev[i][2] = -1; } - UNLOCK(pointerMutex); if (debug_pointer) { rfbLog("pointer(): deferring event %d" " %.4f\n", i, tmr - x11vnc_start); } + POINTER_UNLOCK; + INPUT_UNLOCK; return; } } @@ -912,13 +914,14 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { dt = 0.0; dtime0(&tmr); - UNLOCK(pointerMutex); + POINTER_UNLOCK; } if (mask < 0) { /* -1 just means flush the event queue */ if (debug_pointer) { rfbLog("pointer(): flush only. %.4f\n", dnowx()); } + INPUT_UNLOCK; return; } @@ -955,6 +958,7 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { XFlush_wr(dpy); X_UNLOCK; } + INPUT_UNLOCK; } void initialize_pipeinput(void) { diff --git a/x11vnc/remote.c b/x11vnc/remote.c index 6d4e48a..356aa81 100644 --- a/x11vnc/remote.c +++ b/x11vnc/remote.c @@ -484,6 +484,7 @@ void http_connections(int on) { if (screen->httpPort == 0) { int port = find_free_port(5800, 5850); if (port) { + /* mutex */ screen->httpPort = port; } } @@ -517,6 +518,7 @@ static void reset_httpport(int old, int new) { rfbLog("reset_httpport: cannot set httpport: %d" " in inetd.\n", hp); } else if (screen) { + /* mutex */ screen->httpPort = hp; screen->httpInitDone = FALSE; if (screen->httpListenSock > -1) { @@ -544,6 +546,7 @@ static void reset_rfbport(int old, int new) { rfbClientIteratorPtr iter; rfbClientPtr cl; int maxfd; + /* mutex */ if (rp == 0) { screen->autoPort = TRUE; } else { @@ -655,7 +658,9 @@ int remote_control_access_ok(void) { } } + X_LOCK; xha = XListHosts(dpy, &n, &enabled); + X_UNLOCK; if (! enabled) { rfbLog("X access control is disabled, X clients can\n"); rfbLog(" connect from any host. Run 'xhost -'\n"); @@ -1055,6 +1060,13 @@ char *process_remote_cmd(char *cmd, int stringonly) { close_clients(p); goto done; } + if (strstr(p, "id_cmd") == p) { + NOTAPP + COLON_CHECK("id_cmd:") + p += strlen("id_cmd:"); + id_cmd(p); + goto done; + } if (strstr(p, "id") == p) { int ok = 0; Window twin; @@ -1465,6 +1477,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { rfbLog("remote_cmd: enable sharing.\n"); shared = 1; if (screen) { + /* mutex */ screen->alwaysShared = TRUE; screen->neverShared = FALSE; } @@ -1477,6 +1490,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { rfbLog("remote_cmd: disable sharing.\n"); shared = 0; if (screen) { + /* mutex */ screen->alwaysShared = FALSE; screen->neverShared = TRUE; } @@ -1562,6 +1576,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } if (! screen->permitFileTransfer) { rfbLog("remote_cmd: enabling -ultrafilexfer for clients.\n"); + /* mutex */ screen->permitFileTransfer = TRUE; } goto done; @@ -1577,6 +1592,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } if (screen->permitFileTransfer) { rfbLog("remote_cmd: disabling -ultrafilexfer for clients.\n"); + /* mutex */ screen->permitFileTransfer = FALSE; } goto done; @@ -1595,6 +1611,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { p += strlen("rfbversion:"); if (sscanf(p, "%d.%d", &maj, &min) == 2) { + /* mutex */ screen->protocolMajorVersion = maj; screen->protocolMinorVersion = min; rfbLog("remote_cmd: set rfbversion to: %d.%d\n", maj, min); @@ -1766,6 +1783,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } listen_str = strdup("localhost"); + /* mutex */ screen->listenInterface = htonl(INADDR_LOOPBACK); rfbLog("listening on loopback network only.\n"); rfbLog("allow list is: '%s'\n", NONUL(allow_list)); @@ -1813,6 +1831,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } listen_str = NULL; + /* mutex */ screen->listenInterface = htonl(INADDR_ANY); rfbLog("listening on ALL network interfaces.\n"); rfbLog("allow list is: '%s'\n", NONUL(allow_list)); @@ -1853,6 +1872,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } ok = 1; + /* mutex */ if (listen_str == NULL || *listen_str == '\0' || !strcmp(listen_str, "any")) { screen->listenInterface = htonl(INADDR_ANY); @@ -4134,6 +4154,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } #endif } else { + X_LOCK; if (down == -1) { XTestFakeKeyEvent_wr(dpy, kc, 1, CurrentTime); usleep(50*1000); @@ -4141,6 +4162,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { } else { XTestFakeKeyEvent_wr(dpy, kc, down, CurrentTime); } + X_UNLOCK; } goto done; } @@ -4340,8 +4362,9 @@ char *process_remote_cmd(char *cmd, int stringonly) { rfbLog("bcx_xattach: failed grab check for '%s': %s. Retrying[%d]...\n", p, res, try); free(res); pointer(0, dpy_x/2 + try, dpy_y/2 + try, NULL); - XFlush_wr(dpy); #if !NO_X11 + X_LOCK; + XFlush_wr(dpy); if (dpy) { if (try == 2) { XSync(dpy, False); @@ -4349,6 +4372,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { XSync(dpy, True); } } + X_UNLOCK; #endif if (try == 1) { usleep(250*1000); @@ -4382,6 +4406,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { if (d < 0) d = 0; rfbLog("remote_cmd: setting defer to %d ms.\n", d); defer_update = d; + /* mutex */ screen->deferUpdateTime = d; got_defer = 1; goto done; @@ -4403,6 +4428,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { if (d < 0) d = 0; rfbLog("remote_cmd: setting defer to %d ms.\n", d); defer_update = d; + /* mutex */ screen->deferUpdateTime = d; got_defer = 1; goto done; @@ -4907,6 +4933,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { if (f < 0) f = 0; rfbLog("remote_cmd: setting progressive %d -> %d.\n", screen->progressiveSliceHeight, f); + /* mutex */ screen->progressiveSliceHeight = f; goto done; } @@ -4995,6 +5022,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { goto qry; } rfbLog("turning on enablehttpproxy.\n"); + /* mutex */ screen->httpEnableProxyConnect = 1; goto done; } @@ -5081,6 +5109,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { free(rfb_desktop_name); } rfb_desktop_name = strdup(p); + /* mutex */ screen->desktopName = rfb_desktop_name; rfbLog("remote_cmd: setting desktop name to %s\n", rfb_desktop_name); @@ -5449,6 +5478,7 @@ char *process_remote_cmd(char *cmd, int stringonly) { passwds_new[0] = strdup(p); + /* mutex */ if (screen->authPasswdData && screen->passwordCheck == rfbCheckPasswordByList) { passwds_new[1] = passwds_old[1]; @@ -5984,8 +6014,10 @@ char *process_remote_cmd(char *cmd, int stringonly) { } } else { if (dpy) { /* raw_fb hack */ + X_LOCK; set_x11vnc_remote_prop(buf); XFlush_wr(dpy); + X_UNLOCK; } } #endif /* REMOTE_CONTROL */ diff --git a/x11vnc/screen.c b/x11vnc/screen.c index 66dd3f5..b34a941 100644 --- a/x11vnc/screen.c +++ b/x11vnc/screen.c @@ -125,6 +125,7 @@ void set_greyscale_colormap(void) { if (! screen) { return; } + /* mutex */ if (screen->colourMap.data.shorts) { free(screen->colourMap.data.shorts); screen->colourMap.data.shorts = NULL; @@ -154,6 +155,7 @@ void set_hi240_colormap(void) { if (! screen) { return; } + /* mutex */ if (0) fprintf(stderr, "set_hi240_colormap: %s\n", raw_fb_pixfmt); if (screen->colourMap.data.shorts) { free(screen->colourMap.data.shorts); @@ -211,6 +213,7 @@ void set_colormap(int reset) { if (reset) { init = 1; ncolor = 0; + /* mutex */ if (screen->colourMap.data.shorts) { free(screen->colourMap.data.shorts); screen->colourMap.data.shorts = NULL; @@ -233,6 +236,7 @@ void set_colormap(int reset) { } else { ncolor = NCOLOR; } + /* mutex */ screen->colourMap.count = ncolor; screen->serverFormat.trueColour = FALSE; screen->colourMap.is16 = TRUE; @@ -777,6 +781,7 @@ static void nofb_hook(rfbClientPtr cl) { } main_fb = fb->data; rfb_fb = main_fb; + /* mutex */ screen->frameBuffer = rfb_fb; screen->displayHook = NULL; } @@ -813,13 +818,214 @@ void free_old_fb(void) { } } +static char _lcs_tmp[128]; +static int _bytes0_size = 128, _bytes0[128]; + +static char *lcs(rfbClientPtr cl) { + sprintf(_lcs_tmp, "%d/%d/%d/%d/%d-%d/%d/%d", + !!(cl->newFBSizePending), + !!(cl->cursorWasChanged), + !!(cl->cursorWasMoved), + !!(cl->reverseConnection), + cl->state, + cl->modifiedRegion ? !!(sraRgnEmpty(cl->modifiedRegion)) : 2, + cl->requestedRegion ? !!(sraRgnEmpty(cl->requestedRegion)) : 2, + cl->copyRegion ? !!(sraRgnEmpty(cl->copyRegion)) : 2 + ); + return _lcs_tmp; +} + +static int lock_client_sends(int lock) { + static rfbClientPtr *cls = NULL; + static int cls_len = 0; + static int blocked = 0; + static int state = 0; + rfbClientIteratorPtr iter; + rfbClientPtr cl; + char *s; + + if (!use_threads || !screen) { + return 0; + } + if (lock < 0) { + return state; + } + state = lock; + + if (lock) { + if (cls_len < client_count + 128) { + if (cls != NULL) { + free(cls); + } + cls_len = client_count + 256; + cls = (rfbClientPtr *) calloc(cls_len * sizeof(rfbClientPtr), 1); + } + + iter = rfbGetClientIterator(screen); + blocked = 0; + while ((cl = rfbClientIteratorNext(iter)) != NULL) { + s = lcs(cl); + SEND_LOCK(cl); + rfbLog("locked client: %p %.6f %s\n", cl, dnowx(), s); + cls[blocked++] = cl; + } + rfbReleaseClientIterator(iter); + } else { + int i; + for (i=0; i < blocked; i++) { + cl = cls[i]; + if (cl != NULL) { + s = lcs(cl); + SEND_UNLOCK(cl) + rfbLog("unlocked client: %p %.6f %s\n", cl, dnowx(), s); + } + cls[i] = NULL; + } + blocked = 0; + } + return state; +} + +static void settle_clients(int init) { + rfbClientIteratorPtr iter; + rfbClientPtr cl; + int fb_pend, i, ms = 1000; + char *s; + + if (!use_threads || !screen) { + return; + } + + if (init) { + iter = rfbGetClientIterator(screen); + i = 0; + while ((cl = rfbClientIteratorNext(iter)) != NULL) { + if (i < _bytes0_size) { + _bytes0[i] = rfbStatGetSentBytesIfRaw(cl); + } + i++; + } + rfbReleaseClientIterator(iter); + + if (getenv("X11VNC_THREADS_NEW_FB_SLEEP")) { + ms = atoi(getenv("X11VNC_THREADS_NEW_FB_SLEEP")); + } else if (subwin) { + ms = 250; + } else { + ms = 500; + } + usleep(ms * 1000); + return; + } + + if (getenv("X11VNC_THREADS_NEW_FB_SLEEP")) { + ms = atoi(getenv("X11VNC_THREADS_NEW_FB_SLEEP")); + } else if (subwin) { + ms = 500; + } else { + ms = 1000; + } + usleep(ms * 1000); + + for (i=0; i < 5; i++) { + fb_pend = 0; + iter = rfbGetClientIterator(screen); + while ((cl = rfbClientIteratorNext(iter)) != NULL) { + s = lcs(cl); + if (cl->newFBSizePending) { + fb_pend++; + rfbLog("pending fb size: %p %.6f %s\n", cl, dnowx(), s); + } + } + rfbReleaseClientIterator(iter); + if (fb_pend > 0) { + rfbLog("do_new_fb: newFBSizePending extra -threads sleep (%d)\n", i+1); + usleep(ms * 1000); + } else { + break; + } + } + for (i=0; i < 5; i++) { + int stuck = 0, tot = 0, j = 0; + iter = rfbGetClientIterator(screen); + while ((cl = rfbClientIteratorNext(iter)) != NULL) { + if (j < _bytes0_size) { + int db = rfbStatGetSentBytesIfRaw(cl) - _bytes0[j]; + int Bpp = cl->format.bitsPerPixel / 8; + + s = lcs(cl); + rfbLog("addl bytes sent: %p %.6f %s %d %d\n", + cl, dnowx(), s, db, _bytes0[j]); + + if (i==0) { + if (db < Bpp * dpy_x * dpy_y) { + stuck++; + } + } else if (i==1) { + if (db < 0.5 * Bpp * dpy_x * dpy_y) { + stuck++; + } + } else { + if (db <= 0) { + stuck++; + } + } + } + tot++; + j++; + } + rfbReleaseClientIterator(iter); + if (stuck > 0) { + rfbLog("clients stuck: %d/%d sleep(%d)\n", stuck, tot, i); + usleep(2 * ms * 1000); + } else { + break; + } + } +} + +static void prep_clients_for_new_fb(void) { + rfbClientIteratorPtr iter; + rfbClientPtr cl; + + if (!use_threads || !screen) { + return; + } + iter = rfbGetClientIterator(screen); + while ((cl = rfbClientIteratorNext(iter)) != NULL) { + if (!cl->newFBSizePending) { + rfbLog("** set_new_fb_size_pending client: %p\n", cl); + cl->newFBSizePending = TRUE; + } + cl->cursorWasChanged = FALSE; + cl->cursorWasMoved = FALSE; + } + rfbReleaseClientIterator(iter); +} + void do_new_fb(int reset_mem) { XImage *fb; /* for threaded we really should lock libvncserver out. */ if (use_threads) { - rfbLog("warning: changing framebuffers while threaded may\n"); - rfbLog(" not work, do not use -threads if problems arise.\n"); + int ms = 1000; + if (getenv("X11VNC_THREADS_NEW_FB_SLEEP")) { + ms = atoi(getenv("X11VNC_THREADS_NEW_FB_SLEEP")); + } else if (subwin) { + ms = 500; + } else { + ms = 1000; + } + rfbLog("Warning: changing framebuffers in threaded mode may be unstable.\n"); + threads_drop_input = 1; + usleep(ms * 1000); + } + + INPUT_LOCK; + lock_client_sends(1); + + if (use_threads) { + settle_clients(1); } if (reset_mem == 1) { @@ -842,6 +1048,16 @@ void do_new_fb(int reset_mem) { if (ncache) { check_ncache(1, 0); } + + prep_clients_for_new_fb(); + lock_client_sends(0); + INPUT_UNLOCK; + + if (use_threads) { + /* need to let things settle... */ + settle_clients(0); + threads_drop_input = 0; + } } static void remove_fake_fb(void) { @@ -859,51 +1075,6 @@ static void remove_fake_fb(void) { fake_fb = NULL; } -static void lock_client_sends(int lock) { - static rfbClientPtr *cls = NULL; - static int cls_len = 0; - static int blocked = 0; - rfbClientIteratorPtr iter; - rfbClientPtr cl; - - if (!use_threads) { - return; - } - if (!screen) { - return; - } - - if (lock) { - if (cls_len < client_count + 128) { - if (cls != NULL) { - free(cls); - } - cls_len = client_count + 128; - cls = (rfbClientPtr *) calloc(cls_len * sizeof(rfbClientPtr), 1); - } - - iter = rfbGetClientIterator(screen); - blocked = 0; - while ((cl = rfbClientIteratorNext(iter)) != NULL) { - SEND_LOCK(cl); -rfbLog("locked client: %p\n", cl); - cls[blocked++] = cl; - } - rfbReleaseClientIterator(iter); - } else { - int i; - for (i=0; i < blocked; i++) { - cl = cls[i]; - if (cl != NULL) { - SEND_UNLOCK(cl) -rfbLog("unlocked client: %p\n", cl); - } - cls[i] = NULL; - } - blocked = 0; - } -} - static void rfb_new_framebuffer(rfbScreenInfoPtr rfbScreen, char *framebuffer, int width,int height, int bitsPerSample,int samplesPerPixel, int bytesPerPixel) { @@ -918,12 +1089,14 @@ static void install_fake_fb(int w, int h, int bpp) { if (! screen) { return; } + lock_client_sends(1); if (fake_fb) { free(fake_fb); } fake_fb = (char *) calloc(w*h*bpp/8, 1); if (! fake_fb) { rfbLog("could not create fake fb: %dx%d %d\n", w, h, bpp); + lock_client_sends(0); return; } bpc = guess_bits_per_color(bpp); @@ -931,7 +1104,6 @@ static void install_fake_fb(int w, int h, int bpp) { rfbLog("rfbNewFramebuffer(0x%x, 0x%x, %d, %d, %d, %d, %d)\n", screen, fake_fb, w, h, bpc, 1, bpp/8); - lock_client_sends(1); rfb_new_framebuffer(screen, fake_fb, w, h, bpc, 1, bpp/8); lock_client_sends(0); } @@ -2275,6 +2447,8 @@ if (0) fprintf(stderr, "vis_str %s\n", vis_str ? vis_str : "notset"); /* set up parameters for subwin or non-subwin cases: */ + again: + if (! subwin) { /* full screen */ window = rootwin; @@ -2368,7 +2542,6 @@ if (0) fprintf(stderr, "DefaultDepth: %d visial_id: %d\n", depth, (int) visual_ (int) XVisualIDFromVisual(default_visual)); } - again: if (subwin) { int shift = 0, resize = 0; int subwin_x, subwin_y; @@ -2435,7 +2608,9 @@ if (0) fprintf(stderr, "DefaultDepth: %d visial_id: %d\n", depth, (int) visual_ */ fb = XCreateImage_wr(dpy, default_visual, depth, ZPixmap, 0, NULL, dpy_x, dpy_y, BitmapPad(dpy), 0); - fb->data = (char *) malloc(fb->bytes_per_line * fb->height); + if (fb) { + fb->data = (char *) malloc(fb->bytes_per_line * fb->height); + } } else { fb = XGetImage_wr(dpy, window, 0, 0, dpy_x, dpy_y, AllPlanes, @@ -2448,7 +2623,7 @@ if (0) fprintf(stderr, "DefaultDepth: %d visial_id: %d\n", depth, (int) visual_ if (subwin) { XSetErrorHandler(old_handler); - if (trapped_xerror) { + if (trapped_xerror || fb == NULL) { rfbLog("trapped GetImage at SUBWIN creation.\n"); if (try < subwin_tries) { usleep(250 * 1000); @@ -2464,10 +2639,51 @@ if (0) fprintf(stderr, "DefaultDepth: %d visial_id: %d\n", depth, (int) visual_ } trapped_xerror = 0; - } else if (! fb && try == 1) { - /* try once more */ - usleep(250 * 1000); - goto again; + } else if (fb == NULL) { + XEvent xev; + rfbLog("initialize_xdisplay_fb: *** fb creation failed: 0x%x try: %d\n", fb, try); +#if LIBVNCSERVER_HAVE_LIBXRANDR + if (xrandr_present && xrandr_base_event_type) { + int cnt = 0; + while (XCheckTypedEvent(dpy, xrandr_base_event_type + RRScreenChangeNotify, &xev)) { + XRRScreenChangeNotifyEvent *rev; + rev = (XRRScreenChangeNotifyEvent *) &xev; + + rfbLog("initialize_xdisplay_fb: XRANDR event while redoing fb[%d]:\n", cnt++); + rfbLog(" serial: %d\n", (int) rev->serial); + rfbLog(" timestamp: %d\n", (int) rev->timestamp); + rfbLog(" cfg_timestamp: %d\n", (int) rev->config_timestamp); + rfbLog(" size_id: %d\n", (int) rev->size_index); + rfbLog(" sub_pixel: %d\n", (int) rev->subpixel_order); + rfbLog(" rotation: %d\n", (int) rev->rotation); + rfbLog(" width: %d\n", (int) rev->width); + rfbLog(" height: %d\n", (int) rev->height); + rfbLog(" mwidth: %d mm\n", (int) rev->mwidth); + rfbLog(" mheight: %d mm\n", (int) rev->mheight); + rfbLog("\n"); + rfbLog("previous WxH: %dx%d\n", wdpy_x, wdpy_y); + + xrandr_width = rev->width; + xrandr_height = rev->height; + xrandr_timestamp = rev->timestamp; + xrandr_cfg_time = rev->config_timestamp; + xrandr_rotation = (int) rev->rotation; + + rfbLog("initialize_xdisplay_fb: updating XRANDR config...\n"); + XRRUpdateConfiguration(&xev); + } + } +#endif + if (try < 5) { + XFlush_wr(dpy); + usleep(250 * 1000); + if (try < 3) { + XSync(dpy, False); + } else if (try >= 3) { + XSync(dpy, True); + } + goto again; + } } if (use_snapfb) { initialize_snap_fb(); @@ -2734,9 +2950,11 @@ static rfbBool set_xlate_wrapper(rfbClientPtr cl) { } else if (ncache) { int save = ncache_xrootpmap; rfbLog("set_xlate_wrapper: clearing -ncache for new pixel format.\n"); + INPUT_LOCK; ncache_xrootpmap = 0; check_ncache(1, 0); ncache_xrootpmap = save; + INPUT_UNLOCK; } return rfbSetTranslateFunction(cl); } @@ -2751,7 +2969,8 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { int create_screen = screen ? 0 : 1; int bits_per_color; int fb_bpp, fb_Bpl, fb_depth; - + int locked_sends = 0; + bpp = fb->bits_per_pixel; fb_bpp = (int) fb->bits_per_pixel; @@ -2860,7 +3079,10 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { */ bits_per_color = guess_bits_per_color(fb_bpp); - lock_client_sends(1); + if (lock_client_sends(-1) == 0) { + lock_client_sends(1); + locked_sends = 1; + } /* n.b. samplesPerPixel (set = 1 here) seems to be unused. */ if (create_screen) { @@ -3274,7 +3496,6 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { /* may need, bpp, main_red_max, etc. */ parse_wireframe(); parse_scroll_copyrect(); - setup_cursors_and_push(); if (scaling || rotating || cmap8to24) { @@ -3297,10 +3518,13 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { } rfbReleaseClientIterator(iter); if (!quiet) rfbLog(" done.\n"); - do_copy_screen = 1; /* done for framebuffer change case */ - lock_client_sends(0); + if (locked_sends) { + lock_client_sends(0); + } + + do_copy_screen = 1; return; } @@ -3376,7 +3600,10 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { install_passwds(); - lock_client_sends(0); + if (locked_sends) { + lock_client_sends(0); + } + return; } #define DO_AVAHI \ @@ -3981,6 +4208,7 @@ void watch_loop(void) { while (1) { char msg[] = "new client: %s taking unixpw client off hold.\n"; + int skip_scan_for_updates = 0; got_user_input = 0; got_pointer_input = 0; @@ -4187,8 +4415,20 @@ void watch_loop(void) { if (x11vnc_current < last_new_client + 0.5 && !all_clients_initialized()) { continue; } + if (subwin && freeze_when_obscured) { + /* XXX not working */ + X_LOCK; + XFlush_wr(dpy); + X_UNLOCK; + check_xevents(0); + if (subwin_obscured) { + skip_scan_for_updates = 1; + } + } - if (button_mask && (!show_dragging || pointer_mode == 0)) { + if (skip_scan_for_updates) { + ; + } else if (button_mask && (!show_dragging || pointer_mode == 0)) { /* * if any button is pressed in this mode do * not update rfb screen, but do flush the @@ -4216,6 +4456,7 @@ void watch_loop(void) { if (rawfb_vnc_reflect) { vnc_reflect_process_client(); } + dtime0(&tm); #if !NO_X11 @@ -4235,7 +4476,9 @@ void watch_loop(void) { } X_UNLOCK; } + X_LOCK; check_xrandr_event("before-scan"); + X_UNLOCK; } #endif if (use_snapfb) { diff --git a/x11vnc/sslhelper.c b/x11vnc/sslhelper.c index b9b0058..12f5819 100644 --- a/x11vnc/sslhelper.c +++ b/x11vnc/sslhelper.c @@ -2666,8 +2666,8 @@ void check_https(void) { } void openssl_port(void) { - int sock, shutdown = 0; - static int port = 0; + int sock = -1, shutdown = 0; + static int port = -1; static in_addr_t iface = INADDR_ANY; int db = 0; @@ -2683,6 +2683,8 @@ void openssl_port(void) { if (screen->listenSock > -1 && screen->port > 0) { port = screen->port; shutdown = 1; + } else if (screen->port == 0) { + port = screen->port; } if (screen->listenInterface) { iface = screen->listenInterface; @@ -2696,14 +2698,18 @@ void openssl_port(void) { #endif } - if (port <= 0) { + if (port < 0) { rfbLog("openssl_port: could not obtain listening port %d\n", port); clean_up_exit(1); - } - sock = rfbListenOnTCPPort(port, iface); - if (sock < 0) { - rfbLog("openssl_port: could not reopen port %d\n", port); - clean_up_exit(1); + } else if (port == 0) { + /* no listen case, i.e. -connect */ + sock = -1; + } else { + sock = rfbListenOnTCPPort(port, iface); + if (sock < 0) { + rfbLog("openssl_port: could not reopen port %d\n", port); + clean_up_exit(1); + } } rfbLog("openssl_port: listen on port/sock %d/%d\n", port, sock); if (!quiet) { @@ -3852,6 +3858,7 @@ void accept_openssl(int mode, int presock) { if (screen->port == 0) { int fd = fileno(stdin); if (getenv("X11VNC_INETD_PORT")) { + /* mutex */ screen->port = atoi(getenv( "X11VNC_INETD_PORT")); } else { diff --git a/x11vnc/tkx11vnc b/x11vnc/tkx11vnc index 9806f84..3aeb327 100755 --- a/x11vnc/tkx11vnc +++ b/x11vnc/tkx11vnc @@ -176,6 +176,7 @@ Screen =GAL SubWindow:: id: sid: + =RA id_cmd: =GAL LOFF =GAL ResizeRotate:: = xrandr diff --git a/x11vnc/tkx11vnc.h b/x11vnc/tkx11vnc.h index 54400a7..beea1bb 100644 --- a/x11vnc/tkx11vnc.h +++ b/x11vnc/tkx11vnc.h @@ -187,6 +187,7 @@ char gui_code[] = ""; " =GAL SubWindow::\n" " id:\n" " sid:\n" +" =RA id_cmd:\n" " =GAL LOFF\n" " =GAL ResizeRotate::\n" " = xrandr\n" diff --git a/x11vnc/unixpw.c b/x11vnc/unixpw.c index 950f3b0..92eec53 100644 --- a/x11vnc/unixpw.c +++ b/x11vnc/unixpw.c @@ -2033,6 +2033,7 @@ void unixpw_accept(char *user) { unixpw_client->viewOnly = TRUE; } unixpw_in_progress = 0; + /* mutex */ screen->permitFileTransfer = unixpw_file_xfer_save; if ((tightfilexfer = unixpw_tightvnc_xfer_save)) { /* this doesn't work: the current client is never registered! */ @@ -2078,6 +2079,7 @@ void unixpw_deny(void) { } unixpw_in_progress = 0; + /* mutex */ screen->permitFileTransfer = unixpw_file_xfer_save; if ((tightfilexfer = unixpw_tightvnc_xfer_save)) { #ifdef LIBVNCSERVER_WITH_TIGHTVNC_FILETRANSFER diff --git a/x11vnc/user.c b/x11vnc/user.c index d70ce0d..2eb939e 100644 --- a/x11vnc/user.c +++ b/x11vnc/user.c @@ -1085,6 +1085,7 @@ void install_passwds(void) { passwds_new[0] = passwds_old[0]; passwds_new[1] = viewonly_passwd; passwds_new[2] = NULL; + /* mutex */ screen->authPasswdData = (void*) passwds_new; } else if (passwd_list) { int i = 0; @@ -1094,6 +1095,7 @@ void install_passwds(void) { if (begin_viewonly < 0) { begin_viewonly = i+1; } + /* mutex */ screen->authPasswdData = (void*) passwd_list; screen->authPasswdFirstViewOnly = begin_viewonly; } @@ -1167,6 +1169,7 @@ static void handle_one_http_request(void) { if (inetd || screen->httpPort == 0) { int port = find_free_port(5800, 5860); if (port) { + /* mutex */ screen->httpPort = port; } else { rfbLog("handle_one_http_request: no http port.\n"); @@ -1703,6 +1706,7 @@ static void vnc_redirect_loop(char *vnc_redirect_test, int *vnc_redirect_cnt) { #if LIBVNCSERVER_HAVE_FORK if ((pid = fork()) > 0) { close(screen->httpListenSock); + /* mutex */ screen->httpListenSock = -2; usleep(500 * 1000); } else { diff --git a/x11vnc/userinput.c b/x11vnc/userinput.c index 1a50a03..2fd53c7 100644 --- a/x11vnc/userinput.c +++ b/x11vnc/userinput.c @@ -373,6 +373,7 @@ static void parse_wireframe_str(char *wf) { Colormap cmap; if (dpy && (bpp == 32 || bpp == 16)) { #if !NO_X11 + X_LOCK; cmap = DefaultColormap (dpy, scr); if (XParseColor(dpy, cmap, str, &cdef) && XAllocColor(dpy, cmap, &cdef)) { @@ -389,6 +390,7 @@ static void parse_wireframe_str(char *wf) { wireframe_shade = n; ok = 1; } + X_UNLOCK; #else r = g = b = 0; cmap = 0; diff --git a/x11vnc/util.c b/x11vnc/util.c index a00679a..5a733de 100644 --- a/x11vnc/util.c +++ b/x11vnc/util.c @@ -471,6 +471,7 @@ double rfac(void) { void check_allinput_rate(void) { static double last_all_input_check = 0.0; static int set = 0, verb = -1; + if (use_threads) { return; } @@ -703,7 +704,7 @@ double rect_overlap(int x1, int y1, int x2, int y2, int X1, int Y1, char *choose_title(char *display) { static char title[(MAXN+10)]; - memset(title, 0, MAXN+10); + memset(title, 0, sizeof(title)); strcpy(title, "x11vnc"); if (display == NULL) { @@ -724,13 +725,33 @@ char *choose_title(char *display) { if (subwin && dpy && valid_window(subwin, NULL, 0)) { #if !NO_X11 char *name = NULL; + int do_appshare = getenv("X11VNC_APPSHARE_ACTIVE") ? 1 : 0; + if (0 && do_appshare) { + title[0] = '\0'; + } if (XFetchName(dpy, subwin, &name)) { if (name) { - strncat(title, " ", MAXN - strlen(title)); + if (title[0] != '\0') { + strncat(title, " ", MAXN - strlen(title)); + } strncat(title, name, MAXN - strlen(title)); free(name); } } + if (do_appshare) { + Window c; + int x, y; + if (xtranslate(subwin, rootwin, 0, 0, &x, &y, &c, 1)) { + char tmp[32]; + if (scaling) { + x *= scale_fac_x; + y *= scale_fac_y; + } + sprintf(tmp, " XY=%d,%d", x, y); + strncat(title, tmp, MAXN - strlen(title)); + } + rfbLog("appshare title: %s\n", title); + } #endif /* NO_X11 */ } X_UNLOCK; diff --git a/x11vnc/util.h b/x11vnc/util.h index 41014ce..2d8c3bf 100644 --- a/x11vnc/util.h +++ b/x11vnc/util.h @@ -72,6 +72,11 @@ extern char *choose_title(char *display); #define NONUL(x) ((x) ? (x) : "") +/* + Put this in usleep2() for debug printout. + fprintf(stderr, "_mysleep: %08d %10.6f %s:%d\n", (x), dnow() - x11vnc_start, __FILE__, __LINE__); \ + */ + /* XXX usleep(3) is not thread safe on some older systems... */ extern struct timeval _mysleep; #define usleep2(x) \ @@ -96,6 +101,10 @@ extern struct timeval _mysleep; */ #ifdef LIBVNCSERVER_HAVE_LIBPTHREAD extern MUTEX(x11Mutex); +extern MUTEX(scrollMutex); +MUTEX(clientMutex); +MUTEX(inputMutex); +MUTEX(pointerMutex); #endif #define X_INIT INIT_MUTEX(x11Mutex) @@ -105,26 +114,33 @@ extern MUTEX(x11Mutex); #define X_UNLOCK UNLOCK(x11Mutex) #else extern int hxl; -#define X_LOCK fprintf(stderr, "*** X_LOCK**[%05d] %d%s\n", \ - __LINE__, hxl, hxl ? " BAD-PRE-LOCK":""); LOCK(x11Mutex); hxl = 1; -#define X_UNLOCK fprintf(stderr, " x_unlock[%05d] %d%s\n", \ - __LINE__, hxl, !hxl ? " BAD-PRE-UNLOCK":""); UNLOCK(x11Mutex); hxl = 0; +#define X_LOCK fprintf(stderr, "*** X_LOCK** %d%s %s:%d\n", \ + hxl, hxl ? " BAD-PRE-LOCK":"", __FILE__, __LINE__); LOCK(x11Mutex); hxl = 1; +#define X_UNLOCK fprintf(stderr, " x_unlock %d%s %s:%d\n", \ + hxl, !hxl ? " BAD-PRE-UNLOCK":"", __FILE__, __LINE__); UNLOCK(x11Mutex); hxl = 0; #endif -#ifdef LIBVNCSERVER_HAVE_LIBPTHREAD -extern MUTEX(scrollMutex); -#endif #define SCR_LOCK if (use_threads) {LOCK(scrollMutex);} #define SCR_UNLOCK if (use_threads) {UNLOCK(scrollMutex);} #define SCR_INIT INIT_MUTEX(scrollMutex) -#ifdef LIBVNCSERVER_HAVE_LIBPTHREAD -MUTEX(clientMutex); -#endif #define CLIENT_LOCK if (use_threads) {LOCK(clientMutex);} #define CLIENT_UNLOCK if (use_threads) {UNLOCK(clientMutex);} #define CLIENT_INIT INIT_MUTEX(clientMutex) +#if 1 +#define INPUT_LOCK if (use_threads) {LOCK(inputMutex);} +#define INPUT_UNLOCK if (use_threads) {UNLOCK(inputMutex);} +#else +#define INPUT_LOCK +#define INPUT_UNLOCK +#endif +#define INPUT_INIT INIT_MUTEX(inputMutex) + +#define POINTER_LOCK if (use_threads) {LOCK(pointerMutex);} +#define POINTER_UNLOCK if (use_threads) {UNLOCK(pointerMutex);} +#define POINTER_INIT INIT_MUTEX(pointerMutex) + /* * The sendMutex member was added to libvncserver 0.9.8 * rfb/rfb.h sets LIBVNCSERVER_SEND_MUTEX if present. diff --git a/x11vnc/win_utils.c b/x11vnc/win_utils.c index eaa0113..3fccc45 100644 --- a/x11vnc/win_utils.c +++ b/x11vnc/win_utils.c @@ -38,6 +38,7 @@ so, delete this exception statement from your version. #include "cleanup.h" #include "xwrappers.h" #include "connections.h" +#include "xrandr.h" #include "macosx.h" winattr_t *stack_list = NULL; @@ -49,7 +50,7 @@ Window parent_window(Window win, char **name); int valid_window(Window win, XWindowAttributes *attr_ret, int bequiet); Bool xtranslate(Window src, Window dst, int src_x, int src_y, int *dst_x, int *dst_y, Window *child, int bequiet); -int get_window_size(Window win, int *x, int *y); +int get_window_size(Window win, int *w, int *h); void snapshot_stack_list(int free_only, double allowed_age); int get_boff(void); int get_bwin(void); @@ -58,6 +59,7 @@ Window query_pointer(Window start); unsigned int mask_state(void); int pick_windowid(unsigned long *num); Window descend_pointer(int depth, Window start, char *name_info, int len); +void id_cmd(char *cmd); Window parent_window(Window win, char **name) { @@ -184,12 +186,12 @@ Bool xtranslate(Window src, Window dst, int src_x, int src_y, int *dst_x, #endif /* NO_X11 */ } -int get_window_size(Window win, int *x, int *y) { +int get_window_size(Window win, int *w, int *h) { XWindowAttributes attr; /* valid_window? */ if (valid_window(win, &attr, 1)) { - *x = attr.width; - *y = attr.height; + *w = attr.width; + *h = attr.height; return 1; } else { return 0; @@ -609,3 +611,161 @@ Window descend_pointer(int depth, Window start, char *name_info, int len) { #endif /* NO_X11 */ } +void id_cmd(char *cmd) { + int rc, dx = 0, dy = 0, dw = 0, dh = 0; + int x0, y0, w0, h0; + int x, y, w, h, do_move = 0, do_resize = 0; + int disp_x = DisplayWidth(dpy, scr); + int disp_y = DisplayHeight(dpy, scr); + Window win = subwin; + XWindowAttributes attr; + XErrorHandler old_handler = NULL; + Window twin; + + if (!cmd || !strcmp(cmd, "")) { + return; + } + if (strstr(cmd, "win=") == cmd) { + if (! scan_hexdec(cmd + strlen("win="), &win)) { + rfbLog("id_cmd: incorrect win= hex/dec number: %s\n", cmd); + return; + } else { + char *q = strchr(cmd, ':'); + if (!q) { + rfbLog("id_cmd: incorrect win=...: hex/dec number: %s\n", cmd); + return; + } + rfbLog("id_cmd:%s set window id to 0x%lx\n", cmd, win); + cmd = q+1; + } + } + if (!win) { + rfbLog("id_cmd:%s not in sub-window mode or no win=0xNNNN.\n", cmd); + return; + } +#if !NO_X11 + X_LOCK; + if (!valid_window(win, &attr, 1)) { + X_UNLOCK; + return; + } + w0 = w = attr.width; + h0 = h = attr.height; + old_handler = XSetErrorHandler(trap_xerror); + trapped_xerror = 0; + XTranslateCoordinates(dpy, win, rootwin, 0, 0, &x, &y, &twin); + x0 = x; + y0 = y; + if (strstr(cmd, "move:") == cmd) { + if (sscanf(cmd, "move:%d%d", &dx, &dy) == 2) { + x = x + dx; + y = y + dy; + do_move = 1; + } + } else if (strstr(cmd, "resize:") == cmd) { + if (sscanf(cmd, "resize:%d%d", &dw, &dh) == 2) { + w = w + dw; + h = h + dh; + do_move = 1; + do_resize = 1; + } + } else if (strstr(cmd, "geom:") == cmd) { + if (parse_geom(cmd+strlen("geom:"), &w, &h, &x, &y, disp_x, disp_y)) { + do_move = 1; + do_resize = 1; + if (w <= 0) { + w = w0; + } + if (h <= 0) { + h = h0; + } + if (scaling && getenv("X11VNC_APPSHARE_ACTIVE")) { + x /= scale_fac_x; + y /= scale_fac_y; + } + } + } else if (!strcmp(cmd, "raise")) { + rc = XRaiseWindow(dpy, win); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (!strcmp(cmd, "lower")) { + rc = XLowerWindow(dpy, win); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (!strcmp(cmd, "map")) { + rc= XMapRaised(dpy, win); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (!strcmp(cmd, "unmap")) { + rc= XUnmapWindow(dpy, win); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (!strcmp(cmd, "iconify")) { + rc= XIconifyWindow(dpy, win, scr); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (strstr(cmd, "wm_name:") == cmd) { + rc= XStoreName(dpy, win, cmd+strlen("wm_name:")); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (strstr(cmd, "icon_name:") == cmd) { + rc= XSetIconName(dpy, win, cmd+strlen("icon_name:")); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else if (!strcmp(cmd, "wm_delete")) { + XClientMessageEvent ev; + memset(&ev, 0, sizeof(ev)); + ev.type = ClientMessage; + ev.send_event = True; + ev.display = dpy; + ev.window = win; + ev.message_type = XInternAtom(dpy, "WM_PROTOCOLS", False); + ev.format = 32; + ev.data.l[0] = XInternAtom(dpy, "WM_DELETE_WINDOW", False); + rc = XSendEvent(dpy, win, False, 0, (XEvent *) &ev); + rfbLog("id_cmd:%s rc=%d\n", cmd, rc); + } else { + rfbLog("id_cmd:%s unrecognized command.\n", cmd); + } + if (do_move || do_resize) { + if (w >= disp_x) { + w = disp_x - 4; + } + if (h >= disp_y) { + h = disp_y - 4; + } + if (w < 1) { + w = 1; + } + if (h < 1) { + h = 1; + } + if (x + w > disp_x) { + x = disp_x - w - 1; + } + if (y + h > disp_y) { + y = disp_y - h - 1; + } + if (x < 0) { + x = 1; + } + if (y < 0) { + y = 1; + } + rc = 0; + rc += XMoveWindow(dpy, win, x, y); + off_x = x; + off_y = y; + + rc += XResizeWindow(dpy, win, w, h); + + rfbLog("id_cmd:%s rc=%d dx=%d dy=%d dw=%d dh=%d %dx%d+%d+%d -> %dx%d+%d+%d\n", + cmd, rc, dx, dy, dw, dh, w0, h0, x0, y0, w, h, x, h); + } + XSync(dpy, False); + XSetErrorHandler(old_handler); + if (trapped_xerror) { + rfbLog("id_cmd:%s trapped_xerror.\n", cmd); + } + trapped_xerror = 0; + if (do_resize) { + rfbLog("id_cmd:%s calling check_xrandr_event.\n", cmd); + check_xrandr_event("id_cmd"); + } + X_UNLOCK; +#endif +} + diff --git a/x11vnc/win_utils.h b/x11vnc/win_utils.h index 8ef89a7..4a7c890 100644 --- a/x11vnc/win_utils.h +++ b/x11vnc/win_utils.h @@ -45,7 +45,7 @@ extern Window parent_window(Window win, char **name); extern int valid_window(Window win, XWindowAttributes *attr_ret, int bequiet); extern Bool xtranslate(Window src, Window dst, int src_x, int src_y, int *dst_x, int *dst_y, Window *child, int bequiet); -extern int get_window_size(Window win, int *x, int *y); +extern int get_window_size(Window win, int *w, int *h); extern void snapshot_stack_list(int free_only, double allowed_age); extern int get_boff(void); extern int get_bwin(void); @@ -54,5 +54,6 @@ extern Window query_pointer(Window start); extern unsigned int mask_state(void); extern int pick_windowid(unsigned long *num); extern Window descend_pointer(int depth, Window start, char *name_info, int len); +extern void id_cmd(char *cmd); #endif /* _X11VNC_WIN_UTILS_H */ diff --git a/x11vnc/x11vnc.1 b/x11vnc/x11vnc.1 index e7fc81b..f6ef2c8 100644 --- a/x11vnc/x11vnc.1 +++ b/x11vnc/x11vnc.1 @@ -1,8 +1,8 @@ .\" This file was automatically generated from x11vnc -help output. -.TH X11VNC "1" "November 2009" "x11vnc " "User Commands" +.TH X11VNC "1" "December 2009" "x11vnc " "User Commands" .SH NAME x11vnc - allow VNC connections to real X11 displays - version: 0.9.9, lastmod: 2009-11-18 + version: 0.9.9, lastmod: 2009-12-02 .SH SYNOPSIS .B x11vnc [OPTION]... @@ -158,6 +158,15 @@ shifts a root view to it: this shows SaveUnders menus, etc, although they will be clipped if they extend beyond the window. .PP +\fB-appshare\fR +.IP +Simple application sharing based on the \fB-id/-sid\fR +mechanism. Every new toplevel window that the +application creates induces a new viewer window via +a reverse connection. The \fB-id/-sid\fR and \fB-connect\fR +options are required. Run 'x11vnc \fB-appshare\fR \fB-help'\fR +for more info. +.PP \fB-clip\fR \fIWxH+X+Y\fR .IP Only show the sub-region of the full display that @@ -3110,7 +3119,7 @@ Instead of exiting after cleaning up, run a simple \fB-q,\fR \fB-quiet\fR .IP Be quiet by printing less informational output to -stderr. +stderr. (use \fB-noquiet\fR to undo an earlier \fB-quiet.)\fR .PP \fB-v,\fR \fB-verbose\fR .IP @@ -3611,7 +3620,7 @@ Client-side caching scheme. Framebuffer memory \fIn\fR (an integer) times that of the full display is allocated below the actual framebuffer to cache screen contents for rapid retrieval. So a W x H frambuffer is expanded -to a W x (n+1)*H one. Use 0 to disable. Default: XXX. +to a W x (n+1)*H one. Use 0 to disable. .IP The \fIn\fR is actually optional, the default is 10. .IP @@ -3619,13 +3628,17 @@ For this and the other \fB-ncache*\fR options below you can abbreviate "\fB-ncache\fR" with "\fB-nc\fR". Also, "\fB-nonc\fR" is the same as "\fB-ncache\fR \fI0\fR" .IP -This is an experimental option, currently implemented -in an awkward way in that in the VNC Viewer you can -see the cache contents if you scroll down, etc. So you +This is an experimental option, currently implemented in +an awkward way in that in the VNC Viewer you can see the +pixel cache contents if you scroll down, etc. So you will have to set things up so you can't see that region. If this method is successful, the changes required for clients to do this less awkwardly will be investigated. .IP +The SSVNC viewer does a good job at automatically hiding +the pixel cache region. Or use SSVNC's \fB-ycrop\fR option +to explicitly hide the region. +.IP Note that this mode consumes a huge amount of memory, both on the x11vnc server side and on the VNC Viewer side. If n=2 then the amount of RAM used is roughly @@ -4465,10 +4478,7 @@ In this mode new threads (one for input and one for output) are created to handle each new client. Default: \fB-nothreads.\fR .IP -NOTE: The \fB-threads\fR mode may be disabled due to its -unstable behavior. If it is disabled, a warning is -printed out. Stability has been improved in version -0.9.8 and so the feature has been re-enabled. +Thread stability is much improved in version 0.9.8. .IP Multiple clients in threaded mode should be stable for the ZRLE encoding on all platforms. The Tight and @@ -4476,9 +4486,14 @@ Zlib encodings are currently only stable on Linux for multiple clients. Compile with \fB-DTLS=__thread\fR if your OS and compiler and linker support it. .IP +For resizes (randr, etc.) set this env. var. to the number +of milliseconds to sleep: X11VNC_THREADS_NEW_FB_SLEEP +at various places in the do_new_fb() action. This is to +let various activities settle. Default is about 500ms. +.IP Multiple clients in threaded mode could yield better -performance for 'class-room' broadcasting usage. -See also the \fB-reflect\fR option. +performance for 'class-room' broadcasting usage; also in +\fB-appshare\fR broadcast mode. See also the \fB-reflect\fR option. .PP \fB-fs\fR \fIf\fR .IP @@ -5252,6 +5267,13 @@ or "root" to go back to root window .IP sid:windowid set \fB-sid\fR window to "windowid" .IP +id_cmd:cmd cmds: raise, lower, map, unmap, iconify, +move:dXdY, resize:dWdH, geom:WxH+X+Y. dX +dY, dW, and dH must have a leading "+" +or "-" e.g.: move:-30+10 resize:+20+35 +also: wm_delete, wm_name:string and +icon_name:string. Also id_cmd:win=N:cmd +.IP waitmapped wait until subwin is mapped. .IP nowaitmapped do not wait until subwin is mapped. @@ -6035,8 +6057,8 @@ query straight to the X11VNC_REMOTE property or connect file use "qry=..." instead of "cmd=..." .IP ans= stop quit exit shutdown ping resend_cutbuffer -resend_clipboard resend_primary blacken zero -refresh reset close disconnect id sid waitmapped +resend_clipboard resend_primary blacken zero refresh +reset close disconnect id_cmd id sid waitmapped nowaitmapped clip flashcmap noflashcmap shiftcmap truecolor notruecolor overlay nooverlay overlay_cursor overlay_yescursor nooverlay_nocursor nooverlay_cursor @@ -6185,6 +6207,10 @@ Any corresponding output text for that remote control command is sent back to all client as rfbCutText. The returned output is also prefixed with \fIstr\fR. Example: \fB-remote_prefix\fR DO_THIS: +.IP +Note that enabling \fB-remote_prefix\fR allows the remote +VNC viewers to run x11vnc \fB-remote\fR commands. Do not +use this option if they are not to be trusted. .PP \fB-noremote,\fR \fB-yesremote\fR .IP diff --git a/x11vnc/x11vnc.c b/x11vnc/x11vnc.c index 70cef69..e13e228 100644 --- a/x11vnc/x11vnc.c +++ b/x11vnc/x11vnc.c @@ -172,6 +172,7 @@ static void check_rcfile(int argc, char **argv); static void immediate_switch_user(int argc, char* argv[]); static void print_settings(int try_http, int bg, char *gui_str); static void check_loop_mode(int argc, char* argv[], int force); +static void check_appshare_mode(int argc, char* argv[]); static int tsdo_timeout_flag; @@ -1702,6 +1703,24 @@ static void check_loop_mode(int argc, char* argv[], int force) { #endif } } + +extern int appshare_main(int argc, char* argv[]); + +static void check_appshare_mode(int argc, char* argv[]) { + int i; + + for (i=1; i < argc; i++) { + char *p = argv[i]; + if (strstr(p, "--") == p) { + p++; + } + if (strstr(p, "-appshare") == p) { + appshare_main(argc, argv); + exit(0); + } + } +} + static void store_homedir_passwd(char *file) { char str1[32], str2[32], *p, *h, *f; struct stat sbuf; @@ -1992,21 +2011,32 @@ int main(int argc, char* argv[]) { char *got_rfbport_str = NULL; int got_rfbport_pos = -1; int got_tls = 0; + int got_inetd = 0; + int got_noxrandr = 0; /* used to pass args we do not know about to rfbGetScreen(): */ int argc_vnc_max = 1024; int argc_vnc = 1; char *argv_vnc[2048]; - /* check for -loop mode: */ check_loop_mode(argc, argv, 0); + /* check for -appshare mode: */ + check_appshare_mode(argc, argv); + dtime0(&x11vnc_start); + for (i=1; i < argc; i++) { + if (!strcmp(argv[i], "-inetd")) { + got_inetd = 1; + } + } if (!getuid() || !geteuid()) { started_as_root = 1; - rfbLog("getuid: %d geteuid: %d\n", getuid(), geteuid()); + if (0 && !got_inetd) { + rfbLog("getuid: %d geteuid: %d\n", getuid(), geteuid()); + } /* check for '-users =bob' */ immediate_switch_user(argc, argv); @@ -2363,6 +2393,14 @@ int main(int argc, char* argv[]) { ; /* handled above */ continue; } + if (strstr(arg, "-appshare") == arg) { + ; /* handled above */ + continue; + } + if (strstr(arg, "-freeze_when_obscured") == arg) { + freeze_when_obscured = 1; + continue; + } if (!strcmp(arg, "-timeout")) { CHECK_ARGC first_conn_timeout = atoi(argv[++i]); @@ -2955,6 +2993,7 @@ int main(int argc, char* argv[]) { if (!strcmp(arg, "-noxrandr")) { xrandr = 0; xrandr_maybe = 0; + got_noxrandr = 1; continue; } if (!strcmp(arg, "-rotate")) { @@ -3040,6 +3079,10 @@ int main(int argc, char* argv[]) { quiet = 1; continue; } + if (!strcmp(arg, "-noquiet")) { + quiet = 0; + continue; + } if (!strcmp(arg, "-v") || !strcmp(arg, "-verbose")) { verbose = 1; continue; @@ -3049,7 +3092,9 @@ int main(int argc, char* argv[]) { bg = 1; opts_bg = bg; #else - fprintf(stderr, "warning: -bg mode not supported.\n"); + if (!got_inetd) { + fprintf(stderr, "warning: -bg mode not supported.\n"); + } #endif continue; } @@ -3446,8 +3491,10 @@ int main(int argc, char* argv[]) { *p = '\0'; } if (atoi(s) < 1 || atoi(s) > pointer_mode_max) { - rfbLog("pointer_mode out of range 1-%d: %d\n", - pointer_mode_max, atoi(s)); + if (!got_inetd) { + rfbLog("pointer_mode out of range 1-%d: %d\n", + pointer_mode_max, atoi(s)); + } } else { pointer_mode = atoi(s); got_pointer_mode = pointer_mode; @@ -3591,7 +3638,9 @@ int main(int argc, char* argv[]) { if (!strcmp(arg, "-chatwindow")) { chat_window = 1; if (argc_vnc + 1 < argc_vnc_max) { - rfbLog("setting '-rfbversion 3.6' for -chatwindow.\n"); + if (!got_inetd) { + rfbLog("setting '-rfbversion 3.6' for -chatwindow.\n"); + } argv_vnc[argc_vnc++] = strdup("-rfbversion"); argv_vnc[argc_vnc++] = strdup("3.6"); } @@ -3645,14 +3694,16 @@ int main(int argc, char* argv[]) { /* we re-enable it due to threaded mode bugfixes. */ use_threads = 1; } else { - rfbLog("\n"); - rfbLog("The -threads mode is unstable and not tested or maintained.\n"); - rfbLog("It is disabled in the source code. If you really need\n"); - rfbLog("the feature you can reenable it at build time by setting\n"); - rfbLog("-DX11VNC_THREADED in CPPFLAGS. Or set X11VNC_THREADED=1\n"); - rfbLog("in your runtime environment.\n"); - rfbLog("\n"); - usleep(500*1000); + if (!got_inetd) { + rfbLog("\n"); + rfbLog("The -threads mode is unstable and not tested or maintained.\n"); + rfbLog("It is disabled in the source code. If you really need\n"); + rfbLog("the feature you can reenable it at build time by setting\n"); + rfbLog("-DX11VNC_THREADED in CPPFLAGS. Or set X11VNC_THREADED=1\n"); + rfbLog("in your runtime environment.\n"); + rfbLog("\n"); + usleep(500*1000); + } } #endif continue; @@ -3931,9 +3982,11 @@ int main(int argc, char* argv[]) { if (!strcasecmp(argv[i+1], "prompt")) { ; } else if (!is_decimal(argv[i+1])) { - rfbLog("Invalid -rfbport value: '%s'\n", argv[i+1]); - rfbLog("setting it to '-1' to induce failure.\n"); - argv[i+1] = strdup("-1"); + if (!got_inetd) { + rfbLog("Invalid -rfbport value: '%s'\n", argv[i+1]); + rfbLog("setting it to '-1' to induce failure.\n"); + argv[i+1] = strdup("-1"); + } } got_rfbport_str = strdup(argv[i+1]); got_rfbport_pos = argc_vnc+1; @@ -4032,7 +4085,9 @@ int main(int argc, char* argv[]) { client_connect_file = str; } if (client_connect_file) { - rfbLog("MacOS X: set -connect file to %s\n", client_connect_file); + if (!got_inetd) { + rfbLog("MacOS X: set -connect file to %s\n", client_connect_file); + } } } } @@ -4053,7 +4108,9 @@ int main(int argc, char* argv[]) { rfbLog("Port prompt indicated cancel.\n"); clean_up_exit(1); } - rfbLog("Port prompt selected: %d\n", got_rfbport_val); + if (!got_inetd) { + rfbLog("Port prompt selected: %d\n", got_rfbport_val); + } sprintf(tport, "%d", got_rfbport_val); argv_vnc[got_rfbport_pos] = strdup(tport); free(opts); @@ -4117,8 +4174,9 @@ int main(int argc, char* argv[]) { q = t + strlen(pstr); } logfile = new; - if (!quiet) { + if (!quiet && !got_inetd) { rfbLog("Expanded logfile to '%s'\n", new); + } free(s); } @@ -4152,7 +4210,7 @@ int main(int argc, char* argv[]) { q = t + strlen(pstr); } logfile = new; - if (!quiet) { + if (!quiet && !got_inetd) { rfbLog("Expanded logfile to '%s'\n", new); } free(s); @@ -4389,7 +4447,7 @@ int main(int argc, char* argv[]) { if (1) { /* mix things up a little bit */ unsigned char buf[CHALLENGESIZE]; - int k, kmax = (int) (500 * rfac()) + 100; + int k, kmax = (int) (50 * rfac()) + 10; for (k=0; k < kmax; k++) { rfbRandomBytes(buf); } @@ -4550,6 +4608,13 @@ int main(int argc, char* argv[]) { exit(1); } + if (use_threads && !got_noxrandr) { + xrandr = 1; + if (! quiet) { + rfbLog("enabling -xrandr in -threads mode.\n"); + } + } + /* fixup settings that do not make sense */ if (use_threads && nofb && cursor_pos_updates) { @@ -4626,6 +4691,7 @@ int main(int argc, char* argv[]) { /* increase rfbwait if threaded */ if (use_threads && ! got_rfbwait) { + /* ??? lower this ??? */ rfbMaxClientWait = 604800000; } @@ -4712,6 +4778,8 @@ int main(int argc, char* argv[]) { X_INIT; SCR_INIT; CLIENT_INIT; + INPUT_INIT; + POINTER_INIT; /* open the X display: */ @@ -5331,9 +5399,7 @@ int main(int argc, char* argv[]) { } #endif - if (!getenv("X11VNC_NO_CHECK_PM")) { - check_pm(); - } + check_pm(); if (! quiet && ! raw_fb_str) { rfbLog("--------------------------------------------------------\n"); @@ -5644,4 +5710,3 @@ int main(int argc, char* argv[]) { } - diff --git a/x11vnc/x11vnc_defs.c b/x11vnc/x11vnc_defs.c index ea3d904..5cafc49 100644 --- a/x11vnc/x11vnc_defs.c +++ b/x11vnc/x11vnc_defs.c @@ -47,7 +47,7 @@ int xtrap_base_event_type = 0; int xdamage_base_event_type = 0; /* date +'lastmod: %Y-%m-%d' */ -char lastmod[] = "0.9.9 lastmod: 2009-11-18"; +char lastmod[] = "0.9.9 lastmod: 2009-12-02"; /* X display info */ diff --git a/x11vnc/xevents.c b/x11vnc/xevents.c index d7ce8fe..37e0104 100644 --- a/x11vnc/xevents.c +++ b/x11vnc/xevents.c @@ -340,6 +340,10 @@ static void initialize_xevents(int reset) { X_LOCK; xselectinput_rootwin |= PropertyChangeMask; XSelectInput_wr(dpy, rootwin, xselectinput_rootwin); + + if (subwin && freeze_when_obscured) { + XSelectInput_wr(dpy, subwin, VisibilityChangeMask); + } X_UNLOCK; did_xselect_input = 1; } @@ -1284,6 +1288,22 @@ void check_xevents(int reset) { last_call = now; } + if (freeze_when_obscured) { + if (XCheckTypedEvent(dpy, VisibilityNotify, &xev)) { + if (xev.type == VisibilityNotify && xev.xany.window == subwin) { + int prev = subwin_obscured; + if (xev.xvisibility.state == VisibilityUnobscured) { + subwin_obscured = 0; + } else if (xev.xvisibility.state == VisibilityPartiallyObscured) { + subwin_obscured = 1; + } else { + subwin_obscured = 2; + } + rfbLog("subwin_obscured: %d -> %d\n", prev, subwin_obscured); + } + } + } + /* check for CUT_BUFFER0, VNC_CONNECT, X11VNC_REMOTE changes: */ if (XCheckTypedEvent(dpy, PropertyNotify, &xev)) { int got_cutbuffer = 0; @@ -1622,6 +1642,10 @@ extern int rawfb_vnc_reflect; void xcut_receive(char *text, int len, rfbClientPtr cl) { allowed_input_t input; + if (threads_drop_input) { + return; + } + if (unixpw_in_progress) { rfbLog("xcut_receive: unixpw_in_progress, skipping.\n"); return; @@ -1640,6 +1664,7 @@ void xcut_receive(char *text, int len, rfbClientPtr cl) { if (!input.clipboard) { return; } + INPUT_LOCK; if (remote_prefix != NULL && strstr(text, remote_prefix) == text) { char *result, *rcmd = text + strlen(remote_prefix); @@ -1649,9 +1674,29 @@ void xcut_receive(char *text, int len, rfbClientPtr cl) { strcat(tmp, "qry="); } strncat(tmp, rcmd, len - strlen(remote_prefix)); - rfbLog("remote_prefix command: '%s'\n", tmp); + if (use_threads) { + if (client_connect_file) { + FILE *f = fopen(client_connect_file, "w"); + if (f) { + fprintf(f, "%s\n", tmp); + fclose(f); + free(tmp); + INPUT_UNLOCK; + return; + } + } + if (vnc_connect) { + sprintf(x11vnc_remote_str, "%s", tmp); + free(tmp); + INPUT_UNLOCK; + return; + } + } + INPUT_UNLOCK; + + result = process_remote_cmd(tmp, 1); if (result == NULL ) { result = strdup("null"); @@ -1675,24 +1720,28 @@ void xcut_receive(char *text, int len, rfbClientPtr cl) { } if (! check_sel_direction("recv", "xcut_receive", text, len)) { + INPUT_UNLOCK; return; } #ifdef MACOSX if (macosx_console) { macosx_set_sel(text, len); + INPUT_UNLOCK; return; } #endif if (rawfb_vnc_reflect) { vnc_reflect_send_cuttext(text, len); + INPUT_UNLOCK; return; } RAWFB_RET_VOID #if NO_X11 + INPUT_UNLOCK; return; #else @@ -1751,6 +1800,7 @@ void xcut_receive(char *text, int len, rfbClientPtr cl) { XFlush_wr(dpy); X_UNLOCK; + INPUT_UNLOCK; set_cutbuffer = 1; #endif /* NO_X11 */ @@ -1956,6 +2006,7 @@ static void try_local_chat_window(void) { return; } + /* mutex */ new_save = screen->newClientHook; screen->newClientHook = new_client_chat_helper; diff --git a/x11vnc/xinerama.c b/x11vnc/xinerama.c index 9e123f9..8a1c0b5 100644 --- a/x11vnc/xinerama.c +++ b/x11vnc/xinerama.c @@ -344,12 +344,14 @@ static void initialize_xinerama (void) { RAWFB_RET_VOID + X_LOCK; if (! XineramaQueryExtension(dpy, &ev, &er)) { if (verbose) { rfbLog("Xinerama: disabling: display does not support it.\n"); } xinerama = 0; xinerama_present = 0; + X_UNLOCK; return; } if (! XineramaIsActive(dpy)) { @@ -359,6 +361,7 @@ static void initialize_xinerama (void) { } xinerama = 0; xinerama_present = 0; + X_UNLOCK; return; } xinerama_present = 1; @@ -385,6 +388,7 @@ static void initialize_xinerama (void) { rfbLog("\n"); } XFree_wr(xineramas); + X_UNLOCK; return; /* must be OK w/o change */ } @@ -406,6 +410,7 @@ static void initialize_xinerama (void) { sc++; } XFree_wr(xineramas); + X_UNLOCK; if (sraRgnEmpty(black_region)) { diff --git a/x11vnc/xrandr.c b/x11vnc/xrandr.c index 90b9ac4..1e4c3f5 100644 --- a/x11vnc/xrandr.c +++ b/x11vnc/xrandr.c @@ -143,6 +143,8 @@ static void handle_xrandr_change(int new_x, int new_y) { RAWFB_RET_VOID + /* assumes no X_LOCK */ + /* sanity check xrandr_mode */ if (! xrandr_mode) { xrandr_mode = strdup("default"); @@ -184,6 +186,8 @@ int check_xrandr_event(char *msg) { RAWFB_RET(0) + /* it is assumed that X_LOCK is on at this point. */ + if (subwin) { return handle_subwin_resize(msg); } @@ -235,8 +239,13 @@ int check_xrandr_event(char *msg) { if (wdpy_x == rev->width && wdpy_y == rev->height && xrandr_rotation == (int) rev->rotation) { - rfbLog("check_xrandr_event: no change detected.\n"); + rfbLog("check_xrandr_event: no change detected.\n"); do_change = 0; + if (! xrandr) { + rfbLog("check_xrandr_event: " + "enabling full XRANDR trapping anyway.\n"); + xrandr = 1; + } } else { do_change = 1; if (! xrandr) { @@ -256,6 +265,7 @@ int check_xrandr_event(char *msg) { XRRUpdateConfiguration(&xev); if (do_change) { + /* under do_change caller normally returns before its X_UNLOCK */ X_UNLOCK; handle_xrandr_change(rev->width, rev->height); } -- cgit v1.2.1