diff options
| author | Sami Kerola | 2011-06-11 17:44:12 +0200 |
|---|---|---|
| committer | Sami Kerola | 2011-06-25 12:37:38 +0200 |
| commit | 177f48fa0c729058e4be84bb5d75d4026a2b3ae2 (patch) | |
| tree | 7b6ccc50e80dec48b03730053a539fe29bd3187b /misc-utils/mcookie.1 | |
| parent | mcookie: use warnx, long options and help screen (diff) | |
| download | kernel-qcow2-util-linux-177f48fa0c729058e4be84bb5d75d4026a2b3ae2.tar.gz kernel-qcow2-util-linux-177f48fa0c729058e4be84bb5d75d4026a2b3ae2.tar.xz kernel-qcow2-util-linux-177f48fa0c729058e4be84bb5d75d4026a2b3ae2.zip | |
docs: inform about mcookie long options
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
Diffstat (limited to 'misc-utils/mcookie.1')
| -rw-r--r-- | misc-utils/mcookie.1 | 27 |
1 files changed, 19 insertions, 8 deletions
diff --git a/misc-utils/mcookie.1 b/misc-utils/mcookie.1 index 641a7c559..e7579c4b9 100644 --- a/misc-utils/mcookie.1 +++ b/misc-utils/mcookie.1 @@ -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 |