man7.org > Linux > man-pages

Linux/UNIX system programming training

uuid_parse(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | AUTHORS | SEE ALSO | REPORTING BUGS | AVAILABILITY 

UUID_PARSE(3)              Programmers Manual              UUID_PARSE(3)

NAME         top

       uuid_parse - convert an input UUID string into binary
       representation

SYNOPSIS         top

       #include <uuid.h>

       int uuid_parse(const char *in, uuid_t uu);
       int uuid_parse_range(const char *in_start, const 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
       pointers.

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
       <https://tools.ietf.org/html/rfc4122>.

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
       https://github.com/util-linux/util-linux/issues.

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
       [email protected]. This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2024-06-14. (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-10.) 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 [email protected]

util-linux 2.41.devel-537-e... 2024-04-04                  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)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI