OSSP CVS Repository

ossp - Check-in [4342]
Not logged in
[Honeypot]  [Browse]  [Home]  [Login]  [Reports
[Search]  [Ticket]  [Timeline
  [Patchset]  [Tagging/Branching

Check-in Number: 4342
Date: 2004-Jan-15 16:38:09 (local)
2004-Jan-15 15:38:09 (UTC)
User:rse
Branch:
Comment: document uuid_dump function
Tickets:
Inspections:
Files:
ossp-pkg/uuid/uuid.pod      1.8 -> 1.9     10 inserted, 1 deleted
ossp-pkg/uuid/uuid_cli.pod      1.8 -> 1.9     5 inserted, 5 deleted

ossp-pkg/uuid/uuid.pod 1.8 -> 1.9

--- uuid.pod     2004/01/15 13:37:54     1.8
+++ uuid.pod     2004/01/15 15:38:09     1.9
@@ -260,7 +260,16 @@
 
 =item uuid_rc_t B<uuid_dump>(uuid_t *I<uuid>, char **I<str>);
 
-FIXME
+This decodes the loaded UUID in I<uuid> and dumps a textual description
+into a string buffer which is allocated under C<*>I<str>. The output has
+the format (for DCE 1.1 v1 UUIDs):
+
+ UUID:    ab3734b7-4770-11d8-9753-0090272ff725
+ variant: DCE 1.1, ISO/IEC 11578:1996
+ version: 1 (time and node based)
+ content: time:  2004-01-15 15:37:04.186079.1 UTC
+          clock: 5971 (usually random)
+          node:  00:90:27:2f:f7:25 (real unicast)
 
 =item char *B<uuid_error>(uuid_rc_t I<rc>);
 


ossp-pkg/uuid/uuid_cli.pod 1.8 -> 1.9

--- uuid_cli.pod 2004/01/15 12:55:54     1.8
+++ uuid_cli.pod 2004/01/15 15:38:09     1.9
@@ -129,15 +129,15 @@
 
  # generate DCE 1.1 v1 UUID (time and node based)
  $ uuid -v1
- 1430fcde-43a9-11d8-8000-0090272ff725
+ ab3734b7-4770-11d8-9753-0090272ff725
 
  # decode and dump DCE 1.1 v1 UUID (time and node based)
- $ uuid -d 1430fcde-43a9-11d8-8000-0090272ff725
- UUID:    1430fcde-43a9-11d8-8000-0090272ff725
+ $ uuid -d ab3734b7-4770-11d8-9753-0090272ff725
+ UUID:    ab3734b7-4770-11d8-9753-0090272ff725
  variant: DCE 1.1, ISO/IEC 11578:1996
  version: 1 (time and node based)
- content: time:  2004-01-10 20:10:47.471843.0 UTC
-          clock: 0 (usually random)
+ content: time:  2004-01-15 15:37:04.186079.1 UTC
+          clock: 5971 (usually random)
           node:  00:90:27:2f:f7:25 (real unicast)
 
  # generate DCE 1.1 v3 UUID (name based)

CVSTrac 2.0.1