]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
docs: inform about mcookie long options
authorSami Kerola <kerolasa@iki.fi>
Sat, 11 Jun 2011 15:44:12 +0000 (17:44 +0200)
committerSami Kerola <kerolasa@iki.fi>
Sat, 25 Jun 2011 10:37:38 +0000 (12:37 +0200)
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
misc-utils/mcookie.1

index 641a7c55972c85a615ab69e42cfabd271a31cda3..e7579c4b9dcc3a789718baad3071ff605785ce05 100644 (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