diff options
| author | runge <runge> | 2005-07-13 01:23:57 +0000 |
|---|---|---|
| committer | runge <runge> | 2005-07-13 01:23:57 +0000 |
| commit | ec45cd952ba011036a0e5cc3b4c3cf10386cd12d (patch) | |
| tree | 61300efac6d0712e0e37a22e805938f1e1a4b8e5 | |
| parent | 640eb162396cfc1fc308973eca331b2694b51849 (diff) | |
| download | libvncserver-ec45cd952ba011036a0e5cc3b4c3cf10386cd12d.zip libvncserver-ec45cd952ba011036a0e5cc3b4c3cf10386cd12d.tar.gz | |
x11vnc: tweaks for release, fix queue buildup under -viewonly.
| -rw-r--r-- | ChangeLog | 5 | ||||
| -rw-r--r-- | x11vnc/ChangeLog | 4 | ||||
| -rw-r--r-- | x11vnc/README | 1914 | ||||
| -rwxr-xr-x | x11vnc/tkx11vnc | 288 | ||||
| -rw-r--r-- | x11vnc/tkx11vnc.h | 288 | ||||
| -rw-r--r-- | x11vnc/x11vnc.1 | 6 | ||||
| -rw-r--r-- | x11vnc/x11vnc.c | 119 |
7 files changed, 1573 insertions, 1051 deletions
@@ -1,4 +1,7 @@ -2005-07-09 Karl Runge <runge@karlrunge.com> +2005-07-12 Karl Runge <runge@karlrunge.com> + * x11vnc: tweaks for release, fix queue buildup under -viewonly + +2005-07-10 Karl Runge <runge@karlrunge.com> * x11vnc: -grab_buster for breaking XGrabServer deadlock, fix scrolls and copyrect for -clip and -id cases. diff --git a/x11vnc/ChangeLog b/x11vnc/ChangeLog index ef3247a..b3143b6 100644 --- a/x11vnc/ChangeLog +++ b/x11vnc/ChangeLog @@ -1,4 +1,8 @@ 2005-07-10 Karl Runge <runge@karlrunge.com> + * gui: remove nevershared etc., parse cmd line, bug fixes. + * x11vnc: fix pointer queue buildup under -viewonly. + +2005-07-10 Karl Runge <runge@karlrunge.com> * more improvements to gui, default values, save-settings.. * x11vnc scary password warnings. Release settings. -QD option. add \# to rc files and fix rcfile read bug. diff --git a/x11vnc/README b/x11vnc/README index f6db49e..fb64e9d 100644 --- a/x11vnc/README +++ b/x11vnc/README @@ -1,5 +1,5 @@ -x11vnc README file Date: Sun Jul 10 23:27:39 EDT 2005 +x11vnc README file Date: Tue Jul 12 22:15:57 EDT 2005 The following information is taken from these URLs: @@ -577,7 +577,7 @@ make I'd like to release version 0.7.2 in Jun-Jul/2005 sometime, here is the current tarball: - RC-7 lastmod: 2005-07-10 [51]x11vnc-0.7.2beta.tar.gz + RC-7 lastmod: 2005-07-11 [51]x11vnc-0.7.2beta.tar.gz There are also some Linux, Solaris, and other OS test binaries [52]here. Please kick the tires and report bugs, performance @@ -847,257 +847,263 @@ make [87]Q-8: I don't like typing arcane command line options every time I start x11vnc. What can I do? Is there a config file? Or a GUI? - [88]Q-9: Can I make x11vnc more quiet and also go into the background + [88]Q-9: How can I get the GUI to run in the System Tray, or at least + be a smaller, simpler icon? + + [89]Q-10: Can I make x11vnc more quiet and also go into the background after starting up? - [89]Q-10: Sometimes when a VNC viewer dies abruptly, x11vnc also dies + [90]Q-11: Sometimes when a VNC viewer dies abruptly, x11vnc also dies with the error message like: "Broken pipe". I'm using the -forever mode and I want x11vnc to keep running. - [90]Q-11: Are there any build-time customizations possible, e.g. + [91]Q-12: Are there any build-time customizations possible, e.g. change defaults, create a smaller binary, etc? [Win2VNC Related] - [91]Q-12: I have two separate machine displays in front of me, one + [92]Q-13: I have two separate machine displays in front of me, one Windows the other X11: can I use x11vnc in combination with Win2VNC in dual-screen mode to pass the keystrokes and mouse motions to the X11 display? - [92]Q-13: I am running Win2VNC on my Windows machine and "x11vnc + [93]Q-14: I am running Win2VNC on my Windows machine and "x11vnc -nofb" on Unix to pass keyboard and mouse to the Unix monitor. Whenever I start Win2VNC it quickly disconnects and x11vnc says: rfbProcessClientNormalMessage: read: Connection reset by peer [Color Issues] - [93]Q-14: The X display I run x11vnc on is only 8 bits per pixel (bpp) + [94]Q-15: The X display I run x11vnc on is only 8 bits per pixel (bpp) PseudoColor (i.e. only 256 distinct colors). The x11vnc colors may start out OK, but after a while they are incorrect in certain windows. - [94]Q-15: Color problems: Why are the colors for some windows + [95]Q-16: Color problems: Why are the colors for some windows incorrect in x11vnc? BTW, my X display has nice overlay/multi-depth visuals of different color depths: e.g. there are both depth 8 and 24 visuals available at the same time. - [95]Q-16: How do I figure out the window id to supply to the -id + [96]Q-17: How do I figure out the window id to supply to the -id windowid option? - [96]Q-17: Why don't menus or other transient windows come up when I am + [97]Q-18: Why don't menus or other transient windows come up when I am using the -id windowid option to view a single application window? - [97]Q-18: My X display is depth 24 at 24bpp (instead of the normal + [98]Q-19: My X display is depth 24 at 24bpp (instead of the normal depth 24 at 32bpp). I'm having lots of color and visual problems with x11vnc and/or vncviewer. What's up? [Xterminals] - [98]Q-19: Can I use x11vnc to view and interact with an Xterminal + [99]Q-20: Can I use x11vnc to view and interact with an Xterminal (e.g. NCD) that is not running UNIX and so x11vnc cannot be run on it directly? - [99]Q-20: How do I get my X permissions (MIT-MAGIC-COOKIE) correct for - a Unix/Linux machine acting as an Xterminal? + [100]Q-21: How do I get my X permissions (MIT-MAGIC-COOKIE file) + correct for a Unix/Linux machine acting as an Xterminal? [Remote Control] - [100]Q-21: How do I stop x11vnc once it is running in the background? + [101]Q-22: How do I stop x11vnc once it is running in the background? - [101]Q-22: Can I change settings in x11vnc without having to restart + [102]Q-23: Can I change settings in x11vnc without having to restart it? Can I remote control it? [Security and Permissions] - [102]Q-23: How do I create a VNC password for use with x11vnc? + [103]Q-24: How do I create a VNC password for use with x11vnc? - [103]Q-24: Can I have two passwords for VNC viewers, one for full + [104]Q-25: Can I have two passwords for VNC viewers, one for full access and the other for view-only access to the display? - [104]Q-25: Can I fine tune what types of user input are allowed? E.g. + [105]Q-26: Can I fine tune what types of user input are allowed? E.g. have some users just be able to move the mouse, but not click or type anything? - [105]Q-26: Why does x11vnc exit as soon as the VNC viewer disconnects? + [106]Q-27: Why does x11vnc exit as soon as the VNC viewer disconnects? And why doesn't it allow more than one VNC viewer to connect at the same time? - [106]Q-27: Can I limit which machines incoming VNC clients can connect + [107]Q-28: Can I limit which machines incoming VNC clients can connect from? - [107]Q-28: How do I build x11vnc/libvncserver with libwrap + [108]Q-29: How do I build x11vnc/libvncserver with libwrap (tcp_wrappers) support? - [108]Q-29: Can I have x11vnc only listen on one network interface + [109]Q-30: Can I have x11vnc only listen on one network interface (e.g. internal LAN) rather than having it listen on all network interfaces and relying on -allow to filter unwanted connections out? - [109]Q-30: Now that -localhost implies listening only on the loopback + [110]Q-31: Now that -localhost implies listening only on the loopback interface, how I can occasionally allow in a non-localhost via the -R allowonce remote control command? - [110]Q-31: How can I tunnel my connection to x11vnc via an encrypted + [111]Q-32: How can I tunnel my connection to x11vnc via an encrypted SSH channel between two Unix machines? - [111]Q-32: How can I tunnel my connection to x11vnc via an encrypted + [112]Q-33: How can I tunnel my connection to x11vnc via an encrypted SSH channel from Windows using an SSH client like Putty? - [112]Q-33: Can I prompt the user at the local X display whether the + [113]Q-34: Can I prompt the user at the local X display whether the incoming VNC client should be accepted or not? Can I decide to make some clients view-only? How about running an arbitrary program to make the decisions? - [113]Q-34: Does x11vnc support Unix usernames and passwords? Can I + [114]Q-35: Does x11vnc support Unix usernames and passwords? Can I further limit the set of Unix usernames who can connect to the VNC desktop? - [114]Q-35: I start x11vnc as root because it is launched via inetd(1) + [115]Q-36: I start x11vnc as root because it is launched via inetd(1) or a display manager like gdm(1). Can I have x11vnc later switch to a different user? - [115]Q-36: I use a screen-lock when I leave my workstation (e.g. + [116]Q-37: I use a screen-lock when I leave my workstation (e.g. xscreensaver or xlock). When I remotely access my workstation desktop via x11vnc I can unlock the desktop fine, but I am worried people will see my activities on the physical monitor. What can I do to prevent this, or at least make it more difficult? - [116]Q-37: Can I have x11vnc automatically lock the screen when I + [117]Q-38: Can I have x11vnc automatically lock the screen when I disconnect the VNC viewer? [Display Managers and Services] - [117]Q-38: How can I run x11vnc as a "service" that is always + [118]Q-39: How can I run x11vnc as a "service" that is always available? - [118]Q-39: How can I use x11vnc to connect to an X login screen like + [119]Q-40: How can I use x11vnc to connect to an X login screen like xdm, GNOME gdm, KDE kdm, or CDE dtlogin? (i.e. nobody is logged into an X session yet). - [119]Q-40: Can I run x11vnc out of inetd(1)? How about xinetd(1)? + [120]Q-41: Can I run x11vnc out of inetd(1)? How about xinetd(1)? - [120]Q-41: How do I make x11vnc work with the Java VNC viewer applet + [121]Q-42: How do I make x11vnc work with the Java VNC viewer applet in a web browser? - [121]Q-42: Are reverse connections (i.e. the VNC server connecting to + [122]Q-43: Are reverse connections (i.e. the VNC server connecting to the VNC viewer) using "vncviewer -listen" and vncconnect(1) supported? - [122]Q-43: Can I use x11vnc as a replacement for Xvnc? (i.e. not for a + [123]Q-44: Can I use x11vnc as a replacement for Xvnc? (i.e. not for a real display, but for a virtual one I keep around). - [123]Q-44: How can I use x11vnc on "headless" machines? Why might I + [124]Q-45: How can I use x11vnc on "headless" machines? Why might I want to? [Resource Usage and Performance] - [124]Q-45: I have lots of memory, but why does x11vnc fail with + [125]Q-46: I have lots of memory, but why does x11vnc fail with shmget: No space left on device or Minor opcode of failed request: 1 (X_ShmAttach)? - [125]Q-46: How can I make x11vnc use less system resources? + [126]Q-47: How can I make x11vnc use less system resources? - [126]Q-47: How can I make x11vnc use MORE system resources? + [127]Q-48: How can I make x11vnc use MORE system resources? - [127]Q-48: I use x11vnc over a slow link with high latency (e.g. + [128]Q-49: I use x11vnc over a slow link with high latency (e.g. dialup modem), is there anything I can do to speed things up? - [128]Q-49: Does x11vnc support the X DAMAGE Xserver extension to find + [129]Q-50: Does x11vnc support the X DAMAGE Xserver extension to find modified regions of the screen quickly and efficiently? - [129]Q-50: When I drag windows around with the mouse or scroll up and + [130]Q-51: 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? - [130]Q-51: Why not do something like wireframe animations to avoid the + [131]Q-52: Why not do something like wireframe animations to avoid the windows "lurching" when being moved or resized? - [131]Q-52: Can x11vnc try to apply heuristics to detect when an window + [132]Q-53: Can x11vnc try to apply heuristics to detect when an window is scrolling its contents and use the CopyRect encoding for a speedup? [Mouse Cursor Shapes] - [132]Q-53: Why isn't the mouse cursor shape (the little icon shape + [133]Q-54: Why isn't the mouse cursor shape (the little icon shape where the mouse pointer is) correct as I move from window to window? - [133]Q-54: When using XFIXES cursorshape mode, some of the cursors + [134]Q-55: When using XFIXES cursorshape mode, some of the cursors look really bad with extra black borders around the cursor and other cruft. How can I improve their appearance? - [134]Q-55: In XFIXES mode, are there any hacks to handle cursor + [135]Q-56: In XFIXES mode, are there any hacks to handle cursor transparency ("alpha channel") exactly? [Mouse Pointer] - [135]Q-56: Why does the mouse arrow just stay in one corner in my + [136]Q-57: Why does the mouse arrow just stay in one corner in my vncviewer, whereas my cursor (that does move) is just a dot? - [136]Q-57: Can I take advantage of the TightVNC extension to the VNC + [137]Q-58: Can I take advantage of the TightVNC extension to the VNC protocol where Cursor Positions Updates are sent back to all connected clients (i.e. passive viewers can see the mouse cursor being moved around by another viewer)? - [137]Q-58: Is it possible to swap the mouse buttons (e.g. left-handed + [138]Q-59: 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? [Keyboard Issues] - [138]Q-59: How can I get my AltGr and Shift modifiers to work between + [139]Q-60: How can I get my AltGr and Shift modifiers to work between keyboards for different languages? - [139]Q-60: When I try to type a "<" (i.e. less than) instead I get ">" + [140]Q-61: When I try to type a "<" (i.e. less than) instead I get ">" (i.e. greater than)! Strangely, typing ">" works OK!! - [140]Q-61: I'm using an "international" keyboard (e.g. German "de", or + [141]Q-62: When I try to type a "<" (i.e. less than) instead I get + "<," (i.e. an extra comma). + + [142]Q-63: I'm using an "international" keyboard (e.g. German "de", or Danish "dk") and the -modtweak mode works well if the VNC viewer is run on a Unix/Linux machine with a similar keyboard. But if I run the VNC viewer on Unix/Linux with a different keyboard (e.g. "us") or Windows with any keyboard, I can't type some keys like: "@", "$", "<", ">", etc. How can I fix this? - [141]Q-62: When typing I sometimes get double, triple, or more of my + [143]Q-64: When typing I sometimes get double, triple, or more of my keystrokes repeated. I'm sure I only typed them once, what can I do? - [142]Q-63: The x11vnc -norepeat mode is in effect, but I still get + [144]Q-65: The x11vnc -norepeat mode is in effect, but I still get repeated keystrokes!! - [143]Q-64: The machine where I run x11vnc has an AltGr key, but the + [145]Q-66: 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? - [144]Q-65: I have a Sun machine I run x11vnc on. Its Sun keyboard has + [146]Q-67: I have a Sun machine I run x11vnc on. Its Sun keyboard has just one Alt key labelled "Alt" and two Meta keys labelled with little diamonds. The machine where I run the VNC viewer only has Alt keys. How can I send a Meta keypress? (e.g. emacs needs this) - [145]Q-66: Can I map a keystroke to a mouse button click on the remote + [147]Q-68: Can I map a keystroke to a mouse button click on the remote machine? [Screen Related Issues and Features] - [146]Q-67: The remote display is larger (in number of pixels) than the + [148]Q-69: The remote display is larger (in number of pixels) than the local display I am running the vncviewer on. I don't like the vncviewer scrollbars, what I can do? - [147]Q-68: Does x11vnc support server-side framebuffer scaling? (E.g. + [149]Q-70: Does x11vnc support server-side framebuffer scaling? (E.g. to make the desktop smaller). - [148]Q-69: Does x11vnc work with Xinerama? (i.e. multiple monitors + [150]Q-71: Does x11vnc work with Xinerama? (i.e. multiple monitors joined together to form one big, single screen). - [149]Q-70: Can I use x11vnc on a multi-headed display that is not + [151]Q-72: Can I use x11vnc on a multi-headed display that is not Xinerama (i.e. separate screens :0.0, :0.1, ... for each monitor)? - [150]Q-71: Can x11vnc show only a portion of the display? (E.g. for a + [152]Q-73: Can x11vnc show only a portion of the display? (E.g. for a special purpose rfb application). - [151]Q-72: Does x11vnc support the XRANDR (X Resize, Rotate and + [153]Q-74: Does x11vnc support the XRANDR (X Resize, Rotate and Reflection) extension? Whenever I rotate or resize the screen x11vnc just seems to crash. - [152]Q-73: Why is the view in my VNC viewer completely black? Or why + [154]Q-75: Why is the view in my VNC viewer completely black? Or why is everything flashing around randomly? - [153]Q-74: I use Linux Virtual Consoles (VC's) to implement 'Fast User + [155]Q-76: I use Linux Virtual Consoles (VC's) to implement 'Fast User Switching' between users' sessions (e.g. Betty is on Ctrl-Alt-F7, Bobby is on Ctrl-Alt-F8, and Sid is on Ctrl-Alt-F1: they use those keystrokes to switch between their sessions). How come the view in a @@ -1105,12 +1111,12 @@ make otherwise all messed up unless the X session x11vnc is attached to is in the active VC? - [154]Q-75: Can I use x11vnc to view my VMWare session remotely? + [156]Q-77: Can I use x11vnc to view my VMWare session remotely? - [155]Q-76: Can non-X devices (e.g. a raw framebuffer) be viewed and/or + [157]Q-78: Can non-X devices (e.g. a raw framebuffer) be viewed and/or controlled by x11vnc? - [156]Q-77: I am using x11vnc where my local machine has "popup/hidden + [158]Q-79: I am using x11vnc where my local machine has "popup/hidden taskbars" (e.g. GNOME or MacOS X) and the remote display where x11vnc runs also has "popup/hidden taskbars" (e.g. GNOME). When I move the mouse to the edge of the screen where the popups happen, the taskbars @@ -1118,13 +1124,13 @@ make [Misc: Clipboard, Beeps, Thanks, etc.] - [157]Q-78: Does the Clipboard/Selection get transferred between the + [159]Q-80: Does the Clipboard/Selection get transferred between the vncviewer and the X display? - [158]Q-79: Why don't I hear the "Beeps" in my X session (e.g. when + [160]Q-81: Why don't I hear the "Beeps" in my X session (e.g. when typing tput bel in an xterm)? - [159]Q-80: Thanks for your program and for your help! Can I make a + [161]Q-82: Thanks for your program and for your help! Can I make a donation? _________________________________________________________________ @@ -1136,9 +1142,9 @@ make protocol specified" and then exits. What do I need to do? For the former error, you need to specify the X display to connect to - (it also needs to be on the same machine x11vnc is to run on). Set - your DISPLAY environment variable or use the [160]-display option to - specify it. Nearly always the correct value will be ":0" + (it also needs to be on the same machine the x11vnc process is to run + on). Set your DISPLAY environment variable or use the [162]-display + option to specify it. Nearly always the correct value will be ":0" For the latter error, you need to set up the X11 permissions @@ -1154,7 +1160,7 @@ make How to Solve: See the xauth(1), Xsecurity(7), and xhost(1) man pages for much info on X11 permissions. For example, you may need to set - your XAUTHORITY environment variable or use the [161]-auth option to + your XAUTHORITY environment variable or use the [163]-auth option to point to the correct MIT-MAGIC-COOKIE file (e.g. /home/joe/.Xauthority or /var/gdm/:0.Xauth), or simply be sure you run x11vnc as the correct user (i.e. the user who owns the X session you wish to view). @@ -1170,7 +1176,7 @@ make solution: x11vnc -display :0 -auth /var/gdm/:0.Xauth - (this is for the display manager gdm, see [162]this faq for other + (this is for the display manager gdm, see [164]this faq for other display manager cookie file names). Less safe, but to avoid figuring out where the XAUTHORITY file is, if @@ -1179,7 +1185,7 @@ make machine). The person could then type "xhost -localhost" after x11vnc has connected to go back to the default permissions. Also, for some situations the "-users lurk=" option may be of use (please read the - documentation on the [163]-users option). + documentation on the [165]-users option). To test out your X11 permissions from a remote shell, set DISPLAY and possibly XAUTHORITY (see your shell's man page, bash(1), tcsh(1), on @@ -1205,7 +1211,7 @@ make After running the libvncserver configure, carefully examine the output and the messages in the config.log file looking for missing - components. If the configure output looks like: + components. For example, if the configure output looks like: checking how to run the C preprocessor... gcc -E checking for X... no checking for XkbSelectEvents in -lX11... no @@ -1291,7 +1297,7 @@ h earlier and perhaps non-Solaris): First use the environment settings (CPPFLAGS, LDFLAGS, etc.) in the - above [164]Solaris build script to run the configure command. That + above [166]Solaris build script to run the configure command. That should succeed without failure. Then you have to hand edit the autogenerated rfb/rfbconfig.h file in the source tree, and just before the last #endif at the bottom of that file insert these workaround @@ -1317,7 +1323,7 @@ typedef unsigned int in_addr_t; on other older OS (Solaris, Linux, ...) releases. Here are some notes for similar steps that need to be done to build on - [165]SunOS 4.x + [167]SunOS 4.x Please let us know if you had to use the above workaround (and whether it worked or not). If there is enough demand we will try to push clean @@ -1327,37 +1333,23 @@ typedef unsigned int in_addr_t; Q-5: Where can I get a precompiled x11vnc binary for my Operating System? - Hopefully the [166]build steps above and [167]FAQ provide enough info + Hopefully the [168]build steps above and [169]FAQ provide enough info for a painless compile for most environments. Please report problems with the x11vnc configure, make, etc. on your system (if your system is known to compile other GNU packages successfully). There are precompiled x11vnc binaries built by other groups that are available at the following locations: - Debian: (.deb) [168]http://packages.debian.org/x11vnc - - Slackware: (.tgz) [169]http://www.linuxpackages.net/ Redhat/Fedora: - (.rpm) [170]http://dag.wieers.com/packages/x11vnc/ SuSE: (.rpm) - [171]http://linux01.gwdg.de/~pbleser/ Solaris: (pkg) - [172]http://www.sunfreeware.com/ wwexptools: (.tgz) - [173]http://www.bell-labs.com/project/wwexptools/packages.html The - last one, wwexptools, provides a variety of Unix binaries (Linux, - Solaris, HP-UX, IRIX, ...) with the intent of being compatible on a - wide range of OS releases. Find x11vnc near the bottom of that page - and select 'download info'. - - Note: it appears some of the wwexptools x11vnc binaries are not - compiled with libz and libjpeg and so the fast compression encodings: - "Tight", "ZRLE", etc are not supported by those binaries. You can see - this by looking at the x11vnc output and if it says the encoding for a - client is "hextile" then likely the fast compression encodings are - missing. If you want optimal performance on your OS, you should see - the [174]build notes above for where to download libz and libjpeg, and - then build everything with gcc. For Solaris, the - http://www.sunfreeware.com/ packages are built with libz and libjpeg. + Debian: (.deb) [170]http://packages.debian.org/x11vnc + + Slackware: (.tgz) [171]http://www.linuxpackages.net/ Redhat/Fedora: + (.rpm) [172]http://dag.wieers.com/packages/x11vnc/ SuSE: (.rpm) + [173]http://linux01.gwdg.de/~pbleser/ Solaris: (pkg) + [174]http://www.sunfreeware.com/ wwexptools: (.tgz) + [175]http://www.bell-labs.com/project/wwexptools/packages.html If the above binaries don't work and building x11vnc on your OS fails - (and all else fails!) you can try one of [175]my collection of + (and all else fails!) you can try one of [176]my collection of binaries for various OS's and x11vnc releases. As a general note, the x11vnc program is simple enough you don't @@ -1378,9 +1370,9 @@ typedef unsigned int in_addr_t; To obtain VNC viewers for the viewing side (Windows, Mac OS, or Unix) try here: - * [176]http://www.tightvnc.com/download.html - * [177]http://www.realvnc.com/download-free.html - * [178]http://sourceforge.net/projects/cotvnc/ + * [177]http://www.tightvnc.com/download.html + * [178]http://www.realvnc.com/download-free.html + * [179]http://sourceforge.net/projects/cotvnc/ Q-7: How can I see all of x11vnc's command line options and @@ -1388,7 +1380,7 @@ typedef unsigned int in_addr_t; Run: x11vnc -opts to list just the option names or run: x11vnc -help for long descriptions about each option. The output is listed - [179]here as well. + [180]here as well. Q-8: I don't like typing arcane command line options every time I @@ -1400,7 +1392,7 @@ typedef unsigned int in_addr_t; # filename: X11vnc (i.e. not "x11vnc") # It resides in a directory in $PATH. "chmod 755 X11vnc" has been run on it. # -x11vnc -nap -wait 50 -localhost -rfbauth $HOME/.vnc/passwd -display :0 $* +x11vnc -wait 50 -localhost -rfbauth $HOME/.vnc/passwd -display :0 $* a similar thing can be done via aliases in your shell (bash, tcsh, csh, etc..). @@ -1409,34 +1401,54 @@ x11vnc -nap -wait 50 -localhost -rfbauth $HOME/.vnc/passwd -display :0 $* $HOME/.x11vncrc config file support. If that file exists, each line is taken as a command line option. E.g. the above would be: # this is a comment in my ~/.x11vncrc file -nap wait 50 # this is a comment to the end of the line. -localhost # note: the leading "-" is optional. rfbauth /home/fred/.vnc/passwd display :0 - At some point this config file support will be expanded. - - As of Dec/2004 in the libvncserver CVS there is now a simple tcl/tk - GUI based on the remote-control functionality that was added. It's not + As of Dec/2004 in the libvncserver CVS there is now a simple Tcl/Tk + GUI based on the remote-control functionality ("-R") that was added. + The /usr/bin/wish program is needed for operation. The gui is not particularly user-friendly, it just provides a point and click mode to set all the many x11vnc parameters and obtain help on them. See the - [180]-gui option for more info. Examples: "x11vnc ... -gui" and + [181]-gui option for more info. Examples: "x11vnc ... -gui" and "x11vnc ... -gui other:0" in the latter case the gui is displayed on - other:0, not the X display x11vnc is polling. + other:0, not the X display x11vnc is polling. There is also a + "[182]-gui tray" system tray mode. - Q-9: Can I make x11vnc more quiet and also go into the background + Q-9: How can I get the GUI to run in the System Tray, or at least be a + smaller, simpler icon? + + As of Jul/2005 in the libvncserver CVS the gui can run in a more + friendly small icon mode "-gui icon" or in the system tray: "-gui + tray". It has balloon status, a simple menu, and a Properities dialog. + The full, complicated, gui is only available under "Advanced". Other + improvements were added as well. Try "Misc -> simple_gui" for a gui + with fewer esoteric menu items. + + If the gui fails to embed itself in the system tray, do a retry via + "Window View -> icon" followed by "Window View -> tray" with the popup + menu. + + For inexperienced users starting up x11vnc and the GUI while sitting + at the physical X display (not remotely), using something like "x11vnc + -display :0 -gui tray=setpass" might be something for them that they + are accustomed to in a Desktop environment (it prompts for an initial + password, etc). This is a basic "Share My Desktop" mode. + + + Q-10: Can I make x11vnc more quiet and also go into the background after starting up? - Use the [181]-q and [182]-bg options, respectively. (also: -quiet is + Use the [183]-q and [184]-bg options, respectively. (also: -quiet is an alias for -q) Note that under -bg the stderr messages will be lost unless you use - the "[183]-o logfile" option. + the "[185]-o logfile" option. - Q-10: Sometimes when a VNC viewer dies abruptly, x11vnc also dies with + Q-11: Sometimes when a VNC viewer dies abruptly, x11vnc also dies with the error message like: "Broken pipe". I'm using the -forever mode and I want x11vnc to keep running. @@ -1449,15 +1461,15 @@ display :0 since about Jun/2004. - Q-11: Are there any build-time customizations possible, e.g. change + Q-12: Are there any build-time customizations possible, e.g. change defaults, create a smaller binary, etc? As of Mar/2004 in the libvncserver cvs there are a few such options. They are enabled by adding something like -Dxxxx=1 to the CPPFLAGS - environment variable before running configure (see the [184]build + environment variable before running configure (see the [186]build notes for general background). - * -DX11VNC_SHARED=1 make -shared the default. - * -DX11VNC_FOREVER=1 make -forever the default. + * -DVNCSHARED=1 make -shared the default. + * -DFOREVER=1 make -forever the default. * -DREMOTE_CONTROL=0 disable the remote control mechanism. * -DSMALL_FOOTPRINT=1 strip out help text, gui, etc to make a smaller binary (e.g. for PDA or embedded system with low disk @@ -1465,7 +1477,7 @@ display :0 out even more. For example: - env CPPFLAGS="-DX11VNC_FOREVER=1" ./configure; make + env CPPFLAGS="-DFOREVER=1" ./configure; make If other things (e.g. "-I ...") are needed in CPPFLAGS add them as well. @@ -1480,47 +1492,41 @@ display :0 Let us know if more build-time customizations would be useful. Look near the top of the source file for any additional customization - macros. - - If the system does not have the XTEST XTestGrabControl interface (some - early X11R5 systems have XTEST but not this interface), then configure - will automatically try to see if the DEC-XTRAP extension build - environment is available and use that for avoiding GrabServer - deadlock. If you want DEC-XTRAP compiled in no matter what, set - X11VNC_USE_XTRAP=1 in your environment. Note that DEC-XTRAP should - only be used as a last resort on legacy machines since the standard - XTEST works well. If there is interest for legacy machines to use - DEC-XTRAP for all of the user input injection (not just grab control) - let us know and we will put it in for you to try. (Note: DEC-XTRAP - grab control seems to be broken on Linux/XFree86) + macros. Here is the current (Jul/2005) list: REMOTE_CONTROL, NOPW, + SMALL_FOOTPRINT, NOGUI, XDAMAGE, VNCSHARED, FOREVER, REMOTE_DEFAULT, + EXTERNAL_COMMANDS, VIEWONLY, WIREFRAME, WIREFRAME_PARMS, + WIREFRAME_COPYRECT, SCROLL_COPYRECT_PARMS, SCROLL_COPYRECT, + SCALING_COPYRECT, NOREPEAT, SKIPDUPS, ADDKEYSYMS, + POINTER_MODE_DEFAULT, DEBUG_XEVENTS, BOLDLY_CLOSE_DISPLAY + [Win2VNC Related] - Q-12: I have two separate machine displays in front of me, one Windows + Q-13: I have two separate machine displays in front of me, one Windows the other X11: can I use x11vnc in combination with Win2VNC in dual-screen mode to pass the keystrokes and mouse motions to the X11 display? - Yes, for best response start up x11vnc with the "[185]-nofb" option + Yes, for best response start up x11vnc with the "[187]-nofb" option (disables framebuffer polling, and does other optimizations) on the secondary display (X11) machine. Then start up Win2VNC on the primary display (Windows) referring it to the secondary display. - This will also work X11 to X11 using [186]x2vnc, however you would + This will also work X11 to X11 using [188]x2vnc, however you would probably just want to avoid VNC and use x2x for that. For reference, here are some links to Win2VNC-like programs for multiple monitor setups: - * [187]Original Win2VNC - * [188]Enhanced Win2VNC and [189]sourceforge link - * [190]x2vnc - * [191]x2x also [192]here - * [193]zvnc (MorphOS) + * [189]Original Win2VNC + * [190]Enhanced Win2VNC and [191]sourceforge link + * [192]x2vnc + * [193]x2x also [194]here + * [195]zvnc (MorphOS) All of them will work with x11vnc (except x2x where it is not needed). - Q-13: I am running Win2VNC on my Windows machine and "x11vnc -nofb" on + Q-14: I am running Win2VNC on my Windows machine and "x11vnc -nofb" on Unix to pass keyboard and mouse to the Unix monitor. Whenever I start Win2VNC it quickly disconnects and x11vnc says: rfbProcessClientNormalMessage: read: Connection reset by peer @@ -1535,7 +1541,7 @@ display :0 on your display to be depth 24 TrueColor? Sun machines often have 8+24 overlay/multi-depth visuals, and you can make the default visual depth 24 TrueColor (see fbconfig(1) and Xsun(1)). 2) As of Feb/2004, in the - libvncserver CVS, x11vnc has the [194]-visual option to allow you to + libvncserver CVS, x11vnc has the [196]-visual option to allow you to force the framebuffer visual to whatever you want (this usually messes up the colors unless you are very clever). In this case, the option provides a convenient workaround for the Win2VNC bug: @@ -1546,11 +1552,11 @@ display :0 no problems in doing this. [Color Issues] - Q-14: The X display I run x11vnc on is only 8 bits per pixel (bpp) + Q-15: The X display I run x11vnc on is only 8 bits per pixel (bpp) PseudoColor (i.e. only 256 distinct colors). The x11vnc colors may start out OK, but after a while they are incorrect in certain windows. - Use the [195]-flashcmap option to have x11vnc watch for changes in the + Use the [197]-flashcmap option to have x11vnc watch for changes in the colormap, and propagate those changes back to connected clients. This can be slow (since the whole screen must be updated over the network whenever the colormap changes). This flashing colormap behavior often @@ -1559,21 +1565,21 @@ display :0 example of this. Consider reconfiguring the system to 16 bpp or depth 24 TrueColor if at all possible. - Also note that in some rare cases the [196]-notruecolor option has + Also note that in some rare cases the [198]-notruecolor option has corrected colors on 8bpp displays. The red, green, and blue masks were non-zero in 8bpp PseudoColor on an obscure setup, and this option corrected the problems. - Q-15: Color problems: Why are the colors for some windows incorrect in + Q-16: Color problems: Why are the colors for some windows incorrect in x11vnc? BTW, my X display has nice overlay/multi-depth visuals of different color depths: e.g. there are both depth 8 and 24 visuals available at the same time. - You may want to review the [197]previous question regarding 8 bpp + You may want to review the [199]previous question regarding 8 bpp PseudoColor. - On some hardware (Sun/SPARC, Sgi), the [198]-overlay option discussed + On some hardware (Sun/SPARC, Sgi), the [200]-overlay option discussed a couple paragraphs down may solve this for you (you may want to skip to it directly). @@ -1611,7 +1617,7 @@ TrueColor defdepth 24 The -overlay mode: Another option is if the system with overlay visuals is a Sun system running Solaris or Sgi running IRIX you can - use the [199]-overlay x11vnc option (Aug/2004) to have x11vnc use the + use the [201]-overlay x11vnc option (Aug/2004) to have x11vnc use the Solaris XReadScreen(3X11) function to poll the "true view" of the whole screen at depth 24 TrueColor. XReadDisplay(3X11) is used on IRIX. This is useful for Legacy applications (older versions of @@ -1631,9 +1637,9 @@ TrueColor defdepth 24 Colors still not working correctly? Run xwininfo on the application - with the messed up colors to verify that the depth of its visual is + with the incorrect colors to verify that the depth of its visual is different from the default visual depth (gotten from xdpyinfo). One - possible workaround in this case is to use the [200]-id option to + possible workaround in this case is to use the [202]-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). @@ -1641,48 +1647,41 @@ TrueColor defdepth 24 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. Fortunately the - [201]-overlay option works for Solaris machines with overlay visuals + [203]-overlay option works for Solaris machines with overlay visuals where most of this problem occurs. - Q-16: How do I figure out the window id to supply to the -id windowid + Q-17: How do I figure out the window id to supply to the -id windowid option? Run the xwininfo program in a terminal. It will ask you to click on 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 [202]problems. + debugging x11vnc [204]color problems. - When using -id windowid, note that some VNC viewers will have problems - rendering screens that have a width that is not a multiple of 4. Try - to manually adjust the window width before starting x11vnc -id .... - - Also, as of Dec/2004 libvncserver CVS you can use "[203]-id pick" to + Also, as of Dec/2004 libvncserver CVS you can use "[205]-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. - Q-17: Why don't menus or other transient windows come up when I am + Q-18: Why don't menus or other transient windows come up when I am using the -id windowid option to view a single application window? This is related to the behavior of the XGetImage(3X11) and XShmGetImage() interfaces regarding backingstore, saveunders, etc. The way the image is retrieved depends on some aspects of how the X server maintains the display image data and whether other windows are - clipping or obscuring it. See the XGetImage man page for more details. - If you disable BackingStore and SaveUnders in the X server you should - be able to see these transient windows. + clipping or obscuring it. See the XGetImage(3X11) man page for more + details. If you disable BackingStore and SaveUnders in the X server + 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 [204]-sid windowid option ("shifted" windowid). - - x11vnc is known to crash under both -id and -sid, so both modes are - still experimental. Please report any reproducible bugs. + polling, try the [206]-sid windowid option ("shifted" windowid). - Q-18: My X display is depth 24 at 24bpp (instead of the normal depth + Q-19: My X display is depth 24 at 24bpp (instead of the normal depth 24 at 32bpp). I'm having lots of color and visual problems with x11vnc and/or vncviewer. What's up? @@ -1721,7 +1720,7 @@ TrueColor defdepth 24 24bpp for the vncviewers to work on that X display. [Xterminals] - Q-19: Can I use x11vnc to view and interact with an Xterminal (e.g. + Q-20: Can I use x11vnc to view and interact with an Xterminal (e.g. NCD) that is not running UNIX and so x11vnc cannot be run on it directly? @@ -1729,19 +1728,19 @@ 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 [205]-display option to point the display to that of + machine. Use the [207]-display option to point the display to that of the Xterminal (you'll of course need basic X11 permission to do that) - and also supply the [206]-noshm option (this enables the polling over + and also supply the [208]-noshm option (this enables the polling over the network). 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 [207]-flipbyteorder if the colors - get messed up due to endian byte order differences. + hard to get to X servers. Use something like "-wait 150" to cut down + on the polling rate. You may also need [209]-flipbyteorder if the + colors get messed up due to endian byte order differences. - Q-20: How do I get my X permissions (MIT-MAGIC-COOKIE) correct for a - Unix/Linux machine acting as an Xterminal? + Q-21: How do I get my X permissions (MIT-MAGIC-COOKIE file) correct + for a Unix/Linux machine acting as an Xterminal? If the X display machine is a traditional Xterminal (where the X server process runs on the Xterminal box, but all of the X client @@ -1761,7 +1760,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 - [208]-auth option to point to the correct file). Other options include + [210]-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 - @@ -1773,7 +1772,7 @@ TrueColor defdepth 24 details. If the display name in the cookie file needs to be changed between the - two hosts, see [209]this note on the "xauth add ..." command. + two hosts, see [211]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 @@ -1787,7 +1786,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 [210]poll + Not recommended, but as a last resort, you could have x11vnc [212]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...) @@ -1814,37 +1813,39 @@ TrueColor defdepth 24 [Remote Control] - Q-21: How do I stop x11vnc once it is running in the background? + Q-22: How do I stop x11vnc once it is running in the background? As of Dec/2004 in the libvncserver CVS there is a remote control feature. It can change a huge amount of things on the fly: see the - [211]-remote and [212]-query options. To shut down the running x11vnc + [213]-remote and [214]-query options. To shut down the running x11vnc server just type "x11vnc -R stop". To disconnect all clients do "x11vnc -R disconnect:all", etc. - For older versions: If the [213]-forever option has not been supplied, - x11vnc will automatically exit after the first client disconnects. In - general 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 the [215]-forever option has not been supplied, x11vnc will + automatically exit after the first client disconnects. In general 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 [214]-bg option + If you have not put x11vnc in the background via the [216]-bg option or shell & operator, then simply press Ctrl-C in the shell where - x11vnc is running to stop it. Potential Gotcha: If somehow your - Keypress of Ctrl-C went through x11vnc to the Xserver that then - delivered it to x11vnc it is possible one or both of the Ctrl or C - keys will be left stuck in the pressed 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 [215]-clear_mods option and [216]-clear_keys - option can be used to release pressed keys at startup and exit. - - - Q-22: Can I change settings in x11vnc without having to restart it? + x11vnc is running to stop it. + + Potential Gotcha: If somehow your Keypress of Ctrl-C went through + x11vnc to the Xserver that then delivered it to x11vnc it is possible + one or both of the Ctrl or C keys will be left stuck in the pressed + 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 [217]-clear_mods + option and [218]-clear_keys option can be used to release pressed keys + at startup and exit. + + + Q-23: Can I change settings in x11vnc without having to restart it? Can I remote control it? - Look at the [217]-remote (same as -R) and [218]-query (same as -Q) + Look at the [219]-remote (same as -R) and [220]-query (same as -Q) options added in the Dec/2004 libvncserver CVS. They allow nearly everything to be changed dynamically and settings to be queried. Examples: "x11vnc -R shared", "x11vnc -R forever", "x11vnc -R @@ -1855,12 +1856,15 @@ TrueColor defdepth 24 permissions and DISPLAY must be set up correctly for communication to be possible. - There is also a simple tcl/tk gui based on this remote control - mechanism. See the [219]-gui option for more info. + There is also a simple Tcl/Tk gui based on this remote control + mechanism. See the [221]-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 icon window: + "-gui icon". [Security and Permissions] - Q-23: How do I create a VNC password for use with x11vnc? + Q-24: How do I create a VNC password for use with x11vnc? You may already have one in $HOME/.vnc/passwd if you have used, say, the vncserver program from the regular RealVNC or TightVNC packages @@ -1868,12 +1872,12 @@ TrueColor defdepth 24 vncpasswd(1) program from those packages. The libvncserver package also comes with a simple program: storepasswd in the examples directory. And as of Jun/2004 in the libvncserver CVS x11vnc supports - the -storepasswd "pass" "file" [220]option, which is the the same + the -storepasswd "pass" "file" [222]option, which is the 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: [221]-rfbauth + You then use the password via the x11vnc option: [223]-rfbauth $HOME/myvncpasswd Compared to vncpasswd(1) the latter two methods are a somewhat unsafe @@ -1882,22 +1886,22 @@ TrueColor defdepth 24 out for the command winding up in your shell's history file (history -c is often a way to clear it). - x11vnc also has the [222]-passwdfile and -passwd/-viewpasswd plain + x11vnc also has the [224]-passwdfile and -passwd/-viewpasswd plain text (i.e. not obscured like the -rfbauth VNC passwords) password options. - Q-24: Can I have two passwords for VNC viewers, one for full access + Q-25: 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 in the libvncserver CVS there is the - [223]-viewpasswd option to supply the view-only password. Note the - full-access password option [224]-passwd must be supplied at the same + [225]-viewpasswd option to supply the view-only password. Note the + full-access password option [226]-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 - [225]-passwdfile option to specify a file containing plain text + [227]-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 @@ -1905,7 +1909,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 [226]-rfbauth + View-only passwords currently do not work for the [228]-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 @@ -1915,11 +1919,11 @@ TrueColor defdepth 24 straight-forward to work out what to do from the VNC source code. - Q-25: Can I fine tune what types of user input are allowed? E.g. have + Q-26: Can I fine tune what types of user input are allowed? E.g. have some users just be able to move the mouse, but not click or type anything? - As of Feb/2005, the [227]-input option allows you to do this. "K", + As of Feb/2005, the [229]-input option allows you to do this. "K", "M", and "B" stand for Keystroke, Mouse-motion, and Button-clicks, respectively. The setting: "-input M" makes attached viewers only able to move the mouse. "-input KMB,M" lets normal clients do everything @@ -1929,29 +1933,29 @@ TrueColor defdepth 24 remote control mechanism or the GUI. E.g. x11vnc -R input:hostname:M - Q-26: Why does x11vnc exit as soon as the VNC viewer disconnects? And + Q-27: Why does x11vnc exit as soon as the VNC viewer disconnects? And why doesn't it allow more than one VNC viewer to connect at the same time? 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 [228]-forever option (aka -many) to have + periods of time. Use the [230]-forever option (aka -many) to have x11vnc wait for more connections after the first client disconnects. - Use the [229]-shared option to have x11vnc allow multiple clients to + Use the [231]-shared option to have x11vnc allow multiple clients to connect simultaneously. - Recommended additional safety measures include using ssh ([230]see + Recommended additional safety measures include using ssh ([232]see above), stunnel, or a VPN to authenticate and encrypt the viewer - connections or to at least use the -rfbauth passwd-file [231]option to - use VNC password protection (or [232]-passwdfile) It is up to you to + connections or to at least use the -rfbauth passwd-file [233]option to + use VNC password protection (or [234]-passwdfile) It is up to YOU to apply these security measures, they will not be done for you automatically. - Q-27: Can I limit which machines incoming VNC clients can connect + Q-28: Can I limit which machines incoming VNC clients can connect from? - Yes, look at the [233]-allow and [234]-localhost options to limit + Yes, look at the [235]-allow and [236]-localhost options to limit connections by hostname or IP address. E.g. x11vnc -allow 192.168.0.1,192.168.0.2 @@ -1963,11 +1967,11 @@ TrueColor defdepth 24 Note that -localhost is the same as "-allow 127.0.0.1" For more control, build libvncserver with libwrap support - [235](tcp_wrappers) and then use /etc/hosts.allow See hosts_access(5) + [237](tcp_wrappers) and then use /etc/hosts.allow See hosts_access(5) for complete details. - Q-28: How do I build x11vnc/libvncserver with libwrap (tcp_wrappers) + Q-29: How do I build x11vnc/libvncserver with libwrap (tcp_wrappers) support? Here is one way to pass this information to the configure script: @@ -1983,50 +1987,50 @@ TrueColor defdepth 24 is "vnc", e.g.: vnc: 192.168.100.3 .example.com - Note that if you run x11vnc out of [236]inetd you do not need to build + Note that if you run x11vnc out of [238]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. - Q-29: Can I have x11vnc only listen on one network interface (e.g. + Q-30: Can I have x11vnc only listen on one network interface (e.g. internal LAN) rather than having it listen on all network interfaces and relying on -allow to filter unwanted connections out? - As of Mar/2005 in the libvncserver CVS, there is the "[237]-listen + As of Mar/2005 in the libvncserver CVS, there is the "[239]-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 "[238]-allow host1,..." option to allow only specific hosts + use the "[240]-allow host1,..." option to allow only specific hosts in. - This option is useful if you want insure that no one can even begin a - dialog with x11vnc from untrusted network interfaces (e.g. ppp0). The - option [239]-localhost now implies "-listen localhost" since that is - what most people expect it to do. + 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 [241]-localhost now implies "-listen localhost" since that + is what most people expect it to do. - Q-30: Now that -localhost implies listening only on the loopback + Q-31: Now that -localhost implies listening only on the loopback interface, how I can occasionally allow in a non-localhost via the -R allowonce remote control command? - To do this specify "[240]-allow localhost". Unlike [241]-localhost + To do this specify "[242]-allow localhost". Unlike [243]-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 connection from a remote host. Note that if you do a lot of changing of the listening interface - ([242]-listen option) via remote control or gui, you may need to also - manually adjust the [243]-allow list if you unexpectedly get into a + ([244]-listen option) via remote control or gui, you may need to also + manually adjust the [245]-allow list if you unexpectedly get into a state where the allow list cannot match any hosts that would be coming - in on the listening interface. If you just toggle [244]-localhost on + in on the listening interface. If you just toggle [246]-localhost on and off x11vnc should see to it that you never get into such a state. - Q-31: How can I tunnel my connection to x11vnc via an encrypted SSH + Q-32: 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 [245]how to tunnel VNC via + See the description earlier on this page on [247]how to tunnel VNC via SSH from Unix to Unix. A number of ways are described along with some issues you may encounter. @@ -2034,10 +2038,10 @@ TrueColor defdepth 24 VPNs, etc. - Q-32: How can I tunnel my connection to x11vnc via an encrypted SSH + Q-33: How can I tunnel my connection to x11vnc via an encrypted SSH channel from Windows using an SSH client like Putty? - [246]Above we described how to tunnel VNC via SSH from Unix to Unix, + [248]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 @@ -2049,7 +2053,7 @@ TrueColor defdepth 24 * Log into the remote machine by pressing 'Open' and supplying username, password, etc. * In that SSH shell, start up x11vnc by typing the command: x11vnc - -display :0 plus any other desired options. + -display :0 plus any other desired options (e.g. -localhost). * Finally, start up your VNC Viewer in Windows and enter 'localhost:0' as the VNC server. @@ -2060,8 +2064,8 @@ TrueColor defdepth 24 process in a BAT file including launching the VNC viewer by using the plink Putty utility. Send us the script if you get that working. - For extra protection feel free to run x11vnc with the [247]-localhost - and [248]-rfbauth/[249]-passwdfile options. + For extra protection feel free to run x11vnc with the [249]-localhost + and [250]-rfbauth/[251]-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 @@ -2069,22 +2073,22 @@ TrueColor defdepth 24 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 [250]chaining ssh's. + automated by [252]chaining ssh's. - As discussed [251]above another option is to first start the VNC + As discussed [253]above another option is to first start the VNC viewer in "listen" mode, and then launch x11vnc with the - "[252]-connect localhost" option to establish the reverse connection. + "[254]-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). - Q-33: Can I prompt the user at the local X display whether the + Q-34: Can I prompt the user at the local X display whether the incoming VNC client should be accepted or not? Can I decide to make some clients view-only? How about running an arbitrary program to make the decisions? - Yes, look at the "[253]-accept command" option, it allows you to + Yes, look at the "[255]-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 the client is accepted, otherwise the @@ -2103,7 +2107,7 @@ TrueColor defdepth 24 own simple popup window. To accept the 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 [254]-viewonly option has been + mouse on the "View" button. If the [256]-viewonly option has been supplied, the "View" action will not be present: the whole display is view only in that case. @@ -2119,7 +2123,7 @@ TrueColor defdepth 24 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 [255]ftp://ftp.x.org/ + is available at [257]ftp://ftp.x.org/ To include view-only decisions for the external commands, prefix the command something like this: "yes:0,no:*,view:3 mycommand ..." This @@ -2158,7 +2162,7 @@ elif [ $rc = 4 ]; then fi exit 1 - Stefan Radman has written a nice dtksh script [256]dtVncPopup for use + Stefan Radman has written a nice dtksh script [258]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. @@ -2167,14 +2171,14 @@ 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 "[257]-gone + To run a command when a client disconnects, use the "[259]-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"). - Q-34: Does x11vnc support Unix usernames and passwords? Can I further + Q-35: Does x11vnc support Unix usernames and passwords? Can I further limit the set of Unix usernames who can connect to the VNC desktop? Until the VNC protocol and libvncserver support this things will be @@ -2182,13 +2186,13 @@ exit 1 such support. 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 username - -L 5900:localhost:5900 hostname ... See the ssh wrapper scripts - mentioned [259]elsewhere on this page. Of course a malicious user + machine. As discussed above, ssh is useful for this: "ssh -l username + -L 5900:localhost:5900 hostname ..." See the ssh wrapper scripts + mentioned [261]elsewhere on this page. 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 watch out for is a malicious user on the viewer side (where ssh is running) trying to @@ -2197,7 +2201,7 @@ exit 1 Regarding limiting the set of Unix usernames who can connect, the traditional way would be to further require a VNC password to supplied (-rfbauth, -passwd, etc). A scheme that avoids a second password - involves using the [260]-accept option that runs a program to examine + involves using the [262]-accept option that runs a program to examine the connection information to determine which user is connecting from the local machine. For example, the program could use the ident service on the local machine (normally ident should not be trusted @@ -2226,19 +2230,20 @@ exit 1 # reject it UsePrivilegeSeparation must be enabled. - Q-35: I start x11vnc as root because it is launched via inetd(1) or a + Q-36: I start x11vnc as root because it is launched via inetd(1) or a display manager like gdm(1). Can I have x11vnc later switch to a different user? - As of Feb/2005 x11vnc has the [261]-users option that allows things - like this. Please read the documentation on it (in the x11vnc -help - output) carefully for features and caveats. It's use can often - decrease security unless care is taken. A nice use of it is "-users - +nobody" that switches to the Unix user nobody right after connections - to the X display are established. + As of Feb/2005 x11vnc has the [263]-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. + + BTW, a nice use of it is "-users +nobody" that switches to the Unix + user nobody right after connections to the X display are established. - Q-36: I use a screen-lock when I leave my workstation (e.g. + Q-37: I use a screen-lock when I leave my workstation (e.g. xscreensaver or xlock). When I remotely access my workstation desktop via x11vnc I can unlock the desktop fine, but I am worried people will see my activities on the physical monitor. What can I do to prevent @@ -2251,7 +2256,7 @@ exit 1 # reject it 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 [262]blockdpy.c The idea behind it is simple (but + source for it is [264]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 @@ -2267,16 +2272,16 @@ exit 1 # reject it bulletproof. A really robust solution would likely require X server and perhaps even video hardware support. - The blockdpy utility is launched by the [263]-accept option and told - to exit via the [264]-gone option (the vnc client user should + The blockdpy utility is launched by the [265]-accept option and told + to exit via the [266]-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. - Q-37: Can I have x11vnc automatically lock the screen when I + Q-38: Can I have x11vnc automatically lock the screen when I disconnect the VNC viewer? - Yes, a user mentions he uses the [265]-gone option under CDE to run a + Yes, a user mentions he uses the [267]-gone option under CDE to run a screen lock program: x11vnc -display :0 -forever -gone 'dtaction LockDisplay' @@ -2288,22 +2293,22 @@ exit 1 # reject it [Display Managers and Services] - Q-38: How can I run x11vnc as a "service" that is always available? + Q-39: How can I run x11vnc as a "service" that is always available? There are a number of ways to do this. The primary thing you need to decide is whether you want x11vnc to connect to the X session on the machine 1) regardless of who (or if anyone) has the X session, or 2) only if a certain user has the X session. Because X sessions are - protected by X permissions (XAUTHORITY and $HOME/.Xauthority) the - automatically started x11vnc will of course need to have sufficient - permissions to connect to the X display. + protected by X permissions (MIT-MAGIC-COOKIE files XAUTHORITY and + $HOME/.Xauthority) the automatically started x11vnc will of course + need to have sufficient permissions to connect to the X display. Here are some ideas: - * Use the description under "Continuously" in the [266]FAQ on x11vnc + * Use the description under "Continuously" in the [268]FAQ on x11vnc and Display Managers - * Use the description in the [267]FAQ on x11vnc and inetd(1) + * Use the description in the [269]FAQ on x11vnc and inetd(1) * Start x11vnc from your $HOME/.xsession (or $HOME/.xinitrc) - * Although less reliable, see the [268]x11vnc_loop rc.local hack + * Although less reliable, see the [270]x11vnc_loop rc.local hack below. The display manager scheme will not be specific to which user has the @@ -2322,7 +2327,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg plus any other options you desire. - Q-39: How can I use x11vnc to connect to an X login screen like xdm, + Q-40: How can I use x11vnc to connect to an X login screen like xdm, GNOME gdm, KDE kdm, or CDE dtlogin? (i.e. nobody is logged into an X session yet). @@ -2334,7 +2339,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 [269]-auth option sets the XAUTHORITY variable for you). + (the [271]-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 @@ -2359,7 +2364,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg 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 - [270]the example at the end of this FAQ). Then restart dtlogin, e.g.: + [272]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. Continuously. Have x11vnc reattach each time the X server is @@ -2367,11 +2372,14 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg To make x11vnc always attached to the the X server including the login screen you will need to add a command to a display manager startup - script. Please consider the security implications of this! Besides - having the VNC display for the X session always available, there are - other issues: .e.g. if you run the tkx11vnc gui (via say -gui or -gui - tray), then the gui controls (insecure) are available on the physical - X display before anyone has logged in. + script. + + Please consider the security implications of this! Besides having the + VNC display for the X session always available, there are other + issues: .e.g. if you run the tkx11vnc gui (via say -gui or -gui tray), + then the gui controls (insecure) are available on the physical X + display before anyone has logged in (maybe doing "-gui + tray,geom=+4000+4000" is a good idea...) The name of the display manager startup script file depends on desktop used and seem to be: @@ -2419,7 +2427,7 @@ rever -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 [271]full details + killed immediately after the user logs in. Here are [273]full details on how to configure gdm _________________________________________________________________ @@ -2461,23 +2469,23 @@ rever -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: [272]x11vnc_loop It will need some local + file like rc.local: [274]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. If the machine is a traditional Xterminal you may want to read - [273]this FAQ. + [275]this FAQ. - Q-40: Can I run x11vnc out of inetd(1)? How about xinetd(1)? + Q-41: Can I run x11vnc out of inetd(1)? How about xinetd(1)? Yes, perhaps a line something like this in /etc/inetd.conf will do it for you: 5900 stream tcp nowait root /usr/sbin/tcpd /usr/local/bin/x11vnc_sh - where the shell script /usr/local/bin/x11vnc_sh uses the [274]-inetd + where the shell script /usr/local/bin/x11vnc_sh uses the [276]-inetd option and looks something like (you'll need to customize to your settings). #!/bin/sh @@ -2490,7 +2498,7 @@ rever -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 [275]-quiet) option: "/usr/local/bin/x11vnc -q + specify the -q (aka [277]-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 @@ -2498,7 +2506,7 @@ rever -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 [276]-auth to point to the + Note also the need to set XAUTHORITY via [278]-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 @@ -2562,11 +2570,11 @@ service x11vncservice capture a log) - Q-41: How do I make x11vnc work with the Java VNC viewer applet in a + Q-42: How do I make x11vnc work with the Java VNC viewer applet in a web browser? To have x11vnc serve up a Java VNC viewer applet to any web browsers - that connect to it, run x11vnc with this [277]option: + that connect to it, run x11vnc with this [279]option: -httpdir /path/to/the/java/classes/dir (this directory will contain the files index.vnc and, for example, @@ -2585,18 +2593,21 @@ service x11vncservice 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. - Note that if you wanted to, you could also start the Java viewer + As of May/2005 the [280]-http option will try to guess where the Java + classes jar file is by looking a expected locations. + + Also note that if you wanted to, you could also start the Java viewer entirely from the viewer-side by having the jar file there and using either the java or appletviewer commands to run the program. - Q-42: Are reverse connections (i.e. the VNC server connecting to the + Q-43: Are reverse connections (i.e. the VNC server connecting to the VNC viewer) using "vncviewer -listen" and vncconnect(1) supported? As of Mar/2004 in the libvncserver CVS 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 [278]-connect option. To connect immediately + starts up x11vnc with the [281]-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 5500). If a file is specified instead: -connect /path/to/some/file @@ -2604,7 +2615,7 @@ service x11vncservice hosts to connect to. To use the vncconnect(1) program (from the core VNC package at - www.realvnc.com) specify the [279]-vncconnect option to x11vnc (Note: + www.realvnc.com) specify the [282]-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 or do not want to get @@ -2618,7 +2629,7 @@ service x11vncservice xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" - Q-43: Can I use x11vnc as a replacement for Xvnc? (i.e. not for a real + Q-44: Can I use x11vnc as a replacement for Xvnc? (i.e. not for a real display, but for a virtual one I keep around). You can, but you would not be doing this for performance reasons (for @@ -2648,7 +2659,7 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" There are some annoyances WRT Xvfb though. The default keyboard mapping seems to be very poor. One should run x11vnc with - [280]-add_keysyms option to have keysyms added automatically. Also, to + [283]-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" @@ -2668,7 +2679,7 @@ xmodmap -e "add Control = Control_L Control_R" server code is closely correlated with the real XFree86/Xorg Xserver unlike Xvfb. 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) [281]switching even though it + Linux Virtual Console/Terminal (VC/VT) [284]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. @@ -2683,7 +2694,7 @@ startx -- :1 -config /etc/X11/xorg.conf.dummy sessions, say Xnest or even Xvnc itself (useful for testing x11vnc). - Q-44: How can I use x11vnc on "headless" machines? Why might I want + Q-45: How can I use x11vnc on "headless" machines? Why might I want to? An interesting application of x11vnc is to let it export displays of @@ -2695,7 +2706,7 @@ startx -- :1 -config /etc/X11/xorg.conf.dummy 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 [282]this FAQ) and access it from + display via x11vnc (e.g. see [285]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 @@ -2720,7 +2731,7 @@ startx -- :1 -config /etc/X11/xorg.conf.dummy [Resource Usage and Performance] - Q-45: I have lots of memory, but why does x11vnc fail with shmget: + Q-46: I have lots of memory, but why does x11vnc fail with shmget: No space left on device or Minor opcode of failed request: 1 (X_ShmAttach)? @@ -2738,7 +2749,7 @@ startx -- :1 -config /etc/X11/xorg.conf.dummy 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 [283]shm_clear to list and prompt for removal + Here is a shell script [286]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, @@ -2772,101 +2783,129 @@ ied) in /etc/system. See the next paragraph for more workarounds. To minimize the number of shm segments used by x11vnc try using the - [284]-onetile option (corresponds to only 3 shm segments used, and + [287]-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 - [285]-noshm option. Performance will be somewhat degraded but when + [288]-noshm option. Performance will be somewhat degraded but when done over local machine sockets it should be acceptable (see an - [286]earlier question discussing -noshm). + [289]earlier question discussing -noshm). - Q-46: How can I make x11vnc use less system resources? + Q-47: How can I make x11vnc use less system resources? - The [287]-nap and "[288]-wait n" (where n is the sleep between polls + The [290]-nap and "[291]-wait n" (where n is the sleep between polls in milliseconds, the default is 30 or so) option are good places to start. 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. Using the - [289]-onetile option will use less memory and use fewer shared memory - slots (add [290]-fs 1.0 for one less slot). + even 8bpp) will further decrease memory I/O and network I/O. The + ShadowFB will make x11vnc's screen polling less severe. Using the + [292]-onetile option will use less memory and use fewer shared memory + slots (add [293]-fs 1.0 for one less slot). - Q-47: How can I make x11vnc use MORE system resources? + Q-48: How can I make x11vnc use MORE system resources? - You can try [291]-threads and dial down the wait time (e.g. -wait 1) - and possibly dial down [292]-defer as well. Note that if you try to + You can try [294]-threads and dial down the wait time (e.g. -wait 1) + and possibly dial down [295]-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 [293]-id option) can be streamed over a LAN or wireless at + the x11vnc [296]-id option) can be streamed over a LAN or wireless at a reasonable frame rate. - Q-48: I use x11vnc over a slow link with high latency (e.g. dialup + Q-49: I use x11vnc over a slow link with high latency (e.g. dialup modem), is there anything I can do to speed things up? - Some things you might want to experiment with (most of which will help + Some things you might want to experiment with (many of which will help performance on faster links as well): X server/session parameters: - * Configure the X server bits per pixel to 16bpp or even 8bpp. - (reduces amount of data needed to be sent) + * Configure the X server bits per pixel to be 16bpp or even 8bpp. + (reduces amount of data needed to be polled, compressed, and sent) * 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 - [294]-solid [color] option. + [297]-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 Opaque moves, resizes, and animations. + Disable window animations, etc. Maybe your desktop has a "low + bandwidth" theme you can easily switch into and out of. * Avoid small scrolls of large windows using the Arrow keys or - scrollbar. Try to use PageUp/PageDown instead. - * Turn off Anti-aliased fonts on your system, web browser, - terminals, etc. AA fonts do not compress as well as traditional - fonts. + scrollbar. Try to use PageUp/PageDown instead. (not so much of a + problem in x11vnc 0.7.2 if [298]-scrollcopyrect is active and + detecting scrolls for the application). + * If the [299]-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) + then you should Enable Opaque Moves and Resizes in the window + manager! This seems counter-intuitive, but because x11vnc detects + the move/resize events early there is a huge speedup over a slow + link when Opaque Moves and Resizes are enabled. (e.g. CopyRect + encoding will be used). + * Turn off Anti-aliased fonts on your system, web browser, terminal + windows, etc. AA fonts do not compress as well as traditional + fonts (sometimes 10X less). * On XFree86 turn on the Shadow Framebuffer to speed up reading. - (Option "ShadowFB" "true", and possibly Option "NoAccel" "true" as - well, in the Device section of /etc/X11/XF86Config) This disables - 2D acceleration on the physical display and so is probably not - worth it, but could be of use in some situations. + (Option "ShadowFB" "true" in the Device section of + /etc/X11/XF86Config) This disables 2D acceleration on the physical + display and so may not be worth it, but could be of use in some + situations. If the link is very slow, this speedup may not be + noticed. VNC viewer parameters: - * Use a [295]TightVNC enabled viewer! - * Make sure the tight encoding is being used (look at vncviewer and - x11vnc outputs) + * Use a [300]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 + vncviewer and x11vnc outputs) * Request 8 bits per pixel using -bgr233 (up to 4X speedup over depth 24 TrueColor (32bpp), but colors will be off) - * The -depth option is similar to -bgr233 in reducing the requested - number of bits per pixel. + * RealVNC 4.x viewer has some extremely low color modes (only 64 and + even 8 colors). 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) * Try reducing the TightVNC -quality (increases JPEG compression, - but is lossy) - * Try other VNC encodings via -encodings (tight is probably fastest, - but you should check) + but is lossy with painting artifacts) + * Try other VNC encodings via -encodings (tight is may be the + fastest, but you should compare it to zrle and maybe some of the + others) * On the machine where vncviewer is run, make sure Backing Store is - enabled (XFree86 disables it by default causing re-exposures of - vncviewer to be very slow) + enabled (XFree86/Xorg disables it by default causing re-exposures + of vncviewer to be very slow) Option "backingstore" in config + file. x11vnc parameters: - * Try using [296]-nodragging (no screen updates when dragging mouse, + * Try using [301]-nodragging (no screen updates when dragging mouse, but sometimes you miss visual feedback) - * Try the [297]-progressive pixelheight mode with the block + * Make sure the [302]-wireframe option is active (it should be on by + default) and you have Opaque Moves/Resizes Enabled in the window + manager. + * Make sure the [303]-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. + * Set [304]-fs 1.0 (disables fullscreen updates) + * Try increasing [305]-wait or [306]-defer (reduces the maximum + "frame rate", but won't help much for large screen changes) + * Try the [307]-progressive pixelheight mode with the block pixelheight 100 or so (delays sending vertical blocks since they may change while viewer is receiving earlier ones) - * Set [298]-fs 1.0 (disables fullscreen updates) - * Try increasing [299]-wait or [300]-defer (reduces the maximum - "frame rate", but won't help much for large screen changes) - * If you just want to watch one (simple) window use [301]-id (cuts + * If you just want to watch one (simple) window use [308]-id (cuts down extraneous polling and updates, but can be buggy or insufficient) - * Set [302]-nosel (disables all clipboard selection exchange) - * Use [303]-nocursor and [304]-nocursorpos (repainting the remote + * Set [309]-nosel (disables all clipboard selection exchange) + * Use [310]-nocursor and [311]-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 + [312]-readtimeout n setting if it sometimes takes more than 20sec + to paint the full screen, etc. - Q-49: Does x11vnc support the X DAMAGE Xserver extension to find + Q-50: Does x11vnc support the X DAMAGE Xserver extension to find modified regions of the screen quickly and efficiently? Yes, as of Mar/2005 in the libvncserver CVS x11vnc will use the X @@ -2876,51 +2915,53 @@ ied) The DAMAGE extension enables the X server to report changed regions of the screen back to x11vnc. So x11vnc doesn't have to guess where the - changes are (by polling the entire screen every 2-4 seconds). The use - of X DAMAGE dramatically reduces the load when the screen is not - changing very much (i.e. most of the time). It also noticeably - improves updates, especially for very small changed areas (e.g. clock - ticking, cursor flashing, typing, etc). + changes are (by polling every pixel of the entire screen every 2-4 + seconds). The use of X DAMAGE dramatically reduces the load when the + screen is not changing very much (i.e. most of the time). It also + noticeably improves updates, especially for very small changed areas + (e.g. clock ticking, cursor flashing, typing, etc). 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 [305]slow (e.g. + in main memory. So reading the fb is still painfully [313]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. + 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 + considerably (at the cost of h/w acceleration). Unfortunately the current Xorg DAMAGE extension implementation can at - times be overly cautious and report very large rectangles as "damaged" - even though only a small portion of the pixels have actually been - modified. This behavior is often the fault of the window manager (e.g. - it redraws the entire, unseen, frame window underneath the application - window when it gains focus), or the application itself (e.g. does - large, unnecessary repaints). + times be overly conservative and report very large rectangles as + "damaged" even though only a small portion of the pixels have actually + been modified. This behavior is often the fault of the window manager + (e.g. it redraws the entire, unseen, frame window underneath the + application window when it gains focus), or the application itself + (e.g. does large, unnecessary repaints). To work around this deficiency, x11vnc currently only trusts small 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 "[306]-xd_area A" option to adjust the size + skipped). You can use the "[314]-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 "[307]-xd_mem f" may also be of use in tuning the - algorithm. To disable using DAMAGE entirely use "[308]-noxdamage". + The option "[315]-xd_mem f" may also be of use in tuning the + algorithm. To disable using DAMAGE entirely use "[316]-noxdamage". - Q-50: When I drag windows around with the mouse or scroll up and down + Q-51: 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 [309]slow hardware read rates from + This problem is primarily due to [317]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 - [310]-pointer_mode option for more info. The next bottleneck is + [318]-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 @@ -2930,30 +2971,31 @@ ied) tree. The 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 "[311]-pointer_mode 1" option. + way via the "[319]-pointer_mode 1" option. - Also added was the [312]-nodragging option that disables all screen + Also added was the [320]-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 in the libvncserver CVS the [313]-pointer_mode n option + As of Dec/2004 in the libvncserver CVS the [321]-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 [314]-threads option can improve + Also, in some circumstances the [322]-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). - See the [315]wireframe FAQ and [316]scrollcopyrect FAQ below for - schemes to sweep this problem under the rug for window moves or - resizes and for some window scrolls. + As of Apr/2005 in the libvncserver CVS two new options (see the + [323]wireframe FAQ and [324]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. - Q-51: Why not do something like wireframe animations to avoid the + Q-52: Why not do something like wireframe animations to avoid the windows "lurching" when being moved or resized? Nice idea for a hack! As of Apr/2005 in the libvncserver CVS x11vnc by @@ -2964,13 +3006,16 @@ ied) shown. When 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 [317]slow video - card read rates (see [318]here too). A displacement, even a small one, + of the intermediate steps. BTW the lurching is due to [325]slow video + card read rates (see [326]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. + Note that Opaque Moves/Resizes must be Enabled by your window manager + for -wireframe to do any good. + The mode is currently on by default because most people are inflicted - with the problem. It can be disabled with the [319]-nowireframe option + with the problem. It can be disabled with the [327]-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 @@ -2988,17 +3033,20 @@ ied) The heuristics used to guess window motion or resizing are simple, but are not fool proof: x11vnc is sometimes tricked and so you'll occasionally see the lurching opaque move and rarely something even - worse. First it assumes that the move/resize will occur with a mouse - button pressed, held down and dragged (of course this is only mostly - true). Next it will only consider a window for wireframing if the - mouse pointer is initially "close enough" to the edges of the window - frame, e.g. you have grabbed the title bar or a resizer edge (this - requirement can be disabled). If these are true, it will wait an - amount of time to see if the window starts moving or resizing. If it - does, it starts drawing the wireframe "outline" of where the window - would be. When the mouse button is released, or a timeout occurs, it - goes back to the standard mode to allow the actual framebuffer changes - to propagate to the viewers. + worse. + + First it assumes that the move/resize will occur with a mouse button + pressed, held down and dragged (of course this is only mostly true). + Next it will only consider a window for wireframing if the mouse + pointer is initially "close enough" to the edges of the window frame, + e.g. you have grabbed the title bar or a resizer edge (this + requirement can be disabled and it also not applied if a modifier key, + e.g. Alt, is pressed). If these are true, it will wait an amount of + time to see if the window starts moving or resizing. If it does, it + starts drawing the wireframe "outline" of where the window would be. + When the mouse button is released, or a timeout occurs, it goes back + to the standard mode to allow the actual framebuffer changes to + propagate to the viewers. These parameters can be tweaked: * Color/Shade of the wireframe. @@ -3006,18 +3054,19 @@ ied) * Cutoff size of windows to not apply wireframing to. * Cutoffs for closeness to Top, Bottom, Left, and Right edges of window. + * Modifier keys to enable interior window grabbing. * Maximum time to wait for dragging pointer events. * Maximum time to wait for the window to start moving/resizing. * Maximum time to show a wireframe animation. * Minimum time between sending wireframe outlines. - See the [320]"-wireframe tweaks" option for more details. On a slow - link, e.g. dialup modem, you may want to increase all four of these - times, e.g. double them from the defaults. + See the [328]"-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 - [321]"-wirecopyrect mode" option. It is also on by default. This + [329]"-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 @@ -3048,29 +3097,30 @@ ied) -nowirecopyrect if this or other painting errors are unacceptable. - Q-52: Can x11vnc try to apply heuristics to detect when an window is + Q-53: Can x11vnc try to apply heuristics to detect when an window is scrolling its contents and use the CopyRect encoding for a speedup? Another nice idea for a hack! As of May/2005 in the libvncserver CVS x11vnc will by default apply heuristics to try to detect if the the window that has the input focus is scrolling its contents (but only - when x11vnc is feeding user input (keystroke or pointer) to the X + when x11vnc is feeding user input, keystroke or pointer, to the X server). So, when detected, scrolls induced by dragging on a scrollbar or by typing (e.g. Up or Down arrows, hitting Return in a terminal window, etc), will show up much more quickly than via the standard - x11vnc screen polling update mechanism. There will be a speedup for - both slow and fast links to viewers. For slow links the speedup is - mostly due to the CopyRect encoding not 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 - [322]slow). + x11vnc screen polling update mechanism. + + There will be a speedup for both slow and fast links to viewers. For + slow links the speedup is mostly due to the CopyRect encoding not + 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 [330]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. - This extension is usually present on most X servers. On XFree86/Xorg - it can be enabled via Load "record" in the Module section of the - config file. + This extension is usually present on most X servers (but SuSE disables + it for some reason). On XFree86/Xorg it can be enabled via Load + "record" in the Module section of the config file if it isn't already. Currently the RECORD extension is used as little as possible so as to not slow down regular use. Only simple heuristics are applied to @@ -3086,12 +3136,15 @@ ied) the X server display: if one falls too far behind it could become a mess... - The initial implementation of [323]-scrollcopyrect option is useful in + The initial implementation of [331]-scrollcopyrect option is useful in that it detects many scrolls and thus gives a much nicer working - environment (especially when combined with the [324]-wireframe - [325]-wirecopyrect [326]options, which are also on by default). The - fact that there aren't long delays or lurches during scrolling is the - primary improvement. But there are some drawbacks: + environment (especially when combined with the [332]-wireframe + [333]-wirecopyrect [334]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. + + But there are some drawbacks: * Not all scrolls are detected. Some apps scroll windows in ways that cannot currently be detected, and other times x11vnc "misses" the scroll due to timeouts, etc. Sometimes it is more distracting @@ -3119,10 +3172,10 @@ ied) 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: [327]-fixscreen + also: [335]-fixscreen * Some applications, notably OpenOffice, do XCopyArea scrolls in weird ways that assume ancestor window clipping is taking place. - See the [328]-scr_skip option for ways to tweak this on a + See the [336]-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 @@ -3132,28 +3185,28 @@ ied) * For reasons not yet understood the RECORD extension can stop responding (and hence scrolls are missed). As a workaround x11vnc attempts to reset the RECORD connection every 60 seconds or so. - Another workaround is to type 5 Super_L (Left Super/Windows-Flag + Another workaround is to type 4 Super_L (Left Super/Windows-Flag key) in a row to reset RECORD. Work is in progress to try to fix this bug. * Sometimes you need to "retrain" x11vnc for a certain window 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 [329]-scale option there will be a quick CopyRect + * When using the [337]-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 involves a blending of nearby pixels and if you translate a pixel the neighbor pixel weighting may be different. So you have to wait - a bit for the cleanup update to finish. On slow links x11vnc will + a bit for the cleanup update to finish. On slow links x11vnc may automatically decide to not detect scrolls when -scale is in effect. In general it will also try to defer the cleanup update if possible. If you find the -scrollcopyrect behavior too approximate or distracting you can go back to the standard polling-only update method - with the [330]-noscrollcopyrect or -noscr for short. If you find some - extremely bad and repeatable behavior for -scrollcopyrect please + with the [338]-noscrollcopyrect (or -noscr for short). If you find + some extremely bad and repeatable behavior for -scrollcopyrect please report a bug. Alternatively, as with -wireframe, there are many tuning parameters to @@ -3176,30 +3229,31 @@ ied) [Mouse Cursor Shapes] - Q-53: Why isn't the mouse cursor shape (the little icon shape where + Q-54: Why isn't the mouse cursor shape (the little icon shape where the mouse pointer is) correct as I move from window to window? On X servers supporting XFIXES or Solaris/IRIX Overlay extensions it - is possible for x11vnc to do this correctly. See the paragraphs below. + is possible for x11vnc to do this correctly. See a few paragraphs down + for the answer. Historically, the X11 mouse cursor shape (i.e. little picture: an - arrow, X, I-beam, resizer, etc) is one of the few write-only objects + arrow, X, I-beam, resizer, etc) is one of the few WRITE-only objects in X11. That is, an application can tell the X server what the cursor shape should be when the pointer is in a given window, but a program (like x11vnc) unfortunately cannot read this information. I believe 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 "[331]-cursor X" option that + A simple kludge is provided by the "[339]-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 "[332]-cursor some" option for + work for those cases. Also see the "[340]-cursor some" option for additional kludges. Note that as of Aug/2004 in the libvncserver CVS, on Solaris using the SUN_OVL overlay extension and IRIX, x11vnc can show the correct mouse - cursor when the [333]-overlay option is supplied. See [334]this FAQ + cursor when the [341]-overlay option is supplied. See [342]this FAQ for more info. Also as of Dec/2004 in the libvncserver CVS XFIXES X extension support @@ -3207,18 +3261,18 @@ ied) 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 [335]Solaris 10. + distros and [343]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 - approximated to opaque RGB values. There are some 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. [336]Details can be found here. + approximated to opaque RGB values for use in VNC. There are some + 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. [344]Details can be found here. - Q-54: When using XFIXES cursorshape mode, some of the cursors look + Q-55: When using XFIXES cursorshape mode, some of the cursors look really bad with extra black borders around the cursor and other cruft. How can I improve their appearance? @@ -3248,25 +3302,35 @@ ied) 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 "[337]-alphacut n" option lets + course!) some tunable parameters. The "[345]-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 "[338]-alphafrac f" option tries to correct individual + 240. The "[346]-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 [339]-alpharemove that is useful for + Finally, there is an option [347]-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 -alpharemove to brighten them by having x11vnc divide out the alpha value. + One user played with these parameters and reported back: + Of the cursor themes present on my system: + + gentoo and gentoo-blue: alphacut:192 - noalpharemove + + gentoo-silver: alphacut:127 and alpharemove - Q-55: In XFIXES mode, are there any hacks to handle cursor + whiteglass and redglass (presumably also handhelds, which is based + heavily on redglass) look fine with the apparent default of alphacut:255. + + + Q-56: In XFIXES mode, are there any hacks to handle cursor transparency ("alpha channel") exactly? As of Jan/2005 in the CVS, libvncserver has been modified to allow an @@ -3274,11 +3338,11 @@ ied) send the 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 [340]-nocursorshape x11vnc option. + disabled for all clients with the [348]-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 - [341]-noalphablend option to disable this behavior (always approximate + [349]-noalphablend option to disable this behavior (always approximate transparent cursors with opaque RGB values). The CursorShapeUpdates VNC extension complicates matters because the @@ -3303,12 +3367,12 @@ ied) [Mouse Pointer] - Q-56: Why does the mouse arrow just stay in one corner in my + Q-57: 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 [342]tightvnc extension + This default takes advantage of a [350]tightvnc extension (CursorShapeUpdates) that allows specifying a cursor image shape for - the local VNC viewer. You may disable it with the [343]-nocursor + the local VNC viewer. You may disable it with the [351]-nocursor option to x11vnc if your viewer does not have this extension. Note: as of Aug/2004 in the libvncserver CVS this should be fixed: the @@ -3317,23 +3381,23 @@ ied) framebuffer. This can also be disabled via -nocursor. - Q-57: Can I take advantage of the TightVNC extension to the VNC + Q-58: Can I take advantage of the TightVNC extension to the VNC protocol where Cursor Positions Updates are sent back to all connected clients (i.e. passive viewers can see the mouse cursor being moved around by another viewer)? - Use the [344]-cursorpos option when starting x11vnc. A VNC viewer must + Use the [352]-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 in the - libvncserver CVS -cursorpos is the default. See also [345]-nocursorpos - and [346]-nocursorshape. - - - Q-58: Is it possible to swap the mouse buttons (e.g. left-handed + libvncserver CVS -cursorpos is the default. See also [353]-nocursorpos + and [354]-nocursorshape. + + + Q-59: 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: [347]-buttonmap + You can remap the mouse buttons via something like: [355]-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. @@ -3341,7 +3405,7 @@ ied) 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 [348]-debug_pointer option prints out much info for + Note that the [356]-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 @@ -3363,9 +3427,9 @@ ied) 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 [349]-buttonmap but rather configuring the X server + consider not using [357]-buttonmap but rather configuring the X server to think it has a mouse with 5 buttons even though the physical mouse - does not. + does not. (e.g. 'Option "ZAxisMapping" "4 5"'). Note that when a keysym-mapped mouse button is clicked down this immediately generates the key-press and key-release events (for each @@ -3390,33 +3454,33 @@ ied) "click" usually gives a multi-line scroll). [Keyboard Issues] - Q-59: How can I get my AltGr and Shift modifiers to work between + Q-60: How can I get my AltGr and Shift modifiers to work between keyboards for different languages? - The option [350]-modtweak should be of some use for this. 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. + The option [358]-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. Update: As of Jul/2004 in the libvncserver CVS, -modtweak is now the default (use -nomodtweak 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 [351]this FAQ + and ">" it. This key does not exist on the keyboard (see [359]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 [352]FAQ about the -xkb option for a more powerful method + Also see the [360]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 - [353]-debug_keyboard option prints out much info for every keystroke + [361]-debug_keyboard option prints out much info for every keystroke and so can be useful debugging things. - Q-60: When I try to type a "<" (i.e. less than) instead I get ">" + Q-61: When I try to type a "<" (i.e. less than) instead I get ">" (i.e. greater than)! Strangely, typing ">" works OK!! Does your keyboard have a single key with both "<" and ">" on it? Even @@ -3424,6 +3488,12 @@ ied) (e.g. pc105 in the XF86Config file when it should be something else, say pc104). + Short Cut: Try the [362]-xkb or [363]-sloppy_keys options and see if + that helps the situation. The discussion below is a bit outdated (e.g. + [364]-modtweak is now the default) but is useful reference for various + tricks and so is kept. + + The problem here is that on the Xserver where x11vnc is run there are two keycodes that correspond to the "<" keysym. Run something like this to see: @@ -3463,21 +3533,34 @@ ied) -remap less-comma These are convenient in that they do not modify the actual X server - settings. The former ([354]-modtweak) is a mode that monitors the + settings. The former ([365]-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 ([355]-remap less-comma) is an immediate remapping of the + The latter ([366]-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 [356]FAQ about the -xkb option as a possible workaround + See also the [367]FAQ about the -xkb option as a possible workaround using the XKEYBOARD extension. - Note that the [357]-debug_keyboard option prints out much info for + Note that the [368]-debug_keyboard option prints out much info for every keystroke to aid debugging keyboard problems. - Q-61: I'm using an "international" keyboard (e.g. German "de", or + Q-62: When I try to type a "<" (i.e. 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 [369]keymapping + ambiguity the last event "< up" is interpreted as "," because that key + unshifted is the comma. + + This should not happen in [370]-xkb mode, because it works hard to + resolve the ambiguities. If you do not want to use -xkb, try the + option [371]-sloppy_keys to attempt a similar type of algorithm. + + + Q-63: I'm using an "international" keyboard (e.g. German "de", or Danish "dk") and the -modtweak mode works well if the VNC viewer is run on a Unix/Linux machine with a similar keyboard. But if I run the VNC viewer on Unix/Linux with a different keyboard (e.g. "us") or @@ -3498,7 +3581,7 @@ ied) 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 [358]-modtweak + This all worked fine with x11vnc running with the [372]-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 @@ -3516,13 +3599,18 @@ ied) * there is a new option -xkb to use the XKEYBOARD extension API to do the Modifier key tweaking. - The [359]-xkb option seems to fix all of the missing keys: "@", "<", + The [373]-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 (aka -dk) option twice you will get a huge amount of keystroke debugging output (send it along with any problems you report). + Update: as of Jun/2005 x11vnc will try to automatically enable + [374]-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. + Known problems: * One user had to disable a "ghost" Mode_switch key that was causing problems under -xkb. His physical AltGr key was bound to @@ -3534,7 +3622,7 @@ ied) 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: - [360]-skip_keycodes 93 + [375]-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 @@ -3551,23 +3639,27 @@ ied) 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 [361]-remap x11vnc option: + created using the [376]-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 - [362]-add_keysyms option in the next paragraph. - * To complement the above workaround using the [363]-remap, an - option [364]-add_keysyms was added. This option instructs x11vnc + [377]-add_keysyms option in the next paragraph. + Update: for convenience "[378]-remap DEAD" does many of these + mappings at once. + * To complement the above workaround using the [379]-remap, an + option [380]-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 created. Note that the -remap mappings are applied first, right when the Keysym is received from a VNC viewer, and only after that would -add_keysyms, or anything else, come into play. + Update: -add_keysyms is now on by default. Use -noadd_keysyms to + disable. - Q-62: When typing I sometimes get double, triple, or more of my + Q-64: When typing I sometimes get double, triple, or more of my keystrokes repeated. I'm sure I only typed them once, what can I do? This may be due to an interplay between your X server's key autorepeat @@ -3575,10 +3667,12 @@ ied) 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) [365]-norepeat x11vnc option. You will still + use the new (Jul/2004) [381]-norepeat x11vnc option. You will still have autorepeating because that is taken care of on your VNC viewer - side. Update: as of Dec/2004 -norepeat is now the default. Use -repeat - to disable it. + side. + + Update: as of Dec/2004 -norepeat is now the default. Use -repeat to + disable it. Details: suppose you press a key DOWN and it generates changes in large regions of the screen. The CPU and I/O work x11vnc does for the @@ -3597,18 +3691,18 @@ ied) 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 [366]-norepeat (which has since Dec/2004 been + needed, or to use the [382]-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 working at the physical display and misses his autorepeating. - Q-63: The x11vnc -norepeat mode is in effect, but I still get repeated + Q-65: The x11vnc -norepeat mode is in effect, but I still get repeated keystrokes!! Are you using x11vnc to log in to an X session? (as described in - [367]this FAQ) If so, x11vnc is starting before your session and it + [383]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 trying to be @@ -3628,11 +3722,11 @@ ied) should figure out how to disable that somehow. - Q-64: The machine where I run x11vnc has an AltGr key, but the local + Q-66: 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 "[368]-remap Super_R-Mode_switch" x11vnc option may + Something like "[384]-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)). @@ -3643,7 +3737,7 @@ ied) specify remappings from a file. - Q-65: I have a Sun machine I run x11vnc on. Its Sun keyboard has just + Q-67: I have a Sun machine I run x11vnc on. Its Sun keyboard has just one Alt key labelled "Alt" and two Meta keys labelled with little diamonds. The machine where I run the VNC viewer only has Alt keys. How can I send a Meta keypress? (e.g. emacs needs this) @@ -3655,26 +3749,27 @@ ied) 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 [369]-remap Alt_L-Meta_L to x11vnc may be sufficient for ones + the [385]-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. + better choice if the Super_L key is typically unused in Unix. - Q-66: Can I map a keystroke to a mouse button click on the remote + Q-68: Can I map a keystroke to a mouse button click on the remote machine? 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 [370]-remap + have x11vnc do the remapping. This can be done via the [386]-remap option using the fake "keysyms" Button1, Button2, etc. as the "to" keys (i.e. the ones after the "-") As an example, consider a laptop where the VNC viewer is run that has a touchpad with only two buttons. It is difficult to do a middle - button "paste" because (using XFree86 Emulate3Buttons) you have to - click both buttons on the touch pad at the same time. This remapping: - [371]-remap Super_R-Button2 + button "paste" because (using XFree86/Xorg Emulate3Buttons) you have + to click both buttons on the touch pad at the same time. This + remapping: + [387]-remap Super_R-Button2 maps the Super_R "flag" key press to the Button2 click, thereby making X pasting a bit easier. @@ -3685,7 +3780,7 @@ ied) [Screen Related Issues and Features] - Q-67: The remote display is larger (in number of pixels) than the + Q-69: The remote display is larger (in number of pixels) than the local display I am running the vncviewer on. I don't like the vncviewer scrollbars, what I can do? @@ -3693,26 +3788,26 @@ ied) option) for vncviewer to run in full screen, where it will automatically scroll when the mouse is near the edge of the current view. For quick scrolling, also make sure Backing Store is enabled on - the machine vncviewer is run on. (XFree86 disables it by default for - some reason, add Option "backingstore" to XF86Config on the vncviewer - side). + the machine vncviewer is run on. (XFree86/Xorg disables it by default + for some reason, add Option "backingstore" to XF86Config on the + vncviewer side). BTW, contact me if you are having problems with vncviewer in fullscreen mode with your window manager (i.e. no keyboard response). I have a workaround for vncviewer using XGrabServer(). - There may also be scaling viewers out there (e.g. TightVNC on Windows) - that automatically shrink or expand the remote framebuffer to fit the - local display. Especially for hand-held devices. See also [372]this - FAQ on x11vnc scaling. + 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 + [388]this FAQ on x11vnc scaling. - Q-68: Does x11vnc support server-side framebuffer scaling? (E.g. to + Q-70: Does x11vnc support server-side framebuffer scaling? (E.g. to make the desktop smaller). As of Jun/2004 in the libvncserver CVS x11vnc provides basic server-side scaling. It is a global scaling of the desktop, not a - per-client setting. To enable it use the "[373]-scale fraction" + per-client setting. To enable it use the "[389]-scale fraction" option. "fraction" can either be a floating point number (e.g. -scale 0.5) or the alternative m/n fraction notation (e.g. -scale 2/3). Note that if fraction is greater than one the display is magnified. @@ -3728,11 +3823,12 @@ ied) "-scale 1/3:nb" Fonts will be difficult to read, but the larger features will be recognizable. BTW, "no blending" mode is forced on when scaling 8bpp PseudoColor displays (because blending an indexed - colormap is a bad idea and leads to random colors). + colormap is a bad idea and leads to random colors, use :fb to force it + on). 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 - [374]applications. Since with integer scale factors the framebuffers + [390]applications. Since with integer scale factors the framebuffers become huge and scaling operations time consuming, be sure to use ":nb" for the fastest response. @@ -3758,45 +3854,59 @@ ied) 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 ([375]-rfbport option, + different scalings listening on separate ports ([391]-rfbport option, etc.). - As of Mar/2005 in the libvncserver CVS x11vnc now scales the mouse - cursor with the same scale factor as the screen. If you don't want - that, use the [376]"-scale_cursor frac" option to set the cursor + BTW, whenever you run two or more x11vnc's on the same X display and + use the [392]GUI, then to avoid all of the x11vnc's simultaneously + answering the gui you will need to use something like [393]"-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 proces and the + gui process. Otherwise they all share the same X property channel: + VNC_CONNECT. + + Update: As of Mar/2005 in the libvncserver CVS x11vnc now scales the + mouse cursor with the same scale factor as the screen. If you don't + want that, use the [394]"-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). - Q-69: Does x11vnc work with Xinerama? (i.e. multiple monitors joined + Q-71: Does x11vnc work with Xinerama? (i.e. multiple monitors joined together to form one big, single screen). Yes, it should generally work because it simply polls the big - effective screen. If the viewing-end monitor is not as big as the - remote Xinerama display, then the vncviewer scrollbars, etc, will have - to be used to pan across the large area. - - There are a couple potential issues however. If the 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 [377]-blackout x11vnc option allows you - to blacken-out rectangles by specifying their WxH+X+Y geometries. If - your system has the libXinerama library, the [378]-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). + effective screen. + + If the viewing-end monitor is not as big as the remote Xinerama + display, then the vncviewer scrollbars, etc, will have to be used to + pan across the large area. However one user started two x11vnc's, one + with "-clip 1280x1024+0+0" and the other with "-clip 1280x1024+1280+0" + to split the big screen into two and used two VNC viewers to access + them. + + There are a couple potential issues with Xinerama however. If the + 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 [395]-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 + [396]-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). 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 [379]-xwarppointer + of the large display. If this happens try using the [397]-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). - Q-70: Can I use x11vnc on a multi-headed display that is not Xinerama + Q-72: Can I use x11vnc on a multi-headed display that is not Xinerama (i.e. separate screens :0.0, :0.1, ... for each monitor)? You can, but it is a little bit awkward: you must start separate @@ -3814,41 +3924,43 @@ ied) 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 [380]FAQ to increase the limit. It - is probably also a good idea to run with the [381]-onetile option in + /etc/system as mentioned in another [398]FAQ to increase the limit. It + is probably also a good idea to run with the [399]-onetile option in this case (to limit each x11vnc to 3 shm segments), or even - [382]-noshm to use no shm segments. + [400]-noshm to use no shm segments. - Q-71: Can x11vnc show only a portion of the display? (E.g. for a + Q-73: Can x11vnc show only a portion of the display? (E.g. for a special purpose rfb application). - As of Mar/2005 in the libvncserver CVS x11vnc has the "[383]-clip + As of Mar/2005 in the libvncserver CVS x11vnc has the "[401]-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. + display and be only WxH in size. One user used -clip to split up a + large [402]Xinerama screen into two more managable smaller screens. This also works to view a sub-region of a single application window if - the [384]-id or [385]-sid options are used. The offset is measured + the [403]-id or [404]-sid options are used. The offset is measured from the upper left corner of the selected window. - Q-72: Does x11vnc support the XRANDR (X Resize, Rotate and Reflection) + Q-74: Does x11vnc support the XRANDR (X Resize, Rotate and Reflection) extension? Whenever I rotate or resize the screen x11vnc just seems to crash. As of Dec/2004 in the libvncserver CVS x11vnc supports XRANDR. You - enable it with the [386]-xrandr option to make x11vnc monitor XRANDR + enable it with the [405]-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. If the - connected vnc viewers support the NewFBSize VNC extension (Windows - TightVNC viewer and RealVNC 4.0 windows and Unix viewers do) 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 - [387]-padgeom option to make the region big enough to hold all resizes - and rotations. + change it will create a new framebuffer using the new screen. + + If the connected vnc viewers support the NewFBSize VNC extension + (Windows TightVNC viewer and RealVNC 4.0 windows and Unix viewers do) + 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 [406]-padgeom option to make the region big + enough to hold all resizes and rotations. If you specify "-xrandr newfbsize" then vnc viewers that do not support NewFBSize will be disconnected before the resize. If you @@ -3856,13 +3968,13 @@ ied) terminate. - Q-73: Why is the view in my VNC viewer completely black? Or why is + Q-75: Why is the view in my VNC viewer completely black? Or why is everything flashing around randomly? See the next FAQ for a possible explanation. - Q-74: I use Linux Virtual Consoles (VC's) to implement 'Fast User + Q-76: I use Linux Virtual Consoles (VC's) to implement 'Fast User Switching' between users' sessions (e.g. Betty is on Ctrl-Alt-F7, Bobby is on Ctrl-Alt-F8, and Sid is on Ctrl-Alt-F1: they use those keystrokes to switch between their sessions). How come the view in a @@ -3890,7 +4002,7 @@ ied) "chvt 7" for VC #7. - Q-75: Can I use x11vnc to view my VMWare session remotely? + Q-77: Can I use x11vnc to view my VMWare session remotely? Yes, since VMWare is an X application you can view it via x11vnc in the normal way. @@ -3901,9 +4013,9 @@ ied) * Fullscreen mode The way VMWare does Fullscreen mode on Linux is to display the Guest - desktop in a separate Virtual Console (e.g. VC 8) (see [388]this FAQ + desktop in a separate Virtual Console (e.g. VC 8) (see [407]this FAQ on VC's for background). Unfortunately, this Fullscreen VC is not an X - server. So x11vnc cannot access it (however, [389]see this for a + server. So x11vnc cannot access it (however, [408]see this for a possible partial workaround). x11vnc works fine with "Normal X application window" and "Quick-Switch mode" because these use X. @@ -3920,13 +4032,13 @@ ied) 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 [390]is in the active VC. + as long as the VMWare X session [409]is in the active VC. Also note that with a little bit of playing with "xwininfo -all -children" output one can extract the (non-toplevel) windowid 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 [391]-id windowid option. The + the VMWare menu buttons) by use of the [410]-id windowid option. The caveats are the X session VMWare is in must be in the active VC and the window must be fully visible, so this mode is not terribly convenient, but could be useful in some circumstances (e.g. running @@ -3935,7 +4047,7 @@ ied) mouse)). - Q-76: Can non-X devices (e.g. a raw framebuffer) be viewed and/or + Q-78: Can non-X devices (e.g. a raw framebuffer) be viewed and/or controlled by x11vnc? As of Apr/2005 in the libvncserver CVS there is rudimentary support @@ -3945,11 +4057,11 @@ ied) keystroke input). This non-X mode for x11vnc is experimental because it is so removed in - scope from the intended usage of the tool. No attempt is made to make - all of the other options consistent with non-X framebuffer polling. So - all of the X-related options (e.g. -add_keysyms, -xkb) are just - ignored or in the worst case will cause a crash. Be careful applying - such an option via the command line or remote control. + scope from the intended usage of the tool. Little attempt is made to + make all of the other options consistent with non-X framebuffer + polling. So all of the X-related options (e.g. -add_keysyms, -xkb) are + just ignored or in the worst case will cause a crash. Be careful + applying such an option via the command line or remote control. The format for the -rawfb string is: -rawfb <type>:<object>@<W>x<H>x<bpp>[:<R>/<G>/<B>][+<offset>] @@ -4007,7 +4119,7 @@ ied) 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. Of course for the case - of Xvfb x11vnc can poll it much better via the [392]X API, but you get + of Xvfb x11vnc can poll it much better via the [411]X API, but you get the idea. By default in -rawfb mode x11vnc will actually close any X display it @@ -4060,7 +4172,7 @@ ied) 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 VC #2 (assuming it is the [393]active VC) one + view and interact with VC #2 (assuming it is the [412]active VC) one can run something like: x11vnc -rawfb map:/dev/fb0@1024x768x16 -pipeinput './vcinject.pl 2' @@ -4073,9 +4185,9 @@ ied) more accurate and faster LinuxVNC program. The only advantage x11vnc -rawfb might have is that it can presumably allow interaction with a non-text application, e.g. one based on svgalib. For example the - [394]VMWare Fullscreen mode is actually viewable under -rawfb. But + [413]VMWare Fullscreen mode is actually viewable under -rawfb. But this isn't much use until one figures out how to inject keystrokes and - mouse events. + mouse events... The -rawfb and -pipeinput features are intended to help one creatively "get out of a jam" (say on a legacy or embedded device) where X is @@ -4084,36 +4196,38 @@ ied) program that passes the framebuffer to libvncserver. - Q-77: I am using x11vnc where my local machine has "popup/hidden + Q-79: I am using x11vnc where my local machine has "popup/hidden taskbars" (e.g. GNOME or MacOS X) and the remote display where x11vnc runs also has "popup/hidden taskbars" (e.g. GNOME). When I move the mouse to the edge of the screen where the popups happen, the taskbars interfere and fight with each other in strange ways. What can I do? Is there a way to temporarily disable one or both of these magic - desktop taskbars? One x11vnc user suggests: it should be - straightforward to right mouse click on the task bar panel, and - uncheck "enable auto-hide" from the panel properties dialog box. This - will make the panel always visible. + desktop taskbars? + + One x11vnc user suggests: it should be straightforward to right mouse + click on the task bar panel, and uncheck "enable auto-hide" from the + panel properties dialog box. This will make the panel always visible. [Misc: Clipboard, Beeps, Thanks, etc.] - Q-78: Does the Clipboard/Selection get transferred between the + Q-80: Does the Clipboard/Selection get transferred between the vncviewer and the X display? As of Jan/2004 in the libvncserver CVS x11vnc supports the "CutText" part of the rfb protocol. Furthermore, x11vnc is able to hold the PRIMARY selection (Xvnc does not seem to do this). If you don't want - the Clipboard/Selection exchanged use the [395]-nosel option. If you + the Clipboard/Selection exchanged use the [414]-nosel option. If you don't want the PRIMARY selection to be polled for changes use the - [396]-noprimary option. + [415]-noprimary option. You can also fine-tune it a bit with the + [416]-seldir dir option. You may need to watch out for desktop utilities such as KDE's "Klipper" that do odd things with the selection, clipboard, and cutbuffers. - Q-79: Why don't I hear the "Beeps" in my X session (e.g. when typing + Q-81: Why don't I hear the "Beeps" in my X session (e.g. when typing tput bel in an xterm)? As of Dec/2003 in the libvncserver CVS "Beep" XBell events are tracked @@ -4121,7 +4235,7 @@ ied) not on by default 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 [397]-nobell option. If + If you don't want to hear the beeps use the [417]-nobell option. If you want to hear the audio from the remote applications, consider trying a redirector such as esd. @@ -4130,14 +4244,14 @@ ied) Contributions: - Q-80: Thanks for your program and for your help! Can I make a + Q-82: Thanks for your program and for your help! Can I make a donation? Please do (any amount is appreciated) and thank you for your support! Click on the PayPal button below for more info. Also, in general I always enjoy hearing from x11vnc users, how they use it, what new features they would like, etc. Please send me an - [398]email! + [418]email! [PayPal] @@ -4230,317 +4344,337 @@ References 85. http://www.karlrunge.com/x11vnc/index.html#faq-viewer-download 86. http://www.karlrunge.com/x11vnc/index.html#faq-cmdline-opts 87. http://www.karlrunge.com/x11vnc/index.html#faq-config-file - 88. http://www.karlrunge.com/x11vnc/index.html#faq-quiet-bg - 89. http://www.karlrunge.com/x11vnc/index.html#faq-sigpipe - 90. http://www.karlrunge.com/x11vnc/index.html#faq-build-customizations - 91. http://www.karlrunge.com/x11vnc/index.html#faq-win2vnc - 92. http://www.karlrunge.com/x11vnc/index.html#faq-win2vnc-8bpp - 93. http://www.karlrunge.com/x11vnc/index.html#faq-8bpp - 94. http://www.karlrunge.com/x11vnc/index.html#faq-overlays - 95. http://www.karlrunge.com/x11vnc/index.html#faq-windowid - 96. http://www.karlrunge.com/x11vnc/index.html#faq-transients-id - 97. http://www.karlrunge.com/x11vnc/index.html#faq-24bpp - 98. http://www.karlrunge.com/x11vnc/index.html#faq-noshm - 99. http://www.karlrunge.com/x11vnc/index.html#faq-xterminal-xauth - 100. http://www.karlrunge.com/x11vnc/index.html#faq-stop-bg - 101. http://www.karlrunge.com/x11vnc/index.html#faq-remote_control - 102. http://www.karlrunge.com/x11vnc/index.html#faq-passwd - 103. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile - 104. http://www.karlrunge.com/x11vnc/index.html#faq-input-opt - 105. http://www.karlrunge.com/x11vnc/index.html#faq-forever-shared - 106. http://www.karlrunge.com/x11vnc/index.html#faq-allow-opt - 107. http://www.karlrunge.com/x11vnc/index.html#faq-tcp_wrappers - 108. http://www.karlrunge.com/x11vnc/index.html#faq-listen-interface - 109. http://www.karlrunge.com/x11vnc/index.html#faq-listen-localhost - 110. http://www.karlrunge.com/x11vnc/index.html#faq-ssh-unix - 111. http://www.karlrunge.com/x11vnc/index.html#faq-ssh-putty - 112. http://www.karlrunge.com/x11vnc/index.html#faq-accept-opt - 113. http://www.karlrunge.com/x11vnc/index.html#faq-unix-passwords - 114. http://www.karlrunge.com/x11vnc/index.html#faq-users-opt - 115. http://www.karlrunge.com/x11vnc/index.html#faq-blockdpy - 116. http://www.karlrunge.com/x11vnc/index.html#faq-gone-lock - 117. http://www.karlrunge.com/x11vnc/index.html#faq-service - 118. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager - 119. http://www.karlrunge.com/x11vnc/index.html#faq-inetd - 120. http://www.karlrunge.com/x11vnc/index.html#faq-java-http - 121. http://www.karlrunge.com/x11vnc/index.html#faq-reverse-connect - 122. http://www.karlrunge.com/x11vnc/index.html#faq-xvfb - 123. http://www.karlrunge.com/x11vnc/index.html#faq-headless - 124. http://www.karlrunge.com/x11vnc/index.html#faq-solshm - 125. http://www.karlrunge.com/x11vnc/index.html#faq-less-resource - 126. http://www.karlrunge.com/x11vnc/index.html#faq-more-resource - 127. http://www.karlrunge.com/x11vnc/index.html#faq-slow-link - 128. http://www.karlrunge.com/x11vnc/index.html#faq-xdamage - 129. http://www.karlrunge.com/x11vnc/index.html#faq-pointer-mode - 130. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe - 131. http://www.karlrunge.com/x11vnc/index.html#faq-scrollcopyrect - 132. http://www.karlrunge.com/x11vnc/index.html#faq-cursor-shape - 133. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha - 134. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha-hacks - 135. http://www.karlrunge.com/x11vnc/index.html#faq-cursor-arrow - 136. http://www.karlrunge.com/x11vnc/index.html#faq-cursor-positions - 137. http://www.karlrunge.com/x11vnc/index.html#faq-buttonmap-opt - 138. http://www.karlrunge.com/x11vnc/index.html#faq-altgr - 139. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless - 140. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak - 141. http://www.karlrunge.com/x11vnc/index.html#faq-repeated-keys - 142. http://www.karlrunge.com/x11vnc/index.html#faq-repeated-keys-still - 143. http://www.karlrunge.com/x11vnc/index.html#faq-remap-opt - 144. http://www.karlrunge.com/x11vnc/index.html#faq-sun-alt-meta - 145. http://www.karlrunge.com/x11vnc/index.html#faq-remap-button-click - 146. http://www.karlrunge.com/x11vnc/index.html#faq-scrollbars - 147. http://www.karlrunge.com/x11vnc/index.html#faq-scaling - 148. http://www.karlrunge.com/x11vnc/index.html#faq-xinerama - 149. http://www.karlrunge.com/x11vnc/index.html#faq-multi-screen - 150. http://www.karlrunge.com/x11vnc/index.html#faq-clip-screen - 151. http://www.karlrunge.com/x11vnc/index.html#faq-xrandr - 152. http://www.karlrunge.com/x11vnc/index.html#faq-black-screen - 153. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 154. http://www.karlrunge.com/x11vnc/index.html#faq-vmware - 155. http://www.karlrunge.com/x11vnc/index.html#faq-rawfb - 156. http://www.karlrunge.com/x11vnc/index.html#faq-hidden-taskbars - 157. http://www.karlrunge.com/x11vnc/index.html#faq-clipboard - 158. http://www.karlrunge.com/x11vnc/index.html#faq-beeps - 159. http://www.karlrunge.com/x11vnc/index.html#faq-thanks - 160. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display - 161. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 162. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager - 163. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 164. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding - 165. http://www.karlrunge.com/x11vnc/x11vnc_sunos4.html - 166. http://www.karlrunge.com/x11vnc/index.html#building - 167. http://www.karlrunge.com/x11vnc/index.html#faq-build - 168. http://packages.debian.org/x11vnc - 169. http://www.linuxpackages.net/search_view.php?by=name&name=x11vnc - 170. http://dag.wieers.com/packages/x11vnc/ - 171. http://linux01.gwdg.de/~pbleser/rpm-navigation.php?cat=Network/x11vnc/ - 172. http://www.sunfreeware.com/ - 173. http://www.bell-labs.com/project/wwexptools/packages.html - 174. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding - 175. http://www.karlrunge.com/x11vnc/bins - 176. http://www.tightvnc.com/download.html - 177. http://www.realvnc.com/download-free.html - 178. http://sourceforge.net/projects/cotvnc/ - 179. http://www.karlrunge.com/x11vnc/x11vnc_opts.html - 180. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 181. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q - 182. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg - 183. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-o - 184. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding - 185. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nofb - 186. http://fredrik.hubbe.net/x2vnc.html - 187. http://www.hubbe.net/~hubbe/win2vnc.html - 188. http://www.deboer.gmxhome.de/ - 189. http://sourceforge.net/projects/win2vnc/ - 190. http://fredrik.hubbe.net/x2vnc.html - 191. http://freshmeat.net/projects/x2x/ - 192. http://ftp.digital.com/pub/Digital/SRC/x2x/ - 193. http://zapek.com/software/zvnc/ - 194. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-visual - 195. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flashcmap - 196. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-notruecolor - 197. http://www.karlrunge.com/x11vnc/index.html#faq-8bpp - 198. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 199. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 200. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 88. http://www.karlrunge.com/x11vnc/index.html#faq-gui-tray + 89. http://www.karlrunge.com/x11vnc/index.html#faq-quiet-bg + 90. http://www.karlrunge.com/x11vnc/index.html#faq-sigpipe + 91. http://www.karlrunge.com/x11vnc/index.html#faq-build-customizations + 92. http://www.karlrunge.com/x11vnc/index.html#faq-win2vnc + 93. http://www.karlrunge.com/x11vnc/index.html#faq-win2vnc-8bpp + 94. http://www.karlrunge.com/x11vnc/index.html#faq-8bpp + 95. http://www.karlrunge.com/x11vnc/index.html#faq-overlays + 96. http://www.karlrunge.com/x11vnc/index.html#faq-windowid + 97. http://www.karlrunge.com/x11vnc/index.html#faq-transients-id + 98. http://www.karlrunge.com/x11vnc/index.html#faq-24bpp + 99. http://www.karlrunge.com/x11vnc/index.html#faq-noshm + 100. http://www.karlrunge.com/x11vnc/index.html#faq-xterminal-xauth + 101. http://www.karlrunge.com/x11vnc/index.html#faq-stop-bg + 102. http://www.karlrunge.com/x11vnc/index.html#faq-remote_control + 103. http://www.karlrunge.com/x11vnc/index.html#faq-passwd + 104. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile + 105. http://www.karlrunge.com/x11vnc/index.html#faq-input-opt + 106. http://www.karlrunge.com/x11vnc/index.html#faq-forever-shared + 107. http://www.karlrunge.com/x11vnc/index.html#faq-allow-opt + 108. http://www.karlrunge.com/x11vnc/index.html#faq-tcp_wrappers + 109. http://www.karlrunge.com/x11vnc/index.html#faq-listen-interface + 110. http://www.karlrunge.com/x11vnc/index.html#faq-listen-localhost + 111. http://www.karlrunge.com/x11vnc/index.html#faq-ssh-unix + 112. http://www.karlrunge.com/x11vnc/index.html#faq-ssh-putty + 113. http://www.karlrunge.com/x11vnc/index.html#faq-accept-opt + 114. http://www.karlrunge.com/x11vnc/index.html#faq-unix-passwords + 115. http://www.karlrunge.com/x11vnc/index.html#faq-users-opt + 116. http://www.karlrunge.com/x11vnc/index.html#faq-blockdpy + 117. http://www.karlrunge.com/x11vnc/index.html#faq-gone-lock + 118. http://www.karlrunge.com/x11vnc/index.html#faq-service + 119. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager + 120. http://www.karlrunge.com/x11vnc/index.html#faq-inetd + 121. http://www.karlrunge.com/x11vnc/index.html#faq-java-http + 122. http://www.karlrunge.com/x11vnc/index.html#faq-reverse-connect + 123. http://www.karlrunge.com/x11vnc/index.html#faq-xvfb + 124. http://www.karlrunge.com/x11vnc/index.html#faq-headless + 125. http://www.karlrunge.com/x11vnc/index.html#faq-solshm + 126. http://www.karlrunge.com/x11vnc/index.html#faq-less-resource + 127. http://www.karlrunge.com/x11vnc/index.html#faq-more-resource + 128. http://www.karlrunge.com/x11vnc/index.html#faq-slow-link + 129. http://www.karlrunge.com/x11vnc/index.html#faq-xdamage + 130. http://www.karlrunge.com/x11vnc/index.html#faq-pointer-mode + 131. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe + 132. http://www.karlrunge.com/x11vnc/index.html#faq-scrollcopyrect + 133. http://www.karlrunge.com/x11vnc/index.html#faq-cursor-shape + 134. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha + 135. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha-hacks + 136. http://www.karlrunge.com/x11vnc/index.html#faq-cursor-arrow + 137. http://www.karlrunge.com/x11vnc/index.html#faq-cursor-positions + 138. http://www.karlrunge.com/x11vnc/index.html#faq-buttonmap-opt + 139. http://www.karlrunge.com/x11vnc/index.html#faq-altgr + 140. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless + 141. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless-sloppy + 142. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak + 143. http://www.karlrunge.com/x11vnc/index.html#faq-repeated-keys + 144. http://www.karlrunge.com/x11vnc/index.html#faq-repeated-keys-still + 145. http://www.karlrunge.com/x11vnc/index.html#faq-remap-opt + 146. http://www.karlrunge.com/x11vnc/index.html#faq-sun-alt-meta + 147. http://www.karlrunge.com/x11vnc/index.html#faq-remap-button-click + 148. http://www.karlrunge.com/x11vnc/index.html#faq-scrollbars + 149. http://www.karlrunge.com/x11vnc/index.html#faq-scaling + 150. http://www.karlrunge.com/x11vnc/index.html#faq-xinerama + 151. http://www.karlrunge.com/x11vnc/index.html#faq-multi-screen + 152. http://www.karlrunge.com/x11vnc/index.html#faq-clip-screen + 153. http://www.karlrunge.com/x11vnc/index.html#faq-xrandr + 154. http://www.karlrunge.com/x11vnc/index.html#faq-black-screen + 155. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 156. http://www.karlrunge.com/x11vnc/index.html#faq-vmware + 157. http://www.karlrunge.com/x11vnc/index.html#faq-rawfb + 158. http://www.karlrunge.com/x11vnc/index.html#faq-hidden-taskbars + 159. http://www.karlrunge.com/x11vnc/index.html#faq-clipboard + 160. http://www.karlrunge.com/x11vnc/index.html#faq-beeps + 161. http://www.karlrunge.com/x11vnc/index.html#faq-thanks + 162. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display + 163. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 164. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager + 165. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 166. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding + 167. http://www.karlrunge.com/x11vnc/x11vnc_sunos4.html + 168. http://www.karlrunge.com/x11vnc/index.html#building + 169. http://www.karlrunge.com/x11vnc/index.html#faq-build + 170. http://packages.debian.org/x11vnc + 171. http://www.linuxpackages.net/search_view.php?by=name&name=x11vnc + 172. http://dag.wieers.com/packages/x11vnc/ + 173. http://linux01.gwdg.de/~pbleser/rpm-navigation.php?cat=Network/x11vnc/ + 174. http://www.sunfreeware.com/ + 175. http://www.bell-labs.com/project/wwexptools/packages.html + 176. http://www.karlrunge.com/x11vnc/bins + 177. http://www.tightvnc.com/download.html + 178. http://www.realvnc.com/download-free.html + 179. http://sourceforge.net/projects/cotvnc/ + 180. http://www.karlrunge.com/x11vnc/x11vnc_opts.html + 181. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 182. http://www.karlrunge.com/x11vnc/index.html#faq-gui-tray + 183. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q + 184. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg + 185. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-o + 186. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding + 187. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nofb + 188. http://fredrik.hubbe.net/x2vnc.html + 189. http://www.hubbe.net/~hubbe/win2vnc.html + 190. http://www.deboer.gmxhome.de/ + 191. http://sourceforge.net/projects/win2vnc/ + 192. http://fredrik.hubbe.net/x2vnc.html + 193. http://freshmeat.net/projects/x2x/ + 194. http://ftp.digital.com/pub/Digital/SRC/x2x/ + 195. http://zapek.com/software/zvnc/ + 196. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-visual + 197. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flashcmap + 198. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-notruecolor + 199. http://www.karlrunge.com/x11vnc/index.html#faq-8bpp + 200. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay 201. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 202. http://www.karlrunge.com/x11vnc/index.html#faq-overlays - 203. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 204. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sid - 205. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display - 206. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 207. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flipbyteorder - 208. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 209. http://www.karlrunge.com/x11vnc/index.html#xauth_pain - 210. http://www.karlrunge.com/x11vnc/index.html#faq-noshm - 211. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 212. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query - 213. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever - 214. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg - 215. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods - 216. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_keys - 217. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query - 219. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd - 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 222. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile - 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewpasswd - 224. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwd - 225. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input - 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever - 229. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-shared - 230. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 231. http://www.karlrunge.com/x11vnc/index.html#faq-passwd - 232. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile - 233. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 234. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 235. http://www.karlrunge.com/x11vnc/index.html#faq-tcp_wrappers - 236. http://www.karlrunge.com/x11vnc/index.html#faq-inetd - 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen - 238. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 239. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 202. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 203. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 204. http://www.karlrunge.com/x11vnc/index.html#faq-overlays + 205. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 206. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sid + 207. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display + 208. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 209. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flipbyteorder + 210. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 211. http://www.karlrunge.com/x11vnc/index.html#xauth_pain + 212. http://www.karlrunge.com/x11vnc/index.html#faq-noshm + 213. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 214. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query + 215. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever + 216. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg + 217. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods + 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_keys + 219. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query + 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 222. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd + 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 224. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile + 225. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewpasswd + 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwd + 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 229. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input + 230. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever + 231. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-shared + 232. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 233. http://www.karlrunge.com/x11vnc/index.html#faq-passwd + 234. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile + 235. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 236. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 237. http://www.karlrunge.com/x11vnc/index.html#faq-tcp_wrappers + 238. http://www.karlrunge.com/x11vnc/index.html#faq-inetd + 239. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen 240. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow 241. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen - 243. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 244. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 245. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 246. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 247. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 250. http://www.karlrunge.com/x11vnc/index.html#gateway_double_ssh - 251. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 252. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 253. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 254. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewonly - 255. ftp://ftp.x.org/ - 256. http://www.karlrunge.com/x11vnc/dtVncPopup - 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 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/x11vnc_opts.html#opt-accept - 261. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 262. http://www.karlrunge.com/x11vnc/blockdpy.c - 263. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 264. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 266. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously - 267. http://www.karlrunge.com/x11vnc/index.html#faq-inetd - 268. http://www.karlrunge.com/x11vnc/index.html#x11vnc_loop - 269. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 270. http://www.karlrunge.com/x11vnc/index.html#dtlogin_solaris - 271. http://www.jirka.org/gdm-documentation/x241.html - 272. http://www.karlrunge.com/x11vnc/x11vnc_loop - 273. http://www.karlrunge.com/x11vnc/index.html#faq-xterminal-xauth - 274. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd - 275. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q - 276. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 277. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir - 278. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 279. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vncconnect - 280. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 281. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 282. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously - 283. http://www.karlrunge.com/x11vnc/shm_clear - 284. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 285. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 286. http://www.karlrunge.com/x11vnc/index.html#faq-noshm - 287. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nap - 288. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 289. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 290. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs - 291. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 292. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 293. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 294. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid - 295. http://www.tightvnc.com/ - 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 297. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-progressive - 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs - 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 300. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 301. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 302. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel - 303. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor - 304. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos - 305. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 306. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_area - 307. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_mem - 308. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage - 309. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 310. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 311. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 312. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 313. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 314. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 315. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe - 316. http://www.karlrunge.com/x11vnc/index.html#faq-scrollcopyrect - 317. http://www.karlrunge.com/x11vnc/index.html#faq-pointer-mode - 318. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 319. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 320. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 321. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 322. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 323. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 324. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 325. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wirecopyrect - 326. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe - 327. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen - 328. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scr_skip - 329. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 330. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 331. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 332. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 333. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 334. http://www.karlrunge.com/x11vnc/index.html#the-overlay-mode - 335. http://www.karlrunge.com/x11vnc/index.html#solaris10-build - 336. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha-hacks - 337. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphacut - 338. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphafrac - 339. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alpharemove - 340. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape - 341. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noalphablend - 342. http://www.tightvnc.com/ - 343. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor - 344. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursorpos - 345. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos - 346. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape - 347. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap - 348. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_pointer - 349. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap - 350. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 351. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless - 352. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak - 353. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard - 354. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 355. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 356. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak - 357. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 243. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 244. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen + 245. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 247. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 248. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 250. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 251. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 252. http://www.karlrunge.com/x11vnc/index.html#gateway_double_ssh + 253. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 254. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 255. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewonly + 257. ftp://ftp.x.org/ + 258. http://www.karlrunge.com/x11vnc/dtVncPopup + 259. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 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/x11vnc_opts.html#opt-accept + 263. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 264. http://www.karlrunge.com/x11vnc/blockdpy.c + 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 266. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 267. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 268. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously + 269. http://www.karlrunge.com/x11vnc/index.html#faq-inetd + 270. http://www.karlrunge.com/x11vnc/index.html#x11vnc_loop + 271. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 272. http://www.karlrunge.com/x11vnc/index.html#dtlogin_solaris + 273. http://www.jirka.org/gdm-documentation/x241.html + 274. http://www.karlrunge.com/x11vnc/x11vnc_loop + 275. http://www.karlrunge.com/x11vnc/index.html#faq-xterminal-xauth + 276. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd + 277. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q + 278. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 279. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir + 280. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http + 281. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 282. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vncconnect + 283. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 284. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 285. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously + 286. http://www.karlrunge.com/x11vnc/shm_clear + 287. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 288. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 289. http://www.karlrunge.com/x11vnc/index.html#faq-noshm + 290. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nap + 291. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 292. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 293. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs + 294. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 295. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 297. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid + 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 300. http://www.tightvnc.com/ + 301. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 302. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 303. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 304. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs + 305. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 306. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 307. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-progressive + 308. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 309. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel + 310. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor + 311. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos + 312. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-readtimeout + 313. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 314. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_area + 315. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_mem + 316. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 317. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 318. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 319. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 320. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 321. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 322. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 323. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe + 324. http://www.karlrunge.com/x11vnc/index.html#faq-scrollcopyrect + 325. http://www.karlrunge.com/x11vnc/index.html#faq-pointer-mode + 326. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 327. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 328. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 329. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 330. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 331. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 332. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 333. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wirecopyrect + 334. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe + 335. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen + 336. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scr_skip + 337. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 338. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 339. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 340. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 341. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 342. http://www.karlrunge.com/x11vnc/index.html#the-overlay-mode + 343. http://www.karlrunge.com/x11vnc/index.html#solaris10-build + 344. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha-hacks + 345. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphacut + 346. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphafrac + 347. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alpharemove + 348. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape + 349. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noalphablend + 350. http://www.tightvnc.com/ + 351. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor + 352. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursorpos + 353. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos + 354. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape + 355. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap + 356. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_pointer + 357. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap 358. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 359. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 360. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_keycodes - 361. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 362. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 363. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 364. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 365. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat - 366. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat - 367. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager - 368. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 369. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 370. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 371. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 372. http://www.karlrunge.com/x11vnc/index.html#faq-scaling - 373. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 374. http://www.cus.cam.ac.uk/~ssb22/source/vnc-magnification.html - 375. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport - 376. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale_cursor - 377. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-blackout - 378. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama - 379. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer - 380. http://www.karlrunge.com/x11vnc/index.html#faq-solshm - 381. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 382. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 383. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip - 384. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 385. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 386. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xrandr - 387. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-padgeom - 388. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 389. http://www.karlrunge.com/x11vnc/index.html#faq-rawfb - 390. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 391. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 392. http://www.karlrunge.com/x11vnc/index.html#faq-xvfb - 393. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 394. http://www.karlrunge.com/x11vnc/index.html#faq-vmware - 395. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel - 396. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noprimary - 397. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nobell - 398. mailto:xvml@karlrunge.com + 359. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless + 360. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak + 361. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 362. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 363. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys + 364. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 365. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 366. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 367. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak + 368. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 369. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless + 370. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 371. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys + 372. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 373. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 374. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 375. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_keycodes + 376. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 377. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 378. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 379. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 380. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 381. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat + 382. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat + 383. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager + 384. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 385. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 386. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 387. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 388. http://www.karlrunge.com/x11vnc/index.html#faq-scaling + 389. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 390. http://www.cus.cam.ac.uk/~ssb22/source/vnc-magnification.html + 391. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport + 392. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 393. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 394. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale_cursor + 395. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-blackout + 396. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama + 397. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer + 398. http://www.karlrunge.com/x11vnc/index.html#faq-solshm + 399. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 400. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 401. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip + 402. http://www.karlrunge.com/x11vnc/index.html#faq-xinerama + 403. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 404. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 405. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xrandr + 406. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-padgeom + 407. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 408. http://www.karlrunge.com/x11vnc/index.html#faq-rawfb + 409. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 410. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 411. http://www.karlrunge.com/x11vnc/index.html#faq-xvfb + 412. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 413. http://www.karlrunge.com/x11vnc/index.html#faq-vmware + 414. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel + 415. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noprimary + 416. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-seldir + 417. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nobell + 418. mailto:xvml@karlrunge.com ======================================================================= @@ -4553,7 +4687,7 @@ 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.7.2 lastmod: 2005-07-10 +x11vnc: allow VNC connections to real X11 displays. 0.7.2 lastmod: 2005-07-12 x11vnc options: -display disp -auth file @@ -4655,7 +4789,7 @@ libvncserver options: % x11vnc -help -x11vnc: allow VNC connections to real X11 displays. 0.7.2 lastmod: 2005-07-10 +x11vnc: allow VNC connections to real X11 displays. 0.7.2 lastmod: 2005-07-12 Typical usage is: @@ -6076,6 +6210,10 @@ n full gui. (To supply more than one, use "+" sign). E.g. -gui tray=setpass and -gui icon=0x3600028 + Other modes: "full", the default and need not be + specified. "-gui none", do not show a gui, useful + to override a ~/.x11vncrc setting, etc. + 5) When "geom=+X+Y" is specified, that geometry is passed to the gui toplevel. This is the icon in icon/tray mode, or the full gui otherwise. You can diff --git a/x11vnc/tkx11vnc b/x11vnc/tkx11vnc index c056f88..4549c11 100755 --- a/x11vnc/tkx11vnc +++ b/x11vnc/tkx11vnc @@ -252,9 +252,9 @@ Permissions =0 storepasswd =GAL LOFF =GAL Misc-Perms:: - =S alwaysshared - =S nevershared - =S dontdisconnect + =0S alwaysshared + =0S nevershared + =0S dontdisconnect =SQA deny_all =GAL LOFF @@ -335,7 +335,8 @@ The \"Actions -> stop\" action sends a signal to the running x11vnc server indicating it should shutdown all connections and exit. The GUI stays running in case you want to start a new x11vnc or attach -to another one. Use \"Actions -> Quit\" if you want to have the gui exit. +to another one. Use \"Actions -> Quit\" if you then want to have the +gui exit. Use \"Actions -> stop+quit\" to have both exit at once. " set helptext(show-start-cmd) " @@ -345,8 +346,10 @@ settings. This can be done even in the attached state. Intended for debugging the gui. The help item for \"Actions -> start\" gives the same info. -If you want to load in a saved profile \"rc file\" use Misc -> rc -and select the file. +If you want to load in a saved profile \"rc file\" use \"Misc -> rc\" +and select the file. \"Actions -> load-settings\" does a similar thing +with an rc-file, but reading the file and setting the gui variables to +its values. " set helptext(debug_gui) " @@ -393,7 +396,9 @@ default. Basically sets everything to 0 or the string (unset). This action is only available in \"startup\" mode, not when connected to a running x11vnc server (in that case the variable settings reflect -the state of the running x11vnc). +the state of the running x11vnc). To detach from a running x11vnc +server use \"Actions -> detach\"; to completely stop the x11vnc server +use \"Actions -> stop\". " set helptext(defaults-all) " @@ -402,7 +407,9 @@ everything to the default queries \"x11vnc -QD var\" retrieved at startup. This action is only available in \"startup\" mode, not when connected to a running x11vnc server (in that case the variable settings reflect -the state of the running x11vnc). +the state of the running x11vnc). To detach from a running x11vnc +server use \"Actions -> detach\"; to completely stop the x11vnc server +use \"Actions -> stop\". " set helptext(load-settings) " @@ -416,7 +423,9 @@ using the gui before starting x11vnc. This action is only available in \"startup\" mode, not when connected to a running x11vnc server (in that case the variable settings reflect -the state of the running x11vnc). +the state of the running x11vnc). To detach from a running x11vnc +server use \"Actions -> detach\"; to completely stop the x11vnc server +use \"Actions -> stop\". " set helptext(save-settings) " @@ -652,6 +661,7 @@ with -rfbauth, but only with -passwdfile, -passwd, and -viewpasswd. set helptext(Misc-Perms:) " In this sub-menu we provide some lesser used permission options. + Regarding -alwaysshared, -nevershared, and -dontdisconnect, you probably should never use them and just use x11vnc's -shared and -forever options instead (these give basically the same functionality and if you mixed @@ -974,8 +984,9 @@ Key Bindings: Anywhere: Control-a invokes \"Actions -> attach\" Anywhere: Control-p invokes \"Actions -> ping\" Anywhere: Control-u and Control-r invoke \"Actions -> update-all\" +" - +set under_wally " Misc: Since x11vnc has so many settings and to avoid further confusion, @@ -2168,6 +2179,8 @@ proc get_default_vars {} { set val "" } elseif {$item == "auth"} { set val "" + } elseif {$item == "gui"} { + continue } # some hacks we do here for now.. if {$item == "cursor" && $val == ""} { @@ -2176,8 +2189,8 @@ proc get_default_vars {} { set val "always" } elseif {$item == "wirecopyrect" && $val == ""} { set val "always" - } elseif {$item == "overlay_nocursor" && $val == 0} { - set val 1 +# } elseif {$item == "overlay_nocursor" && $val == 0} { +# set val 1 } set default_var($item) $val @@ -2186,6 +2199,94 @@ proc get_default_vars {} { } } +proc tilde_expand {file} { + global env + if {[file exists $file]} { + return $file + } + + set user "" + if {[info exists env(USER)]} { + set user $env(USER) + } + if {$user == "" && [info exists env(LOGNAME)]} { + set user $env(LOGNAME) + } + + set home "" + if {[info exists env(HOME)]} { + set home $env(HOME) + } elseif {$user != ""} { + set home "/home/$user" + } + + if {[regexp {^~} $file]} { + if {[regexp {^~/} $file]} { + if {$home != ""} { + regsub {^~} $file $home file + } + } else { + regsub {^~} $file "/home/" file + } + } + return $file +} + +proc insert_cmdline_vars {} { + global env cmd_var menu_var default_var x11vnc_cmdline + if {![info exists x11vnc_cmdline]} { + return + } + if {$x11vnc_cmdline == ""} { + return + } + set cmd_var(novar) 1 + set str [string trim $x11vnc_cmdline] + + while {[regexp -- {^-} $str]} { + if {[regexp -- {^--*([^ \t][^ \t]*)(.*)$} $str m var rest]} { + set rest [string trim $rest] + set var [string trim $var] + if {[regexp {^\{\{([^\}]*)\}\}(.*)} $rest m val rest]} { + set str [string trim $rest] + set cmd_var($var) $val + } else { + set str $rest + set cmd_var($var) "boolean" + } + } else { + break + } + } + + if {[info exists cmd_var(rc)]} { + load_settings $cmd_var(rc) + } elseif {[info exists cmd_var(norc)]} { + ; + } else { + set filex [tilde_expand "~/.x11vncrc"] + if {[file exists $filex]} { + load_settings $filex + } + } + + foreach var [array names cmd_var] { + if {$var == "novar"} { + continue + } + if {[regexp {^[ \t]*$} $var]} { + continue + } + if {[info exists menu_var($var)]} { + if {$cmd_var($var) == "boolean"} { + set menu_var($var) 1 + } else { + set menu_var($var) $cmd_var($var) + } + } + } +} + proc copy_default_vars {} { global menu_var default_var foreach item [array names default_var] { @@ -2239,22 +2340,25 @@ proc update_menu_vars {{query ""}} { } } -proc load_settings {} { - global menu_var default_var +proc load_settings {{file ""}} { + global menu_var default_var env - if {![info exists menu_var(load-settings)]} { - return + if {$file == ""} { + if {![info exists menu_var(load-settings)]} { + return + } + set file $menu_var(load-settings) } - set file $menu_var(load-settings) if {$file == ""} { return } set fh "" - catch {set fh [open $file "r"]} + set filex [tilde_expand $file] + catch {set fh [open $filex "r"]} if {$fh == ""} { - append_text "load_settings: *** failed to open $file ***\n" + append_text "load_settings: *** failed to open $filex ***\n" return } copy_default_vars @@ -2281,6 +2385,9 @@ proc load_settings {} { } close $fh + set count 0 + set parms "" + foreach line [split $str "\n"] { set line [string trim $line] regsub {^--*} $line "" line @@ -2291,16 +2398,31 @@ proc load_settings {} { if {[regexp {^[ \t]*$} $item]} { continue } + if {$item == "gui"} { + continue + } if {[info exists menu_var($item)]} { if {[value_is_bool $item]} { set menu_var($item) 1 + incr count + append parms " -$item\n" } elseif {[value_is_string $item]} { if {$value != ""} { set menu_var($item) $value + set nitem [get_nitem $item] + append parms " -$nitem $value\n" + incr count } } } } + append_text "loaded $count parameter settings from $filex" + if {$count > 0} { + append_text ":\n" + append_text $parms + } else { + append_text ".\n" + } } proc save_settings {} { @@ -2361,6 +2483,7 @@ proc save_settings {} { if {$file == ""} { return } + set file [tilde_expand $file] append_text "\nSaving current settings to $file ...\n" if {[file exists $file]} { set backup "${file}~" @@ -2525,7 +2648,8 @@ proc show_all_settings {} { proc show_logfile {} { global menu_var unset_str - set logfile $menu_var(logfile) + + set logfile [tilde_expand $menu_var(logfile)] if {$logfile == "" || $logfile == $unset_str} { set txt "\nNo logfile was specified at x11vnc startup.\n\n" @@ -3843,6 +3967,8 @@ proc do_new_client {} { button $w.b -text OK -command "destroy $w" -font $bfont bind $w.e <Return> "update; after 100; destroy $w" + wm title $w "New Client" + pack $w.l $w.e $w.b -side left -pady 1m -padx 1m focus $w.e center_win $w @@ -4338,6 +4464,8 @@ proc make_gui {mode} { wm minsize . 1 1 + set gui_current_state "" + if {$mode == "full"} { frame $fw set icon_mode 0 @@ -4397,6 +4525,8 @@ proc make_gui {mode} { copy_default_vars if {$x11vnc_connect} { try_connect_and_query_all + } else { + insert_cmdline_vars } } else { set_name "RESTORE" @@ -4731,13 +4861,12 @@ proc get_settings_rcfile {} { } if {$item == "debug_gui"} { continue - } - if {$item == "WindowView"} { + } elseif {$item == "WindowView"} { continue - } - if {$item == "rc" || $item == "norc"} { + } elseif {$item == "rc" || $item == "norc"} { continue } + set def "" if {[info exists default_var($item)]} { set def $default_var($item) @@ -4768,16 +4897,7 @@ proc get_settings_rcfile {} { set ntab 3 if {$item == "gui" || [value_is_string $item]} { - set nitem $item - if {$nitem == "screen_blank"} { - set nitem "sb" - } elseif {$nitem == "xrandr_mode"} { - set nitem "xrandr" - } elseif {$nitem == "wireframe_mode"} { - set nitem "wireframe" - } elseif {$nitem == "solid_color"} { - set nitem "solid" - } + set nitem [get_nitem $item] if {$mv == "" && $def != ""} { set qst $hmm @@ -4871,8 +4991,22 @@ proc show_start_cmd {} { append_text "$msg\n" } +proc get_nitem {item} { + set nitem $item + if {$nitem == "screen_blank"} { + set nitem "sb" + } elseif {$nitem == "xrandr_mode"} { + set nitem "xrandr" + } elseif {$nitem == "wireframe_mode"} { + set nitem "wireframe" + } elseif {$nitem == "solid_color"} { + set nitem "solid" + } + return $nitem +} + proc get_start_x11vnc_cmd {{show_rc 0}} { - global menu_var default_var unset_str x11vnc_prog + global cmd_var menu_var default_var unset_str x11vnc_prog set xterm_cmd "xterm -iconic -geometry 80x35 -title x11vnc-console -e" @@ -4880,24 +5014,26 @@ proc get_start_x11vnc_cmd {{show_rc 0}} { lappend cmd $x11vnc_prog + lappend cmd "-gui" + lappend cmd "none" + set rc_txt "" set saw_id 0 foreach item [lsort [array names menu_var]] { if {$item == "gui"} { - ; + continue } elseif {![active_when_starting $item]} { continue } elseif {[is_action $item]} { continue - } - if {$item == "debug_gui"} { + } elseif {$item == "debug_gui"} { continue - } - if {$item == "WindowView"} { + } elseif {$item == "WindowView"} { continue } + if {$item == "id" || $item == "sid"} { set val $menu_var($item); if {$val == "0x0" || $val == "root"} { @@ -4909,17 +5045,13 @@ proc get_start_x11vnc_cmd {{show_rc 0}} { } if {$item == "id"} { set saw_id 1 - } - if {$item == "httpport" && $menu_var($item) == "0"} { + } elseif {$item == "httpport" && $menu_var($item) == "0"} { continue - } - if {$item == "progressive" && $menu_var($item) == "0"} { + } elseif {$item == "progressive" && $menu_var($item) == "0"} { continue - } - if {$item == "dontdisconnect" && $menu_var($item) == "-1"} { + } elseif {$item == "dontdisconnect" && $menu_var($item) == "-1"} { continue - } - if {$item == "alwaysshared" && $menu_var($item) == "-1"} { + } elseif {$item == "alwaysshared" && $menu_var($item) == "-1"} { continue } @@ -4939,32 +5071,41 @@ proc get_start_x11vnc_cmd {{show_rc 0}} { } } } elseif {[value_is_string $item]} { - if {[info exists menu_var($item)]} { - if {$menu_var($item) != "" - && $menu_var($item) != $unset_str} { - set add 1 - set nitem $item - if {$nitem == "screen_blank"} { - set nitem "sb" - } elseif {$nitem == "xrandr_mode"} { - set nitem "xrandr" - } elseif {$nitem == "wireframe_mode"} { - set nitem "wireframe" - } elseif {$nitem == "solid_color"} { - set nitem "solid" + if {![info exists menu_var($item)]} { + continue + } + if {$menu_var($item) != "" && $menu_var($item) != $unset_str} { + set add 1 + set nitem [get_nitem $item] + + if {[info exists default_var($item)]} { + if {$menu_var($item) == $default_var($item)} { + set add 0; } - if {[info exists default_var($item)]} { - if {$menu_var($item) == $default_var($item)} { - set add 0; + } + if {$add} { + lappend cmd "-$nitem" + set mv $menu_var($item) + + if {[regexp {^~} $mv]} { + if {$item == "auth" || + $item == "rc" || + $item == "accept" || + $item == "connect" || + $item == "allow" || + $item == "passwdfile" || + $item == "o" || + $item == "logfile" || + $item == "remap" || + $item == "httpdir"} { + set mv [tilde_expand $mv] } } - if {$add} { - lappend cmd "-$nitem" - lappend cmd $menu_var($item) - set mt $menu_var($item) - regsub -all {#} $mt {\#} mt - append rc_txt "-$nitem $mt\n" - } + + lappend cmd $mv + set mt $mv + regsub -all {#} $mt {\#} mt + append rc_txt "-$nitem $mt\n" } } } @@ -5073,7 +5214,7 @@ proc run_remote_cmd {opts} { lappend cmd "/dev/null" # lappend cmd "/tmp/nono" - if {0} { + if {0 || $debug} { set str [join $cmd] puts "running: $str" foreach word $cmd { @@ -5170,6 +5311,9 @@ proc change_view_state {} { set new [get_view_variable] + if {![info exists gui_current_state]} { + set gui_current_state "" + } set old $gui_current_state #puts "$old -> $new" diff --git a/x11vnc/tkx11vnc.h b/x11vnc/tkx11vnc.h index 721d936..97d3ae5 100644 --- a/x11vnc/tkx11vnc.h +++ b/x11vnc/tkx11vnc.h @@ -258,9 +258,9 @@ " =0 storepasswd\n" " =GAL LOFF\n" " =GAL Misc-Perms::\n" -" =S alwaysshared\n" -" =S nevershared\n" -" =S dontdisconnect\n" +" =0S alwaysshared\n" +" =0S nevershared\n" +" =0S dontdisconnect\n" " =SQA deny_all\n" " =GAL LOFF\n" "\n" @@ -341,7 +341,8 @@ "server indicating it should shutdown all connections and exit.\n" "\n" "The GUI stays running in case you want to start a new x11vnc or attach\n" -"to another one. Use \\\"Actions -> Quit\\\" if you want to have the gui exit.\n" +"to another one. Use \\\"Actions -> Quit\\\" if you then want to have the\n" +"gui exit. Use \\\"Actions -> stop+quit\\\" to have both exit at once.\n" "\"\n" "\n" " set helptext(show-start-cmd) \"\n" @@ -351,8 +352,10 @@ "debugging the gui. The help item for \\\"Actions -> start\\\" gives the\n" "same info.\n" "\n" -"If you want to load in a saved profile \\\"rc file\\\" use Misc -> rc\n" -"and select the file.\n" +"If you want to load in a saved profile \\\"rc file\\\" use \\\"Misc -> rc\\\"\n" +"and select the file. \\\"Actions -> load-settings\\\" does a similar thing\n" +"with an rc-file, but reading the file and setting the gui variables to\n" +"its values.\n" "\"\n" "\n" " set helptext(debug_gui) \"\n" @@ -399,7 +402,9 @@ "\n" "This action is only available in \\\"startup\\\" mode, not when connected\n" "to a running x11vnc server (in that case the variable settings reflect\n" -"the state of the running x11vnc).\n" +"the state of the running x11vnc). To detach from a running x11vnc\n" +"server use \\\"Actions -> detach\\\"; to completely stop the x11vnc server\n" +"use \\\"Actions -> stop\\\".\n" "\"\n" "\n" " set helptext(defaults-all) \"\n" @@ -408,7 +413,9 @@ "\n" "This action is only available in \\\"startup\\\" mode, not when connected\n" "to a running x11vnc server (in that case the variable settings reflect\n" -"the state of the running x11vnc).\n" +"the state of the running x11vnc). To detach from a running x11vnc\n" +"server use \\\"Actions -> detach\\\"; to completely stop the x11vnc server\n" +"use \\\"Actions -> stop\\\".\n" "\"\n" "\n" " set helptext(load-settings) \"\n" @@ -422,7 +429,9 @@ "\n" "This action is only available in \\\"startup\\\" mode, not when connected\n" "to a running x11vnc server (in that case the variable settings reflect\n" -"the state of the running x11vnc).\n" +"the state of the running x11vnc). To detach from a running x11vnc\n" +"server use \\\"Actions -> detach\\\"; to completely stop the x11vnc server\n" +"use \\\"Actions -> stop\\\".\n" "\"\n" "\n" " set helptext(save-settings) \"\n" @@ -658,6 +667,7 @@ "\n" " set helptext(Misc-Perms:) \"\n" "In this sub-menu we provide some lesser used permission options.\n" +"\n" "Regarding -alwaysshared, -nevershared, and -dontdisconnect, you probably\n" "should never use them and just use x11vnc's -shared and -forever options\n" "instead (these give basically the same functionality and if you mixed\n" @@ -980,8 +990,9 @@ " Anywhere: Control-a invokes \\\"Actions -> attach\\\"\n" " Anywhere: Control-p invokes \\\"Actions -> ping\\\"\n" " Anywhere: Control-u and Control-r invoke \\\"Actions -> update-all\\\"\n" +"\"\n" "\n" -"\n" +"set under_wally \"\n" "Misc:\n" "\n" "Since x11vnc has so many settings and to avoid further confusion,\n" @@ -2174,6 +2185,8 @@ " set val \"\"\n" " } elseif {$item == \"auth\"} {\n" " set val \"\"\n" +" } elseif {$item == \"gui\"} {\n" +" continue\n" " } \n" " # some hacks we do here for now..\n" " if {$item == \"cursor\" && $val == \"\"} {\n" @@ -2182,8 +2195,8 @@ " set val \"always\"\n" " } elseif {$item == \"wirecopyrect\" && $val == \"\"} {\n" " set val \"always\"\n" -" } elseif {$item == \"overlay_nocursor\" && $val == 0} {\n" -" set val 1\n" +"# } elseif {$item == \"overlay_nocursor\" && $val == 0} {\n" +"# set val 1\n" " }\n" "\n" " set default_var($item) $val\n" @@ -2192,6 +2205,94 @@ " }\n" "}\n" "\n" +"proc tilde_expand {file} {\n" +" global env\n" +" if {[file exists $file]} {\n" +" return $file\n" +" }\n" +"\n" +" set user \"\"\n" +" if {[info exists env(USER)]} {\n" +" set user $env(USER)\n" +" }\n" +" if {$user == \"\" && [info exists env(LOGNAME)]} {\n" +" set user $env(LOGNAME)\n" +" }\n" +"\n" +" set home \"\"\n" +" if {[info exists env(HOME)]} {\n" +" set home $env(HOME)\n" +" } elseif {$user != \"\"} {\n" +" set home \"/home/$user\"\n" +" }\n" +"\n" +" if {[regexp {^~} $file]} {\n" +" if {[regexp {^~/} $file]} {\n" +" if {$home != \"\"} {\n" +" regsub {^~} $file $home file\n" +" }\n" +" } else {\n" +" regsub {^~} $file \"/home/\" file\n" +" }\n" +" }\n" +" return $file\n" +"}\n" +"\n" +"proc insert_cmdline_vars {} {\n" +" global env cmd_var menu_var default_var x11vnc_cmdline\n" +" if {![info exists x11vnc_cmdline]} {\n" +" return\n" +" }\n" +" if {$x11vnc_cmdline == \"\"} {\n" +" return\n" +" }\n" +" set cmd_var(novar) 1 \n" +" set str [string trim $x11vnc_cmdline]\n" +"\n" +" while {[regexp -- {^-} $str]} {\n" +" if {[regexp -- {^--*([^ \\t][^ \\t]*)(.*)$} $str m var rest]} {\n" +" set rest [string trim $rest]\n" +" set var [string trim $var]\n" +" if {[regexp {^\\{\\{([^\\}]*)\\}\\}(.*)} $rest m val rest]} {\n" +" set str [string trim $rest]\n" +" set cmd_var($var) $val\n" +" } else {\n" +" set str $rest\n" +" set cmd_var($var) \"boolean\"\n" +" }\n" +" } else {\n" +" break\n" +" }\n" +" }\n" +"\n" +" if {[info exists cmd_var(rc)]} {\n" +" load_settings $cmd_var(rc)\n" +" } elseif {[info exists cmd_var(norc)]} {\n" +" ;\n" +" } else {\n" +" set filex [tilde_expand \"~/.x11vncrc\"]\n" +" if {[file exists $filex]} {\n" +" load_settings $filex\n" +" }\n" +" }\n" +"\n" +" foreach var [array names cmd_var] {\n" +" if {$var == \"novar\"} {\n" +" continue\n" +" }\n" +" if {[regexp {^[ \\t]*$} $var]} {\n" +" continue\n" +" }\n" +" if {[info exists menu_var($var)]} {\n" +" if {$cmd_var($var) == \"boolean\"} {\n" +" set menu_var($var) 1\n" +" } else {\n" +" set menu_var($var) $cmd_var($var)\n" +" }\n" +" }\n" +" }\n" +"}\n" +"\n" "proc copy_default_vars {} {\n" " global menu_var default_var\n" " foreach item [array names default_var] {\n" @@ -2245,22 +2346,25 @@ " }\n" "}\n" "\n" -"proc load_settings {} {\n" -" global menu_var default_var\n" +"proc load_settings {{file \"\"}} {\n" +" global menu_var default_var env\n" "\n" -" if {![info exists menu_var(load-settings)]} {\n" -" return\n" +" if {$file == \"\"} {\n" +" if {![info exists menu_var(load-settings)]} {\n" +" return\n" +" }\n" +" set file $menu_var(load-settings)\n" " }\n" -" set file $menu_var(load-settings)\n" " if {$file == \"\"} {\n" " return\n" " }\n" "\n" " set fh \"\"\n" -" catch {set fh [open $file \"r\"]}\n" +" set filex [tilde_expand $file]\n" +" catch {set fh [open $filex \"r\"]}\n" "\n" " if {$fh == \"\"} {\n" -" append_text \"load_settings: *** failed to open $file ***\\n\"\n" +" append_text \"load_settings: *** failed to open $filex ***\\n\"\n" " return\n" " }\n" " copy_default_vars\n" @@ -2287,6 +2391,9 @@ " }\n" " close $fh\n" "\n" +" set count 0\n" +" set parms \"\"\n" +"\n" " foreach line [split $str \"\\n\"] {\n" " set line [string trim $line]\n" " regsub {^--*} $line \"\" line\n" @@ -2297,16 +2404,31 @@ " if {[regexp {^[ \\t]*$} $item]} {\n" " continue\n" " }\n" +" if {$item == \"gui\"} {\n" +" continue\n" +" }\n" " if {[info exists menu_var($item)]} {\n" " if {[value_is_bool $item]} {\n" " set menu_var($item) 1\n" +" incr count\n" +" append parms \" -$item\\n\"\n" " } elseif {[value_is_string $item]} {\n" " if {$value != \"\"} {\n" " set menu_var($item) $value\n" +" set nitem [get_nitem $item]\n" +" append parms \" -$nitem $value\\n\"\n" +" incr count\n" " }\n" " }\n" " }\n" " }\n" +" append_text \"loaded $count parameter settings from $filex\"\n" +" if {$count > 0} {\n" +" append_text \":\\n\"\n" +" append_text $parms\n" +" } else {\n" +" append_text \".\\n\"\n" +" }\n" "}\n" "\n" "proc save_settings {} {\n" @@ -2367,6 +2489,7 @@ " if {$file == \"\"} {\n" " return\n" " }\n" +" set file [tilde_expand $file]\n" " append_text \"\\nSaving current settings to $file ...\\n\" \n" " if {[file exists $file]} {\n" " set backup \"${file}~\"\n" @@ -2531,7 +2654,8 @@ "\n" "proc show_logfile {} {\n" " global menu_var unset_str\n" -" set logfile $menu_var(logfile)\n" +"\n" +" set logfile [tilde_expand $menu_var(logfile)]\n" " \n" " if {$logfile == \"\" || $logfile == $unset_str} {\n" " set txt \"\\nNo logfile was specified at x11vnc startup.\\n\\n\" \n" @@ -3849,6 +3973,8 @@ " button $w.b -text OK -command \"destroy $w\" -font $bfont\n" " bind $w.e <Return> \"update; after 100; destroy $w\"\n" "\n" +" wm title $w \"New Client\"\n" +"\n" " pack $w.l $w.e $w.b -side left -pady 1m -padx 1m\n" " focus $w.e\n" " center_win $w\n" @@ -4344,6 +4470,8 @@ "\n" " wm minsize . 1 1\n" "\n" +" set gui_current_state \"\"\n" +"\n" " if {$mode == \"full\"} {\n" " frame $fw\n" " set icon_mode 0\n" @@ -4403,6 +4531,8 @@ " copy_default_vars\n" " if {$x11vnc_connect} {\n" " try_connect_and_query_all\n" +" } else {\n" +" insert_cmdline_vars\n" " }\n" " } else {\n" " set_name \"RESTORE\"\n" @@ -4737,13 +4867,12 @@ " }\n" " if {$item == \"debug_gui\"} {\n" " continue\n" -" }\n" -" if {$item == \"WindowView\"} {\n" +" } elseif {$item == \"WindowView\"} {\n" " continue\n" -" }\n" -" if {$item == \"rc\" || $item == \"norc\"} {\n" +" } elseif {$item == \"rc\" || $item == \"norc\"} {\n" " continue\n" " }\n" +"\n" " set def \"\"\n" " if {[info exists default_var($item)]} {\n" " set def $default_var($item)\n" @@ -4774,16 +4903,7 @@ " set ntab 3\n" "\n" " if {$item == \"gui\" || [value_is_string $item]} {\n" -" set nitem $item\n" -" if {$nitem == \"screen_blank\"} {\n" -" set nitem \"sb\"\n" -" } elseif {$nitem == \"xrandr_mode\"} {\n" -" set nitem \"xrandr\"\n" -" } elseif {$nitem == \"wireframe_mode\"} {\n" -" set nitem \"wireframe\"\n" -" } elseif {$nitem == \"solid_color\"} {\n" -" set nitem \"solid\"\n" -" }\n" +" set nitem [get_nitem $item]\n" "\n" " if {$mv == \"\" && $def != \"\"} {\n" " set qst $hmm\n" @@ -4877,8 +4997,22 @@ " append_text \"$msg\\n\"\n" "}\n" "\n" +"proc get_nitem {item} {\n" +" set nitem $item\n" +" if {$nitem == \"screen_blank\"} {\n" +" set nitem \"sb\"\n" +" } elseif {$nitem == \"xrandr_mode\"} {\n" +" set nitem \"xrandr\"\n" +" } elseif {$nitem == \"wireframe_mode\"} {\n" +" set nitem \"wireframe\"\n" +" } elseif {$nitem == \"solid_color\"} {\n" +" set nitem \"solid\"\n" +" }\n" +" return $nitem\n" +"}\n" +"\n" "proc get_start_x11vnc_cmd {{show_rc 0}} {\n" -" global menu_var default_var unset_str x11vnc_prog\n" +" global cmd_var menu_var default_var unset_str x11vnc_prog\n" "\n" " set xterm_cmd \"xterm -iconic -geometry 80x35 -title x11vnc-console -e\"\n" "\n" @@ -4886,24 +5020,26 @@ "\n" " lappend cmd $x11vnc_prog\n" "\n" +" lappend cmd \"-gui\"\n" +" lappend cmd \"none\"\n" +"\n" " set rc_txt \"\"\n" "\n" " set saw_id 0\n" "\n" " foreach item [lsort [array names menu_var]] {\n" " if {$item == \"gui\"} {\n" -" ;\n" +" continue\n" " } elseif {![active_when_starting $item]} {\n" " continue\n" " } elseif {[is_action $item]} {\n" " continue\n" -" }\n" -" if {$item == \"debug_gui\"} {\n" +" } elseif {$item == \"debug_gui\"} {\n" " continue\n" -" }\n" -" if {$item == \"WindowView\"} {\n" +" } elseif {$item == \"WindowView\"} {\n" " continue\n" " }\n" +"\n" " if {$item == \"id\" || $item == \"sid\"} {\n" " set val $menu_var($item);\n" " if {$val == \"0x0\" || $val == \"root\"} {\n" @@ -4915,17 +5051,13 @@ " }\n" " if {$item == \"id\"} {\n" " set saw_id 1\n" -" }\n" -" if {$item == \"httpport\" && $menu_var($item) == \"0\"} {\n" +" } elseif {$item == \"httpport\" && $menu_var($item) == \"0\"} {\n" " continue\n" -" }\n" -" if {$item == \"progressive\" && $menu_var($item) == \"0\"} {\n" +" } elseif {$item == \"progressive\" && $menu_var($item) == \"0\"} {\n" " continue\n" -" }\n" -" if {$item == \"dontdisconnect\" && $menu_var($item) == \"-1\"} {\n" +" } elseif {$item == \"dontdisconnect\" && $menu_var($item) == \"-1\"} {\n" " continue\n" -" }\n" -" if {$item == \"alwaysshared\" && $menu_var($item) == \"-1\"} {\n" +" } elseif {$item == \"alwaysshared\" && $menu_var($item) == \"-1\"} {\n" " continue\n" " }\n" "\n" @@ -4945,32 +5077,41 @@ " }\n" " }\n" " } elseif {[value_is_string $item]} {\n" -" if {[info exists menu_var($item)]} {\n" -" if {$menu_var($item) != \"\"\n" -" && $menu_var($item) != $unset_str} {\n" -" set add 1\n" -" set nitem $item\n" -" if {$nitem == \"screen_blank\"} {\n" -" set nitem \"sb\"\n" -" } elseif {$nitem == \"xrandr_mode\"} {\n" -" set nitem \"xrandr\"\n" -" } elseif {$nitem == \"wireframe_mode\"} {\n" -" set nitem \"wireframe\"\n" -" } elseif {$nitem == \"solid_color\"} {\n" -" set nitem \"solid\"\n" +" if {![info exists menu_var($item)]} {\n" +" continue\n" +" }\n" +" if {$menu_var($item) != \"\" && $menu_var($item) != $unset_str} {\n" +" set add 1\n" +" set nitem [get_nitem $item]\n" +"\n" +" if {[info exists default_var($item)]} {\n" +" if {$menu_var($item) == $default_var($item)} {\n" +" set add 0;\n" " }\n" -" if {[info exists default_var($item)]} {\n" -" if {$menu_var($item) == $default_var($item)} {\n" -" set add 0;\n" +" }\n" +" if {$add} {\n" +" lappend cmd \"-$nitem\"\n" +" set mv $menu_var($item)\n" +"\n" +" if {[regexp {^~} $mv]} {\n" +" if {$item == \"auth\" ||\n" +" $item == \"rc\" ||\n" +" $item == \"accept\" || \n" +" $item == \"connect\" || \n" +" $item == \"allow\" || \n" +" $item == \"passwdfile\" || \n" +" $item == \"o\" || \n" +" $item == \"logfile\" || \n" +" $item == \"remap\" || \n" +" $item == \"httpdir\"} { \n" +" set mv [tilde_expand $mv]\n" " }\n" " }\n" -" if {$add} {\n" -" lappend cmd \"-$nitem\"\n" -" lappend cmd $menu_var($item)\n" -" set mt $menu_var($item)\n" -" regsub -all {#} $mt {\\#} mt\n" -" append rc_txt \"-$nitem $mt\\n\"\n" -" }\n" +" \n" +" lappend cmd $mv\n" +" set mt $mv\n" +" regsub -all {#} $mt {\\#} mt\n" +" append rc_txt \"-$nitem $mt\\n\"\n" " }\n" " }\n" " }\n" @@ -5079,7 +5220,7 @@ " lappend cmd \"/dev/null\"\n" "# lappend cmd \"/tmp/nono\"\n" "\n" -" if {0} {\n" +" if {0 || $debug} {\n" " set str [join $cmd]\n" " puts \"running: $str\"\n" " foreach word $cmd {\n" @@ -5176,6 +5317,9 @@ "\n" " set new [get_view_variable]\n" "\n" +" if {![info exists gui_current_state]} {\n" +" set gui_current_state \"\"\n" +" }\n" " set old $gui_current_state\n" " #puts \"$old -> $new\"\n" "\n" diff --git a/x11vnc/x11vnc.1 b/x11vnc/x11vnc.1 index fc6a224..9c72a16 100644 --- a/x11vnc/x11vnc.1 +++ b/x11vnc/x11vnc.1 @@ -2,7 +2,7 @@ .TH X11VNC "1" "July 2005" "x11vnc " "User Commands" .SH NAME x11vnc - allow VNC connections to real X11 displays - version: 0.7.2, lastmod: 2005-07-10 + version: 0.7.2, lastmod: 2005-07-12 .SH SYNOPSIS .B x11vnc [OPTION]... @@ -1804,6 +1804,10 @@ given by hexnumber. Use =noadvanced to disable the full gui. (To supply more than one, use "+" sign). E.g. \fB-gui\fR tray=setpass and \fB-gui\fR icon=0x3600028 .IP +Other modes: "full", the default and need not be +specified. "\fB-gui\fR \fInone\fR", do not show a gui, useful +to override a ~/.x11vncrc setting, etc. +.IP 5) When "geom=+X+Y" is specified, that geometry is passed to the gui toplevel. This is the icon in icon/tray mode, or the full gui otherwise. You can diff --git a/x11vnc/x11vnc.c b/x11vnc/x11vnc.c index 48e646d..771ab14 100644 --- a/x11vnc/x11vnc.c +++ b/x11vnc/x11vnc.c @@ -387,7 +387,7 @@ double xdamage_scheduled_mark = 0.0; sraRegionPtr xdamage_scheduled_mark_region = NULL; /* date +'lastmod: %Y-%m-%d' */ -char lastmod[] = "0.7.2 lastmod: 2005-07-10"; +char lastmod[] = "0.7.2 lastmod: 2005-07-12"; int hack_val = 0; /* X display info */ @@ -531,7 +531,9 @@ int cursor_x, cursor_y; /* x and y from the viewer(s) */ int button_change_x, button_change_y; int got_user_input = 0; int got_pointer_input = 0; +int got_pointer_calls = 0; int got_keyboard_input = 0; +int got_keyboard_calls = 0; int urgent_update = 0; int last_keyboard_keycode = 0; rfbBool last_rfb_down = FALSE; @@ -800,7 +802,9 @@ enum { char *rc_rcfile = NULL; /* -rc */ +int rc_rcfile_default = 0; int rc_norc = 0; +int got_norc = 0; int opts_bg = 0; #ifndef VNCSHARED @@ -9586,6 +9590,7 @@ void keyboard(rfbBool down, rfbKeySym keysym, rfbClientPtr client) { static double max_keyrepeat_last_time = 0.0; dtime0(&tnow); + got_keyboard_calls++; if (debug_keyboard) { char *str; @@ -10520,6 +10525,10 @@ void pointer(int mask, int x, int y, rfbClientPtr client) { int sent = 0, buffer_it = 0; double now; + if (mask >= 0) { + got_pointer_calls++; + } + if (debug_pointer && mask >= 0) { static int show_motion = -1; static double last_pointer = 0.0; @@ -12573,13 +12582,13 @@ int send_remote_cmd(char *cmd, int query, int wait) { } if (in != NULL) { - fprintf(stderr, "sending remote command: \"%s\"\nvia connect" - " file: %s\n", cmd, client_connect_file); + fprintf(stderr, ">>> sending remote command: \"%s\"\n via" + " connect file: %s\n", cmd, client_connect_file); fprintf(in, "%s\n", cmd); fclose(in); } else { - fprintf(stderr, "sending remote command: \"%s\" via VNC_CONNECT" - " X property.\n", cmd); + fprintf(stderr, ">>> sending remote command: \"%s\" via" + " VNC_CONNECT X property.\n", cmd); set_vnc_connect_prop(cmd); XFlush(dpy); } @@ -16090,9 +16099,13 @@ char *process_remote_cmd(char *cmd, int stringonly) { } else if (!strcmp(p, "flag")) { snprintf(buf, bufn, "aro=%s:%s", p, NONUL(flagfile)); } else if (!strcmp(p, "rc")) { - snprintf(buf, bufn, "aro=%s:%s", p, NONUL(rc_rcfile)); + char *s = rc_rcfile; + if (rc_rcfile_default) { + s = NULL; + } + snprintf(buf, bufn, "aro=%s:%s", p, NONUL(s)); } else if (!strcmp(p, "norc")) { - snprintf(buf, bufn, "aro=%s:%d", p, rc_norc); + snprintf(buf, bufn, "aro=%s:%d", p, got_norc); } else if (!strcmp(p, "h") || !strcmp(p, "help") || !strcmp(p, "V") || !strcmp(p, "version") || !strcmp(p, "lastmod")) { @@ -18230,6 +18243,8 @@ void restore_cursor_shape_updates(rfbScreenInfoPtr s) { void disable_cursor_shape_updates(rfbScreenInfoPtr s) { rfbClientIteratorPtr iter; rfbClientPtr cl; + static int changed = 0; + int count = 0; if (! s || ! s->clientHead) { return; @@ -18242,9 +18257,17 @@ void disable_cursor_shape_updates(rfbScreenInfoPtr s) { if (cl->enableCursorShapeUpdates) { cd->had_cursor_shape_updates = 1; + count++; + if (debug_pointer) { + rfbLog("%s disable HCSU\n", cl->host); + } } if (cl->enableCursorPosUpdates) { cd->had_cursor_pos_updates = 1; + count++; + if (debug_pointer) { + rfbLog("%s disable HCPU\n", cl->host); + } } cl->enableCursorShapeUpdates = FALSE; @@ -18252,6 +18275,10 @@ void disable_cursor_shape_updates(rfbScreenInfoPtr s) { cl->cursorWasChanged = FALSE; } rfbReleaseClientIterator(iter); + + if (count) { + changed = 1; + } } int cursor_shape_updates_clients(rfbScreenInfoPtr s) { @@ -23977,7 +24004,7 @@ void run_gui(char *gui_xdisplay, int connect_to_x11vnc, int simple_gui, FILE *pipe, *tmpf; if (*gui_code == '\0') { - rfbLog("gui not compiled into this program.\n"); + rfbLog("gui: gui not compiled into this program.\n"); exit(0); } if (getenv("DISPLAY") != NULL) { @@ -23990,7 +24017,7 @@ void run_gui(char *gui_xdisplay, int connect_to_x11vnc, int simple_gui, } if (connect_to_x11vnc) { int rc, i; - rfbLogEnable(0); + rfbLogEnable(1); if (! client_connect_file) { if (getenv("XAUTHORITY") != NULL) { old_xauth = strdup(getenv("XAUTHORITY")); @@ -24008,7 +24035,7 @@ void run_gui(char *gui_xdisplay, int connect_to_x11vnc, int simple_gui, dpy = XOpenDisplay(x11vnc_xdisplay); } if (! dpy) { - fprintf(stderr, "gui: could not open x11vnc " + rfbLog("gui: could not open x11vnc " "display: %s\n", NONUL(x11vnc_xdisplay)); exit(1); } @@ -24018,16 +24045,18 @@ void run_gui(char *gui_xdisplay, int connect_to_x11vnc, int simple_gui, } usleep(2200*1000); fprintf(stderr, "\n"); + rfbLog("gui: trying to contact a x11vnc server at X display " + "%s ...\n", NONUL(x11vnc_xdisplay)); for (i=0; i<try_max; i++) { usleep(sleep*1000); - fprintf(stderr, "gui: pinging %s try=%d ...\n", + rfbLog("gui: pinging %s try=%d ...\n", NONUL(x11vnc_xdisplay), i+1); rc = send_remote_cmd("qry=ping", 1, 1); if (rc == 0) { break; } if (parent && mypid != parent && kill(parent, 0) != 0) { - fprintf(stderr, "gui: parent process %d has gone" + rfbLog("gui: parent process %d has gone" " away: bailing out.\n", parent); rc = 1; break; @@ -24038,10 +24067,10 @@ void run_gui(char *gui_xdisplay, int connect_to_x11vnc, int simple_gui, set_env("X11VNC_AUTH_FILE", getenv("XAUTHORITY")); } if (rc == 0) { - fprintf(stderr, "gui: ping succeeded.\n"); + rfbLog("gui: ping succeeded.\n"); set_env("X11VNC_CONNECT", "1"); } else { - fprintf(stderr, "gui: could not connect to: '%s', try" + rfbLog("gui: could not connect to: '%s', try" " again manually.\n", x11vnc_xdisplay); } if (client_connect_file) { @@ -24063,6 +24092,7 @@ void run_gui(char *gui_xdisplay, int connect_to_x11vnc, int simple_gui, } free(old_xauth); } + rfbLogEnable(0); } orig_path = getenv("PATH"); @@ -24211,7 +24241,7 @@ void do_gui(char *opts, int sleep) { int got_gui_xdisplay = 0; int start_x11vnc = 1; int connect_to_x11vnc = 0; - int simple_gui = 0; + int simple_gui = 0, none_gui = 0; Display *test_dpy; if (opts) { @@ -24245,6 +24275,8 @@ void do_gui(char *opts, int sleep) { } else if (!strcmp(p, "wait")) { start_x11vnc = 0; connect_to_x11vnc = 0; + } else if (!strcmp(p, "none")) { + none_gui = 1; } else if (!strcmp(p, "conn") || !strcmp(p, "connect")) { start_x11vnc = 0; connect_to_x11vnc = 1; @@ -24255,6 +24287,8 @@ void do_gui(char *opts, int sleep) { if ((q = strchr(p, '=')) != NULL) { icon_mode_font = strdup(q+1); } + } else if (!strcmp(p, "full")) { + ; } else if (strstr(p, "tray") == p || strstr(p, "icon") == p) { char *q; icon_mode = 1; @@ -24279,6 +24313,13 @@ void do_gui(char *opts, int sleep) { p = strtok(NULL, ","); } free(s); + + if (none_gui) { + if (!start_x11vnc) { + exit(0); + } + return; + } if (start_x11vnc) { connect_to_x11vnc = 1; } @@ -26425,6 +26466,32 @@ int scrollability(Window win, int set) { return set; } +void eat_viewonly_input(int max_eat, int keep) { + int i, gp, gk; + + for (i=0; i<max_eat; i++) { + int cont = 0; + gp = got_pointer_calls; + gk = got_keyboard_calls; + rfbCFD(0); + if (got_pointer_calls > gp) { + if (debug_pointer) { + rfbLog("eat_viewonly_input: pointer: %d\n", i); + } + cont++; + } + if (got_keyboard_calls > gk) { + if (debug_keyboard) { + rfbLog("eat_viewonly_input: keyboard: %d\n", i); + } + cont++; + } + if (i >= keep - 1 && ! cont) { + break; + } + } +} + int eat_pointer(int max_ptr_eat, int keep) { int i, count = 0, gp = got_pointer_input; @@ -29585,7 +29652,9 @@ static void watch_loop(void) { got_user_input = 0; got_pointer_input = 0; + got_pointer_calls = 0; got_keyboard_input = 0; + got_keyboard_calls = 0; urgent_update = 0; if (! use_threads) { @@ -29614,6 +29683,12 @@ if (debug_scroll) fprintf(stderr, "watch_loop: LOOP-BACK: %d\n", ret); continue; } } + + /* watch for viewonly input piling up: */ + if ((got_pointer_calls > got_pointer_input) + || (got_keyboard_calls > got_keyboard_input)) { + eat_viewonly_input(10, 3); + } } else { if (0 && use_xrecord) { /* XXX not working */ @@ -31174,6 +31249,10 @@ static void print_help(int mode) { " full gui. (To supply more than one, use \"+\" sign).\n" " E.g. -gui tray=setpass and -gui icon=0x3600028\n" "\n" +" Other modes: \"full\", the default and need not be\n" +" specified. \"-gui none\", do not show a gui, useful\n" +" to override a ~/.x11vncrc setting, etc.\n" +"\n" " 5) When \"geom=+X+Y\" is specified, that geometry\n" " is passed to the gui toplevel. This is the icon in\n" " icon/tray mode, or the full gui otherwise. You can\n" @@ -31868,6 +31947,7 @@ static void check_rcfile(int argc, char **argv) { } if (!strcmp(argv[i], "-norc")) { norc = 1; + got_norc = 1; } if (!strcmp(argv[i], "-QD")) { norc = 1; @@ -31909,6 +31989,7 @@ static void check_rcfile(int argc, char **argv) { norc = 1; } else { rc_rcfile = strdup(rcfile); + rc_rcfile_default = 1; } } } @@ -31975,7 +32056,7 @@ static void check_rcfile(int argc, char **argv) { c = *q; q++; } - if (q != p) { + if (q != p && !cont) { if (*q == '\0') { q--; } @@ -32252,7 +32333,7 @@ void nopassword_warning_msg(int gotloc) { fprintf(stderr, "%s", str1); fflush(stderr); - usleep(2500 * 1000); + usleep(2000 * 1000); fprintf(stderr, "%s", str2); if (gotloc) { fprintf(stderr, "%s", str3); @@ -32940,6 +33021,10 @@ int main(int argc, char* argv[]) { if (!got_passwd && !got_rfbauth && !got_passwdfile && !nopw) { running_without_passwd = 1; } + if (launch_gui && (query_cmd || remote_cmd)) { + launch_gui = 0; + gui_str = NULL; + } if (launch_gui) { int sleep = 0; if (running_without_passwd && !quiet) { |
