projects / thirdparty / util-linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 6c64d12d MB |
1 | // mcookie.1 -- |
| 2 | // Public Domain 1995 Rickard E. Faith (faith@cs.unc.edu) | |
| 3 | = mcookie(1) | |
| 4 | :doctype: manpage | |
| 5 | :man manual: User Commands | |
| 6 | :man source: util-linux {release-version} | |
| 7 | :page-layout: base | |
| 8 | :command: mcookie | |
| 9 | ||
| 10 | == NAME | |
| 11 | ||
| 12 | mcookie - generate magic cookies for xauth | |
| 13 | ||
| 14 | == SYNOPSIS | |
| 15 | ||
| 16 | *mcookie* [options] | |
| 17 | ||
| 18 | == DESCRIPTION | |
| 19 | ||
| 20 | *mcookie* generates a 128-bit random hexadecimal number for use with the X authority system. Typical usage: | |
| 21 | ||
| 22 | ____ | |
| 23 | *xauth add :0 . `mcookie`* | |
| 24 | ____ | |
| 25 | ||
| 26 | The "random" number generated is actually the MD5 message digest of random information coming from one of the sources *getrandom*(2) system call, _/dev/urandom_, _/dev/random_, or the _libc pseudo-random functions_, in this preference order. See also the option *--file*. | |
| 27 | ||
| 28 | == OPTIONS | |
| 29 | ||
| 30 | *-f*, *--file* _file_:: | |
| 31 | Use this _file_ as an additional source of randomness (for example _/dev/urandom_). When _file_ is '-', characters are read from standard input. | |
| 32 | ||
| 33 | *-m*, *--max-size* _number_:: | |
| 34 | Read from _file_ only this _number_ of bytes. This option is meant to be used when reading additional randomness from a file or device. + | |
| 35 | The _number_ argument may be followed by the multiplicative suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" is optional, e.g., "K" has the same meaning as "KiB") or the suffixes KB=1000, MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB. | |
| 36 | ||
| 37 | *-v*, *--verbose*:: | |
| 38 | Inform where randomness originated, with amount of entropy read from each source. | |
| 39 | ||
| 40 | *-V*, *--version*:: | |
| 41 | Display version information and exit. | |
| 42 | ||
| 43 | *-h*, *--help*:: | |
| 44 | Display help text and exit. | |
| 45 | ||
| 46 | == FILES | |
| 47 | ||
| 48 | _/dev/urandom_ + | |
| 49 | _/dev/random_ | |
| 50 | ||
| 51 | == BUGS | |
| 52 | ||
| 53 | It is assumed that none of the randomness sources will block. | |
| 54 | ||
| 55 | == SEE ALSO | |
| 56 | ||
| 57 | *md5sum*(1), | |
| 58 | *X*(7), | |
| 59 | *xauth*(1), | |
| 60 | *rand*(3) | |
| 61 | ||
| 62 | include::../man-common/bugreports.adoc[] | |
| 63 | ||
| 64 | include::../man-common/footer.adoc[] | |
| 65 | ||
| 66 | ifdef::translation[] | |
| 67 | include::../man-common/translation.adoc[] | |
| 68 | endif::[] |