getuuid

getuuid#

Generates an UUID from string.

Defines

UUID_LEN#

Length of UUID, excluding terminating NUL.

UUID_ERROR#

error

Return values

UUID_COPY#

copied UUID from input as-is

UUID_RANDOM#

random version 4 UUID

UUID_HASH#

version 5 sha1-based UUID using the DNS namespace

UUID_EXTRACT#

UUID extracted input: [metadata URI]/[UUID].

Functions

int getuuid(char *buff, const char *id)#

Writes an UUID to buff based on id.

It follow the follow heuristics:

  • If id is NULL or empty, a new random version 4 UUID is generated. Return: UUID_RANDOM

  • If id is a valid UUID, it is copied as-is to buff. Return: UUID_COPY

  • If id matches [URI]/[UUID] then it returns the [UUID] part. id may optionally end with a final hash (#) or slash (/), which will be ignored. Return: UUID_EXTRACT

  • Otherwise is id an invalid UUID string. A new version 5 sha1-based UUID is generated from id using the DNS namespace. Any optional final hash (#) or slash (/) will be stripped off. Return: UUID_HASH

Length of buff must at least 37 bytes (36 for UUID + NUL termination).

Returns one of the codes UUID_RANDOM, UUID_COPY, UUID_EXTRACT or UUID_HASH. On error -1 is returned.

int getuuidn(char *buff, const char *id, size_t len)#

Like getuuid(), but takes the the length of id as an additional parameter.

int isuuid(const char *s)#

Returns non-zero if s is a valid UUID.

int isinstanceuri(const char *s, int len)#

Returns non-zero if s matches [URI]/[UUID].lenis the length ofs`. An optional final hash or slash will be ignored.