util-linux (2.39)

(root)/
share/
man/
man3/
uuid_parse.3
UUID_PARSE(3) Programmers Manual UUID_PARSE(3)

NAME
uuid_parse - convert an input UUID string into binary representation

SYNOPSIS
#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
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
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
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
Theodore Y. Ts’o

SEE ALSO
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
For bug reports, use the issue tracker at https://github.com/util-linux/util-linux/issues.

AVAILABILITY
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/>.

util-linux 2.39 2022-05-11 UUID_PARSE(3)