summaryrefslogtreecommitdiffstats
path: root/libuuid/man/uuid_generate.3
diff options
context:
space:
mode:
Diffstat (limited to 'libuuid/man/uuid_generate.3')
-rw-r--r--libuuid/man/uuid_generate.313
1 files changed, 12 insertions, 1 deletions
diff --git a/libuuid/man/uuid_generate.3 b/libuuid/man/uuid_generate.3
index 9b7796dc9..a5b0ab701 100644
--- a/libuuid/man/uuid_generate.3
+++ b/libuuid/man/uuid_generate.3
@@ -41,6 +41,8 @@ uuid_generate_time_safe \- create a new unique UUID value
.BI "void uuid_generate_random(uuid_t " out );
.BI "void uuid_generate_time(uuid_t " out );
.BI "int uuid_generate_time_safe(uuid_t " out );
+.BI "void uuid_generate_md5(uuid_t " out ", const uuid_t " ns ", const char " *name ", size_t " len ");
+.BI "void uuid_generate_sha1(uuid_t " out ", const uuid_t " ns ", const char " *name ", size_t " len ");
.fi
.SH DESCRIPTION
The
@@ -100,13 +102,22 @@ the universe according to Carl Sagan's
The new UUID can reasonably be considered unique among all UUIDs created
on the local system, and among UUIDs created on other systems in the past
and in the future.
+.sp
+The
+.B uuid_generate_md5
+and
+.B uuid_generate_sha1
+functions generate an MD5 and SHA1 hashed (predictable) UUID based on a
+well-known UUID providing the namespace and an arbitrary binary string. The UUIDs
+confirm to V3 and V5 UUIDs per RFC-4122.
.SH RETURN VALUE
The newly created UUID is returned in the memory location pointed to by
.IR out .
.B uuid_generate_time_safe
returns zero if the UUID has been generated in a safe manner, \-1 otherwise.
.SH "CONFORMING TO"
-OSF DCE 1.1
+This library generates UUIDs compatible OSF DCE 1.1, and hash based UUIDs V3 and
+V5 compatible with RFC-4122.
.SH AUTHOR
Theodore Y.\& Ts'o
.SH AVAILABILITY