uuid_time(3) — Linux manual page


UUID_TIME(3)                     Libuuid API                    UUID_TIME(3)

NAME         top

       uuid_time - extract the time at which the UUID was created

SYNOPSIS         top

       #include <uuid.h>

       time_t uuid_time(uuid_t uu, struct timeval *ret_tv)

DESCRIPTION         top

       The uuid_time function extracts the time at which the supplied time-
       based UUID uu was created.  Note that the UUID creation time is only
       encoded within certain types of UUIDs.  This function can only
       reasonably expect to extract the creation time for UUIDs created with
       the uuid_generate_time(3) and uuid_generate_time_safe(3) functions.
       It may or may not work with UUIDs created by other mechanisms.

RETURN VALUE         top

       The time at which the UUID was created, in seconds since January 1,
       1970 GMT (the epoch), is returned (see 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 ret_tv (see

AUTHORS         top

       Theodore Y. Ts'o

SEE ALSO         top

       uuid(3), uuid_clear(3), uuid_compare(3), uuid_copy(3),
       uuid_generate(3), uuid_is_null(3), uuid_parse(3), uuid_unparse(3)

AVAILABILITY         top

       libuuid is part of the util-linux package since version 2.15.1 and is
       available from https://www.kernel.org/pub/linux/utils/util-linux/.

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found at 
       ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩.  If you have a
       bug report for this manual page, send it to
       util-linux@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2020-09-18.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-09-15.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

util-linux                        May 2009                      UUID_TIME(3)

Pages that refer to this page: uuid(3)uuid_generate(3)uuid_generate_random(3)uuid_generate_time(3)uuid_generate_time_safe(3)uuid_is_null(3)uuid_parse(3)uuid_unparse(3)