--- uuid_cli.pod 2006/01/13 06:44:30 1.24
+++ uuid_cli.pod 2006/05/11 09:37:28 1.25
@@ -44,7 +44,7 @@
[B<-m>]
[B<-n> I<count>]
[B<-1>]
-[B<-r>]
+[B<-F> I<format>]
[B<-o> I<filename>]
[I<namespace> I<name>]
@@ -113,11 +113,31 @@
remembered in the UUID context of the API. Option B<-1> deletes the
remembered UUID on each iteration.
-=item B<-r>
+=item B<-F> I<format>
+
+Representation format for importing or exporting an UUID. The
+following (case insensitive) format identifiers are currently recognized:
+
+=over 4
+
+=item C<BIN> (binary representation)
+
+This is the raw 128 bit network byte order binary representation of a
+UUID. Example is the octet stream C<0xF8 0x1D 0x4F 0xAE 0x7D 0xEC 0x11
+0xD0 0xA7 0x65 0x00 0xA0 0xC9 0x1E 0x6B 0xF6>.
-Output the generated UUID in 128 bit (network byte order) raw binary
-representation format. The default is to output the generated UUID in
-the standardized ASCII string representation.
+=item C<STR> (string representation)
+
+This is the 36 character hexadecimal ASCII string representation of a
+UUID. Example is the string "C<f81d4fae-7dec-11d0-a765-00a0c91e6bf6>".
+
+=item C<SIV> (single integer value representation)
+
+This is the maximum 39 character long single integer
+value representation of a UUID. Example is the string
+"C<329800735698586629295641978511506172918>".
+
+=back
=item B<-o> I<filename>
@@ -139,12 +159,13 @@
# decode and dump DCE 1.1 v1 UUID (time and node based)
$ uuid -d 01c47915-4777-11d8-bc70-0090272ff725
- UUID: 01c47915-4777-11d8-bc70-0090272ff725
- variant: DCE 1.1, ISO/IEC 11578:1996
- version: 1 (time and node based)
- content: time: 2004-01-15 16:22:26.376322.1 UTC
- clock: 15472 (usually random)
- node: 00:90:27:2f:f7:25 (global unicast)
+ encode: STR: 01c47915-4777-11d8-bc70-0090272ff725
+ SIV: 2349374037528578887923094374772111141
+ decode: variant: DCE 1.1, ISO/IEC 11578:1996
+ version: 1 (time and node based)
+ content: time: 2004-01-15 16:22:26.376322.1 UTC
+ clock: 15472 (usually random)
+ node: 00:90:27:2f:f7:25 (global unicast)
# generate DCE 1.1 v3 UUID (name based)
$ uuid -v3 ns:URL http://www.ossp.org/
@@ -152,11 +173,12 @@
# decode and dump DCE 1.1 v3 UUID (name based)
$ uuid -d 02d9e6d5-9467-382e-8f9b-9300a64ac3cd
- UUID: 02d9e6d5-9467-382e-8f9b-9300a64ac3cd
- variant: DCE 1.1, ISO/IEC 11578:1996
- version: 3 (name based)
- content: 02:D9:E6:D5:94:67:08:2E:0F:9B:93:00:A6:4A:C3:CD
- (not decipherable, because message digest only)
+ encode: STR: 02d9e6d5-9467-382e-8f9b-9300a64ac3cd
+ SIV: 3789866285607910888100818383505376205
+ decode: variant: DCE 1.1, ISO/IEC 11578:1996
+ version: 3 (name based, MD5)
+ content: 02:D9:E6:D5:94:67:08:2E:0F:9B:93:00:A6:4A:C3:CD
+ (not decipherable: MD5 message digest only)
# generate DCE 1.1 v4 UUID 4 (random data based)
$ uuid -v4
@@ -164,11 +186,12 @@
# decode and dump DCE 1.1 v4 UUID 4 (random data based)
$ uuid -d eb424026-6f54-4ef8-a4d0-bb658a1fc6cf
- UUID: eb424026-6f54-4ef8-a4d0-bb658a1fc6cf
- variant: DCE 1.1, ISO/IEC 11578:1996
- version: 4 (random data based)
- content: EB:42:40:26:6F:54:0E:F8:24:D0:BB:65:8A:1F:C6:CF
- (no semantics, because random data only)
+ encode: STR: eb424026-6f54-4ef8-a4d0-bb658a1fc6cf
+ SIV: 312712571721458096795100956955942831823
+ decode: variant: DCE 1.1, ISO/IEC 11578:1996
+ version: 4 (random data based)
+ content: EB:42:40:26:6F:54:0E:F8:24:D0:BB:65:8A:1F:C6:CF
+ (no semantics: random data only)
=head1 SEE ALSO
|
