uuid_parse(3) — Linux manual page


UUID_PARSE(3)              Programmers Manual              UUID_PARSE(3)

NAME         top

       uuid_parse - convert an input UUID string into binary

SYNOPSIS         top

       #include <uuid.h>

       int uuid_parse(char *in, uuid_t uu);
       int uuid_parse_range(char *in_start, char *in_end, uuid_t uu);

DESCRIPTION         top

       The uuid_parse() function converts the UUID string given by in
       into the binary representation. The input UUID is a string of the
       form 1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in printf(3) format
       "%08x-%04x-%04x-%04x-%012x", 36 bytes plus the trailing '\0').

       The uuid_parse_range() function works like uuid_parse() but
       parses only range in string specified by in_start and in_end

RETURN VALUE         top

       Upon successfully parsing the input string, 0 is returned, and
       the UUID is stored in the location pointed to by uu, otherwise -1
       is returned.

CONFORMING TO         top

       This library parses UUIDs compatible with OSF DCE 1.1, and hash
       based UUIDs V3 and V5 compatible with RFC-4122

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_time(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_PARSE(3)

Pages that refer to this page: uuid(3)uuid_clear(3)uuid_compare(3)uuid_copy(3)uuid_generate(3)uuid_is_null(3)uuid_time(3)uuid_unparse(3)