uuid_parse(3)

uuid_parse3

Convert an input uuid string into binary representation

Usage

#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);

Overview

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(3) 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.

Releases

14 releases since Debian 2.2 (Potato); the text changed 12 times.

  1. 2.2
  2. 3.0
  3. 3.1
  4. 4.0
  5. 5.0
  6. 6.0
  7. 7
  8. 8–9
  9. 10
  10. 11
  11. 12
  12. 13
  13. Arch

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

Reporting bugs

For bug reports, use the issue tracker <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/>.

From util-linux-libs 2.42.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.