uuid.h File Reference

Universally unique IDs. More...

#include <stdint.h>
#include <byteswap.h>

Go to the source code of this file.

Data Structures
union	uuid
	A universally unique ID. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static void	uuid_mangle (union uuid *uuid)
	Change UUID endianness. More...
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.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

uuid_mangle()

static void uuid_mangle ( union uuid *  uuid )

inlinestatic

Change UUID endianness.

Parameters

uuid

UUID

RFC4122 defines UUIDs as being encoded in network byte order, but leaves some wriggle room for "explicit application or presentation protocol specification to the contrary". PXE, EFI and SMBIOS (versions 2.6 and above) treat the first three fields as being little-endian.

Definition at line 43 of file uuid.h.

                                                    {

        __bswap_32s ( &uuid->canonical.a );
        __bswap_16s ( &uuid->canonical.b );
        __bswap_16s ( &uuid->canonical.c );
}

References uuid::a, uuid::b, uuid::c, and uuid::canonical.

Referenced by dhcp_create_request(), efi_guid_ntoa(), efi_path_guid(), format_uuid_setting(), parse_uuid_setting(), smbios_fetch(), and vmbus_probe_channels().

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().