--- uuid.pod 2004/01/18 19:59:12 1.11
+++ uuid.pod 2004/01/19 12:15:05 1.12
@@ -186,7 +186,7 @@
=item B<UUID_VERSION1>, B<UUID_VERSION3>, B<UUID_VERSION4>, B<UUID_MCASTRND>
-The I<mode> bits for use with B<uuid_generate>(). The
+The I<mode> bits for use with B<uuid_make>(). The
B<UUID_VERSION>I<N> specify which UUID version to generate. The
B<UUID_MCASTRND> forces the use of a random multi-cast MAC address
instead of the real physical MAC address in version 1 UUIDs.
@@ -223,10 +223,6 @@
Destroy UUID object I<uuid>.
-=item uuid_rc_t B<uuid_nil>(uuid_t *I<uuid>);
-
-Sets or resets the UUID in I<uuid> to the I<Nil> UUID.
-
=item uuid_rc_t B<uuid_isnil>(uuid_t *I<uuid>, int *I<result>);
Checks whether the UUID in I<uuid> is the I<Nil> UUID.
@@ -240,7 +236,6 @@
smaller than I<uuid2>, C<0> if I<uuid1> is equal to I<uuid2>
and C<+1> if I<uuid1> is greater than I<uuid2>.
-
=item uuid_rc_t B<uuid_import>(uuid_t *I<uuid>, uuid_fmt_t I<fmt>, const void *I<data_ptr>, size_t I<data_len>);
Imports a UUID I<uuid> from an external representation of format I<fmt>.
@@ -264,7 +259,31 @@
minimum required length in C<*>I<data_len> depends on it. Valid values
for I<fmt> are B<UUID_FMT_BIN>, B<UUID_FMT_STR> and B<UUID_FMT_TXT>.
-=item uuid_rc_t B<uuid_generate>(uuid_t *I<uuid>, unsigned int I<mode>, ...);
+=item uuid_rc_t B<uuid_load>(uuid_t *I<uuid>, const char *I<name>);
+
+Loads a pre-defined UUID value into the UUID object I<uuid>. The
+following I<name> arguments are currently known:
+
+=over 4
+
+=item I<name> I<UUID>
+
+=item nil 00000000-0000-0000-0000-000000000000
+
+=item ns:DNS 6ba7b810-9dad-11d1-80b4-00c04fd430c8
+
+=item ns:URL 6ba7b811-9dad-11d1-80b4-00c04fd430c8
+
+=item ns:OID 6ba7b812-9dad-11d1-80b4-00c04fd430c8
+
+=item ns:X500 6ba7b814-9dad-11d1-80b4-00c04fd430c8
+
+=back
+
+The "C<ns:>I<XXX>" are names of pre-defined name-space UUIDs for use in
+the generation of DCE 1.1 version 3 UUIDs.
+
+=item uuid_rc_t B<uuid_make>(uuid_t *I<uuid>, unsigned int I<mode>, ...);
Generates a new UUID in I<uuid> according to I<mode> and optional
arguments (dependent on I<mode>).
@@ -302,27 +321,31 @@
code.
/* generate a DCE 1.1 v1 UUID from system environment */
- char *uuid_v1(void)
+ char *uuid_v1(void)
{
uuid_t *uuid;
char *str = NULL;
uuid_create(&uuid);
- uuid_generate(uuid, UUID_VERSION1);
- uuid_export(uuid, UUID_FMT_STR, &str, NULL);
+ uuid_make(uuid, UUID_VERSION1);
+ uuid_export(uuid, UUID_FMT_STR, (void **)&str, NULL);
uuid_destroy(uuid);
return str;
}
/* generate a DCE 1.1 v3 UUID from an URL */
- char *uuid_v3(const char *url)
+ char *uuid_v3(const char *url)
{
uuid_t *uuid;
+ uuid_t *uuid_ns;
char *str = NULL;
uuid_create(&uuid);
- uuid_generate(uuid, UUID_VERSION3, "URL", url);
- uuid_export(uuid, UUID_FMT_STR, &str, NULL);
+ uuid_create(&uuid_ns);
+ uuid_load(uuid_ns, "ns:URL");
+ uuid_make(uuid, UUID_VERSION3, uuid_ns, url);
+ uuid_export(uuid, UUID_FMT_STR, (void **)&str, NULL);
+ uuid_destroy(uuid_ns);
uuid_destroy(uuid);
return str;
}
@@ -333,7 +356,7 @@
=over 4
-=item
+=item
B<UUIDs and GUIDs>,
IETF Internet Draft (expired),
@@ -341,7 +364,7 @@
February 1998, 27 pages,
http://www.opengroup.org/dce/info/draft-leach-uuids-guids-01.txt
-=item
+=item
B<DCE 1.1: Remote Procedure Call>,
appendix B<Universally Unique Identifier>,
@@ -349,16 +372,16 @@
Document Number C706, August 1997, 737 pages,
(supersedes C309 DCE: Remote Procedure Call 8/1994,
which was basis for ISO/IEC 11578:1996 specification),
-http://www.opengroup.org/publications/catalog/c706.htm
+http://www.opengroup.org/publications/catalog/c706.htm
-=item
+=item
B<Information technology -- Open Systems Interconnection (OSI) -- Remote Procedure Call (RPC)>,
ISO/IEC 11578:1996,
August 2001, 570 pages, (CHF 340,00),
http://www.iso.ch/cate/d2229.html
-=item
+=item
B<HTTP Extensions for Distributed Authoring (WebDAV)>,
section B<6.4.1 Node Field Generation Without the IEEE 802 Address>,
|
