tigervncsession - start a VNC server
tigervncsession <
username> <:
display#>
tigervncsession is used to start a VNC (Virtual Network Computing)
desktop.
tigervncsession performs all the necessary steps to create a
new user session, run Xtigervnc with appropriate options and starts a window
manager on the VNC desktop.
tigervncsession is rarely called directly and is normally started by the
system service manager.
Several VNC-related files are found in the directory
~/.vnc:
- /etc/tigervnc/vncserver-config-defaults
- The optional system-wide equivalent of
~/.vnc/tigervnc.conf. If this file exists and defines options to be
passed to Xtigervnc, they will be used as defaults for users. The user's
~/.vnc/tigervnc.conf overrides settings configured in this file.
The overall configuration file load order is: this file,
~/.vnc/tigervnc.conf, and then
/etc/tigervnc/vncserver-config-mandatory. None are required to
exist.
- /etc/tigervnc/vncserver-config-mandatory
- The optional system-wide equivalent of
~/.vnc/tigervnc.conf. If this file exists and defines options to be
passed to Xtigervnc, they will override any of the same options defined in
a user's ~/.vnc/tigervnc.conf. This file offers a mechanism to
establish some basic form of system-wide policy. WARNING! There is nothing
stopping users from constructing their own tigervncsession-like script
that calls Xtigervnc directly to bypass any options defined in
/etc/tigervnc/vncserver-config-mandatory. The overall configuration
file load order is: /etc/tigervnc/vncserver-config-defaults,
~/.vnc/tigervnc.conf, and then this file. None are required to
exist.
- ~/.vnc/tigervnc.conf
- An optional server config file wherein options to be passed
to Xtigervnc are listed to avoid hard-coding them to the physical
invocation. This file uses perl(1) syntax. The special option
session can be used to control which session type will be started.
This should match one of the files in /usr/share/xsessions. E.g.,
if there is a file called gnome.desktop, then
$session="gnome"; would use that session type.
To be compatible with the upstream provided wrapper scripts, we will fall
back to trying to load configuration from ~/.vnc/config if
tigervnc.conf is not present. The ~/.vnc/config file lists
options one per line. Options without an argument are listed as a single
word, for example: "localhost" or "alwaysshared". For
those requiring an argument, separate the option from the argument with an
equal sign, for example, "session=gnome",
"geometry=2000x1200", or
"securitytypes=VncAuth,TLSVnc".
- ~/.vnc/passwd
- The VNC password file.
- ~/.vnc/host:display#.log
- The log file for Xtigervnc and the session.
xtigervncviewer(1),
tigervncpasswd(1),
tigervncconfig(1),
Xtigervnc(1)
https://www.tigervnc.org
Tristan Richardson, RealVNC Ltd., D. R. Commander and others.
VNC was originally developed by the RealVNC team while at Olivetti Research Ltd
/ AT&T Laboratories Cambridge. TightVNC additions were implemented by
Constantin Kaplinsky. Many other people have since participated in
development, testing and support. This manual is part of the TigerVNC software
suite.