From 177f48fa0c729058e4be84bb5d75d4026a2b3ae2 Mon Sep 17 00:00:00 2001 From: Sami Kerola Date: Sat, 11 Jun 2011 17:44:12 +0200 Subject: [PATCH] docs: inform about mcookie long options Signed-off-by: Sami Kerola --- misc-utils/mcookie.1 | 27 +++++++++++++++++++-------- 1 file 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