Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3uuid/uuid_clear.3uuid
Real path: /usr/share/man/man3uuid/uuid_clear.3uuid
Zurück

'\" te .\" Copyright (c) 2006, 2020, Oracle and/or its affiliates. .TH uuid_clear 3UUID "15 Jul 2020" "Oracle Solaris 11.4" "Universally Unique Identifier Library Functions" .SH NAME uuid_clear, uuid_compare, uuid_copy, uuid_generate, uuid_generate_random, uuid_generate_time, uuid_is_null, uuid_parse, uuid_time, uuid_unparse, uuid_unparse_lower, uuid_unparse_upper \- universally unique identifier (UUID) operations .SH SYNOPSIS .LP .nf cc [ flag ... ] file... -luuid [ library ... ] #include \fB<uuid/uuid.h>\fR \fBvoid uuid_clear\fR(\fBuuid_t\fR \fIuu\fR); \fBint uuid_compare\fR(\fBconst uuid_t\fR \fIuu1\fR, \fBconst uuid_t\fR \fIuu2\fR); \fBvoid uuid_copy\fR(\fBuuid_t\fR \fIdst\fR, \fBconst uuid_t\fR \fIsrc\fR); \fBvoid uuid_generate\fR(\fBuuid_t\fR \fIout\fR); \fBvoid uuid_generate_random\fR(\fBuuid_t\fR \fIout\fR); \fBvoid uuid_generate_time\fR(\fBuuid_t\fR \fIout\fR); \fBint uuid_is_null\fR(\fBconst uuid_t\fR \fIuu\fR); \fBint uuid_parse\fR(\fBchar *\fR\fIin\fR, \fBuuid_t\fR \fIuu\fR); \fBtime_t uuid_time\fR(\fBconst uuid_t\fR \fIuu\fR, \fBstruct timeval *\fR\fIret_tv\fR); \fBvoid uuid_unparse\fR(\fBconst uuid_t\fR \fIuu\fR, \fBchar *\fR\fIout\fR); \fBvoid uuid_unparse_lower\fR(\fBconst uuid_t\fR \fIuu\fR, \fBchar *\fR\fIout\fR); \fBvoid uuid_unparse_upper\fR(\fBconst uuid_t\fR \fIuu\fR, \fBchar *\fR\fIout\fR); .fi .SH DESCRIPTION .sp .LP The \fBuuid_clear()\fR function sets the value of the specified universally unique identifier (UUID) variable \fIuu\fR to the \fINULL\fR value. .sp .LP The \fBuuid_compare()\fR function compares the two specified UUID variables \fIuu1\fR and \fIuu2\fR to each other. It returns an integer less than, equal to, or greater than zero if \fIuu1\fR is found to be, respectively, lexicographically less than, equal, or greater than \fIuu2\fR. .sp .LP The \fBuuid_copy()\fR function copies the UUID variable \fIsrc\fR to \fIdst\fR. .sp .LP The \fBuuid_generate_random()\fR function produces a UUID that corresponds to a DCE version 4 UUID, generated with both time and MAC address based on high-quality randomness from \fBgetrandom\fR(2). .sp .LP The \fBuuid_generate_time()\fR function uses the current time and the randomly generated 47-bit cryptographic MAC address that corresponds to a DCE version 1 UUID. The randomly generated 47-bit cryptographic MAC address is used as the low 47 bits of the node ID, with the most significant bit of the first octet of the node ID set to 1. This bit is the multicast bit, which will never be set in IEEE 802 addresses obtained from network cards. The uniqueness of time based UUID's created by both root and normal users are guaranteed with or without zones. The random MAC address is unique to each zone and is generated during boot of the zone, including the global zone, and is reused in all UUIDs generated with \fBuuid_generate_time()\fR until the next boot of the zone. Because the use of this algorithm provides information about when and where the UUID was generated, it could cause privacy problems for some applications. .sp .LP The \fBuuid_generate()\fR function generates a UUID using a method chosen by the implementation. The Oracle Solaris implementation currently always uses the \fBuuid_generate_random()\fR function. Other implementations, including Solaris versions prior to Oracle Solaris 11.4.15 and possibly future implementations, may fall back to using the \fBuuid_generate_time()\fR method if they cannot obtain sufficient random data. Software that prefers a specific type of UUID should call either \fBuuid_generate_random()\fR or \fBuuid_generate_time()\fR directly instead of leaving the choice of which to generate up to \fBuuid_generate()\fR. .sp .LP The \fBuuid_is_null()\fR function compares the value of the specified UUID variable \fIuu\fR to the \fINULL\fR value. If the value is equal to the \fINULL\fR UUID, 1 is returned. Otherwise 0 is returned. .sp .LP The \fBuuid_parse()\fR function converts the UUID string specified by \fIin\fR to the internal \fBuuid_t\fR format. The input UUID is a string of the form \fBcefa7a9c-1dd2-11b2-8350-880020adbeef\fR. In \fBprintf\fR(3C) format, the string is "\fB%08x-%04x-%04x-%04x-%012x\fR", 36 bytes plus the trailing null character. If the input string is parsed successfully, \fB0\fR is returned and the UUID is stored in the location pointed to by \fIuu\fR. Otherwise \fB-1\fR is returned. .sp .LP The \fBuuid_time()\fR function extracts the time at which the specified UUID \fIuu\fR was created. Since the UUID creation time is encoded within the UUID, this function can reasonably be expected to extract the creation time only for UUID's created with the \fBuuid_generate_time()\fR function. The time at which the UUID was created, in seconds since January 1, 1970 GMT (the epoch), is returned. For more information, see the \fBtime\fR(2) man page. The time at which the UUID was created, in seconds and microseconds since the epoch is also stored in the location pointed to by \fBret_tv\fR. For more information, see the \fBgettimeofday\fR(3C) man page. .sp .LP The \fBuuid_unparse()\fR function converts the specified UUID \fIuu\fR from the internal binary format to a string of the length defined in the \fBuuid.h\fR macro, \fBUUID_PRINTABLE_STRING_LENGTH\fR, which includes the trailing null character. The resulting value is stored in the character string pointed to by \fIout\fR. .sp .LP The \fBuuid_unparse_lower()\fR and \fBuuid_unparse_upper()\fR functions are similar to \fBuuid_unparse()\fR, but specify whether the output uses lowercase ("\fBabcdef\fR") or uppercase ("\fBABCDEF\fR") letters to represent hexadecimal digits. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level Safe .TE .sp .SH SEE ALSO .sp .LP \fBtime\fR(2), \fBgettimeofday\fR(3C), \fBprintf\fR(3C), \fBlibuuid\fR(3LIB), \fBattributes\fR(7), \fBinetd\fR(8) .SH HISTORY .sp .LP The \fBuuid_unparse_lower()\fR and \fBuuid_unparse_upper()\fR functions were added to Solaris in the Oracle Solaris 11.4.27 Support Repository Update. .sp .LP The \fBlibuuid\fR library, including the functions \fBuuid_clear()\fR, \fBuuid_compare()\fR, \fBuuid_copy()\fR, \fBuuid_generate()\fR, \fBuuid_generate_random()\fR, \fBuuid_generate_time()\fR, \fBuuid_is_null()\fR, \fBuuid_parse()\fR, \fBuuid_time()\fR, and \fBuuid_unparse()\fR, was added to Solaris in the Solaris 9 4/03 update release.