[src/trunk]: src/lib/libc/sys Update uuidgen(2) man page to reflect reality a...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/4c861a414e94
branches:  trunk
changeset: 462055:4c861a414e94
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Wed Jul 24 06:11:57 2019 +0000

description:
Update uuidgen(2) man page to reflect reality as of five years ago.

diffstat:

 lib/libc/sys/uuidgen.2 |  42 +++++++++++++++++++++---------------------
 1 files changed, 21 insertions(+), 21 deletions(-)

diffs (71 lines):

diff -r f66a86b398f5 -r 4c861a414e94 lib/libc/sys/uuidgen.2
--- a/lib/libc/sys/uuidgen.2    Wed Jul 24 06:07:57 2019 +0000
+++ b/lib/libc/sys/uuidgen.2    Wed Jul 24 06:11:57 2019 +0000
@@ -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 @@
 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 @@
 .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 @@
 .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 .