mirror of
git://git.9front.org/plan9front/plan9front
synced 2025-01-12 11:10:06 +00:00
4d69aacea0
Add vncv option '-a' to autoscale remote frame buffer to local screen window size; useful when remote frame buffer is larger than the local screen. If the remote frame buffer is larger than the local screen, and autoscaling is disabled, only the upper left corner is accessible.
220 lines
3.8 KiB
Text
220 lines
3.8 KiB
Text
.TH VNC 1
|
|
.SH NAME
|
|
vncs, vncv \- remote frame buffer server and viewer for Virtual Network Computing (VNC)
|
|
.SH SYNOPSIS
|
|
.B vncs
|
|
[
|
|
.B -v
|
|
]
|
|
[
|
|
.B -c
|
|
.I cert
|
|
]
|
|
[
|
|
.B -d
|
|
.BI : display
|
|
]
|
|
[
|
|
.B -g
|
|
.IB width x height
|
|
]
|
|
[
|
|
.B -p
|
|
.I pixfmt
|
|
]
|
|
[
|
|
.B -x
|
|
.I net
|
|
]
|
|
[
|
|
.I cmd
|
|
[
|
|
.I args
|
|
...
|
|
]
|
|
]
|
|
.PP
|
|
.B vncs
|
|
.B -k
|
|
.BI : display
|
|
[
|
|
.B -x
|
|
.I net
|
|
]
|
|
.PP
|
|
.B vncv
|
|
[
|
|
.B -acstv
|
|
]
|
|
[
|
|
.B -e
|
|
.I encodings
|
|
]
|
|
[
|
|
.B -l
|
|
.I charset
|
|
]
|
|
[
|
|
.B -k
|
|
.I keypattern
|
|
]
|
|
.IR host [\fL: n ]
|
|
.SH DESCRIPTION
|
|
VNC is a lightweight protocol
|
|
for accessing graphical applications
|
|
remotely. The protocol allows one or more
|
|
clients to connect to a server.
|
|
While connected, clients display the frame buffer
|
|
presented by the server and can send mouse events,
|
|
keyboard events, and exchange snarf buffers.
|
|
The server persists across viewer sessions, so that
|
|
the virtual application can be accessed from various locations
|
|
as its owner moves around.
|
|
.PP
|
|
VNC displays have names of the form
|
|
.IB host : n \fR,
|
|
where
|
|
.I host
|
|
is the machine's network name and
|
|
.I n
|
|
is a small integer identifier; display
|
|
.I n
|
|
is served on TCP port
|
|
.RI 5900+ n .
|
|
.PP
|
|
.I Vncs
|
|
starts a new virtual frame buffer in memory, simulating
|
|
a Plan 9 terminal running
|
|
.I cmd
|
|
.IR args ,
|
|
by default an interactive shell.
|
|
As viewers connect, each is authenticated using a
|
|
(rather breakable) challenge-response protocol using
|
|
the user's Inferno/POP password.
|
|
.PP
|
|
The options are:
|
|
.TF "\fL-p \fIpixfmt"
|
|
.PD
|
|
.TP
|
|
.B -c \fIcert
|
|
start TLS on each viewer connection using the certificate
|
|
in the file
|
|
.IR cert .
|
|
The corresponding private key must be loaded into
|
|
the server's
|
|
.IR factotum (4).
|
|
When serving TLS connections, the base port is
|
|
35729 rather than 5900.
|
|
.TP
|
|
.B -d :\fIn
|
|
run on display
|
|
.I n ;
|
|
without this option, the server searches
|
|
for an unused display.
|
|
.TP
|
|
.B -g \fIwidth\fBx\fIheight\fR
|
|
set the virtual frame buffer to be
|
|
.IB width x height
|
|
(default
|
|
1024x768)
|
|
pixels.
|
|
.TP
|
|
.B -p \fIpixfmt
|
|
set the virtual frame buffer's internal pixel format to
|
|
.I pixfmt
|
|
(default
|
|
.BR r5g6b5 ).
|
|
.TP
|
|
.B -v
|
|
print verbose output to standard error.
|
|
.TP
|
|
.B -x \fInet
|
|
announce on an alternate network interface.
|
|
.TP
|
|
.B -A
|
|
turn off authentication.
|
|
.PD
|
|
.PP
|
|
The command
|
|
.B vncs
|
|
.B -k
|
|
.BI : n
|
|
kills the VNC server running on display
|
|
.IR n .
|
|
.PP
|
|
.I Vncv
|
|
provides access to remote display
|
|
.IB host : n \fR.
|
|
It resizes its window to be the smaller of the
|
|
remote frame buffer size and the local screen
|
|
when not using the autoscaling option.
|
|
.PP
|
|
The options are:
|
|
.TP
|
|
.B -a
|
|
autoscale remote frame buffer to local screen window size.
|
|
.TP
|
|
.B -c
|
|
when connecting to 8-bit displays, request
|
|
.B r4g4b4
|
|
pixels rather than
|
|
.B r3g3b2
|
|
pixels.
|
|
This takes up more bandwidth but usually gives
|
|
significantly better matching to the Plan 9 color map.
|
|
.TP
|
|
.B -e \fIencodings
|
|
set the ordered list of allowed frame buffer update encodings.
|
|
The default (and full) set is
|
|
.B copyrect
|
|
.B corre
|
|
.B hextile
|
|
.B rre
|
|
.B raw
|
|
.B mousewarp
|
|
.B desktopsize
|
|
.BR xdesktopsize .
|
|
The encodings should be given as a single space-separated argument
|
|
(quoted when using the shell).
|
|
.TP
|
|
.B -l \fIcharset
|
|
sets the character set (see
|
|
.IR tcs (1))
|
|
used by the server to encode clipboard text. The default is
|
|
.B utf-8.
|
|
.TP
|
|
.B -k \fIkeypattern
|
|
add
|
|
.I keypattern
|
|
to the pattern used to select a key from
|
|
.IR factotum (4).
|
|
.TP
|
|
.B -s
|
|
share the display with extant viewers;
|
|
by default extant viewers are closed
|
|
when a new viewer connects.
|
|
.TP
|
|
.B -t
|
|
start TLS on the connection.
|
|
.TP
|
|
.B -v
|
|
print verbose output to standard error.
|
|
.PD
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/vnc
|
|
.SH "SEE ALSO
|
|
.B http://www.uk.research.att.com/vnc
|
|
.SH BUGS
|
|
If the remote frame buffer is larger than the local screen,
|
|
and autoscaling is disabled, only the upper left corner can be accessed.
|
|
Autoscaling is only implemented for raw encoding.
|
|
.PP
|
|
.I Vncs
|
|
and
|
|
.I vncv
|
|
encryption is not secure. It's advisable to tunnel through
|
|
ssh or some other secure protocol.
|
|
.PP
|
|
.I Vncv
|
|
does no verification of the TLS certificate presented
|
|
by the server.
|