VNCVIEWER(1)                                         VNCVIEWER(1)

     NAME
          vncviewer - remote frame buffer viewer

     SYNOPSIS
          vncviewer [ -e encodings ] [ -csv ] host[:n]

     DESCRIPTION
          Vncviewer provides access to remote frame buffer n on host
          using the VNC (Virtual Network Computing) protocol.  It
          resizes its window to be the smaller of the remote frame
          buffer size and the local screen.

          The -e option specifies an ordered list of rectangle encod-
          ings to allow in the protocol.  The default (and full set)
          is

               copyrect corre hextile rre raw

          By default, connecting to a display closes any other connec-
          tions to that display.  The -s option allows the other con-
          nections to share the display.

          The -v option causes verbose output.

          Vncviewer negotiates with the VNC server to settle on a
          true-color pixel format.  For true-color displays, this is
          the native display pixel format.  On eight bit color-mapped
          displays, vncviewer requests r3g3b2 pixels and upon receipt
          translates them to the nearest color in the map.  This does
          not cover the color map particularly well.  When invoked
          with the -c option, vncviewer requests r4g4b4 pixels
          instead.  This consumes more bandwidth but results in better
          matching to the available colors.

          Vncviewer correctly handles the typing of control characters
          and shifted keystrokes.  To support systems that require the
          use of modifiers like Alt, Ctl, and Shift on things like
          mouse events, typing the sequences Alt Z A (for Alt), Alt Z
          C (for Ctrl), and Alt Z S (for Shift) will send a ``key
          down'' message for the given key (see keyboard(6)). A corre-
          sponding ``key up'' message will be sent after the next key
          is pressed, or when the sequence is retyped, whichever hap-
          pens first.

     SOURCE
          /sys/src/cmd/vncviewer

     SEE ALSO
          drawterm(8)
          http://www.uk.research.att.com/vnc

     Page 1                       Plan 9             (printed 4/25/24)

     VNCVIEWER(1)                                         VNCVIEWER(1)

     BUGS
          If the remote frame buffer is larger than the local screen,
          only the upper left corner can be accessed.

     Page 2                       Plan 9             (printed 4/25/24)