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 --
.\" 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
mcookie \- generate magic cookies for xauth
.SH SYNOPSIS
.B mcookie
.RB [ \-v ]
.RB [ \-f
.IR filename ]
[\fIoptions\fR]
.SH DESCRIPTION
.B mcookie
generates a 128-bit random hexadecimal number for use with the X authority
@ -18,15 +16,28 @@ xauth add :0 . `mcookie`
.PP
The "random" number generated is actually the output of the MD5 message
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
.B \-f
is specified), and several bytes of information from the first of the
following devices which is present:
process id, the parent process id, and optionally the contents of an input
file. and several bytes of information from the first of the following
devices which is present:
.IR /dev/random ,
.IR /dev/urandom ,
files in
.IR /proc ,
.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
The entropy in the generated 128-bit is probably quite small (and,
therefore, vulnerable to attack) unless a non-pseudorandom number generator