Provided by: ssvnc_1.0.29-6ubuntu3_amd64 bug

NAME

       ssvncviewer - an X viewer client for VNC

SYNOPSIS

       ssvncviewer [options] [host][:display]
       ssvncviewer [options] [host][::port]
       ssvncviewer [options] exec=[cmd+args...]
       ssvncviewer [options] fd=n
       ssvncviewer [options] /path/to/unix/socket
       ssvncviewer [options] unix=/path/to/unix/socket
       ssvncviewer [options] -listen [display]
       ssvncviewer -help

DESCRIPTION

       ssvncviewer  is  an  Xt-based  client  application for the VNC (Virtual Network Computing) system. It can
       connect to any VNC-compatible server such as Xvnc, WinVNC, or x11vnc, allowing  you  to  control  desktop
       environment of a different machine.

       ssvncviewer is an enhanced version of the tightvnc unix viewer that can take advantage of features in the
       x11vnc and UltraVNC VNC servers.  See below for the description of these features.

       You can use F8 to display a pop-up utility menu (also F7 on MacOSX.)  Press F8 twice to pass single F8 to
       the remote side.

OPTIONS

       -help  Prints a short usage notice to stderr.

       -listen
              Make the viewer listen on port 5500+display for reverse connections from a server. WinVNC supports
              reverse connections using the "Add New Client" menu option, or the -connect command  line  option.
              Xvnc requires the use of the helper program vncconnect.

       -via gateway
              Automatically create encrypted TCP tunnel to the gateway machine before connection, connect to the
              host through that tunnel (TightVNC-specific). By default,  this  option  invokes  SSH  local  port
              forwarding,  assuming that SSH client binary can be accessed as /usr/bin/ssh. 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. See the ENVIRONMENT
              section below for the information on configuring the -via option.

       -shared
              When connecting, specify that a shared connection is requested. In TightVNC, this is  the  default
              mode, allowing you to share the desktop with other clients already using it.

       -noshared
              When  connecting,  specify  that the session may not be shared. This would either disconnect other
              connected clients or refuse your connection, depending on the server configuration.

       -viewonly
              Disable transfer of mouse and keyboard events from the client to the server.

       -fullscreen
              Start in full-screen mode. Please be aware that operating in full-screen mode may confuse X window
              managers.  Typically,  such  conflicts  cause incorrect handling of input focus or make the viewer
              window disappear mysteriously. See the grabKeyboard setting in the RESOURCES section below  for  a
              method to solve input focus problem.

       -noraiseonbeep
              By  default,  the  viewer  shows  and  raises  its window on remote beep (bell) event. This option
              disables such behaviour (TightVNC-specific).

       -user username
              User name for Unix login authentication. Default is to use current Unix user name. If this  option
              was given, the viewer will prefer Unix login authentication over the standard VNC authentication.

       -passwd passwd-file
              File  from  which  to  get  the  password  (as generated by the vncpasswd(1) program). This option
              affects only the standard VNC authentication.

       -encodings encoding-list
              TightVNC supports several different compression methods to  encode  screen  updates;  this  option
              specifies  a  set  of  them  to use in order of preference. Encodings are specified separated with
              spaces, and must thus be enclosed in quotes if more than one is specified.  Commas may be used  to
              avoid  spaces.  Available encodings, in default order for a remote connection, are "copyrect tight
              hextile zlib corre rre raw". For a local connection (to the same machine), the  default  order  to
              try  is  "raw  copyrect  tight  hextile  zlib corre rre". Raw encoding is always assumed as a last
              option if no other encoding can be used for some reason. For more information  on  encodings,  see
              the section ENCODINGS below.

       -bgr233
              Always use the BGR233 format to encode pixel data. This reduces network traffic, but colors may be
              represented inaccurately. The bgr233 format is an 8-bit "true color" format, with 2 bits  blue,  3
              bits green, and 3 bits red.

       -owncmap
              Try  to use a PseudoColor visual and a private colormap. This allows the VNC server to control the
              colormap.

       -truecolour, -truecolor
              Try to use a TrueColor visual.

       -depth depth
              On an X server which supports multiple TrueColor visuals of different depths, attempt to  use  the
              specified  one  (in  bits  per  pixel);  if  successful, this depth will be requested from the VNC
              server.

       -compresslevel level
              Use specified compression level (0..9) for "tight" and "zlib" encodings (TightVNC-specific). Level
              1  uses  minimum  of  CPU  time  and  achieves  weak compression ratios, while level 9 offers best
              compression but is slow in terms of CPU time consumption on the server side. Use high levels  with
              very  slow  network  connections,  and  low  levels  when  working  over high-speed LANs. It's not
              recommended to use compression level 0, reasonable choices start from the level 1.

       -quality level
              Use the specified JPEG quality level (0..9) for the "tight" encoding (TightVNC-specific).  Quality
              level  0  denotes  bad  image quality but very impressive compression ratios, while level 9 offers
              very good image quality at lower compression ratios. Note that the "tight" encoder  uses  JPEG  to
              encode  only  those screen areas that look suitable for lossy compression, so quality level 0 does
              not always mean unacceptable image quality.

       -nojpeg
              Disable lossy JPEG compression in Tight encoding (TightVNC-specific).  Disabling JPEG  compression
              is  not  a  good  idea in typical cases, as that makes the Tight encoder less efficient. You might
              want to use this option if it's absolutely necessary to achieve perfect image  quality  (see  also
              the -quality option).

       -nocursorshape
              Disable  cursor  shape updates, protocol extensions used to handle remote cursor movements locally
              on the client side (TightVNC-specific). Using cursor shape updates decreases  delays  with  remote
              cursor movements, and can improve bandwidth usage dramatically.

       -x11cursor
              Use  a  real X11 cursor with X-style cursor shape updates, instead of drawing the remote cursor on
              the framebuffer. This option also disables the dot cursor, and disables cursor position updates in
              non-fullscreen mode.

       -autopass
              Read a plain-text password from stdin. This option affects only the standard VNC authentication.

