uuid_time(3) — Linux manual page


UUID_TIME(3)               Programmers Manual               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)

REPORTING BUGS         top

       For bug reports, use the issue tracker at

AVAILABILITY         top

       The libuuid library is part of the util-linux package since
       version 2.15.1. It can be downloaded from Linux Kernel Archive
       <https://www.kernel.org/pub/linux/utils/util-linux/>. 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
       2023-12-22. (At that time, the date of the most recent commit
       that was found in the repository was 2023-12-14.) 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 man-pages@man7.org

util-linux 2.39.594-1e0ad      2023-07-19                   UUID_TIME(3)

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