manual/util-linux/original/man3/uuid_unparse.3

   1 '\" t
   2 .\"     Title: uuid_unparse
   3 .\"    Author: [see the "AUTHOR(S)" section]
   4 .\" Generator: Asciidoctor 2.0.15
   5 .\"      Date: 2022-01-06
   6 .\"    Manual: Programmer's Manual
   7 .\"    Source: util-linux 2.38
   8 .\"  Language: English
   9 .\"
  10 .TH "UUID_UNPARSE" "3" "2022-01-06" "util\-linux 2.38" "Programmer\(aqs Manual"
  11 .ie \n(.g .ds Aq \(aq
  12 .el       .ds Aq '
  13 .ss \n[.ss] 0
  14 .nh
  15 .ad l
  16 .de URL
  17 \fI\\$2\fP <\\$1>\\$3
  18 ..
  19 .als MTO URL
  20 .if \n[.g] \{\
  21 .  mso www.tmac
  22 .  am URL
  23 .    ad l
  24 .  .
  25 .  am MTO
  26 .    ad l
  27 .  .
  28 .  LINKSTYLE blue R < >
  29 .\}
  30 .SH "NAME"
  31 uuid_unparse \- convert a UUID from binary representation to a string
  32 .SH "SYNOPSIS"
  33 .sp
  34 \fB#include <uuid.h>\fP
  35 .sp
  36 \fBvoid uuid_unparse(uuid_t \fIuu\fP, char *\fIout\fP);\fP
  37 .br
  38 \fBvoid uuid_unparse_upper(uuid_t \fIuu\fP, char *\fIout\fP);\fP
  39 .br
  40 \fBvoid uuid_unparse_lower(uuid_t \fIuu\fP, char *\fIout\fP);\fP
  41 .SH "DESCRIPTION"
  42 .sp
  43 The \fBuuid_unparse\fP() function converts the supplied UUID \fIuu\fP from the binary representation into a 36\-byte string (plus trailing \(aq\(rs0\(aq) of the form 1b4e28ba\-2fa1\-11d2\-883f\-0016d3cca427 and stores this value in the character string pointed to by \fIout\fP. The case of the hex digits returned by \fBuuid_unparse\fP() may be upper or lower case, and is dependent on the system\-dependent local default.
  44 .sp
  45 If the case of the hex digits is important then the functions \fBuuid_unparse_upper\fP() and \fBuuid_unparse_lower\fP() may be used.
  46 .SH "CONFORMING TO"
  47 .sp
  48 This library unparses UUIDs compatible with OSF DCE 1.1.
  49 .SH "AUTHORS"
  50 .sp
  51 Theodore Y. Ts\(cqo
  52 .SH "SEE ALSO"
  53 .sp
  54 \fBuuid\fP(3),
  55 \fBuuid_clear\fP(3),
  56 \fBuuid_compare\fP(3),
  57 \fBuuid_copy\fP(3),
  58 \fBuuid_generate\fP(3),
  59 \fBuuid_time\fP(3),
  60 \fBuuid_is_null\fP(3),
  61 \fBuuid_parse\fP(3)
  62 .SH "REPORTING BUGS"
  63 .sp
  64 For bug reports, use the issue tracker at \c
  65 .URL "https://github.com/util\-linux/util\-linux/issues" "" "."
  66 .SH "AVAILABILITY"
  67 .sp
  68 The \fBlibuuid\fP library is part of the util\-linux package since version 2.15.1. It can be downloaded from \c
  69 .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."