Enhanced TightVNC Viewer (SSVNC) OPTIONS

       Enhanced TightVNC Viewer (SSVNC) web page is located at:

       http://www.karlrunge.com/x11vnc/ssvnc.html

       Note: ZRLE and ZYWRLE encodings are now supported.

       Note: F9 is shortcut to Toggle FullScreen mode.

       Note: In -listen mode set the env var. SSVNC_MULTIPLE_LISTEN=1
              to  allow more than one incoming VNC server at a time.  This is the same as -multilisten described
              below.   Set  SSVNC_MULTIPLE_LISTEN=MAX:n  to  allow  no  more  than  "n"   simultaneous   reverse
              connections.

              If  the  host:port  is specified as "exec=command args..."  then instead of making a TCP/IP socket
              connection to the remote VNC server, "command args..." is executed and the viewer is  attached  to
              its  stdio.   This enables tunnelling established via an external command, e.g. an stunnel(8) that
              does not involve a listening socket.  This mode does not work for -listen reverse connections.  To
              not have the exec= pid killed at exit, set SSVNC_NO_KILL_EXEC_CMD=1.

              If  the host:port is specified as "fd=n" then it is assumed n is an already opened file descriptor
              to the socket. (i.e the parent did fork+exec)

              If the host:port contains a '/' and exists in the file system it is interpreted as  a  unix-domain
              socket (AF_LOCAL/AF_UNIX instead of AF_INET)  Prefix with unix= to force interpretation as a unix-
              domain socket.

       -multilisten
              As in -listen (reverse connection listening) except allow more than one incoming VNC server to  be
              connected  at  a time.  The default for -listen of only one at a time tries to play it safe by not
              allowing anyone on the network to put (many) desktops on your screen over a long window  of  time.
              Use -multilisten for no limit.

       -acceptpopup
              In -listen (reverse connection listening) mode when a reverse VNC connection comes in show a popup
              asking whether to Accept or Reject the connection.  The IP  address  of  the  connecting  host  is
              shown.  Same as setting the env. var. SSVNC_ACCEPT_POPUP=1.

       -acceptpopupsc
              As  in  -acceptpopup  except  assume  UltraVNC  Single  Click  (SC)  server.   Retrieve  User  and
              ComputerName info from UltraVNC Server and display in the Popup.

       -use64 In -bgr233 mode, use 64 colors instead of 256.

       -bgr222
              Same as -use64.

       -use8  In -bgr233 mode, use 8 colors instead of 256.

       -bgr111
              Same as -use8.

       -16bpp If the vnc viewer X display is depth 24 at 32bpp request a 16bpp format from the VNC server to cut
              network traffic by up to 2X, then tranlate the pixels to 32bpp locally.

       -bgr565
              Same as -16bpp.

       -grey  Use a grey scale for the 16- and 8-bpp modes.

       -alpha Use  alphablending  transparency for local cursors requires: x11vnc server, both client and server
              must be 32bpp and same endianness.

       -scale str
              Scale the desktop locally.  The string "str"  can  a  floating  point  ratio,  e.g.  "0.9",  or  a
              fraction,  e.g.  "3/4", or WxH, e.g. 1280x1024.  Use "fit" to fit in the current screen size.  Use
              "auto" to fit in the window size.  "str" can also be set by the env. var. SSVNC_SCALE.

              If you observe mouse  trail  painting  errors,  enable  X11  Cursor  mode  (either  via  Popup  or
              -x11cursor.)

              Note  that  scaling is done in software and so can be slow and requires more memory.  Some speedup
              Tips:

              ZRLE is faster than Tight in this mode.  When scaling is first  detected,  the  encoding  will  be
              automatically  switched  to  ZRLE.   Use  the  Popup  menu  if  you want to go back to Tight.  Set
              SSVNC_PRESERVE_ENCODING=1 to disable this.

              Use a solid background on the remote side.  (e.g. manually or via x11vnc -solid ...)

              If the remote server is x11vnc, try client side caching: x11vnc -ncache 10 ...

       -ycrop n
              Only show the top n rows of the framebuffer.  For use with x11vnc -ncache client caching option to
              help  "hide"  the  pixel  cache  region.   Use  a  negative  value  (e.g.  -1)  for autodetection.
              Autodetection will always take place if the remote fb height is more than 2 times the width.

       -sbwidth n
              Scrollbar width for x11vnc -ncache mode (-ycrop), default is very narrow: 2 pixels, it  is  narrow
              to avoid distraction in -ycrop mode.

       -nobell
              Disable bell.

       -rawlocal
              Prefer raw encoding for localhost, default is no, i.e. assumes you have a SSH tunnel instead.

       -notty Try  to avoid using the terminal for interactive responses: use windows for messages and prompting
              instead.  Messages will also be printed to terminal.

       -sendclipboard
              Send the X CLIPBOARD selection (i.e. Ctrl+C, Ctrl+V) instead of the  X  PRIMARY  selection  (mouse
              select and middle button paste.)

       -sendalways
              Whenever the mouse enters the VNC viewer main window, send the selection to the VNC server even if
              it has not changed.  This is like the Xt resource translation SelectionToVNC(always)

       -recvtext
              str   When cut text is received from the VNC server, ssvncviewer will set both the X  PRIMARY  and
              the  X  CLIPBOARD  local  selections.   To  control  which  is  set,  specify  'str' as 'primary',
              'clipboard', or 'both' (the default.)

       -graball
              Grab the entire X server when in fullscreen mode, needed by some old window managers like fvwm2.

       -popupfix
              Warp the popup back to the pointer position, needed by some old window managers like fvwm2.

       -grabkbd
              Grab  the  X  keyboard  when  in  fullscreen  mode,  needed  by  some  window  managers.  Same  as
              -grabkeyboard.  -grabkbd is the default, use -nograbkbd to disable.

       -bs, -nobs
              Whether  or  not  to use X server Backingstore for the main viewer window.  The default is to not,
              mainly because most Linux, etc, systems X servers  disable  *all*  Backingstore  by  default.   To
              re-enable it put

              Option "Backingstore"

              in  the Device section of /etc/X11/xorg.conf.  In -bs mode with no X server backingstore, whenever
              an area of the screen is re-exposed it must go out to the VNC server to retrieve the pixels.  This
              is too slow.

              In  -nobs  mode,  memory  is allocated by the viewer to provide its own backing of the main viewer
              window. This actually makes some activities faster (changes in large regions) but  can  appear  to
              "flash" too much.

       -noshm Disable use of MIT shared memory extension (not recommended)

       -termchat
              Do the UltraVNC chat in the terminal vncviewer is in instead of in an independent window.

       -unixpw str
              Useful  for  logging into x11vnc in -unixpw mode. "str" is a string that allows many ways to enter
              the Unix Username and Unix Password.  These characters: username, newline, password,  newline  are
              sent  to  the VNC server after any VNC authentication has taken place.  Under x11vnc they are used
              for the -unixpw login.  Other VNC servers could do something similar.

              You can also indicate "str" via the environment variable SSVNC_UNIXPW.

              Note that the Escape key is actually sent first to tell x11vnc to not echo the Unix Username  back
              to the VNC viewer. Set SSVNC_UNIXPW_NOESC=1 to override this.

              If  str  is  ".",  then  you are prompted at the command line for the username and password in the
              normal way.  If str is "-" the stdin is read via getpass(3) for username@password.   Otherwise  if
              str  is  a file, it is opened and the first line read is taken as the Unix username and the 2nd as
              the password. If str prefixed by "rm:" the file is removed after reading. Otherwise, if str has  a
              "@"  character,  it is taken as username@password. Otherwise, the program exits with an error. Got
              all that?

       -repeater str
              This     is     for     use     with     UltraVNC     repeater     proxy      described      here:
              http://www.uvnc.com/addons/repeater.html.   The "str" is the ID string to be sent to the repeater.
              E.g. ID:1234 It can also be the hostname and port or display of the VNC server, e.g. 12.34.56.78:0
              or  snoopy.com:1.   Note  that  when  using -repeater, the host:dpy on the cmdline is the repeater
              server, NOT the VNC server.  The repeater will connect you.

              Example: vncviewer ... -repeater ID:3333 repeat.host:5900

              Example: vncviewer ... -repeater vhost:0 repeat.host:5900

              Use, e.g., '-repeater SCIII=ID:3210' if  the  repeater  is  a  Single  Click  III  (SSL)  repeater
              (repeater_SSL.exe) and you are passing the SSL part of the connection through stunnel, socat, etc.
              This way the magic UltraVNC string 'testB' needed to work with the repeater is sent to it.

       -rfbversion str
              Set the advertised RFB version.  E.g.: -rfbversion 3.6  For some servers, e.g. UltraVNC this needs
              to be done.

       -ultradsm
              UltraVNC       has       symmetric       private       encryption      DSM      plugins.       See
              http://www.uvnc.com/features/encryption.html.  It is assumed you are using a  unix  program  (e.g.
              our  ultravnc_dsm_helper)  to  encrypt  and  decrypt  the UltraVNC DSM stream. IN ADDITION TO THAT
              supply -ultradsm to tell THIS viewer to modify the RFB data sent so as to work with  the  UltraVNC
              Server.  For some reason, each RFB msg type must be sent twice under DSM.

       -mslogon user
              Use  Windows  MS  Logon  to  an  UltraVNC server.  Supply the username or "1" to be prompted.  The
              default is to autodetect the UltraVNC MS Logon server and prompt for the username and password.

              IMPORTANT NOTE: The UltraVNC MS-Logon Diffie-Hellman exchange is very weak and can be brute forced
              to recover your username and password in a few seconds of CPU time.  To be safe, be sure to use an
              additional encrypted tunnel (e.g. SSL or SSH) for the entire VNC session.

       -chatonly
              Try to be a client that only does UltraVNC text chat. This mode is used by  x11vnc  to  present  a
              chat window on the physical X11 console (i.e. to chat with the person at the display).

       -env VAR=VALUE
              To  save  writing  a shell script to set environment variables, specify as many as you need on the
              command line.  For example, -env SSVNC_MULTIPLE_LISTEN=MAX:5 -env EDITOR=vi

       -noipv6
              Disable all IPv6 sockets.  Same as VNCVIEWER_NO_IPV6=1.

       -noipv4
              Disable all IPv4 sockets.  Same as VNCVIEWER_NO_IPV4=1.

       -printres
              Print out the Ssvnc X resources (appdefaults) and then exit. You can  save  them  to  a  file  and
              customize  them  (e.g. the keybindings and Popup menu)  Then point to the file via XENVIRONMENT or
              XAPPLRESDIR.

       -pipeline
              Like TurboVNC, request the next framebuffer update as soon as possible instead  of  waiting  until
              the  end  of  the  current  framebuffer  update coming in.  Helps 'pipeline' the updates.  This is
              currently the default, use -nopipeline to disable.

       -appshare
              Enable features for use with x11vnc's -appshare mode where instead of  sharing  the  full  desktop
              only the application's windows are shared.  Viewer multilisten mode is used to create the multiple
              windows: -multilisten is implied.  See 'x11vnc -appshare -help'  more  information  on  the  mode.
              Features  enabled  in the viewer under -appshare are: Minimum extra text in the title, auto -ycrop
              is disabled, x11vnc -remote_prefix X11VNC_APPSHARE_CMD: message  channel,  x11vnc  initial  window
              position hints.  See also Escape Keys below for additional key and mouse bindings.

       -escape str
              This  sets  the  'Escape  Keys' modifier sequence and enables escape keys mode.  When the modifier
              keys escape sequence is held down, the next keystroke is interpreted locally to perform a  special
              action instead of being sent to the remote VNC server.

              Use  '-escape  default'  for  the  default  modifier  sequence.   (Unix: Alt_L,Super_L and MacOSX:
              Control_L,Meta_L)

              Here are the 'Escape Keys: Help+Set' instructions from the Popup:

              Escape Keys:  Enter a comma separated list of modifier keys to be  the  'escape  sequence'.   When
              these  keys  are  held  down, the next keystroke is interpreted locally to invoke a special action
              instead of being sent to the remote VNC server.  In other words, a set of 'Hot Keys'.

              Here is the list of local key mappings to special actions:

              r: refresh desktop  b: toggle bell  c: toggle full-color

              f: file transfer    x: x11cursor    z: toggle Tight/ZRLE

              l: full screen      g: graball      e: escape keys dialog

              s: scale dialog     +: scale up (=) -: scale down (_)

              t: text chat                        a: alphablend cursor

              V: toggle viewonly  Q: quit viewer  123456: UltraVNC scale 1/n

              Arrow keys: pan the viewport about 10% for each keypress.

              PageUp/PageDown: pan the viewport by a screenful vertically.

              Home/End: pan the viewport by a screenful horizontally.

              KeyPad Arrows: pan the viewport by 1 pixel for each keypress.

              Dragging the Mouse with Button1 pressed also pans the viewport.

              Clicking Mouse Button3 brings up the Popup Menu.

              The above mappings are always active in ViewOnly mode, unless you set the  Escape  Keys  value  to
              'never'.

              x11vnc  -appshare hot-keys:  x11vnc has a simple application sharing mode that enables the viewer-
              side to move, resize, or raise the remote toplevel windows.  To enable it, hold down Shift  +  the
              Escape Keys and press these:

              Arrow keys: move the remote window around in its desktop.

              PageUp/PageDn/Home/End:  resize the remote window.

              +/-: raise or lower the remote window.

              M or Button1 move win to local position;  D or Button3: delete remote win.

              If  the  Escape  Keys  value  below is set to 'default' then a default list of of modifier keys is
              used.  For Unix it is: Alt_L,Super_L and for MacOSX it is Control_L,Meta_L.  Note: the Super_L key
              usually  has  a  Windows(TM)  Flag  on it.  Also note the _L and _R mean the key is on the LEFT or
              RIGHT side of the keyboard.

              On Unix   the default is Alt and Windows keys on Left side of keyboard.  On MacOSX the default  is
              Control and Command keys on Left side of keyboard.

              Example:  Press  and hold the Alt and Windows keys on the LEFT side of the keyboard and then press
              'c' to toggle the full-color state.  Or press 't' to toggle the ultravnc Text Chat window, etc.

              To use something besides the default, supply a comma  separated  list  (or  a  single  one)  from:
              Shift_L  Shift_R  Control_L Control_R Alt_L Alt_R Meta_L Meta_R Super_L Super_R Hyper_L Hyper_R or
              Mode_switch.

        New Popup actions:

               ViewOnly:                ~ -viewonly
               Disable Bell:            ~ -nobell
               Cursor Shape:            ~ -nocursorshape
               X11 Cursor:              ~ -x11cursor
               Cursor Alphablend:       ~ -alpha
               Toggle Tight/Hextile:    ~ -encodings hextile...
               Toggle Tight/ZRLE:       ~ -encodings zrle...
               Toggle ZRLE/ZYWRLE:      ~ -encodings zywrle...
               Quality Level            ~ -quality (both Tight and ZYWRLE)
               Compress Level           ~ -compresslevel
               Disable JPEG:            ~ -nojpeg  (Tight)
               Pipeline Updates         ~ -pipeline

               Full Color                 as many colors as local screen allows.
               Grey scale (16 & 8-bpp)  ~ -grey, for low colors 16/8bpp modes only.
               16 bit color (BGR565)    ~ -16bpp / -bgr565
               8  bit color (BGR233)    ~ -bgr233
               256 colors               ~ -bgr233 default # of colors.
                64 colors               ~ -bgr222 / -use64
                 8 colors               ~ -bgr111 / -use8
               Scale Viewer             ~ -scale
               Escape Keys: Toggle      ~ -escape
               Escape Keys: Help+Set    ~ -escape
               Set Y Crop (y-max)       ~ -ycrop
               Set Scrollbar Width      ~ -sbwidth
               XGrabServer              ~ -graball

               UltraVNC Extensions:

                 Set 1/n Server Scale     Ultravnc ext. Scale desktop by 1/n.
                 Text Chat                Ultravnc ext. Do Text Chat.
                 File Transfer            Ultravnc ext. File xfer via Java helper.
                 Single Window            Ultravnc ext. Grab and view a single window.
                                          (select then click on the window you want).
                 Disable Remote Input     Ultravnc ext. Try to prevent input and
                                          viewing of monitor at physical display.

               Note: the Ultravnc extensions only apply to servers that support
                     them.  x11vnc/libvncserver supports some of them.

               Send Clipboard not Primary  ~ -sendclipboard
               Send Selection Every time   ~ -sendalways

