uuid.c File Reference

Universally unique IDs. More...

#include <stdint.h>
#include <stdio.h>
#include <errno.h>
#include <byteswap.h>
#include <ipxe/base16.h>
#include <ipxe/uuid.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
const char *	uuid_ntoa (const union uuid *uuid)
	Convert UUID to printable string. More...
int	uuid_aton (const char *string, union uuid *uuid)
	Parse UUID. More...

Detailed Description

Universally unique IDs.

Definition in file uuid.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

uuid_ntoa()

const char* uuid_ntoa

(

const union uuid *

uuid

)

Convert UUID to printable string.

Parameters

uuid

UUID

Return values

string

UUID in canonical form

Definition at line 45 of file uuid.c.

                                                  {
        static char buf[37]; /* "00000000-0000-0000-0000-000000000000" */

        sprintf ( buf, "%08x-%04x-%04x-%04x-%02x%02x%02x%02x%02x%02x",
                  be32_to_cpu ( uuid->canonical.a ),
                  be16_to_cpu ( uuid->canonical.b ),
                  be16_to_cpu ( uuid->canonical.c ),
                  be16_to_cpu ( uuid->canonical.d ),
                  uuid->canonical.e[0], uuid->canonical.e[1],
                  uuid->canonical.e[2], uuid->canonical.e[3],
                  uuid->canonical.e[4], uuid->canonical.e[5] );
        return buf;
}

References uuid::a, uuid::b, be16_to_cpu, be32_to_cpu, uuid::c, uuid::canonical, uuid::d, uuid::e, and sprintf.

Referenced by efi_block_match(), efi_guid_ntoa(), format_uuid_setting(), iscsi_fetch_settings(), peerdisc_create(), uuid_aton_okx(), uuid_ntoa_okx(), vmbus_probe_channels(), and vmbus_reset_channels().

uuid_aton()

int uuid_aton	(	const char *	string,
		union uuid *	uuid
	)

Parse UUID.

Parameters

string	UUID string
uuid	UUID to fill in

Return values

rc	Return status code

Definition at line 66 of file uuid.c.

                                                       {
        int len;
        int rc;

        /* Decode as hex string with optional '-' separator */
        len = hex_decode ( ( '-' | HEX_DECODE_OPTIONAL ), string, uuid->raw,
                           sizeof ( *uuid ) );
        if ( len < 0 ) {
                rc = len;
                return rc;
        }

        /* Check length */
        if ( len != sizeof ( *uuid ) )
                return -EINVAL;

        return 0;
}

References EINVAL, hex_decode(), HEX_DECODE_OPTIONAL, len, uuid::raw, and rc.

Referenced by parse_uuid(), parse_uuid_setting(), uuid_aton_fail_okx(), and uuid_aton_okx().