From f67ba5ca5061e5ee1b9a3e1617d6a51a81e0c189 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Peter=20Babi=C4=8D?= <peter@babic.dev>
Date: Fri, 14 May 2021 14:11:08 +0200
Subject: [PATCH] uuid: add page, uuidgen: update description (#5892)

---
 pages/linux/uuid.md    | 33 +++++++++++++++++++++++++++++++++
 pages/linux/uuidgen.md | 10 ++++++----
 2 files changed, 39 insertions(+), 4 deletions(-)
 create mode 100644 pages/linux/uuid.md

diff --git a/pages/linux/uuid.md b/pages/linux/uuid.md
new file mode 100644
index 0000000000..c450c957ca
--- /dev/null
+++ b/pages/linux/uuid.md
@@ -0,0 +1,33 @@
+# uuid
+
+> Generate and decode Universally Unique Identifiers (UUID).
+> See also `uuidgen`.
+> More information: <https://manned.org/uuid>.
+
+- Generate a UUIDv1 (based on time and system's hardware address, if present):
+
+`uuid`
+
+- Generate a UUIDv4 (based on random data):
+
+`uuid -v {{4}}`
+
+- Generate multiple UUIDv4 identifiers at once:
+
+`uuid -v {{4}} -n {{number_of_uuids}}`
+
+- Generate a UUIDv4 and specify the output format:
+
+`uuid -v {{4}} -F {{BIN|STR|SIV}}`
+
+- Generate a UUIDv4 and write the output to a file:
+
+`uuid -v {{4}} -o {{path/to/file}}`
+
+- Generate a UUIDv5 (based on the supplied object name) with a specified namespace prefix:
+
+`uuid -v {{5}} ns:{{DNS|URL|OID|X500}} {{object_name}}`
+
+- Decode a given UUID:
+
+`uuid -d {{uuid}}`
diff --git a/pages/linux/uuidgen.md b/pages/linux/uuidgen.md
index 4603c48ab2..e1679eca2e 100644
--- a/pages/linux/uuidgen.md
+++ b/pages/linux/uuidgen.md
@@ -1,15 +1,17 @@
 # uuidgen
 
 > Generate unique identifiers (UUIDs).
+> See also `uuid`.
+> More information: <https://manned.org/uuidgen>.
 
-- Create a random UUID:
+- Create a random UUIDv4:
 
 `uuidgen --random`
 
-- Create a UUID based on the current time:
+- Create a UUIDv1 based on the current time:
 
 `uuidgen --time`
 
-- Create a UUID based on the hash of a URL:
+- Create a UUIDv5 of the name with a specified namespace prefix:
 
-`uuidgen --sha1 --namespace {{@url}} --name {{object_name}}`
+`uuidgen --sha1 --namespace {{@dns|@url|@oid|@x500}} --name {{object_name}}`