Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / e2fsprogs_custom / 1f00aafd9f5a1c69d72233c5b7859a38a6c702e5 / . / misc / uuidgen.1.in
blob: c521a89db95f689a8e5c4468790592963bcbce86 [file] [log] [blame]
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]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.
4.\"
5.\" This file may be copied under the terms of the GNU Public License.
6.\"
7.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger
Theodore Ts'ob19d1a91999-06-18 00:32:03 +0000[diff] [blame]8.TH UUIDGEN 1 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]9.SH NAME
Theodore Ts'ob19d1a91999-06-18 00:32:03 +0000[diff] [blame]10uuidgen \- command\-line utility to create a new UUID value
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]11.SH SYNOPSIS
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]12.B uuidgen
13[
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]14.B \-r
15|
16.B \-t
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]17]
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]18.SH DESCRIPTION
19The
20.B uuidgen
Theodore Ts'ob19d1a91999-06-18 00:32:03 +0000[diff] [blame]21program creates a new universally unique identifier (UUID) using the
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]22.BR libuuid (3)
23library. The new UUID can reasonably be considered unique among
24all UUIDs created on the local system,
25and among UUIDs created on other systems in the past
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]26and in the future.
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]27.PP
28There are two types of UUID's which
29.B uuidgen
30can generate: time-based UUID's and random-based UUID's. By
31default
32.B uuidgen
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]33will generate a random-based UUID if a high-quality random number
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]34generator is present. Otherwise, it will chose a time-based UUID. It
35is possible to force the generation of one of these two
36UUID types by using the
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]37.B \-r
38or
39.B \-t
40options.
41.SH OPTIONS
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]42.TP
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]43.B \-r
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]44Generate a random-based UUID. This method creates a UUID consisting mostly
45of random bits. It requires that the operating system have a high
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]46quality random number generator, such as
47.IR /dev/random .
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]48.TP
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]49.B \-t
Theodore Ts'o5dbb0721999-07-03 06:16:06 +0000[diff] [blame]50Generate a time-based UUID. This method creates a UUID based on the system
51clock plus the system's ethernet hardware address, if present.
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]52.SH RETURN VALUE
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]53The UUID of the form 1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]54.BR printf (3)
Theodore Ts'ocaf8ce41999-10-21 19:56:34 +0000[diff] [blame]55format "%08x-%04x-%04x-%04x-%012x") is output to the standard output.
Theodore Ts'o5d45d801999-03-16 19:35:19 +0000[diff] [blame]56.SH "CONFORMING TO"
57OSF DCE 1.1
58.SH AUTHOR
59.B uuidgen
60was written by Andreas Dilger for libuuid.
61.SH AVAILABILITY
62.B uuidgen
63is part of libuuid from the e2fsprogs package and is available for anonymous
64ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs.
65.SH "SEE ALSO"
66.BR libuuid (3)