Loading...
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
1/******************************************************************************
2 *
3 * Module Name: utuuid -- UUID support functions
4 *
5 *****************************************************************************/
6
7/*
8 * Copyright (C) 2000 - 2016, Intel Corp.
9 * All rights reserved.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
25 *
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
29 *
30 * NO WARRANTY
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
42 */
43
44#include <acpi/acpi.h>
45#include "accommon.h"
46
47#define _COMPONENT ACPI_COMPILER
48ACPI_MODULE_NAME("utuuid")
49
50#if (defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP || defined ACPI_HELP_APP)
51/*
52 * UUID support functions.
53 *
54 * This table is used to convert an input UUID ascii string to a 16 byte
55 * buffer and the reverse. The table maps a UUID buffer index 0-15 to
56 * the index within the 36-byte UUID string where the associated 2-byte
57 * hex value can be found.
58 *
59 * 36-byte UUID strings are of the form:
60 * aabbccdd-eeff-gghh-iijj-kkllmmnnoopp
61 * Where aa-pp are one byte hex numbers, made up of two hex digits
62 *
63 * Note: This table is basically the inverse of the string-to-offset table
64 * found in the ACPI spec in the description of the to_UUID macro.
65 */
66const u8 acpi_gbl_map_to_uuid_offset[UUID_BUFFER_LENGTH] = {
67 6, 4, 2, 0, 11, 9, 16, 14, 19, 21, 24, 26, 28, 30, 32, 34
68};
69
70/*******************************************************************************
71 *
72 * FUNCTION: acpi_ut_convert_string_to_uuid
73 *
74 * PARAMETERS: in_string - 36-byte formatted UUID string
75 * uuid_buffer - Where the 16-byte UUID buffer is returned
76 *
77 * RETURN: None. Output data is returned in the uuid_buffer
78 *
79 * DESCRIPTION: Convert a 36-byte formatted UUID string to 16-byte UUID buffer
80 *
81 ******************************************************************************/
82
83void acpi_ut_convert_string_to_uuid(char *in_string, u8 *uuid_buffer)
84{
85 u32 i;
86
87 for (i = 0; i < UUID_BUFFER_LENGTH; i++) {
88 uuid_buffer[i] =
89 (acpi_ut_ascii_char_to_hex
90 (in_string[acpi_gbl_map_to_uuid_offset[i]]) << 4);
91
92 uuid_buffer[i] |=
93 acpi_ut_ascii_char_to_hex(in_string
94 [acpi_gbl_map_to_uuid_offset[i] +
95 1]);
96 }
97}
98#endif