Manpages - uuid_parse.3

Table of Contents

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

Author: dt

Created: 2022-02-20 Sun 20:07