diff options
Diffstat (limited to '')
| -rw-r--r-- | libuuid/man/uuid_unparse.3 | 69 | ||||
| -rw-r--r-- | libuuid/man/uuid_unparse.3.adoc | 84 |
2 files changed, 153 insertions, 0 deletions
diff --git a/libuuid/man/uuid_unparse.3 b/libuuid/man/uuid_unparse.3 new file mode 100644 index 0000000..e40c5ee --- /dev/null +++ b/libuuid/man/uuid_unparse.3 @@ -0,0 +1,69 @@ +'\" t +.\" Title: uuid_unparse +.\" Author: [see the "AUTHOR(S)" section] +.\" Generator: Asciidoctor 2.0.15 +.\" Date: 2022-05-11 +.\" Manual: Programmer's Manual +.\" Source: util-linux 2.38.1 +.\" Language: English +.\" +.TH "UUID_UNPARSE" "3" "2022-05-11" "util\-linux 2.38.1" "Programmer\(aqs Manual" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.ss \n[.ss] 0 +.nh +.ad l +.de URL +\fI\\$2\fP <\\$1>\\$3 +.. +.als MTO URL +.if \n[.g] \{\ +. mso www.tmac +. am URL +. ad l +. . +. am MTO +. ad l +. . +. LINKSTYLE blue R < > +.\} +.SH "NAME" +uuid_unparse \- convert a UUID from binary representation to a string +.SH "SYNOPSIS" +.sp +\fB#include <uuid.h>\fP +.sp +\fBvoid uuid_unparse(uuid_t \fIuu\fP, char *\fIout\fP);\fP +.br +\fBvoid uuid_unparse_upper(uuid_t \fIuu\fP, char *\fIout\fP);\fP +.br +\fBvoid uuid_unparse_lower(uuid_t \fIuu\fP, char *\fIout\fP);\fP +.SH "DESCRIPTION" +.sp +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. +.sp +If the case of the hex digits is important then the functions \fBuuid_unparse_upper\fP() and \fBuuid_unparse_lower\fP() may be used. +.SH "CONFORMING TO" +.sp +This library unparses UUIDs compatible with OSF DCE 1.1. +.SH "AUTHORS" +.sp +Theodore Y. Ts\(cqo +.SH "SEE ALSO" +.sp +\fBuuid\fP(3), +\fBuuid_clear\fP(3), +\fBuuid_compare\fP(3), +\fBuuid_copy\fP(3), +\fBuuid_generate\fP(3), +\fBuuid_time\fP(3), +\fBuuid_is_null\fP(3), +\fBuuid_parse\fP(3) +.SH "REPORTING BUGS" +.sp +For bug reports, use the issue tracker at \c +.URL "https://github.com/util\-linux/util\-linux/issues" "" "." +.SH "AVAILABILITY" +.sp +The \fBlibuuid\fP library is part of the util\-linux package since version 2.15.1. It can be downloaded from \c +.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file diff --git a/libuuid/man/uuid_unparse.3.adoc b/libuuid/man/uuid_unparse.3.adoc new file mode 100644 index 0000000..a14dc8c --- /dev/null +++ b/libuuid/man/uuid_unparse.3.adoc @@ -0,0 +1,84 @@ +//po4a: entry man manual +//// +Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca) + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, and the entire permission notice in its entirety, + including the disclaimer of warranties. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. +3. The name of the author may not be used to endorse or promote + products derived from this software without specific prior + written permission. + +THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED +WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF +WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT +OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR +BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE +USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH +DAMAGE. + +Created Wed Mar 10 17:42:12 1999, Andreas Dilger +//// += uuid_unparse(3) +:doctype: manpage +:man manual: Programmer's Manual +:man source: util-linux {release-version} +:page-layout: base +:lib: libuuid +:firstversion: 2.15.1 + +== NAME + +uuid_unparse - convert a UUID from binary representation to a string + +== SYNOPSIS + +*#include <uuid.h>* + +*void uuid_unparse(uuid_t __uu__, char *__out__);* + +*void uuid_unparse_upper(uuid_t __uu__, char *__out__);* + +*void uuid_unparse_lower(uuid_t __uu__, char *__out__);* + +== DESCRIPTION + +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. + +== CONFORMING TO + +This library unparses UUIDs compatible with OSF DCE 1.1. + +== AUTHORS + +Theodore Y. Ts'o + +== SEE ALSO + +*uuid*(3), +*uuid_clear*(3), +*uuid_compare*(3), +*uuid_copy*(3), +*uuid_generate*(3), +*uuid_time*(3), +*uuid_is_null*(3), +*uuid_parse*(3) + +include::man-common/bugreports.adoc[] + +include::man-common/footer-lib.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] |