diff options
Diffstat (limited to 'x11vnc/README')
| -rw-r--r-- | x11vnc/README | 374 |
1 files changed, 203 insertions, 171 deletions
diff --git a/x11vnc/README b/x11vnc/README index 711e12b..6ba11b4 100644 --- a/x11vnc/README +++ b/x11vnc/README @@ -1,5 +1,5 @@ -x11vnc README file Date: Sat Jan 15 23:37:28 EST 2005 +x11vnc README file Date: Sun Jan 23 23:48:41 EST 2005 The following information is taken from these URLs: @@ -367,7 +367,7 @@ vncviewer -via $host localhost:0 # must be TightVNC vncviewer. # Build script for Solaris, etc, with gcc, libjpeg and libz in # non-standard locations. -PATH=/path/to/gcc/bin:/usr/ccs/bin:$PATH # set to get gcc +PATH=/path/to/gcc/bin:/usr/ccs/bin:$PATH # set to get your gcc JPEG=/path/to/jpeg # maybe "/usr/local", "/usr/sfw", or "/opt/sfw" ZLIB=/path/to/zlib # maybe "/usr/local", "/usr/sfw", or "/opt/sfw" @@ -383,7 +383,9 @@ LDFLAGS="-L $JPEG/lib -R $JPEG/lib -L $ZLIB/lib -R $ZLIB/lib" CPPFLAGS="$CPPFLAGS -I /usr/openwin/include" LDFLAGS="$LDFLAGS -L /usr/openwin/lib -R /usr/openwin/lib" -# This only applies to Solaris 10 or later (XFIXES and DAMAGE) +# This only applies to Solaris 10 or later (XFIXES, DAMAGE, and RANDR) +CPPFLAGS="$CPPFLAGS -I /usr/X11/include" +LDFLAGS="$LDFLAGS -L /usr/X11/lib -R /usr/X11/lib" LDFLAGS="$LDFLAGS -L /usr/openwin/sfw/lib -R /usr/openwin/sfw/lib" # Everything needs to built with _REENTRANT for thread safe errno: @@ -786,42 +788,45 @@ ls -l ./x11vnc/x11vnc [94]Q-51: 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? - [95]Q-52: The machine where I run x11vnc has an AltGr key, but the + [95]Q-52: The x11vnc -norepeat mode is in effect, but I still get + repeated keystrokes!! + + [96]Q-53: 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? - [96]Q-53: I have a Sun machine I run x11vnc on. Its Sun keyboard has + [97]Q-54: 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) - [97]Q-54: Can I map a keystroke to a mouse button click on the remote + [98]Q-55: Can I map a keystroke to a mouse button click on the remote machine? [Screen Related Issues and Features] - [98]Q-55: The remote display is larger (in number of pixels) than the + [99]Q-56: 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? - [99]Q-56: Does x11vnc support server-side framebuffer scaling? (E.g. + [100]Q-57: Does x11vnc support server-side framebuffer scaling? (E.g. to make the desktop smaller). - [100]Q-57: Does x11vnc work with Xinerama? (i.e. multiple monitors + [101]Q-58: Does x11vnc work with Xinerama? (i.e. multiple monitors joined together to form one big, single screen). - [101]Q-58: Can I use x11vnc on a multi-headed display that is not + [102]Q-59: Can I use x11vnc on a multi-headed display that is not Xinerama (i.e. separate screens :0.0, :0.1, ... for each monitor)? - [102]Q-59: Does x11vnc support the XRANDR (X Resize, Rotate and + [103]Q-60: Does x11vnc support the XRANDR (X Resize, Rotate and Reflection) extension? Whenever I rotate or resize the screen x11vnc just seems to crash. - [103]Q-60: Why is the view in my VNC viewer completely black? Or why + [104]Q-61: Why is the view in my VNC viewer completely black? Or why is everything flashing around randomly? - [104]Q-61: I use Linux Virtual Consoles (VC's) to implement 'Fast User + [105]Q-62: 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 @@ -829,7 +834,7 @@ ls -l ./x11vnc/x11vnc otherwise all messed up unless the X session x11vnc is attached to is in the active VC? - [105]Q-62: I am using x11vnc where my local machine has "popup/hidden + [106]Q-63: 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 @@ -837,10 +842,10 @@ ls -l ./x11vnc/x11vnc [Misc: Clipboard, Beeps, etc.] - [106]Q-63: Does the Clipboard/Selection get transferred between the + [107]Q-64: Does the Clipboard/Selection get transferred between the vncviewer and the X display? - [107]Q-64: Why don't I hear the "Beeps" in my X session (e.g. when + [108]Q-65: Why don't I hear the "Beeps" in my X session (e.g. when typing tput bel in an xterm)? _________________________________________________________________ @@ -941,7 +946,7 @@ ls -l ./x11vnc/x11vnc is a workaround for Solaris 2.5.1 (and perhaps earlier): First use the environment settings (CPPFLAGS, LDFLAGS, etc.) in the - above [108]Solaris build script to run the configure command. That + above [109]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 @@ -978,18 +983,18 @@ typedef unsigned int in_addr_t; Q-4: Where can I get a precompiled x11vnc binary for my Operating System? - Hopefully the [109]build steps above and [110]FAQ provide enough info + Hopefully the [110]build steps above and [111]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 made by other groups available at the following locations: - Debian: (.deb) [111]http://packages.debian.org/x11vnc + Debian: (.deb) [112]http://packages.debian.org/x11vnc - Slackware: (.tgz) [112]http://www.linuxpackages.net/ Redhat/Fedora: - (.rpm) [113]http://dag.wieers.com/packages/x11vnc/ wwexptools: (.tgz) - [114]http://www.bell-labs.com/project/wwexptools/packages.html The + Slackware: (.tgz) [113]http://www.linuxpackages.net/ Redhat/Fedora: + (.rpm) [114]http://dag.wieers.com/packages/x11vnc/ wwexptools: (.tgz) + [115]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 @@ -1001,12 +1006,12 @@ typedef unsigned int in_addr_t; 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 [115]build notes above for where to download libz and libjpeg, and + the [116]build notes above for where to download libz and libjpeg, and then build everything with gcc. If the above binaries don't work and building x11vnc on your OS fails (and all else fails!) you can try one of my motley collection of - [116]test binaries. Some may be old, some may have extra debugging + [117]test binaries. Some may be old, some may have extra debugging output, etc. One may work on your OS, but please understand they are test/experimental binaries not intended for general usage like the above precompiled ones from 3rd parties. @@ -1028,14 +1033,14 @@ typedef unsigned int in_addr_t; To obtain VNC viewers for the viewing side (Windows, Mac OS, or Unix) try here: - * [117]http://www.tightvnc.com/download.html - * [118]http://www.realvnc.com/download-free.html - * [119]http://sourceforge.net/projects/cotvnc/ + * [118]http://www.tightvnc.com/download.html + * [119]http://www.realvnc.com/download-free.html + * [120]http://sourceforge.net/projects/cotvnc/ Q-6: How can I see all of x11vnc's command line options and documentation on how to use them? - Run: x11vnc -help The output is listed [120]here as well. + Run: x11vnc -help The output is listed [121]here as well. Q-7: 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? @@ -1090,7 +1095,7 @@ display :0 As of Apr/2004 the above fix only works for BSD signal systems (Linux, FreeBSD, ...) For SYSV systems there is a workaround in my - [121]x11vnc.c file. It also has an option -sigpipe exit to have x11vnc + [122]x11vnc.c file. It also has an option -sigpipe exit to have x11vnc clean up and exit upon receiving SIGPIPE. [Win2VNC Related] @@ -1105,16 +1110,16 @@ display :0 secondary display (X11). Then start up Win2VNC on the primary display (Windows) referring it to the secondary display. - This will also work X11 to X11 using [122]x2vnc, however you would + This will also work X11 to X11 using [123]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: - * [123]Original Win2VNC - * [124]Enhanced Win2VNC and [125]sourceforge link - * [126]x2vnc - * [127]x2x also [128]here - * [129]zvnc (MorphOS) + * [124]Original Win2VNC + * [125]Enhanced Win2VNC and [126]sourceforge link + * [127]x2vnc + * [128]x2x also [129]here + * [130]zvnc (MorphOS) All of them (except x2x) will work with x11vnc. @@ -1169,7 +1174,7 @@ display :0 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 [130]previous question regarding 8 bpp + You may want to review the [131]previous question regarding 8 bpp PseudoColor. On some hardware (Sun/SPARC, Sgi), the -overlay option discussed a @@ -1206,24 +1211,24 @@ TrueColor defdepth 24 "-cc 4" X server command line option to get a depth 24 default visual. The -overlay mode: Another option is if the system with overlay - visuals is a Sun system running Solaris you can use the -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.This is useful for Legacy applications (older - versions of Cadence CAD apps are mentioned by x11vnc users) that - require the default depth be 8bpp, or will use a 8bpp visual even if - depth 24 visuals are available, and so the default depth workaround - described in the previous paragraph is not sufficient for these apps. - The -overlay mode should also work on IRIX machines using - XReadDisplay(3X11). + visuals is a Sun system running Solaris or Sgi running IRIX you can + use the -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 + Cadence CAD apps are mentioned by x11vnc users) that require the + default depth be 8bpp, or will use a 8bpp visual even if depth 24 + visuals are available, and so the default depth workaround described + in the previous paragraph is not sufficient for these apps. Misc. notes on -overlay mode: An amusing by-product of -overlay mode is that mouse cursor shape is correct. The -overlay mode may be somewhat slower than normal mode due to the extra framebuffer - manipulations that must be performed. Also, there is a bug in that for - some popup menus, the windows they overlap will have painting problems - while the popup is up (a workaround is to disable SaveUnders by - passing -su to Xsun, e.g. in your /etc/dt/config/Xservers file). + manipulations that must be performed. Also, on Solaris there is a bug + in that for some popup menus, the windows they overlap will have + painting problems while the popup is up (a workaround is to disable + SaveUnders by passing -su to Xsun, e.g. in your + /etc/dt/config/Xservers file). Still not working? Run xwininfo on the application with the messed up colors to verify that the depth of its visual is different from the @@ -1246,7 +1251,7 @@ TrueColor defdepth 24 the desired application window. After clicking, it will print out much information, including the window id. Also, the visual and depth of the window printed out is often useful in debugging x11vnc - [131]problems. + [132]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 @@ -1352,7 +1357,7 @@ central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - xauth(1) manpage for more details. If the display name needs to be changed between the two hosts, see - [132]this note on the xauth add ... command. + [133]this note on the xauth add ... command. A less secure option is to run something like "xhost +127.0.0.1" to allow cookie-free local access for x11vnc. @@ -1361,7 +1366,7 @@ central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - accounts, NFS, etc. you'll need to contact your system administrator to set something up. - Not recommended, but as a last resort, you could have x11vnc [133]poll + Not recommended, but as a last resort, you could have x11vnc [134]poll the Xterminal over the network. Note: use of Display Manager (gdm, kdm, ...) auth cookie files (i.e. @@ -1429,10 +1434,10 @@ central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - -shared option to have x11vnc allow multiple clients to connect simultaneously. - Recommended additional safety measures include using ssh ([134]see + Recommended additional safety measures include using ssh ([135]see above), stunnel, or a VPN to authenticate and encrypt the viewer - connections or to at least use the -rfbauth passwd-file [135]option to - use VNC password protection (or [136]-passwdfile) It is up to you to + connections or to at least use the -rfbauth passwd-file [136]option to + use VNC password protection (or [137]-passwdfile) It is up to you to apply these security measures, they will not be done for you automatically. @@ -1468,7 +1473,7 @@ central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - is "vnc", e.g.: vnc: 192.168.100.3 .example.com - Note that if you run x11vnc out of [137]inetd you do not need to build + Note that if you run x11vnc out of [138]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. @@ -1512,7 +1517,7 @@ central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - 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 [138]ftp://ftp.x.org/ + is available at [139]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 @@ -1551,7 +1556,7 @@ elif [ $rc = 4 ]; then fi exit 1 - Stefan Radman has written a nice dtksh script [139]dtVncPopup for use + Stefan Radman has written a nice dtksh script [140]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. @@ -1587,14 +1592,14 @@ exit 1 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 [140]-passwdfile and -passwd/-viewpasswd plain + x11vnc also has the [141]-passwdfile and -passwd/-viewpasswd plain text (i.e. not obscured like the -rfbauth VNC passwords) password options. Q-26: 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 [141]how to tunnel VNC via + See the description earlier on this page on [142]how to tunnel VNC via SSH from Unix to Unix. A number of ways are described along with some issues you may encounter. @@ -1604,7 +1609,7 @@ exit 1 Q-27: How can I tunnel my connection to x11vnc via an encrypted SSH channel from Windows using an SSH client like Putty? - [142]Above we described how to tunnel VNC via SSH from Unix to Unix, + [143]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 @@ -1637,7 +1642,7 @@ exit 1 you'll need to do a second login (ssh or rsh) to the workstation machine 'otherhost' and then start up x11vnc on it. - As discussed [143]above another option is to first start the VNC + As discussed [144]above another option is to first start the VNC viewer in "listen" mode, and then launch x11vnc with the "-connection localhost" option to establish the reverse connection. In this case a Remote port redirection (not Local) is needed for port 5500 instead of @@ -1658,7 +1663,7 @@ exit 1 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 - [144]elsewhere on this page. Of course a malicious user could allow + [145]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 sneak in through the @@ -1734,7 +1739,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 [145]blockdpy.c The idea behind it is simple (but + source for it is [146]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 @@ -1781,11 +1786,11 @@ exit 1 # reject it permissions. Here are some ideas: - * Use the description under "Continuously" in the [146]FAQ on x11vnc + * Use the description under "Continuously" in the [147]FAQ on x11vnc and Display Managers - * Use the description in the [147]FAQ on x11vnc and inetd(1) + * Use the description in the [148]FAQ on x11vnc and inetd(1) * Start x11vnc from $HOME/.xsession (or $HOME/.xinitrc) - * Although less reliable, see the [148]x11vnc_loop rc.local hack + * Although less reliable, see the [149]x11vnc_loop rc.local hack below. The display manager scheme will not be specific to which user has the @@ -1887,18 +1892,18 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg Then restart: /usr/sbin/gdm-restart (or reboot). The KillInitClients=false setting is important: without it x11vnc will be - killed immediately after the user logs in. Here are [149]full details + killed immediately after the user logs in. Here are [150]full details on how to configure gdm If you do not want to deal with the display manager startup scripts, here is a kludgey script that can be run manually or out of a boot - file like rc.local. [150]x11vnc_loop It will need some local + file like rc.local. [151]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 above is preferred. If the machine is a traditional Xterminal you may want to read - [151]this FAQ. + [152]this FAQ. Q-34: Can I run x11vnc out of inetd(1)? How about xinetd(1)? @@ -2041,7 +2046,7 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" 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 [152]shm_clear to list and prompt for removal + Here is a shell script [153]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, @@ -2079,7 +2084,7 @@ ied) -fs 1.0 knocks it down to 2). If you are having much trouble with shm segments, consider disabling shm completely via the -noshm option. Performance will be somewhat degraded but when done over local machine - sockets it should be acceptable (see an [153]earlier question + sockets it should be acceptable (see an [154]earlier question discussing -noshm). Q-38: How can I make x11vnc use less system resources? @@ -2127,7 +2132,7 @@ ied) worth it, but could be of use in some situations. VNC viewer parameters: - * Use a [154]TightVNC enabled viewer! + * Use a [155]TightVNC enabled viewer! * Make sure the tight encoding is being used (look at vncviewer and x11vnc outputs) * Request 8 bits per pixel using -bgr233 (up to 4X speedup over @@ -2288,7 +2293,7 @@ ied) hide the alpha data), but it also currently requires the client and server to be of the same endianness (otherwise the hidden alpha data gets reset to zero by the translation function). As an example, for - the TightVNC 1.3dev5 Unix vncviewer [155]this patch enables the + the TightVNC 1.3dev5 Unix vncviewer [156]this patch enables the TightVNC viewer to do the blending locally. You have to set the environment variable ALPHABLEND=1 before starting your modified viewer. The patch code should give an example on how to change the @@ -2300,7 +2305,7 @@ ied) Q-45: 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 [156]tightvnc extension + This default takes advantage of a [157]tightvnc extension (CursorShapeUpdates) that allows specifying a cursor image shape for the local VNC viewer. You may disable it with the -nocursor option to x11vnc if your viewer does not have this extension. @@ -2385,12 +2390,12 @@ ied) 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 [157]this FAQ + and ">" it. This key does not exist on the keyboard (see [158]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 [158]FAQ about the -xkb option for a more powerful method + Also see the [159]FAQ about the -xkb option for a more powerful method of modifier tweaking for use on X servers with the XKEYBOARD extension. @@ -2451,7 +2456,7 @@ ied) the keysym comma when it comes in from a client (so when Shift is down the comma press will yield "<"). - See also the [159]FAQ about the -xkb option as a possible workaround + See also the [160]FAQ about the -xkb option as a possible workaround using the XKEYBOARD extension. Note that of Jul/2004 in the libvncserver CVS the -modtweak option is now that default. @@ -2587,7 +2592,23 @@ ied) someone is also working at the physical display and misses his autorepeating. - Q-52: The machine where I run x11vnc has an AltGr key, but the local + Q-52: 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 + [161]this FAQ) If so, x11vnc is starting before your session, and then + your session startup could be resetting the autorepeat to be on. Or it + could be something inside your desktop that decides to turn it back + on. x11vnc in -norepeat mode will not battle with things turning + autorepeat back on. (It will, however, turn it off whenever it goes + from a state of zero clients to one client). + + Under these circumstances you will have to manually turn autorepeating + off by typing "xset r off" or "x11vnc -R norepeat" or a desktop + utility. If something in your desktop is automatically turning it back + on you will have to disable that somehow. + + Q-53: 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? @@ -2601,7 +2622,7 @@ ied) Super_R-Mode_switch,Menu-Multi_key" or use "-remap filename" to specify remappings from a file. - Q-53: I have a Sun machine I run x11vnc on. Its Sun keyboard has just + Q-54: 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) @@ -2618,7 +2639,7 @@ ied) send Alt_L in this case, maybe -remap Super_L-Meta_L would be a better choice. - Q-54: Can I map a keystroke to a mouse button click on the remote + Q-55: 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 @@ -2642,7 +2663,7 @@ ied) [Screen Related Issues and Features] - Q-55: The remote display is larger (in number of pixels) than the + Q-56: 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? @@ -2660,10 +2681,10 @@ ied) 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 [160]this + local display. Especially for hand-held devices. See also [162]this FAQ on x11vnc scaling. - Q-56: Does x11vnc support server-side framebuffer scaling? (E.g. to + Q-57: 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 @@ -2713,7 +2734,7 @@ ied) different scalings listening on separate ports (-rfbport option, etc.). - Q-57: Does x11vnc work with Xinerama? (i.e. multiple monitors joined + Q-58: 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 @@ -2740,7 +2761,7 @@ ied) function. (This may be due to a bug in the X server for XTEST when Xinerama is enabled). - Q-58: Can I use x11vnc on a multi-headed display that is not Xinerama + Q-59: 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 @@ -2758,12 +2779,12 @@ 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 [161]FAQ to increase the limit. It + /etc/system as mentioned in another [163]FAQ to increase the limit. It is probably also a good idea to run with the -onetile option in this case (to limit each x11vnc to 3 shm segments), or even -noshm to use no shm segments. - Q-59: Does x11vnc support the XRANDR (X Resize, Rotate and Reflection) + Q-60: Does x11vnc support the XRANDR (X Resize, Rotate and Reflection) extension? Whenever I rotate or resize the screen x11vnc just seems to crash. @@ -2783,12 +2804,12 @@ ied) specify "-xrandr exit" then all will be disconnected and x11vnc will terminate. - Q-60: Why is the view in my VNC viewer completely black? Or why is + Q-61: 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-61: I use Linux Virtual Consoles (VC's) to implement 'Fast User + Q-62: 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 @@ -2815,7 +2836,7 @@ ied) x11vnc can poll it), one can use the switchto(1) command, e.g. "switchto 7" for VC #7. - Q-62: I am using x11vnc where my local machine has "popup/hidden + Q-63: 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 @@ -2829,7 +2850,7 @@ ied) [Misc: Clipboard, Beeps, etc.] - Q-63: Does the Clipboard/Selection get transferred between the + Q-64: 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" @@ -2839,7 +2860,11 @@ ied) want the PRIMARY selection to be polled for changes use the -noprimary option. - Q-64: Why don't I hear the "Beeps" in my X session (e.g. when typing + 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-65: 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 @@ -2960,60 +2985,62 @@ References 105. http://www.karlrunge.com/x11vnc/index.html#FAQ-62 106. http://www.karlrunge.com/x11vnc/index.html#FAQ-63 107. http://www.karlrunge.com/x11vnc/index.html#FAQ-64 - 108. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding - 109. http://www.karlrunge.com/x11vnc/index.html#building - 110. http://www.karlrunge.com/x11vnc/index.html#buildfaq - 111. http://packages.debian.org/x11vnc - 112. http://www.linuxpackages.net/search_view.php?by=name&name=x11vnc - 113. http://dag.wieers.com/packages/x11vnc/ - 114. http://www.bell-labs.com/project/wwexptools/packages.html - 115. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding - 116. http://www.karlrunge.com/x11vnc/bins - 117. http://www.tightvnc.com/download.html - 118. http://www.realvnc.com/download-free.html - 119. http://sourceforge.net/projects/cotvnc/ - 120. http://www.karlrunge.com/x11vnc/x11vnc_opts.html - 121. http://www.karlrunge.com/x11vnc/x11vnc.c - 122. http://fredrik.hubbe.net/x2vnc.html - 123. http://www.hubbe.net/~hubbe/win2vnc.html - 124. http://www.deboer.gmxhome.de/ - 125. http://sourceforge.net/projects/win2vnc/ - 126. http://fredrik.hubbe.net/x2vnc.html - 127. http://freshmeat.net/projects/x2x/ - 128. http://ftp.digital.com/pub/Digital/SRC/x2x/ - 129. http://zapek.com/software/zvnc/ - 130. http://www.karlrunge.com/x11vnc/index.html#8bpp - 131. http://www.karlrunge.com/x11vnc/index.html#overlays - 132. http://www.karlrunge.com/x11vnc/index.html#xauth_pain - 133. http://www.karlrunge.com/x11vnc/index.html#noshm - 134. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 135. http://www.karlrunge.com/x11vnc/index.html#passwd - 136. http://www.karlrunge.com/x11vnc/index.html#passwdfile - 137. http://www.karlrunge.com/x11vnc/index.html#inetd - 138. ftp://ftp.x.org/ - 139. http://www.karlrunge.com/x11vnc/dtVncPopup - 140. http://www.karlrunge.com/x11vnc/index.html#passwdfile - 141. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 108. http://www.karlrunge.com/x11vnc/index.html#FAQ-65 + 109. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding + 110. http://www.karlrunge.com/x11vnc/index.html#building + 111. http://www.karlrunge.com/x11vnc/index.html#buildfaq + 112. http://packages.debian.org/x11vnc + 113. http://www.linuxpackages.net/search_view.php?by=name&name=x11vnc + 114. http://dag.wieers.com/packages/x11vnc/ + 115. http://www.bell-labs.com/project/wwexptools/packages.html + 116. http://www.karlrunge.com/x11vnc/index.html#solarisbuilding + 117. http://www.karlrunge.com/x11vnc/bins + 118. http://www.tightvnc.com/download.html + 119. http://www.realvnc.com/download-free.html + 120. http://sourceforge.net/projects/cotvnc/ + 121. http://www.karlrunge.com/x11vnc/x11vnc_opts.html + 122. http://www.karlrunge.com/x11vnc/x11vnc.c + 123. http://fredrik.hubbe.net/x2vnc.html + 124. http://www.hubbe.net/~hubbe/win2vnc.html + 125. http://www.deboer.gmxhome.de/ + 126. http://sourceforge.net/projects/win2vnc/ + 127. http://fredrik.hubbe.net/x2vnc.html + 128. http://freshmeat.net/projects/x2x/ + 129. http://ftp.digital.com/pub/Digital/SRC/x2x/ + 130. http://zapek.com/software/zvnc/ + 131. http://www.karlrunge.com/x11vnc/index.html#8bpp + 132. http://www.karlrunge.com/x11vnc/index.html#overlays + 133. http://www.karlrunge.com/x11vnc/index.html#xauth_pain + 134. http://www.karlrunge.com/x11vnc/index.html#noshm + 135. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 136. http://www.karlrunge.com/x11vnc/index.html#passwd + 137. http://www.karlrunge.com/x11vnc/index.html#passwdfile + 138. http://www.karlrunge.com/x11vnc/index.html#inetd + 139. ftp://ftp.x.org/ + 140. http://www.karlrunge.com/x11vnc/dtVncPopup + 141. http://www.karlrunge.com/x11vnc/index.html#passwdfile 142. http://www.karlrunge.com/x11vnc/index.html#tunnelling 143. http://www.karlrunge.com/x11vnc/index.html#tunnelling 144. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 145. http://www.karlrunge.com/x11vnc/blockdpy.c - 146. http://www.karlrunge.com/x11vnc/index.html#display_manager - 147. http://www.karlrunge.com/x11vnc/index.html#inetd - 148. http://www.karlrunge.com/x11vnc/index.html#x11vnc_loop - 149. http://www.jirka.org/gdm-documentation/x241.html - 150. http://www.karlrunge.com/x11vnc/x11vnc_loop - 151. http://www.karlrunge.com/x11vnc/index.html#xterminal_xauth - 152. http://www.karlrunge.com/x11vnc/shm_clear - 153. http://www.karlrunge.com/x11vnc/index.html#noshm - 154. http://www.tightvnc.com/ - 155. http://www.karlrunge.com/x11vnc/tight-vncviewer-alphahack.patch - 156. http://www.tightvnc.com/ - 157. http://www.karlrunge.com/x11vnc/index.html#greaterless - 158. http://www.karlrunge.com/x11vnc/index.html#xkbmodtweak + 145. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 146. http://www.karlrunge.com/x11vnc/blockdpy.c + 147. http://www.karlrunge.com/x11vnc/index.html#display_manager + 148. http://www.karlrunge.com/x11vnc/index.html#inetd + 149. http://www.karlrunge.com/x11vnc/index.html#x11vnc_loop + 150. http://www.jirka.org/gdm-documentation/x241.html + 151. http://www.karlrunge.com/x11vnc/x11vnc_loop + 152. http://www.karlrunge.com/x11vnc/index.html#xterminal_xauth + 153. http://www.karlrunge.com/x11vnc/shm_clear + 154. http://www.karlrunge.com/x11vnc/index.html#noshm + 155. http://www.tightvnc.com/ + 156. http://www.karlrunge.com/x11vnc/tight-vncviewer-alphahack.patch + 157. http://www.tightvnc.com/ + 158. http://www.karlrunge.com/x11vnc/index.html#greaterless 159. http://www.karlrunge.com/x11vnc/index.html#xkbmodtweak - 160. http://www.karlrunge.com/x11vnc/index.html#scaling - 161. http://www.karlrunge.com/x11vnc/index.html#solshm + 160. http://www.karlrunge.com/x11vnc/index.html#xkbmodtweak + 161. http://www.karlrunge.com/x11vnc/index.html#display_manager + 162. http://www.karlrunge.com/x11vnc/index.html#scaling + 163. http://www.karlrunge.com/x11vnc/index.html#solshm ======================================================================= @@ -3026,8 +3053,8 @@ x11vnc: a VNC server for real X displays Here are all of x11vnc command line options: % x11vnc -help -x11vnc: allow VNC connections to real X11 displays. 0.7.1pre lastmod: 2005-01-1 -6 +x11vnc: allow VNC connections to real X11 displays. 0.7.1pre lastmod: 2005-01-2 +3 Typical usage is: @@ -3161,6 +3188,8 @@ Options: disconnects, opposite of -forever. This is the Default. -forever Keep listening for more connections rather than exiting as soon as the first client(s) disconnect. Same as -many +-timeout n Exit unless a client connects within the first n seconds + of startup. -inetd Launched by inetd(1): stdio instead of listening socket. Note: if you are not redirecting stderr to a log file (via shell 2> or -o option) you must also specify the @@ -3427,9 +3456,9 @@ Options: with -nocursor, and also some values of the "mode" option below. - Note that under XFIXES cursors with transparency - (alpha channel) will not be exactly represented and - so Overlay may be preferred. See also the -alphacut + Note that under XFIXES cursors with transparency (alpha + channel) will not be exactly represented and one may + find Overlay may be preferable. See also the -alphacut and -alphafrac options below as fudge factors to try to improve the situation for cursors with transparency for a given theme. @@ -3488,14 +3517,14 @@ Options: black background). Specify this option to remove the alpha factor. (useful for light colored semi-transparent cursors). --alphablend In XFIXES mode send cursor alpha channel data to - libvncserver. The blending effect will only be - visible in -nocursorshape mode or for clients with - cursorshapeupdates turned off. (However there is a - hack for 32bpp with depth 24, it uses the extra 8 bits - to store cursor transparency for use with a hacked - vncviewer that applies the transparency locally. - See the FAQ for more info). +-noalphablend In XFIXES mode do not send cursor alpha channel data + to libvncserver. The default is to send it. The + alphablend effect will only be visible in -nocursorshape + mode or for clients with cursorshapeupdates turned + off. (However there is a hack for 32bpp with depth 24, + it uses the extra 8 bits to store cursor transparency + for use with a hacked vncviewer that applies the + transparency locally. See the FAQ for more info). -nocursorshape Do not use the TightVNC CursorShapeUpdates extension even if clients support it. See -cursor above. @@ -3759,6 +3788,9 @@ Options: noshared disable -shared mode. forever enable -forever mode. noforever disable -forever mode. + timeout:n reset -timeout to n, if there are + currently no clients, exit unless one + connects in the next n secs. deny deny any new connections, same as "lock" nodeny allow new connections, same as "unlock" connect:host do reverse connection to host, "host" @@ -3842,8 +3874,8 @@ Options: alphafrac:f set -alphafrac to f. alpharemove enable -alpharemove mode. noalpharemove disable -alpharemove mode. - alphablend enable -alphablend mode. - noalphablend disable -alphablend mode. + alphablend disable -noalphablend mode. + noalphablend enable -noalphablend mode. cursorshape disable -nocursorshape mode. nocursorshape enable -nocursorshape mode. cursorpos disable -nocursorpos mode. @@ -3936,8 +3968,8 @@ Options: nowaitmapped flashcmap noflashcmap truecolor notruecolor overlay nooverlay overlay_cursor overlay_yescursor nooverlay_nocursor nooverlay_cursor nooverlay_yescursor - overlay_nocursor visual scale viewonly noviewonly - shared noshared forever noforever once deny lock nodeny + overlay_nocursor visual scale viewonly noviewonly shared + noshared forever noforever once timeout deny lock nodeny unlock connect allowonce allow localhost nolocalhost accept gone shm noshm flipbyteorder noflipbyteorder onetile noonetile blackout xinerama noxinerama xrandr @@ -3959,16 +3991,16 @@ Options: noalwaysshared nevershared noalwaysshared dontdisconnect nodontdisconnect desktop noremote - aro= display vncdisplay desktopname auth rootshift - scale_str scaled_x scaled_y scale_numer scale_denom - scale_fac scaling_noblend scaling_nomult4 scaling_pad - scaling_interpolate inetd safer unsafe passwdfile - using_shm logfile o rc norc h help V version lastmod - bg sigpipe threads clients client_count pid ext_xtest - ext_xkb ext_xshm ext_xinerama ext_overlay ext_xfixes - ext_xdamage ext_xrandr rootwin num_buttons button_mask - mouse_x mouse_y bpp depth indexed_color dpy_x dpy_y - rfbauth passwd + aro= display vncdisplay desktopname http_url auth + rootshift scale_str scaled_x scaled_y scale_numer + scale_denom scale_fac scaling_noblend scaling_nomult4 + scaling_pad scaling_interpolate inetd safer unsafe + passwdfile using_shm logfile o rc norc h help V version + lastmod bg sigpipe threads clients client_count pid + ext_xtest ext_xkb ext_xshm ext_xinerama ext_overlay + ext_xfixes ext_xdamage ext_xrandr rootwin num_buttons + button_mask mouse_x mouse_y bpp depth indexed_color + dpy_x dpy_y rfbauth passwd -sync By default -remote commands are run asynchronously, that is, the request is posted and the program immediately |