From 4eca93be214a4a68e1dff3de508e69d719763aaa Mon Sep 17 00:00:00 2001 From: Theodore Ts'o Date: Tue, 16 Mar 1999 20:31:56 +0000 Subject: [PATCH] Many files: Created man pages for libuuid functions. --- lib/uuid/ChangeLog | 4 ++++ lib/uuid/Makefile.in | 45 +++++++++++++++++++++++++++++++++---- lib/uuid/libuuid.3.in | 48 +++++++++++++++++++++++++++++++++++++++ lib/uuid/uuid_clear.3.in | 35 +++++++++++++++++++++++++++++ lib/uuid/uuid_compare.3.in | 37 ++++++++++++++++++++++++++++++ lib/uuid/uuid_copy.3.in | 37 ++++++++++++++++++++++++++++++ lib/uuid/uuid_generate.3.in | 55 +++++++++++++++++++++++++++++++++++++++++++++ lib/uuid/uuid_is_null.3.in | 37 ++++++++++++++++++++++++++++++ lib/uuid/uuid_parse.3.in | 50 +++++++++++++++++++++++++++++++++++++++++ lib/uuid/uuid_time.3.in | 52 ++++++++++++++++++++++++++++++++++++++++++ lib/uuid/uuid_unparse.3.in | 40 +++++++++++++++++++++++++++++++++ 11 files changed, 436 insertions(+), 4 deletions(-) create mode 100644 lib/uuid/libuuid.3.in create mode 100644 lib/uuid/uuid_clear.3.in create mode 100644 lib/uuid/uuid_compare.3.in create mode 100644 lib/uuid/uuid_copy.3.in create mode 100644 lib/uuid/uuid_generate.3.in create mode 100644 lib/uuid/uuid_is_null.3.in create mode 100644 lib/uuid/uuid_parse.3.in create mode 100644 lib/uuid/uuid_time.3.in create mode 100644 lib/uuid/uuid_unparse.3.in diff --git a/lib/uuid/ChangeLog b/lib/uuid/ChangeLog index 04fd89d..69d0050 100644 --- a/lib/uuid/ChangeLog +++ b/lib/uuid/ChangeLog @@ -1,3 +1,7 @@ +1999-03-11 Andreas Dilger + + * Created man pages for libuuid functions. + 1999-01-09 Theodore Ts'o * Release of E2fsprogs 1.14 diff --git a/lib/uuid/Makefile.in b/lib/uuid/Makefile.in index 8b1a4a1..69a71c1 100644 --- a/lib/uuid/Makefile.in +++ b/lib/uuid/Makefile.in @@ -16,6 +16,10 @@ INSTALL = @INSTALL@ all:: +SMANPAGES= libuuid.3 uuid_clear.3 uuid_compare.3 uuid_copy.3 \ + uuid_generate.3 uuid_is_null.3 uuid_parse.3 \ + uuid_time.3 uuid_unparse.3 + OBJS= clear.o \ compare.o \ copy.o \ @@ -78,7 +82,7 @@ BSDLIB_INSTALL_DIR = $(root_libdir) @ELF_CMT@ $(CC) $(ALL_CFLAGS) -fPIC -o elfshared/$*.o -c $< @BSDLIB_CMT@ $(CC) $(ALL_CFLAGS) -fpic -o pic/$*.o -c $< -all:: tst_uuid uuid_time +all:: tst_uuid uuid_time $(SMANPAGES) tst_uuid.o: $(srcdir)/tst_uuid.c $(CC) $(ALL_CFLAGS) -c $(srcdir)/tst_uuid.c -o tst_uuid.o @@ -86,12 +90,39 @@ tst_uuid.o: $(srcdir)/tst_uuid.c tst_uuid: tst_uuid.o $(LIBUUID) $(CC) $(ALL_LDFLAGS) -o tst_uuid tst_uuid.o $(LIBUUID) -uuid_time: $(srcdir)/uuid_time.c +uuid_time: $(srcdir)/uuid_time.c $(LIBUUID) $(CC) $(ALL_CFLAGS) -DDEBUG $(srcdir)/uuid_time.c -o uuid_time $(LIBUUID) +libuuid.3: $(DEP_SUBSTITUTE) $(srcdir)/libuuid.3.in + $(SUBSTITUTE) $(srcdir)/libuuid.3.in libuuid.3 + +uuid_clear.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_clear.3.in + $(SUBSTITUTE) $(srcdir)/uuid_clear.3.in uuid_clear.3 + +uuid_compare.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_compare.3.in + $(SUBSTITUTE) $(srcdir)/uuid_compare.3.in uuid_compare.3 + +uuid_copy.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_copy.3.in + $(SUBSTITUTE) $(srcdir)/uuid_copy.3.in uuid_copy.3 + +uuid_generate.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_generate.3.in + $(SUBSTITUTE) $(srcdir)/uuid_generate.3.in uuid_generate.3 + +uuid_is_null.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_is_null.3.in + $(SUBSTITUTE) $(srcdir)/uuid_is_null.3.in uuid_is_null.3 + +uuid_parse.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_parse.3.in + $(SUBSTITUTE) $(srcdir)/uuid_parse.3.in uuid_parse.3 + +uuid_time.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_time.3.in + $(SUBSTITUTE) $(srcdir)/uuid_time.3.in uuid_time.3 + +uuid_unparse.3: $(DEP_SUBSTITUTE) $(srcdir)/uuid_unparse.3.in + $(SUBSTITUTE) $(srcdir)/uuid_unparse.3.in uuid_unparse.3 + installdirs:: $(top_srcdir)/mkinstalldirs $(DESTDIR)$(libdir) \ - $(DESTDIR)$(includedir)/uuid + $(DESTDIR)$(includedir)/uuid $(DESTDIR)$(man3dir) install:: all installdirs $(INSTALL_DATA) libuuid.a $(DESTDIR)$(libdir)/libuuid.a @@ -99,13 +130,19 @@ install:: all installdirs -$(RANLIB) $(DESTDIR)$(libdir)/libuuid.a $(CHMOD) $(LIBMODE) $(DESTDIR)$(libdir)/libuuid.a $(INSTALL_DATA) $(srcdir)/uuid.h $(DESTDIR)$(includedir)/uuid/uuid.h + for i in $(SMANPAGES); do \ + $(INSTALL_DATA) $$i $(DESTDIR)$(man3dir)/$$i; \ + done uninstall:: $(RM) -f $(DESTDIR)$(libdir)/libuuid.a + for i in $(SMANPAGES); do \ + $(RM) -f $(DESTDIR)$(man3dir)/$$i; \ + done clean:: $(RM) -f \#* *.s *.o *.a *~ *.bak core profiled/* checker/* - $(RM) -f ../libuuid.a ../libuuid_p.a tst_uuid uuid_time + $(RM) -f ../libuuid.a ../libuuid_p.a tst_uuid uuid_time $(SMANPAGES) mostlyclean:: clean distclean:: clean diff --git a/lib/uuid/libuuid.3.in b/lib/uuid/libuuid.3.in new file mode 100644 index 0000000..4fd9549 --- /dev/null +++ b/lib/uuid/libuuid.3.in @@ -0,0 +1,48 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH LIBUUID 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +libuuid \- DCE compatible Universally Unique Identifier library +.SH SYNOPSIS +.nf +.B #include +.sp +.B \-luuid +.SH DESCRIPTION +The +.B libuuid +library is used to generate unique identifiers for objects that may be +accessible beyond the local system. The Linux implementation was created +to uniquely identify ext2 filesystems created by a machine. This library +generates UUIDs compatible with those created by the Open Software +Foundation (OSF) Distributed Computing Environment (DCE) utility +.BR uuidgen . +.sp +The UUIDs generated by this library can be reasonably expected to be +unique within a system, and unique across all systems. They could +be used, for instance, to generate unique HTTP cookies across multiple +web servers without communication between the servers, and without fear +of a name clash. +.SH "CONFORMING TO" +OSF DCE 1.1 +.SH AUTHOR +.B libuuid +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B libuuid +is part of the e2fsprogs package and is available for anonymous ftp +from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR uuid_clear (3), +.BR uuid_compare (3), +.BR uuid_copy (3), +.BR uuid_generate (3), +.BR uuid_is_null (3), +.BR uuid_parse (3), +.BR uuid_time (3), +.BR uuid_unparse (3) diff --git a/lib/uuid/uuid_clear.3.in b/lib/uuid/uuid_clear.3.in new file mode 100644 index 0000000..fe80819 --- /dev/null +++ b/lib/uuid/uuid_clear.3.in @@ -0,0 +1,35 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_CLEAR 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_clear \- reset value of UUID variable to the NULL value +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "void uuid_clear(uuid_t " uu ); +.fi +.SH DESCRIPTION +The +.B uuid_clear +function sets the value of the supplied uuid variable +.I uu +to the NULL value. +.SH AUTHOR +.B uuid_clear +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_clear +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_compare (3), +.BR uuid_copy (3), +.BR uuid_generate (3), +.BR uuid_is_null (3) diff --git a/lib/uuid/uuid_compare.3.in b/lib/uuid/uuid_compare.3.in new file mode 100644 index 0000000..3dab071 --- /dev/null +++ b/lib/uuid/uuid_compare.3.in @@ -0,0 +1,37 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_COMPARE 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_compare \- compare whether two UUIDs are the same +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int uuid_compare(uuid_t " uu1 ", uuid_t " uu2) +.fi +.SH DESCRIPTION +The +.B uuid_compare +function compares the two supplied uuid variables +.IR uu1 " and " uu2 +to each other. +.SH RETURN VALUE +Returns 1 if the two UUIDs are the same and 0 otherwise. +.SH AUTHOR +.B uuid_compare +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_compare +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_copy (3), +.BR uuid_generate (3), +.BR uuid_is_null (3) diff --git a/lib/uuid/uuid_copy.3.in b/lib/uuid/uuid_copy.3.in new file mode 100644 index 0000000..6875c8d --- /dev/null +++ b/lib/uuid/uuid_copy.3.in @@ -0,0 +1,37 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_COPY 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_copy \- copy a UUID value +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "void uuid_copy(uuid_t " dst ", uuid_t " src); +.fi +.SH DESCRIPTION +The +.B uuid_copy +function copies the UUID variable +.IR src " to " dst . +.SH RETURN VALUE +The copied UUID is returned in the location pointed to by +.IR dst . +.SH AUTHOR +.B uuid_copy +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_copy +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_compare (3), +.BR uuid_generate (3), +.BR uuid_is_null (3) diff --git a/lib/uuid/uuid_generate.3.in b/lib/uuid/uuid_generate.3.in new file mode 100644 index 0000000..33455f6 --- /dev/null +++ b/lib/uuid/uuid_generate.3.in @@ -0,0 +1,55 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_GENERATE 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_generate \- create a new unique UUID value +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "void uuid_generate(uuid_t " out ); +.fi +.SH DESCRIPTION +The +.B uuid_generate +function creates a new universally unique identifier. Depending on +compile\- and run\-time availability, the UUID will be based on the +local ethernet MAC address (if available), random data from /dev/urandom +or a pseudo\-random generator +.BR rand "(3) or " random "(3)," +and the current time. +.sp +The UUID is 16 bytes (128 bits) long, which gives approximately 3.4x10^38 +unique values (there are approximately 10^80 elemntary particles in +the universe according to Carl Sagan's +.IR Cosmos ). +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. +.SH RETURN VALUE +The newly created UUID is returned in the memory location pointed to by +.IR out . +.SH "CONFORMING TO" +OSF DCE 1.1 +.SH AUTHOR +.B uuid_generate +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_generate +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_compare (3), +.BR uuid_copy (3), +.BR uuidgen (1), +.BR uuid_is_null (3), +.BR uuid_parse (3), +.BR uuid_time (3), +.BR uuid_unparse (3) diff --git a/lib/uuid/uuid_is_null.3.in b/lib/uuid/uuid_is_null.3.in new file mode 100644 index 0000000..42a65b4 --- /dev/null +++ b/lib/uuid/uuid_is_null.3.in @@ -0,0 +1,37 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_IS_NULL 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_is_null \- compare the value of the UUID to the NULL value +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int uuid_is_null(uuid_t " uu ); +.fi +.SH DESCRIPTION +The +.B uuid_is_null +function compares the value of the supplied UUID variable +.I uu +to the NULL value. If the value is equal to the NULL UUID, 1 is returned, +otherwise 0 is returned. +.SH AUTHOR +.B uuid_is_null +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_is_null +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_compare (3), +.BR uuid_copy (3), +.BR uuid_generate (3), +.BR uuid_time (3) diff --git a/lib/uuid/uuid_parse.3.in b/lib/uuid/uuid_parse.3.in new file mode 100644 index 0000000..ab76cdd --- /dev/null +++ b/lib/uuid/uuid_parse.3.in @@ -0,0 +1,50 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_PARSE 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_parse \- convert an input UUID string into the libuuid internal format +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int uuid_parse( char *" in ", uuid_t " uu ); +.fi +.SH DESCRIPTION +The +.B uuid_parse +function converts the supplied UUID string given by +.I in +into the internal +.B uuid_t +format. The input UUID is a string of the form +1b4e28ba\-2fa1\-11d2\-883f\-b9a761bde3fb (in +.BR printf (3) +format "%08x\-%04x\-%04x\-%04x\-%012x", 36 bytes plus the trailing '\\0'). +.SH RETURN VALUE +Upon successfully parsing the input string, 0 is returned, and the UUID is +stored in the location pointed to by +.IR uu , +otherwise \-1 is returned. +.SH "CONFORMING TO" +OSF DCE 1.1 +.SH AUTHOR +.B uuid_parse +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_parse +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_compare (3), +.BR uuid_copy (3), +.BR uuid_generate (3), +.BR uuid_is_null (3), +.BR uuid_time (3), +.BR uuid_unparse (3) diff --git a/lib/uuid/uuid_time.3.in b/lib/uuid/uuid_time.3.in new file mode 100644 index 0000000..2108bf4 --- /dev/null +++ b/lib/uuid/uuid_time.3.in @@ -0,0 +1,52 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_TIME 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_time \- extract the time at which the UUID was created +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "time_t uuid_time(uuid_t " uu ", struct timeval *" ret_tv ) +.fi +.SH DESCRIPTION +The +.B uuid_time +function extracts the time at which the supplied UUID +.I uu +was created. Note that the UUID creation time is encoded within the UUID, +and this function can only reasonably expect to extract the creation time +for UUIDs created with the +.BR uuid_generate (3) +function. It may or may not work with UUIDs created by OSF DCE +.BR uuidgen . +.SH "RETURN VALUES" +The time at which the UUID was created, in seconds since January 1, 1970 GMT +(the epoch), is returned (see +.BR time "(2))." +The time at which the UUID was created, in seconds and microseconds since +the epoch, is also stored in the location pointed to by +.I ret_tv +(see +.BR gettimeofday "(2))." +.SH AUTHOR +.B uuid_time +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_time +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_compare (3), +.BR uuid_copy (3), +.BR uuid_generate (3), +.BR uuid_is_null (3), +.BR uuid_parse (3), +.BR uuid_unparse (3) diff --git a/lib/uuid/uuid_unparse.3.in b/lib/uuid/uuid_unparse.3.in new file mode 100644 index 0000000..ef5807b --- /dev/null +++ b/lib/uuid/uuid_unparse.3.in @@ -0,0 +1,40 @@ +.\" Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) +.\" +.\" This man page was created for libuuid.so.1.1 from e2fsprogs-1.14. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.\" +.\" Created Wed Mar 10 17:42:12 1999, Andreas Dilger +.TH UUID_UNPARSE 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" +.SH NAME +uuid_unparse \- output UUID variable in string format +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "void uuid_unparse(uuid_t " uu ", char *" out ); +.fi +.SH DESCRIPTION +The +.B uuid_unparse +function converts the supplied UUID +.I uu +from the internal binary format into a 36\-byte string (plus tailing '\\0') +of the form 1b4e28ba\-2fa1\-11d2\-883f\-b9a76 and stores this value in the +character string pointed to by +.IR out . +.SH "CONFORMING TO" +OSF DCE 1.1 +.SH AUTHOR +.B uuid_unparse +was written by Theodore Y. Ts'o for the ext2 filesystem utilties. +.SH AVAILABILITY +.B uuid_unparse +is part of libuuid from the e2fsprogs package and is available for anonymous +ftp from tsx\-11.mit.edu (and its mirrors) in /pub/linux/packages/ext2fs. +.SH "SEE ALSO" +.BR libuuid (3), +.BR uuid_clear (3), +.BR uuid_generate (3), +.BR uuid_parse (3), +.BR uuid_time (3) -- 1.8.3.1