VNCVIEWER(1)						      General Commands Manual						      VNCVIEWER(1)

NAME

       vncviewer - VNC client application

SYNOPSIS

       vncviewer [options] host:display#
       vncviewer [options] -listen [display#]

DESCRIPTION

       View a VNC session.  This is an Xt-based client application for the VNC (Virtual Network Computing) system.  You can use vncviewer to use a
       computing desktop environment that is running on a different machine.

       You can use F8 to display a pop-up utility menu.

OPTIONS

       The options are standard Xt options, or:

       -shared
	      When connecting, specify that a shared connection is allowed.  This is the default.

       -noshared
	      When connecting, specify that the session may not be shared.

       -viewonly
	      Block mouse and keyboard events.

       -fullscreen
	      Occupy the entire screen.

       -passwd passwd-file
	      File from which to get the password (as generated by the vncpasswd(1) program).

       -encodings encoding-list
	      A list of encodings to use in order of preference, separated by spaces.  The default is "copyrect tight hextile zlib corre rre",	or
	      "raw copyrect tight hextile zlib corre rre" for a VNC server on the same machine.

       -bgr233
	      Always use the BGR233 (8-bit) pixel format on the wire, regardless of the visual.

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

       -truecolour
	      Try to use a TrueColor visual.

       -depth depth
	      Try to use a visual of this depth (bits per pixel).

       -compresslevel level
	      Use specified compression level (0-9) for tight encoding.

       -quality level
	      Use the specified image quality level (0-9) for tight encoding.

       -nocursorshape
	      Disable the local cursor shape extension.

       -via gateway [host]:display
	      Tunnel via the gateway to the specified VNC host's display.  By default this uses ssh(1).

       -noraiseonbeep
	      By default the viewer window is raised when a beep (bell) is received from the VNC session.  This option disables that.

RESOURCES

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

       shareDesktop (class ShareDesktop)
	       Equivalent of -noshared/-shared options.  Default true.

       viewOnly (class ViewOnly)
	       Equivalent of -viewonly option.	Default false.

       fullScreen (class FullScreen)
	       Equivalent of -fullscreen option.  Default false.

       raiseOnBeep (class RaiseOnBeep)
	       Equivalent of -noraiseonbeep option.  Default true.

       passwordFile (class PasswordFile)
	       Equivalent of -passwd option.

       serverDialog (class ServerDialog)
	       Settings for dialog widget.

       passwordDialog (class PasswordDialog)
	       Settings for dialog widget.

       encodings (class Encodings)
	       Equivalent of -encodings option.

       useBGR233 (class UseBGR233)
	       Equivalent of -bgr233 option.  Default false.

       nColours (class NColours)
	       Try to allocate this many exact colours from the BGR233 colour cube (when using BGR233).

       useSharedColours (class UseSharedColours)
	       Try to use shared colours.  Default true.

       forceOwnCmap (class ForceOwnCmap)
	       Equivalent of -owncmap option.  Default false.

       forceTrueColour (class ForceTrueColour)
	       Equivalent of -truecolour option.  Default false.

       requestedDepth (class RequestedDepth)
	       Equivalent of -depth option.

       useSharedMemory (class UseSharedMemory)
	       Use MIT shared memory extension if available.  Default true.

       wmDecorationWidth (class WmDecorationWidth)
	       For calculating maximum VNC window size.  Default 4.

       wmDecorationHeight (class WmDecorationHeight)
	       For calculating maximum VNC window size.  Default 24.

       popupButtonCount (class PopupButtonCount)
	       Custom buttons.	See the README file for more information on how to customize buttons.

       debug (class Debug)
	       For debugging.  Default false.

       rawDelay (class RawDelay)
	       For debugging.  Default 0 (off).

       copyRectDelay (class CopyRectDelay)
	       For debugging.  Default 0 (off).

       compressLevel (class CompressionLevel)
	       Equivalent of -compresslevel option.

       qualityLevel (class QualityLevel)
	       Equivalent of -quality option.

       useRemoteCursor (class UseRemoteCursor)
	       Equivalent of -nocursorshape option.  Default true.

SEE ALSO

       vncserver(1), Xvnc(1), vncpasswd(1), vncconnect(1)

AUTHOR

       AT&T Laboratories Cambridge
       Man page by Tim Waugh <twaugh@redhat.com>

								    4 May 2001							      VNCVIEWER(1)