svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
uuid_clear(3uuid)
Universally Unique Identifier Library Functions uuid_clear(3UUID)
NAME
uuid_clear, uuid_compare, uuid_copy, uuid_generate, uuid_generate_ran‐
dom, uuid_generate_time, uuid_is_null, uuid_parse, uuid_time,
uuid_unparse, uuid_unparse_lower, uuid_unparse_upper - universally
unique identifier (UUID) operations
SYNOPSIS
cc [ flag ... ] file... -luuid [ library ... ]
#include <uuid/uuid.h>
void uuid_clear(uuid_t uu);
int uuid_compare(const uuid_t uu1, const uuid_t uu2);
void uuid_copy(uuid_t dst, const uuid_t src);
void uuid_generate(uuid_t out);
void uuid_generate_random(uuid_t out);
void uuid_generate_time(uuid_t out);
int uuid_is_null(const uuid_t uu);
int uuid_parse(char *in, uuid_t uu);
time_t uuid_time(const uuid_t uu, struct timeval *ret_tv);
void uuid_unparse(const uuid_t uu, char *out);
void uuid_unparse_lower(const uuid_t uu, char *out);
void uuid_unparse_upper(const uuid_t uu, char *out);
DESCRIPTION
The uuid_clear() function sets the value of the specified universally
unique identifier (UUID) variable uu to the NULL value.
The uuid_compare() function compares the two specified UUID variables
uu1 and uu2 to each other. It returns an integer less than, equal to,
or greater than zero if uu1 is found to be, respectively, lexicographi‐
cally less than, equal, or greater than uu2.
The uuid_copy() function copies the UUID variable src to dst.
The uuid_generate_random() 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 getrandom(2).
The uuid_generate_time() function uses the current time and the ran‐
domly 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 sig‐
nificant 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 cre‐
ated 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 uuid_generate_time() 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.
The uuid_generate() function generates a UUID using a method chosen by
the implementation. The Oracle Solaris implementation currently always
uses the uuid_generate_random() function. Other implementations,
including Solaris versions prior to Oracle Solaris 11.4.15 and possibly
future implementations, may fall back to using the uuid_generate_time()
method if they cannot obtain sufficient random data. Software that
prefers a specific type of UUID should call either uuid_generate_ran‐
dom() or uuid_generate_time() directly instead of leaving the choice of
which to generate up to uuid_generate().
The uuid_is_null() function compares the value of the specified UUID
variable uu to the NULL value. If the value is equal to the NULL UUID,
1 is returned. Otherwise 0 is returned.
The uuid_parse() function converts the UUID string specified by in to
the internal uuid_t format. The input UUID is a string of the form
cefa7a9c-1dd2-11b2-8350-880020adbeef. In printf(3C) format, the string
is "%08x-%04x-%04x-%04x-%012x", 36 bytes plus the trailing null charac‐
ter. If the input string is parsed successfully, 0 is returned and the
UUID is stored in the location pointed to by uu. Otherwise -1 is
returned.
The uuid_time() function extracts the time at which the specified UUID
uu 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 uuid_generate_time() 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
time(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 ret_tv. For more information, see the gettimeofday(3C) man page.
The uuid_unparse() function converts the specified UUID uu from the
internal binary format to a string of the length defined in the uuid.h
macro, UUID_PRINTABLE_STRING_LENGTH, which includes the trailing null
character. The resulting value is stored in the character string
pointed to by out.
The uuid_unparse_lower() and uuid_unparse_upper() functions are similar
to uuid_unparse(), but specify whether the output uses lowercase
("abcdef") or uppercase ("ABCDEF") letters to represent hexadecimal
digits.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSafe
SEE ALSO
time(2), gettimeofday(3C), printf(3C), libuuid(3LIB), attributes(7),
inetd(8)
HISTORY
The uuid_unparse_lower() and uuid_unparse_upper() functions were added
to Solaris in the Oracle Solaris 11.4.27 Support Repository Update.
The libuuid library, including the functions uuid_clear(), uuid_com‐
pare(), uuid_copy(), uuid_generate(), uuid_generate_random(), uuid_gen‐
erate_time(), uuid_is_null(), uuid_parse(), uuid_time(), and
uuid_unparse(), was added to Solaris in the Solaris 9 4/03 update
release.
Oracle Solaris 11.4 15 Jul 2020 uuid_clear(3UUID)