xref: /linux/drivers/acpi/acpica/exstorob.c (revision 2da68a77)
1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /******************************************************************************
3  *
4  * Module Name: exstorob - AML object store support, store to object
5  *
6  * Copyright (C) 2000 - 2022, Intel Corp.
7  *
8  *****************************************************************************/
9 
10 #include <acpi/acpi.h>
11 #include "accommon.h"
12 #include "acinterp.h"
13 
14 #define _COMPONENT          ACPI_EXECUTER
15 ACPI_MODULE_NAME("exstorob")
16 
17 /*******************************************************************************
18  *
19  * FUNCTION:    acpi_ex_store_buffer_to_buffer
20  *
21  * PARAMETERS:  source_desc         - Source object to copy
22  *              target_desc         - Destination object of the copy
23  *
24  * RETURN:      Status
25  *
26  * DESCRIPTION: Copy a buffer object to another buffer object.
27  *
28  ******************************************************************************/
29 acpi_status
30 acpi_ex_store_buffer_to_buffer(union acpi_operand_object *source_desc,
31 			       union acpi_operand_object *target_desc)
32 {
33 	u32 length;
34 	u8 *buffer;
35 
36 	ACPI_FUNCTION_TRACE_PTR(ex_store_buffer_to_buffer, source_desc);
37 
38 	/* If Source and Target are the same, just return */
39 
40 	if (source_desc == target_desc) {
41 		return_ACPI_STATUS(AE_OK);
42 	}
43 
44 	/* We know that source_desc is a buffer by now */
45 
46 	buffer = ACPI_CAST_PTR(u8, source_desc->buffer.pointer);
47 	length = source_desc->buffer.length;
48 
49 	/*
50 	 * If target is a buffer of length zero or is a static buffer,
51 	 * allocate a new buffer of the proper length
52 	 */
53 	if ((target_desc->buffer.length == 0) ||
54 	    (target_desc->common.flags & AOPOBJ_STATIC_POINTER)) {
55 		target_desc->buffer.pointer = ACPI_ALLOCATE(length);
56 		if (!target_desc->buffer.pointer) {
57 			return_ACPI_STATUS(AE_NO_MEMORY);
58 		}
59 
60 		target_desc->buffer.length = length;
61 	}
62 
63 	/* Copy source buffer to target buffer */
64 
65 	if (length <= target_desc->buffer.length) {
66 
67 		/* Clear existing buffer and copy in the new one */
68 
69 		memset(target_desc->buffer.pointer, 0,
70 		       target_desc->buffer.length);
71 		memcpy(target_desc->buffer.pointer, buffer, length);
72 
73 #ifdef ACPI_OBSOLETE_BEHAVIOR
74 		/*
75 		 * NOTE: ACPI versions up to 3.0 specified that the buffer must be
76 		 * truncated if the string is smaller than the buffer. However, "other"
77 		 * implementations of ACPI never did this and thus became the defacto
78 		 * standard. ACPI 3.0A changes this behavior such that the buffer
79 		 * is no longer truncated.
80 		 */
81 
82 		/*
83 		 * OBSOLETE BEHAVIOR:
84 		 * If the original source was a string, we must truncate the buffer,
85 		 * according to the ACPI spec. Integer-to-Buffer and Buffer-to-Buffer
86 		 * copy must not truncate the original buffer.
87 		 */
88 		if (original_src_type == ACPI_TYPE_STRING) {
89 
90 			/* Set the new length of the target */
91 
92 			target_desc->buffer.length = length;
93 		}
94 #endif
95 	} else {
96 		/* Truncate the source, copy only what will fit */
97 
98 		memcpy(target_desc->buffer.pointer, buffer,
99 		       target_desc->buffer.length);
100 
101 		ACPI_DEBUG_PRINT((ACPI_DB_INFO,
102 				  "Truncating source buffer from %X to %X\n",
103 				  length, target_desc->buffer.length));
104 	}
105 
106 	/* Copy flags */
107 
108 	target_desc->buffer.flags = source_desc->buffer.flags;
109 	target_desc->common.flags &= ~AOPOBJ_STATIC_POINTER;
110 	return_ACPI_STATUS(AE_OK);
111 }
112 
113 /*******************************************************************************
114  *
115  * FUNCTION:    acpi_ex_store_string_to_string
116  *
117  * PARAMETERS:  source_desc         - Source object to copy
118  *              target_desc         - Destination object of the copy
119  *
120  * RETURN:      Status
121  *
122  * DESCRIPTION: Copy a String object to another String object
123  *
124  ******************************************************************************/
125 
126 acpi_status
127 acpi_ex_store_string_to_string(union acpi_operand_object *source_desc,
128 			       union acpi_operand_object *target_desc)
129 {
130 	u32 length;
131 	u8 *buffer;
132 
133 	ACPI_FUNCTION_TRACE_PTR(ex_store_string_to_string, source_desc);
134 
135 	/* If Source and Target are the same, just return */
136 
137 	if (source_desc == target_desc) {
138 		return_ACPI_STATUS(AE_OK);
139 	}
140 
141 	/* We know that source_desc is a string by now */
142 
143 	buffer = ACPI_CAST_PTR(u8, source_desc->string.pointer);
144 	length = source_desc->string.length;
145 
146 	/*
147 	 * Replace existing string value if it will fit and the string
148 	 * pointer is not a static pointer (part of an ACPI table)
149 	 */
150 	if ((length < target_desc->string.length) &&
151 	    (!(target_desc->common.flags & AOPOBJ_STATIC_POINTER))) {
152 		/*
153 		 * String will fit in existing non-static buffer.
154 		 * Clear old string and copy in the new one
155 		 */
156 		memset(target_desc->string.pointer, 0,
157 		       (acpi_size)target_desc->string.length + 1);
158 		memcpy(target_desc->string.pointer, buffer, length);
159 	} else {
160 		/*
161 		 * Free the current buffer, then allocate a new buffer
162 		 * large enough to hold the value
163 		 */
164 		if (target_desc->string.pointer &&
165 		    (!(target_desc->common.flags & AOPOBJ_STATIC_POINTER))) {
166 
167 			/* Only free if not a pointer into the DSDT */
168 
169 			ACPI_FREE(target_desc->string.pointer);
170 		}
171 
172 		target_desc->string.pointer =
173 		    ACPI_ALLOCATE_ZEROED((acpi_size)length + 1);
174 
175 		if (!target_desc->string.pointer) {
176 			return_ACPI_STATUS(AE_NO_MEMORY);
177 		}
178 
179 		target_desc->common.flags &= ~AOPOBJ_STATIC_POINTER;
180 		memcpy(target_desc->string.pointer, buffer, length);
181 	}
182 
183 	/* Set the new target length */
184 
185 	target_desc->string.length = length;
186 	return_ACPI_STATUS(AE_OK);
187 }
188