2009-05-21 09:02:42 -05:00
|
|
|
.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
|
|
|
|
.\"
|
|
|
|
.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14.
|
|
|
|
.\"
|
|
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
|
|
.\"
|
|
|
|
.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger
|
2011-08-18 15:18:34 -05:00
|
|
|
.TH UUIDGEN 1 "June 2011" "util-linux" "User Commands"
|
2009-05-21 09:02:42 -05:00
|
|
|
.SH NAME
|
2011-08-18 15:18:34 -05:00
|
|
|
uuidgen \- create a new UUID value
|
2009-05-21 09:02:42 -05:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B uuidgen
|
2011-06-12 08:22:18 -05:00
|
|
|
[\fIoptions\fR]
|
2009-05-21 09:02:42 -05:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
|
|
|
.B uuidgen
|
|
|
|
program creates (and prints)
|
|
|
|
a new universally unique identifier (UUID) using the
|
|
|
|
.BR libuuid (3)
|
|
|
|
library. The new UUID can reasonably be considered unique among
|
|
|
|
all UUIDs created on the local system,
|
|
|
|
and among UUIDs created on other systems in the past
|
|
|
|
and in the future.
|
|
|
|
.PP
|
2010-06-10 07:04:26 -05:00
|
|
|
There are two types of UUIDs which
|
2009-05-21 09:02:42 -05:00
|
|
|
.B uuidgen
|
2011-08-28 04:14:42 -05:00
|
|
|
can generate: time-based UUIDs and random-based UUIDs. By default
|
2009-05-21 09:02:42 -05:00
|
|
|
.B uuidgen
|
|
|
|
will generate a random-based UUID if a high-quality random number
|
2011-08-28 04:14:42 -05:00
|
|
|
generator is present. Otherwise, it will choose a time-based UUID.
|
|
|
|
It is possible to force the generation of one of these two
|
2009-05-21 09:02:42 -05:00
|
|
|
UUID types by using the
|
|
|
|
.B \-r
|
|
|
|
or
|
|
|
|
.B \-t
|
|
|
|
options.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
2011-08-28 04:14:42 -05:00
|
|
|
.BR \-r , " \-\-random"
|
2009-05-21 09:02:42 -05:00
|
|
|
Generate a random-based UUID. This method creates a UUID consisting mostly
|
|
|
|
of random bits. It requires that the operating system have a high
|
|
|
|
quality random number generator, such as
|
|
|
|
.IR /dev/random .
|
|
|
|
.TP
|
2011-08-28 04:14:42 -05:00
|
|
|
.BR \-t , " \-\-time"
|
2009-05-21 09:02:42 -05:00
|
|
|
Generate a time-based UUID. This method creates a UUID based on the system
|
|
|
|
clock plus the system's ethernet hardware address, if present.
|
2011-06-12 08:22:18 -05:00
|
|
|
.TP
|
2011-08-28 04:14:42 -05:00
|
|
|
.BR \-h , " \-\-help"
|
|
|
|
Display help text and exit.
|
2011-06-12 08:22:18 -05:00
|
|
|
.TP
|
2011-08-28 04:14:42 -05:00
|
|
|
.BR \-V , " \-\-version"
|
|
|
|
Display version information and exit.
|
2009-05-21 09:02:42 -05:00
|
|
|
.SH "CONFORMING TO"
|
|
|
|
OSF DCE 1.1
|
|
|
|
.SH AUTHOR
|
|
|
|
.B uuidgen
|
|
|
|
was written by Andreas Dilger for libuuid.
|
|
|
|
.SH AVAILABILITY
|
2010-11-30 04:41:59 -06:00
|
|
|
The uuidgen command is part of the util-linux package and is available from
|
|
|
|
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
|
2009-05-21 09:02:42 -05:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR libuuid (3)
|