extern/KasmVNC
1
0
Fork 0
mirror of https://github.com/kasmtech/KasmVNC.git synced 2025-02-16 18:31:50 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update vncpasswd manual page

Browse Source
This commit is contained in:
Dmitry Maksyoma 2021-03-13 20:07:06 +13:00
parent 56ed2855bd
commit 2b8374f544
1 changed files with 58 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
unix/vncpasswd/vncpasswd.man
View File

@ -2,18 +2,15 @@
.SH NAME .SH NAME
vncpasswd \- change the VNC password vncpasswd \- change the VNC password
.SH SYNOPSIS .SH SYNOPSIS
\fBvncpasswd\fR [\fIpasswd-file\fR] \fBvncpasswd\fR -u [\fIusername\fR] [\fI-wnod\fR] [\fIpasswd-file\fR]
.br
\fBvncpasswd\fR \-f
.SH DESCRIPTION .SH DESCRIPTION
.B vncpasswd .B vncpasswd
allows you to set the password used to access VNC desktops. Its default allows you to set the password used to access VNC desktops. Its default
behavior is to prompt for a VNC password and then store an obfuscated version behavior is to prompt for a VNC password and then store an obfuscated version
of this password to \fIpasswd-file\fR (or to $HOME/.vnc/passwd if no password of this password to \fIpasswd-file\fR (or to $HOME/.kasmpasswd if no password
file is specified.) The \fBvncserver\fP script runs \fBvncpasswd\fP the first file is specified.) The \fBvncserver\fP script will ask you to add a user
time you start a VNC desktop, and it invokes \fBXvnc\fP with the appropriate the first time you start a VNC desktop. HTTP Basic Authentication will be used
\fB\-rfbauth\fP option. \fBvncviewer\fP can also be given a password file to to ask for username and password, when you connect.
use via the \fB\-passwd\fP option.
The password must be at least six characters long (unless the \fB\-f\fR The password must be at least six characters long (unless the \fB\-f\fR
command-line option is used-- see below), and only the first eight command-line option is used-- see below), and only the first eight
@ -27,22 +24,67 @@ crack the password simply by snooping on the network.
.SH OPTIONS .SH OPTIONS
.TP .TP
.B \-f .B \-u \fIname\fR
Filter mode. Read a plain-text password from stdin and write an encrypted
version to stdout. Note that in filter mode, short or even empty passwords
will be silently accepted.
A view-only password must be separated from the normal password by a newline Specify user name. There can be multiple users.
character.
.TP
.B \-w
Write permission. Enable user to use mouse and keyboard. The default mode is to
view only.
.TP
.B \-o
Owner permission. Allow the user to add/delete users and change their
permissions.
.TP
.B \-d
Delete user specified with \fI-u\fR. You need the owner permission for that.
.TP
.B \-n
Don't update their password, while updating permissions.
.SH FILES .SH FILES
.TP .TP
$HOME/.vnc/passwd $HOME/.kasmpasswd
Default location of the VNC password file. Default location of the VNC password file.
.SH EXAMPLES
.TP
Create a new user foo that can to use mouse and keyboard:
$ vncpasswd -u foo -w
.TP
Create a new user foo that can view, but can't use mouse and keyboard:
$ vncpasswd -u foo
.TP
Create a new user foo that can add new users AND use mouse and keyboard:
$ vncpasswd -u foo -ow
.TP
Delete user foo
$ vncpasswd -u foo -d
.TP
Strip all permissions from user foo, making it view only. Don't touch password.
$ vncpasswd -u foo -n
.TP
Strip all permissions from user foo, making it view only. Change password.
$ vncpasswd -u foo
.TP
Add write permission for user foo. Don't touch password.
$ vncpasswd -u foo -w -n
.SH SEE ALSO .SH SEE ALSO
.BR vncviewer (1),
.BR vncserver (1), .BR vncserver (1),
.BR Xvnc (1) .BR Xvnc (1)
.BR vncconfig (1), .BR vncconfig (1),