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 3/14/26)
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 3/14/26)