docs: inform about mcookie long options

Signed-off-by: Sami Kerola <kerolasa@iki.fi>
This commit is contained in:
Sami Kerola 2011-06-11 17:44:12 +02:00
parent e40f84b9d0
commit 177f48fa0c
1 changed files with 19 additions and 8 deletions

View File

@ -1,13 +1,11 @@
.\" mcookie.1 -- .\" mcookie.1 --
.\" Public Domain 1995 Rickard E. Faith (faith@cs.unc.edu) .\" Public Domain 1995 Rickard E. Faith (faith@cs.unc.edu)
.TH MCOOKIE 1 "25 September 1995" "" "Linux Programmer's Manual" .TH MCOOKIE 1 "June 2011" "util-linux" "User Commands"
.SH NAME .SH NAME
mcookie \- generate magic cookies for xauth mcookie \- generate magic cookies for xauth
.SH SYNOPSIS .SH SYNOPSIS
.B mcookie .B mcookie
.RB [ \-v ] [\fIoptions\fR]
.RB [ \-f
.IR filename ]
.SH DESCRIPTION .SH DESCRIPTION
.B mcookie .B mcookie
generates a 128-bit random hexadecimal number for use with the X authority generates a 128-bit random hexadecimal number for use with the X authority
@ -18,15 +16,28 @@ xauth add :0 . `mcookie`
.PP .PP
The "random" number generated is actually the output of the MD5 message The "random" number generated is actually the output of the MD5 message
digest fed with various pieces of random information: the current time, the digest fed with various pieces of random information: the current time, the
process id, the parent process id, the contents of an input file (if process id, the parent process id, and optionally the contents of an input
.B \-f file. and several bytes of information from the first of the following
is specified), and several bytes of information from the first of the devices which is present:
following devices which is present:
.IR /dev/random , .IR /dev/random ,
.IR /dev/urandom , .IR /dev/urandom ,
files in files in
.IR /proc , .IR /proc ,
.IR /dev/audio . .IR /dev/audio .
.SH OPTIONS
.TP
\fB\-f\fR, \fB\-\-file\fR=\fIFILE\fR
Use file as a macig cookie seed. When file is defined as `-' character
input is read from stdin.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Explain what is being done.
.TP
\fB\-V\fR, \fB\-\-version\fR
Output version information and exit.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display this help and exit.
.SH BUGS .SH BUGS
The entropy in the generated 128-bit is probably quite small (and, The entropy in the generated 128-bit is probably quite small (and,
therefore, vulnerable to attack) unless a non-pseudorandom number generator therefore, vulnerable to attack) unless a non-pseudorandom number generator