uuid_unparse(3)

uuid_unparse3

Convert a uuid from binary representation to a string

Usage

#include <uuid.h>

void uuid_unparse(const uuid_t uu, char *out);
void uuid_unparse_upper(const uuid_t uu, char *out);
void uuid_unparse_lower(const uuid_t uu, char *out);

Overview

The uuid_unparse() function converts the supplied UUID uu from the binary representation into a 36-byte string (plus trailing '\0') of the form 1b4e28ba-2fa1-11d2-883f-0016d3cca427 and stores this value in the character string pointed to by out. The case of the hex digits returned by uuid_unparse() may be upper or lower case, and is dependent on the system-dependent local default.

If the case of the hex digits is important then the functions uuid_unparse_upper() and uuid_unparse_lower() may be used.

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 unparses UUIDs compatible with OSF DCE 1.1.

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.