Module Name: src
Committed By: riastradh
Date: Wed Jul 24 06:11:57 UTC 2019
Modified Files:
src/lib/libc/sys: uuidgen.2
Log Message:
Update uuidgen(2) man page to reflect reality as of five years ago.
To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/lib/libc/sys/uuidgen.2
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/sys/uuidgen.2
diff -u src/lib/libc/sys/uuidgen.2:1.4 src/lib/libc/sys/uuidgen.2:1.5
--- src/lib/libc/sys/uuidgen.2:1.4 Sun Jan 30 18:13:04 2005
+++ src/lib/libc/sys/uuidgen.2 Wed Jul 24 06:11:57 2019
@@ -1,4 +1,4 @@
-.\" $NetBSD: uuidgen.2,v 1.4 2005/01/30 18:13:04 jwise Exp $
+.\" $NetBSD: uuidgen.2,v 1.5 2019/07/24 06:11:57 riastradh Exp $
.\" $FreeBSD: src/lib/libc/sys/uuidgen.2,v 1.7 2003/06/27 13:41:29 yar Exp $
.\" Copyright (c) 2002 Marcel Moolenaar
.\" All rights reserved.
@@ -47,27 +47,14 @@ system call generates
universally unique identifiers (UUIDs) and writes them to the buffer
pointed to by
.Fa store .
-The identifiers are generated according to the syntax and semantics of the
-DCE version 1 variant of universally unique identifiers.
-See below for a more in-depth description of the identifiers.
-When no IEEE 802
-address is available for the node field, a random multi-cast address is
-generated for each invocation of the system call.
-According to the algorithm of generating time-based UUIDs, this will also
-force a new random clock sequence, thereby increasing the likelihood for
-the identifier to be unique.
-.Pp
-When multiple identifiers are to be generated, the
-.Fn uuidgen
-system call will generate a set of identifiers that is dense in such a way
-that there is no identifier that is larger than the smallest identifier in the
-set and smaller than the largest identifier in the set and that is not already
-in the set.
+The identifiers are randomly generated according to UUID version 4.
.Pp
Universally unique identifiers, also known as globally unique identifiers
(GUIDs), have a binary representation of 128-bits.
-The grouping and meaning of these bits is described by the following
-structure and its description of the fields that follow it:
+The grouping and meaning of these bits is based on historical methods
+of generation from on timestamps and IEEE 802 MAC addresses, and is
+described by the following structure and its description of the fields
+that follow it:
.Bd -literal
struct uuid {
uint32_t time_low;
@@ -132,9 +119,19 @@ argument is less than 1 or larger than t
.Sh SEE ALSO
.Xr uuidgen 1 ,
.Xr uuid 3
+.Rs
+.%A P. Leach
+.%A M. Mealling
+.%A R. Salz
+.%T A Universally Unique IDentifier (UUID) URN Namespace
+.%R RFC 4122
+.%I IETF
+.%D July 2005
+.Re
.Sh STANDARDS
-The identifiers are represented and generated in conformance with the DCE 1.1
-RPC specification.
+The identifiers are represented and generated in conformance with IETF
+RFC 4122, based on the historic DCE 1.1 RPC specification of the Open
+Software Foundation (now the Open Group).
The
.Fn uuidgen
system call is itself not part of the specification.
@@ -145,3 +142,6 @@ system call first appeared in
.Fx 5.0
and was subsequently added to
.Nx 2.0 .
+It was changed to use version 4 UUIDs, i.e. randomly generated UUIDs,
+in
+.Nx 8.0 .
