NAME
vncserver - a wrapper to launch an X server for VNC.
SYNOPSIS
vncserver [:display] [-geometry widthxheight] [-depth depth]
[-pixelformat rgbNNN|bgrNNN] [-name desktop-name] [ -httpport int ] [
-basehttpport int ] [ -alwaysshared ] [ -nevershared ]
[Xvnc-options...]
vncserver [ -clean ] -kill :display
vncserver -help
DESCRIPTION
vncserver is a wrapper script for Xvnc, the free X server for VNC
(Virtual Network Computing). It provides all capabilities of a standard
X server, but does not connect to a display for itself. Instead, Xvnc
creates a virtual desktop you can view or control remotely using a VNC
viewer.
OPTIONS
You can add Xvnc options at the command line. They will be added to the
invocation of Xvnc without changes. The options provided by the
vncserver itself are as follows:
:display
The display number to use. If omitted, the next free display
number is used.
-geometry widthxheight
Set desktop width and height.
-depth depth
Set the colour depth of the visual to provide, in bits per
pixel. Must be a value between 8 and 32.
-pixelformat rgbNNN|bgrNNN
Set colour format for pixels representation. The viewer can do
the conversion to any other pixel format, but it is faster if
the depth and pixel format of the server is the same as the
equivalent values on the viewer display.
-name string
This specifies the name of the desktop.
-clean This option can be used in conjunction with
-kill :display
Stops the session running on the specified display.
-nevershared
Never allow shared desktops.
-alwaysshared
Always allow shared desktops.
-basehttpport int
The base http port to use for the java client applet (you have
to install the tightvnc-java package to make this work). The
real port number will be port = base + display num.
-httpport int
The http port to use for the java client applet (you have to
install the tightvnc-java package to make this work).
-help Prints a short usage notice to stderr.
EXAMPLES
vncserver
Invokes Xvnc on the next available display and with suitable
defaults.
vncserver :1
Invokes Xvnc on display :1.
vncserver -geometry 800x600 -depth 16 :1
Invokes Xvnc on display :1 with desktop size of 800x600 pixels
and color depth of 16 bits per pixel.
vncserver -kill :1
Shuts down Xvnc server on display :1.
SEE ALSO
Xvnc(1), vncviewer(1), vncpasswd(1), vncconnect(1)
AUTHORS
Original VNC was developed in AT&T Laboratories Cambridge. TightVNC
additions were implemented by Constantin Kaplinsky. Many other people
participated in development, testing and support.
Man page authors:
Marcus Brinkmann <Marcus.Brinkmann@ruhr-uni-bochum.de>,
Tim Waugh <twaugh@redhat.com>,
Constantin Kaplinsky <const@tightvnc.com>
August 2006 vncserver(1)