1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /******************************************************************************
4 * Module Name: utuuid -- UUID support functions
6 * Copyright (C) 2000 - 2023, Intel Corp.
8 *****************************************************************************/
10 #include <acpi/acpi.h>
13 #define _COMPONENT ACPI_COMPILER
14 ACPI_MODULE_NAME("utuuid")
16 #if (defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP || defined ACPI_HELP_APP)
18 * UUID support functions.
20 * This table is used to convert an input UUID ascii string to a 16 byte
21 * buffer and the reverse. The table maps a UUID buffer index 0-15 to
22 * the index within the 36-byte UUID string where the associated 2-byte
23 * hex value can be found.
25 * 36-byte UUID strings are of the form:
26 * aabbccdd-eeff-gghh-iijj-kkllmmnnoopp
27 * Where aa-pp are one byte hex numbers, made up of two hex digits
29 * Note: This table is basically the inverse of the string-to-offset table
30 * found in the ACPI spec in the description of the to_UUID macro.
32 const u8 acpi_gbl_map_to_uuid_offset[UUID_BUFFER_LENGTH] = {
33 6, 4, 2, 0, 11, 9, 16, 14, 19, 21, 24, 26, 28, 30, 32, 34
36 /*******************************************************************************
38 * FUNCTION: acpi_ut_convert_string_to_uuid
40 * PARAMETERS: in_string - 36-byte formatted UUID string
41 * uuid_buffer - Where the 16-byte UUID buffer is returned
43 * RETURN: None. Output data is returned in the uuid_buffer
45 * DESCRIPTION: Convert a 36-byte formatted UUID string to 16-byte UUID buffer
47 ******************************************************************************/
49 void acpi_ut_convert_string_to_uuid(char *in_string, u8 *uuid_buffer)
53 for (i = 0; i < UUID_BUFFER_LENGTH; i++) {
55 (acpi_ut_ascii_char_to_hex
56 (in_string[acpi_gbl_map_to_uuid_offset[i]]) << 4);
59 acpi_ut_ascii_char_to_hex(in_string
60 [acpi_gbl_map_to_uuid_offset[i] +
65 /*******************************************************************************
67 * FUNCTION: acpi_ut_convert_uuid_to_string
69 * PARAMETERS: uuid_buffer - 16-byte UUID buffer
70 * out_string - 36-byte formatted UUID string
74 * DESCRIPTION: Convert 16-byte UUID buffer to 36-byte formatted UUID string
75 * out_string must be 37 bytes to include null terminator.
77 ******************************************************************************/
79 acpi_status acpi_ut_convert_uuid_to_string(char *uuid_buffer, char *out_string)
83 if (!uuid_buffer || !out_string) {
84 return (AE_BAD_PARAMETER);
87 for (i = 0; i < UUID_BUFFER_LENGTH; i++) {
88 out_string[acpi_gbl_map_to_uuid_offset[i]] =
89 acpi_ut_hex_to_ascii_char(uuid_buffer[i], 4);
91 out_string[acpi_gbl_map_to_uuid_offset[i] + 1] =
92 acpi_ut_hex_to_ascii_char(uuid_buffer[i], 0);
95 /* Insert required hyphens (dashes) */
97 out_string[UUID_HYPHEN1_OFFSET] =
98 out_string[UUID_HYPHEN2_OFFSET] =
99 out_string[UUID_HYPHEN3_OFFSET] =
100 out_string[UUID_HYPHEN4_OFFSET] = '-';
102 out_string[UUID_STRING_LENGTH] = 0; /* Null terminate */