--- old/vncviewer.txt 2009-10-30 13:24:14.734893934 -0700 +++ tigervnc-1.0/vncviewer.txt 2009-10-30 13:17:18.667581500 -0700 @@ -10,6 +10,7 @@ SYNOPSIS /usr/bin/vncviewer [options] [host][:display#] + vncviewer [options] [host][::port] vncviewer [options] -listen [port] DESCRIPTION @@ -38,29 +39,28 @@ AUTOMATIC PROTOCOL SELECTION The viewer tests the speed of the connection to the server - and chooses the encoding and pixel format (colour level) + and chooses the encoding and pixel format (color level) appropriately. This makes it much easier to use than previ- ous versions where the user had to specify arcane command line arguments. The viewer normally starts out assuming the link is slow, - using a low colour level and using the encoding with the - best compression. If it turns out that the link is fast - enough it switches to full-colour mode and will use an - encoding which compresses less but is faster to generate, - thus improving the interactive feel. Automatic selection - can be turned off by setting the AutoSelect parameter to - false, or from the options dialog. + using the encoding with the best compression. If it turns + out that the link is fast enough it switches to an encoding + which compresses less but is faster to generate, thus + improving the interactive feel. + The viewer normally starts in full-color mode, but switches + to low-color mode if the bandwidth is insufficient. However, + this only occurs when communicating with servers supporting + protocol 3.8 or newer, since many old servers does not sup- + port color mode changes safely. -POPUP MENU - The viewer has a popup menu containing entries which perform - various actions. It is usually brought up by pressing F8, - but this can be configured with the MenuKey parameter. + Automatic selection can be turned off by setting the -RealVNC Ltd Last change: 03 Mar 2005 1 +TigerVNC Last change: 05 May 2004 1 @@ -71,6 +71,13 @@ + AutoSelect parameter to false, or from the options dialog. + + +POPUP MENU + The viewer has a popup menu containing entries which perform + various actions. It is usually brought up by pressing F8, + but this can be configured with the MenuKey parameter. Actions which the popup menu can perform include: * switching in and out of full-screen mode @@ -116,27 +123,27 @@ should appear. - -geometry geometry - Standard X position and sizing specification. - -listen [port] - Causes vncviewer to listen on the given port (default - 5500) for reverse connections from a VNC server. +TigerVNC Last change: 05 May 2004 2 -RealVNC Ltd Last change: 03 Mar 2005 2 +Virtual Network Computing vncviewer(1) -Virtual Network Computing vncviewer(1) + -geometry geometry + Standard X position and sizing specification. + -listen [port] + Causes vncviewer to listen on the given port (default + 5500) for reverse connections from a VNC server. WinVNC supports reverse connections initiated using the 'Add New Client' menu option or the '-connect' command-line option. Xvnc supports reverse connections @@ -168,6 +175,14 @@ Start in full-screen mode. + -DesktopSize widthxheight + Instead of keeping the existing remote screen size, the + client will attempt to switch to the specified since + when connecting. If the server does not support the + SetDesktopSize message then the screen will retain the + original size. + + -AutoSelect Use automatic selection of encoding and pixel format (default is on). Normally the viewer tests the speed @@ -176,39 +191,32 @@ -AutoSelect=0. - -FullColour, -FullColor - Tells the VNC server to send full-colour pixels in the - best format for this display. By default a low colour - mode is used until AutoSelect decides the link is fast - enough. However if the server's native pixel format is - colourmapped (as opposed to truecolour) then the - server's format is used by default. - - -LowColourLevel level - Selects the reduced colour level to use on slow links. - level can range from 0 to 2, 0 meaning 8 colours, 1 - meaning 64 colours (the default), 2 meaning 256 +TigerVNC Last change: 05 May 2004 3 -RealVNC Ltd Last change: 03 Mar 2005 3 +Virtual Network Computing vncviewer(1) -Virtual Network Computing vncviewer(1) + -FullColor, -FullColour + Tells the VNC server to send full-color pixels in the + best format for this display. This is default. - - colours. + -LowColorLevel, -LowColourLevel level + Selects the reduced color level to use on slow links. + level can range from 0 to 2, 0 meaning 8 colors, 1 + meaning 64 colors (the default), 2 meaning 256 colors. -PreferredEncoding encoding This option specifies the preferred encoding to use - from one of "ZRLE", "hextile" or "raw". + from one of "Tight", "ZRLE", "hextile" or "raw". -UseLocalCursor @@ -241,33 +249,53 @@ Default is F8. -SEE ALSO - Xvnc(1), vncpasswd(1), vncconfig(1), vncserver(1) - http://www.realvnc.com + -via gateway + Automatically create encrypted TCP tunnel to the gate- + way machine before connection, connect to the host + through that tunnel (TigerVNC-specific). By default, + this option invokes SSH local port forwarding, assuming + that SSH client binary can be accessed as /usr/bin/ssh. -AUTHOR - Tristan Richardson, RealVNC Ltd. - VNC was originally developed by the RealVNC team while at - Olivetti Research Ltd / AT&T Laboratories Cambridge. It is - now being maintained by RealVNC Ltd. See - http://www.realvnc.com for details. +TigerVNC Last change: 05 May 2004 4 -RealVNC Ltd Last change: 03 Mar 2005 4 +Virtual Network Computing vncviewer(1) + Note that when using the -via option, the host machine + name should be specified as known to the gateway + machine, e.g. "localhost" denotes the gateway, not the + machine where vncviewer was launched. The environment + variable VNC_VIA_CMD can override the default tunnel + command of /usr/bin/ssh -f - + L "$L":"$H":"$R" "$G" sleep 20. The tunnel command is + executed with the environment variables L, H, R, and G + taken the values of the local port number, the remote + host, the port number on the remote host, and the gate- + way machine respectively. -Virtual Network Computing vncviewer(1) +SEE ALSO + Xvnc(1), vncpasswd(1), vncconfig(1), vncserver(1) + http://www.tigervnc.org +AUTHOR + Tristan Richardson, RealVNC Ltd. + + VNC was originally developed by the RealVNC team while at + Olivetti Research Ltd / AT&T Laboratories Cambridge. + TightVNC additions were implemented by Constantin Kaplinsky. + Many other people participated in development, testing and + support. + ATTRIBUTES See attributes(5) for descriptions of the following attri- @@ -296,35 +324,7 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - -RealVNC Ltd Last change: 03 Mar 2005 5 +TigerVNC Last change: 05 May 2004 5