Whamcloud - gitweb
libext2fs: install hashmap.h since it is needed by libext2fs.h
[tools/e2fsprogs.git] / misc / uuidgen.1.in
index c521a89..cb8b3a8 100644 (file)
@@ -1,15 +1,15 @@
 .\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
 .\"
 .\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14.
 .\" 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.
 .\" This file may be copied under the terms of the GNU Public License.
-.\" 
+.\"
 .\" Created  Wed Mar 10 17:42:12 1999, Andreas Dilger
 .TH UUIDGEN 1 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
 .SH NAME
 uuidgen \- command\-line utility to create a new UUID value
 .SH SYNOPSIS
 .\" Created  Wed Mar 10 17:42:12 1999, Andreas Dilger
 .TH UUIDGEN 1 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
 .SH NAME
 uuidgen \- command\-line utility to create a new UUID value
 .SH SYNOPSIS
-.B uuidgen 
+.B uuidgen
 [
 .B \-r
 |
 [
 .B \-r
 |
@@ -18,21 +18,22 @@ uuidgen \- command\-line utility to create a new UUID value
 .SH DESCRIPTION
 The
 .B uuidgen
 .SH DESCRIPTION
 The
 .B uuidgen
-program creates a new universally unique identifier (UUID) using the
+program creates (and prints)
+a new universally unique identifier (UUID) using the
 .BR libuuid (3)
 .BR libuuid (3)
-library.  The new UUID can reasonably be considered unique among 
-all UUIDs created on the local system, 
+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
 and among UUIDs created on other systems in the past
 and in the future.
 .PP
-There are two types of UUID's which 
+There are two types of UUID's which
 .B uuidgen
 .B uuidgen
-can generate: time-based UUID's and random-based UUID's.  By 
-default 
+can generate: time-based UUID's and random-based UUID's.  By
+default
 .B uuidgen
 will generate a random-based UUID if a high-quality random number
 .B uuidgen
 will generate a random-based UUID if a high-quality random number
-generator is present.  Otherwise, it will chose a time-based UUID.  It 
-is possible to force the generation of one of these two 
+generator is present.  Otherwise, it will chose a time-based UUID.  It
+is possible to force the generation of one of these two
 UUID types by using the
 .B \-r
 or
 UUID types by using the
 .B \-r
 or
@@ -47,12 +48,8 @@ quality random number generator, such as
 .IR /dev/random .
 .TP
 .B \-t
 .IR /dev/random .
 .TP
 .B \-t
-Generate a time-based UUID.  This method creates a UUID based on the system 
+Generate a time-based UUID.  This method creates a UUID based on the system
 clock plus the system's ethernet hardware address, if present.
 clock plus the system's ethernet hardware address, if present.
-.SH RETURN VALUE
-The UUID of the form 1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in
-.BR printf (3)
-format "%08x-%04x-%04x-%04x-%012x") is output to the standard output.
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR
@@ -60,7 +57,7 @@ OSF DCE 1.1
 was written by Andreas Dilger for libuuid.
 .SH AVAILABILITY
 .B uuidgen
 was written by Andreas Dilger for libuuid.
 .SH AVAILABILITY
 .B uuidgen
-is part of libuuid from the e2fsprogs package and is available for anonymous
-ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs.
+is part of libuuid from the e2fsprogs package and is available from
+http://e2fsprogs.sourceforge.net.
 .SH "SEE ALSO"
 .BR libuuid (3)
 .SH "SEE ALSO"
 .BR libuuid (3)