ENCODINGS

       The server supplies information in whatever format is desired by the client, in order to make the  client
       as  easy  as possible to implement.  If the client represents itself as able to use multiple formats, the
       server will choose one.

       Pixel format refers to the representation of an individual pixel. The most common formats are 24  and  16
       bit "true-color" values, and 8-bit "color map" representations, where an arbitrary map converts the color
       number to RGB values.

       Encoding refers to how a rectangle of  pixels  are  sent  (all  pixel  information  in  VNC  is  sent  as
       rectangles).  All  rectangles  come  with  a  header giving the location and size of the rectangle and an
       encoding type used by the data which follows. These types are listed below.

       Raw    The raw encoding simply sends width*height pixel values. All clients are required to support  this
              encoding  type. Raw is also the fastest when the server and viewer are on the same machine, as the
              connection speed is essentially infinite and raw encoding minimizes processing time.

       CopyRect
              The Copy Rectangle encoding is efficient when something is being moved; the only data sent is  the
              location  of  a rectangle from which data should be copied to the current location. Copyrect could
              also be used to efficiently transmit a repeated pattern.

       RRE    The Rise-and-Run-length-Encoding is basically a 2D version of run-length encoding (RLE).  In  this
              encoding,  a  sequence  of  identical pixels are compressed to a single value and repeat count. In
              VNC, this is implemented with a background color, and then specifications of an  arbitrary  number
              of  subrectangles  and  color for each. This is an efficient encoding for large blocks of constant
              color.

       CoRRE  This is a minor variation on RRE, using a maximum of 255x255 pixel  rectangles.  This  allows  for
              single-byte  values  to  be used, reducing packet size. This is in general more efficient, because
              the savings from sending 1-byte values generally outweighs the losses from the  (relatively  rare)
              cases where very large regions are painted the same color.

       Hextile
              Here, rectangles are split up in to 16x16 tiles, which are sent in a predetermined order. The data
              within the tiles is sent either raw or as a variant on RRE. Hextile encoding is usually  the  best
              choice for using in high-speed network environments (e.g. Ethernet local-area networks).

       Zlib   Zlib  is  a  very simple encoding that uses zlib library to compress raw pixel data. This encoding
              achieves good compression, but consumes a lot of CPU time. Support for this encoding  is  provided
              for  compatibility  with  VNC  servers  that  might  not  understand  Tight encoding which is more
              efficient than Zlib in nearly all real-life situations.

       Tight  Like Zlib encoding, Tight  encoding  uses  zlib  library  to  compress  the  pixel  data,  but  it
              pre-processes data to maximize compression ratios, and to minimize CPU usage on compression. Also,
              JPEG compression may be used to encode color-rich screen areas (see the  description  of  -quality
              and  -nojpeg  options  above). Tight encoding is usually the best choice for low-bandwidth network
              environments (e.g. slow modem connections).

       ZRLE   The SSVNC viewer has ported the RealVNC (www.realvnc.com)  ZRLE  encoding  to  the  unix  tightvnc
              viewer.

       ZYWRLE The   SSVNC   viewer   has   ported   the   Hitachi   lossy   wavelet  based  ZRLE  encoding  from
              http://mobile.hitachi-system.co.jp/publications/ZYWRLE/ to the unix tightvnc viewer.

