1// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2/******************************************************************************
3 *
4 * Module Name: utuuid -- UUID support functions
5 *
6 * Copyright (C) 2000 - 2023, Intel Corp.
7 *
8 *****************************************************************************/
9
10#include <acpi/acpi.h>
11#include "accommon.h"
12
13#define _COMPONENT ACPI_COMPILER
14ACPI_MODULE_NAME("utuuid")
15
16#if (defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP || defined ACPI_HELP_APP)
17/*
18 * UUID support functions.
19 *
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.
24 *
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
28 *
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.
31 */
32const 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
34};
35
36/*******************************************************************************
37 *
38 * FUNCTION: acpi_ut_convert_string_to_uuid
39 *
40 * PARAMETERS: in_string - 36-byte formatted UUID string
41 * uuid_buffer - Where the 16-byte UUID buffer is returned
42 *
43 * RETURN: None. Output data is returned in the uuid_buffer
44 *
45 * DESCRIPTION: Convert a 36-byte formatted UUID string to 16-byte UUID buffer
46 *
47 ******************************************************************************/
48
49void acpi_ut_convert_string_to_uuid(char *in_string, u8 *uuid_buffer)
50{
51 u32 i;
52
53 for (i = 0; i < UUID_BUFFER_LENGTH; i++) {
54 uuid_buffer[i] =
55 (acpi_ut_ascii_char_to_hex
56 (in_string[acpi_gbl_map_to_uuid_offset[i]]) << 4);
57
58 uuid_buffer[i] |=
59 acpi_ut_ascii_char_to_hex(in_string
60 [acpi_gbl_map_to_uuid_offset[i] +
61 1]);
62 }
63}
64
65/*******************************************************************************
66 *
67 * FUNCTION: acpi_ut_convert_uuid_to_string
68 *
69 * PARAMETERS: uuid_buffer - 16-byte UUID buffer
70 * out_string - 36-byte formatted UUID string
71 *
72 * RETURN: Status
73 *
74 * DESCRIPTION: Convert 16-byte UUID buffer to 36-byte formatted UUID string
75 * out_string must be 37 bytes to include null terminator.
76 *
77 ******************************************************************************/
78
79acpi_status acpi_ut_convert_uuid_to_string(char *uuid_buffer, char *out_string)
80{
81 u32 i;
82
83 if (!uuid_buffer || !out_string) {
84 return (AE_BAD_PARAMETER);
85 }
86
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);
90
91 out_string[acpi_gbl_map_to_uuid_offset[i] + 1] =
92 acpi_ut_hex_to_ascii_char(uuid_buffer[i], 0);
93 }
94
95 /* Insert required hyphens (dashes) */
96
97 out_string[UUID_HYPHEN1_OFFSET] =
98 out_string[UUID_HYPHEN2_OFFSET] =
99 out_string[UUID_HYPHEN3_OFFSET] =
100 out_string[UUID_HYPHEN4_OFFSET] = '-';
101
102 out_string[UUID_STRING_LENGTH] = 0; /* Null terminate */
103 return (AE_OK);
104}
105#endif
106

source code of linux/drivers/acpi/acpica/utuuid.c