2022-09-30 10:04:15 +00:00
|
|
|
.TH WESTON-RDP 7 "2017-12-14" "Weston @version@"
|
|
|
|
.SH NAME
|
|
|
|
weston-vnc \- the VNC backend for Weston
|
|
|
|
.SH SYNOPSIS
|
2022-12-05 16:28:23 +00:00
|
|
|
.B weston --backend=vnc
|
2022-09-30 10:04:15 +00:00
|
|
|
.
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The VNC backend allows to run a
|
|
|
|
.B weston
|
|
|
|
environment without the need of specific graphic hardware, or input devices. Users can interact with
|
|
|
|
.B weston
|
|
|
|
only by connecting using the remote framebuffer protocol (RFB).
|
|
|
|
|
|
|
|
The VNC backend uses Neat VNC to implement the VNC part, it acts as a VNC server
|
|
|
|
listening for incoming connections. It supports different encodings for encoding
|
|
|
|
the graphical content, depending on what is supported by the VNC client.
|
|
|
|
|
|
|
|
The VNC backend is not multi-seat aware, so if a second client connects to the
|
|
|
|
backend, the first client will be disconnected.
|
|
|
|
|
2022-11-19 08:52:05 +00:00
|
|
|
The VNC client has to authenticate as the user running weston. This requires a PAM configuration file
|
|
|
|
.BR /etc/pam.d/weston-remote-access .
|
2022-09-30 10:04:15 +00:00
|
|
|
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH CONFIGURATION
|
|
|
|
.
|
|
|
|
The VNC backend uses the following entries from
|
|
|
|
.BR weston.ini .
|
|
|
|
.SS Section vnc
|
|
|
|
.TP
|
|
|
|
\fBrefresh-rate\fR=\fIrate\fR
|
|
|
|
Specifies the desktop redraw rate in Hz. If unspecified, the default is 60Hz. Changing
|
|
|
|
this may be useful if you have a faster than 60Hz display, or if you want to reduce updates to
|
|
|
|
reduce network traffic.
|
2023-07-11 11:57:12 +00:00
|
|
|
.TP
|
|
|
|
\fBtls\-key\fR=\fIfile\fR
|
|
|
|
The file containing the key for doing TLS security. To have TLS security you also need
|
|
|
|
to ship a file containing a certificate.
|
|
|
|
.TP
|
|
|
|
\fBtls\-cert\fR=\fIfile\fR
|
|
|
|
The file containing the certificate for doing TLS security. To have TLS security you also need
|
|
|
|
to ship a key file.
|
2022-09-30 10:04:15 +00:00
|
|
|
|
2023-10-05 09:42:24 +00:00
|
|
|
.SS Section output
|
|
|
|
.TP
|
|
|
|
\fBname\fR=\fIvnc\fR
|
|
|
|
The name
|
|
|
|
.BR vnc
|
|
|
|
is used to identify the VNC output.
|
|
|
|
.TP
|
|
|
|
\fBmode\fR=\fIwidth\fBx\fIheight\fR
|
|
|
|
Specifies the (initial) size for the output.
|
|
|
|
.TP
|
|
|
|
\fBresizeable\fR=\fIboolean\fR
|
|
|
|
Specifies whether the VNC client is allowed to resize the output.
|
|
|
|
|
2022-09-30 10:04:15 +00:00
|
|
|
.\" ***************************************************************
|
|
|
|
.SH OPTIONS
|
|
|
|
.
|
|
|
|
When the VNC backend is loaded,
|
|
|
|
.B weston
|
|
|
|
will understand the following additional command line options.
|
|
|
|
.TP
|
2023-12-06 09:19:08 +00:00
|
|
|
.B \-\-address\fR=\fIaddress\fR
|
|
|
|
The IP address on which the VNC backend will listen for VNC connections. By
|
|
|
|
default it listens on 0.0.0.0.
|
|
|
|
.TP
|
2022-09-30 10:04:15 +00:00
|
|
|
.B \-\-width\fR=\fIwidth\fR
|
|
|
|
The width of the framebuffer. It defaults to 640.
|
|
|
|
.TP
|
|
|
|
.B \-\-height\fR=\fIheight\fR
|
|
|
|
The height of the framebuffer. It defaults to 480.
|
|
|
|
.TP
|
|
|
|
\fB\-\-port\fR=\fIport\fR
|
|
|
|
The TCP port to listen on for connections. It defaults to 5900.
|
2022-10-06 10:18:04 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-vnc\-tls\-key\fR=\fIfile\fR
|
|
|
|
The file containing the key for doing TLS security. To have TLS security you also need
|
|
|
|
to ship a file containing a certificate.
|
|
|
|
.TP
|
|
|
|
\fB\-\-vnc\-tls\-cert\fR=\fIfile\fR
|
|
|
|
The file containing the certificate for doing TLS security. To have TLS security you also need
|
|
|
|
to ship a key file.
|
|
|
|
|
|
|
|
|
|
|
|
.\" ***************************************************************
|
|
|
|
.SH Generating cryptographic material for the VNC backend
|
|
|
|
.
|
|
|
|
You can generate a key and certificate file to use with TLS security using typical
|
|
|
|
.B openssl
|
|
|
|
invocations:
|
2022-09-30 10:04:15 +00:00
|
|
|
|
2022-10-06 10:18:04 +00:00
|
|
|
.nf
|
|
|
|
$ openssl genrsa -out tls.key 2048
|
|
|
|
Generating RSA private key, 2048 bit long modulus
|
|
|
|
[...]
|
|
|
|
$ openssl req -new -key tls.key -out tls.csr
|
|
|
|
[...]
|
|
|
|
$ openssl x509 -req -days 365 -signkey tls.key -in tls.csr -out tls.crt
|
|
|
|
[...]
|
|
|
|
.fi
|
|
|
|
|
|
|
|
You will get the tls.key and tls.crt files to use with the VNC backend.
|
|
|
|
.
|
2022-09-30 10:04:15 +00:00
|
|
|
.\" ***************************************************************
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR weston (1)
|
|
|
|
.\".BR weston.ini (5)
|