uuid: add page, uuidgen: update description (#5892)

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}}`

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}}`