RESOURCES

       X resources that vncviewer knows about, aside from the normal Xt resources, are as follows:

       shareDesktop
              Equivalent of -shared/-noshared options. Default true.

       viewOnly
              Equivalent of -viewonly option. Default false.

       fullScreen
              Equivalent of -fullscreen option. Default false.

       grabKeyboard
              Grab keyboard in full-screen mode. This can help to solve problems  with  losing  keyboard  focus.
              Default false.

       raiseOnBeep
              Equivalent of -noraiseonbeep option, when set to false. Default true.

       passwordFile
              Equivalent of -passwd option.

       userLogin
              Equivalent of -user option.

       passwordDialog
              Whether  to use a dialog box to get the password (true) or get it from the tty (false). Irrelevant
              if passwordFile is set. Default false.

       encodings
              Equivalent of -encodings option.

       compressLevel
              Equivalent of -compresslevel option (TightVNC-specific).

       qualityLevel
              Equivalent of -quality option (TightVNC-specific).

       enableJPEG
              Equivalent of -nojpeg option, when set to false. Default true.

       useRemoteCursor
              Equivalent of -nocursorshape option, when set to false (TightVNC-specific). Default true.

       useBGR233
              Equivalent of -bgr233 option. Default false.

       nColours
              When using BGR233, try to allocate this many "exact" colors from the BGR233 color cube. When using
              a  shared colormap, setting this resource lower leaves more colors for other X clients. Irrelevant
              when using truecolor. Default is 256 (i.e. all of them).

       useSharedColours
              If the number of "exact" BGR233 colors successfully allocated is less than 256 then the  rest  are
              filled in using the "nearest" colors available. This resource says whether to only use the "exact"
              BGR233 colors for this purpose, or whether to use other clients' "shared" colors as well.  Default
              true (i.e. use other clients' colors).

       forceOwnCmap
              Equivalent of -owncmap option. Default false.

       forceTrueColour
              Equivalent of -truecolour option. Default false.

       requestedDepth
              Equivalent of -depth option.

       useSharedMemory
              Use MIT shared memory extension if on the same machine as the X server. Default true.

       wmDecorationWidth, wmDecorationHeight
              The  total width and height taken up by window manager decorations.  This is used to calculate the
              maximum size of the VNC viewer window.  Default is width 4, height 24.

       bumpScrollTime, bumpScrollPixels
              When in full screen mode and the VNC desktop is bigger  than  the  X  display,  scrolling  happens
              whenever the mouse hits the edge of the screen. The maximum speed of scrolling is bumpScrollPixels
              pixels every bumpScrollTime milliseconds. The actual speed of scrolling will be slower than  this,
              of course, depending on how fast your machine is.  Default 20 pixels every 25 milliseconds.

       popupButtonCount
              The  number  of  buttons  in  the popup window. See the README file for more information on how to
              customize the buttons.

       debug  For debugging. Default false.

       rawDelay, copyRectDelay
              For debugging, see the README file for details. Default 0 (off).

ENVIRONMENT

       When started with the -via option, vncviewer reads the VNC_VIA_CMD environment variable, expands patterns
       beginning  with  the  "%"  character,  and executes result as a command assuming that it would create TCP
       tunnel that should be used for VNC  connection.  If  not  set,  this  environment  variable  defaults  to
       "/usr/bin/ssh -f -L %L:%H:%R %G sleep 20".

       The  following  patterns  are recognized in the VNC_VIA_CMD (note that all the patterns %G, %H, %L and %R
       must be present in the command template):

       %%     A literal "%";

       %G     gateway host name;

       %H     remote VNC host name, as known to the gateway;

       %L     local TCP port number;

       %R     remote TCP port number.

SEE ALSO

       vncserver(1),     x11vnc(1),     ssvnc(1),     Xvnc(1),     vncpasswd(1),     vncconnect(1),      ssh(1),
       http://www.karlrunge.com/x11vnc, http://www.karlrunge.com/x11vnc/ssvnc.html

AUTHORS

       Original  VNC  was  developed  in  AT&T  Laboratories  Cambridge.  TightVNC  additions was implemented by
       Constantin Kaplinsky. Many other people participated in development, testing and support.  Karl J.  Runge
       added all of the SSVNC related features and improvements.

       Man page authors:
       Marcus Brinkmann <Marcus.Brinkmann@ruhr-uni-bochum.de>,
       Terran Melconian <terran@consistent.org>,
       Tim Waugh <twaugh@redhat.com>,
       Constantin Kaplinsky <const@ce.cctpu.edu.ru>
       Karl J. Runge <runge@karlrunge.com>

                                                   April 2010                                     ssvncviewer(1)