blob: 0396d9a1f507818d00a85d3d47e8bbee1cc1729d [file] [log] [blame]
.\" mcookie.1 --
.\" Public Domain 1995 Rickard E. Faith (
.TH MCOOKIE 1 "25 September 1995" "" "Linux Programmer's Manual"
mcookie \- generate magic cookies for xauth
.B mcookie
.RB [ \-v ]
.RB [ \-f
.IR filename ]
.B mcookie
generates a 128-bit random hexadecimal number for use with the X authority
system. Typical usage:
xauth add :0 . `mcookie`
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:
.IR /dev/random ,
.IR /dev/urandom ,
files in
.IR /proc ,
.IR /dev/audio .
The entropy in the generated 128-bit is probably quite small (and,
therefore, vulnerable to attack) unless a non-pseudorandom number generator
is used (e.g.,
.I /dev/random
under Linux).
It is assumed that none of the devices opened will block.
.I /dev/random
.I /dev/urandom
.I /dev/audio
.I /proc/stat
.I /proc/loadavg
.BR X (1),
.BR xauth (1),
.BR md5sum (1)
The mcookie command is part of the util-linux-ng package and is available from