UUID_PARSE

Section: Libuuid API (3)
Updated: May 2009
Page Index
 

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.  

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)  

AVAILABILITY

libuuid is part of the util-linux package since version 2.15.1 and is available from https://www.kernel.org/pub/linux/utils/util-linux/.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
CONFORMING TO
AUTHORS
SEE ALSO
AVAILABILITY