]>
Commit | Line | Data |
---|---|---|
5d45d803 TT |
1 | .\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) |
2 | .\" | |
3 | .\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. | |
d04ad325 | 4 | .\" |
5d45d803 | 5 | .\" This file may be copied under the terms of the GNU Public License. |
d04ad325 | 6 | .\" |
5d45d803 | 7 | .\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger |
b19d1a95 | 8 | .TH UUIDGEN 1 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
5d45d803 | 9 | .SH NAME |
b19d1a95 | 10 | uuidgen \- command\-line utility to create a new UUID value |
5d45d803 | 11 | .SH SYNOPSIS |
d04ad325 | 12 | .B uuidgen |
5dbb072e | 13 | [ |
caf8ce4c TT |
14 | .B \-r |
15 | | | |
16 | .B \-t | |
5dbb072e | 17 | ] |
5d45d803 TT |
18 | .SH DESCRIPTION |
19 | The | |
20 | .B uuidgen | |
d04ad325 | 21 | program creates (and prints) |
3b302c2c | 22 | a new universally unique identifier (UUID) using the |
5dbb072e | 23 | .BR libuuid (3) |
d04ad325 TT |
24 | library. The new UUID can reasonably be considered unique among |
25 | all UUIDs created on the local system, | |
5dbb072e | 26 | and among UUIDs created on other systems in the past |
5d45d803 | 27 | and in the future. |
5dbb072e | 28 | .PP |
d04ad325 | 29 | There are two types of UUID's which |
5dbb072e | 30 | .B uuidgen |
d04ad325 TT |
31 | can generate: time-based UUID's and random-based UUID's. By |
32 | default | |
5dbb072e | 33 | .B uuidgen |
caf8ce4c | 34 | will generate a random-based UUID if a high-quality random number |
d04ad325 TT |
35 | generator is present. Otherwise, it will chose a time-based UUID. It |
36 | is possible to force the generation of one of these two | |
5dbb072e | 37 | UUID types by using the |
caf8ce4c TT |
38 | .B \-r |
39 | or | |
40 | .B \-t | |
41 | options. | |
42 | .SH OPTIONS | |
5dbb072e | 43 | .TP |
caf8ce4c | 44 | .B \-r |
5dbb072e TT |
45 | Generate a random-based UUID. This method creates a UUID consisting mostly |
46 | of random bits. It requires that the operating system have a high | |
caf8ce4c TT |
47 | quality random number generator, such as |
48 | .IR /dev/random . | |
5dbb072e | 49 | .TP |
caf8ce4c | 50 | .B \-t |
d04ad325 | 51 | Generate a time-based UUID. This method creates a UUID based on the system |
5dbb072e | 52 | clock plus the system's ethernet hardware address, if present. |
5d45d803 TT |
53 | .SH "CONFORMING TO" |
54 | OSF DCE 1.1 | |
55 | .SH AUTHOR | |
56 | .B uuidgen | |
57 | was written by Andreas Dilger for libuuid. | |
58 | .SH AVAILABILITY | |
59 | .B uuidgen | |
6d56d51a TT |
60 | is part of libuuid from the e2fsprogs package and is available from |
61 | http://e2fsprogs.sourceforge.net. | |
5d45d803 TT |
62 | .SH "SEE ALSO" |
63 | .BR libuuid (3) |