1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /*******************************************************************************
4 * Module Name: nsnames - Name manipulation and search
6 ******************************************************************************/
13 #define _COMPONENT ACPI_NAMESPACE
14 ACPI_MODULE_NAME("nsnames")
16 /*******************************************************************************
18 * FUNCTION: acpi_ns_get_external_pathname
20 * PARAMETERS: node - Namespace node whose pathname is needed
22 * RETURN: Pointer to storage containing the fully qualified name of
23 * the node, In external format (name segments separated by path
26 * DESCRIPTION: Used to obtain the full pathname to a namespace node, usually
27 * for error and debug statements.
29 ******************************************************************************/
30 char *acpi_ns_get_external_pathname(struct acpi_namespace_node
*node
)
34 ACPI_FUNCTION_TRACE_PTR(ns_get_external_pathname
, node
);
36 name_buffer
= acpi_ns_get_normalized_pathname(node
, FALSE
);
37 return_PTR(name_buffer
);
40 /*******************************************************************************
42 * FUNCTION: acpi_ns_get_pathname_length
44 * PARAMETERS: node - Namespace node
46 * RETURN: Length of path, including prefix
48 * DESCRIPTION: Get the length of the pathname string for this node
50 ******************************************************************************/
52 acpi_size
acpi_ns_get_pathname_length(struct acpi_namespace_node
*node
)
56 /* Validate the Node */
58 if (ACPI_GET_DESCRIPTOR_TYPE(node
) != ACPI_DESC_TYPE_NAMED
) {
60 "Invalid/cached reference target node: %p, descriptor type %d",
61 node
, ACPI_GET_DESCRIPTOR_TYPE(node
)));
65 size
= acpi_ns_build_normalized_path(node
, NULL
, 0, FALSE
);
69 /*******************************************************************************
71 * FUNCTION: acpi_ns_handle_to_name
73 * PARAMETERS: target_handle - Handle of named object whose name is
75 * buffer - Where the name is returned
77 * RETURN: Status, Buffer is filled with name if status is AE_OK
79 * DESCRIPTION: Build and return a full namespace name
81 ******************************************************************************/
84 acpi_ns_handle_to_name(acpi_handle target_handle
, struct acpi_buffer
*buffer
)
87 struct acpi_namespace_node
*node
;
88 const char *node_name
;
90 ACPI_FUNCTION_TRACE_PTR(ns_handle_to_name
, target_handle
);
92 node
= acpi_ns_validate_handle(target_handle
);
94 return_ACPI_STATUS(AE_BAD_PARAMETER
);
97 /* Validate/Allocate/Clear caller buffer */
99 status
= acpi_ut_initialize_buffer(buffer
, ACPI_PATH_SEGMENT_LENGTH
);
100 if (ACPI_FAILURE(status
)) {
101 return_ACPI_STATUS(status
);
104 /* Just copy the ACPI name from the Node and zero terminate it */
106 node_name
= acpi_ut_get_node_name(node
);
107 ACPI_COPY_NAMESEG(buffer
->pointer
, node_name
);
108 ((char *)buffer
->pointer
)[ACPI_NAMESEG_SIZE
] = 0;
110 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "%4.4s\n", (char *)buffer
->pointer
));
111 return_ACPI_STATUS(AE_OK
);
114 /*******************************************************************************
116 * FUNCTION: acpi_ns_handle_to_pathname
118 * PARAMETERS: target_handle - Handle of named object whose name is
120 * buffer - Where the pathname is returned
121 * no_trailing - Remove trailing '_' for each name
124 * RETURN: Status, Buffer is filled with pathname if status is AE_OK
126 * DESCRIPTION: Build and return a full namespace pathname
128 ******************************************************************************/
131 acpi_ns_handle_to_pathname(acpi_handle target_handle
,
132 struct acpi_buffer
*buffer
, u8 no_trailing
)
135 struct acpi_namespace_node
*node
;
136 acpi_size required_size
;
138 ACPI_FUNCTION_TRACE_PTR(ns_handle_to_pathname
, target_handle
);
140 node
= acpi_ns_validate_handle(target_handle
);
142 return_ACPI_STATUS(AE_BAD_PARAMETER
);
145 /* Determine size required for the caller buffer */
148 acpi_ns_build_normalized_path(node
, NULL
, 0, no_trailing
);
149 if (!required_size
) {
150 return_ACPI_STATUS(AE_BAD_PARAMETER
);
153 /* Validate/Allocate/Clear caller buffer */
155 status
= acpi_ut_initialize_buffer(buffer
, required_size
);
156 if (ACPI_FAILURE(status
)) {
157 return_ACPI_STATUS(status
);
160 /* Build the path in the caller buffer */
162 (void)acpi_ns_build_normalized_path(node
, buffer
->pointer
,
163 (u32
)required_size
, no_trailing
);
165 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "%s [%X]\n",
166 (char *)buffer
->pointer
, (u32
) required_size
));
167 return_ACPI_STATUS(AE_OK
);
170 /*******************************************************************************
172 * FUNCTION: acpi_ns_build_normalized_path
174 * PARAMETERS: node - Namespace node
175 * full_path - Where the path name is returned
176 * path_size - Size of returned path name buffer
177 * no_trailing - Remove trailing '_' from each name segment
179 * RETURN: Return 1 if the AML path is empty, otherwise returning (length
180 * of pathname + 1) which means the 'FullPath' contains a trailing
183 * DESCRIPTION: Build and return a full namespace pathname.
184 * Note that if the size of 'FullPath' isn't large enough to
185 * contain the namespace node's path name, the actual required
186 * buffer length is returned, and it should be greater than
187 * 'PathSize'. So callers are able to check the returning value
188 * to determine the buffer size of 'FullPath'.
190 ******************************************************************************/
193 acpi_ns_build_normalized_path(struct acpi_namespace_node
*node
,
194 char *full_path
, u32 path_size
, u8 no_trailing
)
197 char name
[ACPI_NAMESEG_SIZE
];
199 char c
, *left
, *right
;
200 struct acpi_namespace_node
*next_node
;
202 ACPI_FUNCTION_TRACE_PTR(ns_build_normalized_path
, node
);
204 #define ACPI_PATH_PUT8(path, size, byte, length) \
206 if ((length) < (size)) \
208 (path)[(length)] = (byte); \
214 * Make sure the path_size is correct, so that we don't need to
215 * validate both full_path and path_size.
222 goto build_trailing_null
;
226 while (next_node
&& next_node
!= acpi_gbl_root_node
) {
227 if (next_node
!= node
) {
228 ACPI_PATH_PUT8(full_path
, path_size
,
229 AML_DUAL_NAME_PREFIX
, length
);
232 ACPI_MOVE_32_TO_32(name
, &next_node
->name
);
233 do_no_trailing
= no_trailing
;
234 for (i
= 0; i
< 4; i
++) {
236 if (do_no_trailing
&& c
!= '_') {
237 do_no_trailing
= FALSE
;
239 if (!do_no_trailing
) {
240 ACPI_PATH_PUT8(full_path
, path_size
, c
, length
);
244 next_node
= next_node
->parent
;
247 ACPI_PATH_PUT8(full_path
, path_size
, AML_ROOT_PREFIX
, length
);
249 /* Reverse the path string */
251 if (length
<= path_size
) {
253 right
= full_path
+ length
- 1;
255 while (left
< right
) {
262 /* Append the trailing null */
265 ACPI_PATH_PUT8(full_path
, path_size
, '\0', length
);
267 #undef ACPI_PATH_PUT8
269 return_UINT32(length
);
272 /*******************************************************************************
274 * FUNCTION: acpi_ns_get_normalized_pathname
276 * PARAMETERS: node - Namespace node whose pathname is needed
277 * no_trailing - Remove trailing '_' from each name segment
279 * RETURN: Pointer to storage containing the fully qualified name of
280 * the node, In external format (name segments separated by path
283 * DESCRIPTION: Used to obtain the full pathname to a namespace node, usually
284 * for error and debug statements. All trailing '_' will be
285 * removed from the full pathname if 'NoTrailing' is specified..
287 ******************************************************************************/
289 char *acpi_ns_get_normalized_pathname(struct acpi_namespace_node
*node
,
295 ACPI_FUNCTION_TRACE_PTR(ns_get_normalized_pathname
, node
);
297 /* Calculate required buffer size based on depth below root */
299 size
= acpi_ns_build_normalized_path(node
, NULL
, 0, no_trailing
);
304 /* Allocate a buffer to be returned to caller */
306 name_buffer
= ACPI_ALLOCATE_ZEROED(size
);
308 ACPI_ERROR((AE_INFO
, "Could not allocate %u bytes", (u32
)size
));
312 /* Build the path in the allocated buffer */
314 (void)acpi_ns_build_normalized_path(node
, name_buffer
, (u32
)size
,
317 ACPI_DEBUG_PRINT_RAW((ACPI_DB_NAMES
, "%s: Path \"%s\"\n",
318 ACPI_GET_FUNCTION_NAME
, name_buffer
));
320 return_PTR(name_buffer
);
323 /*******************************************************************************
325 * FUNCTION: acpi_ns_build_prefixed_pathname
327 * PARAMETERS: prefix_scope - Scope/Path that prefixes the internal path
328 * internal_path - Name or path of the namespace node
332 * DESCRIPTION: Construct a fully qualified pathname from a concatenation of:
333 * 1) Path associated with the prefix_scope namespace node
334 * 2) External path representation of the Internal path
336 ******************************************************************************/
338 char *acpi_ns_build_prefixed_pathname(union acpi_generic_state
*prefix_scope
,
339 const char *internal_path
)
342 char *full_path
= NULL
;
343 char *external_path
= NULL
;
344 char *prefix_path
= NULL
;
345 acpi_size prefix_path_length
= 0;
347 /* If there is a prefix, get the pathname to it */
349 if (prefix_scope
&& prefix_scope
->scope
.node
) {
351 acpi_ns_get_normalized_pathname(prefix_scope
->scope
.node
,
354 prefix_path_length
= strlen(prefix_path
);
358 status
= acpi_ns_externalize_name(ACPI_UINT32_MAX
, internal_path
,
359 NULL
, &external_path
);
360 if (ACPI_FAILURE(status
)) {
364 /* Merge the prefix path and the path. 2 is for one dot and trailing null */
367 ACPI_ALLOCATE_ZEROED(prefix_path_length
+ strlen(external_path
) +
373 /* Don't merge if the External path is already fully qualified */
375 if (prefix_path
&& (*external_path
!= '\\') && (*external_path
!= '^')) {
376 strcat(full_path
, prefix_path
);
377 if (prefix_path
[1]) {
378 strcat(full_path
, ".");
382 acpi_ns_normalize_pathname(external_path
);
383 strcat(full_path
, external_path
);
387 ACPI_FREE(prefix_path
);
390 ACPI_FREE(external_path
);
396 /*******************************************************************************
398 * FUNCTION: acpi_ns_normalize_pathname
400 * PARAMETERS: original_path - Path to be normalized, in External format
402 * RETURN: The original path is processed in-place
404 * DESCRIPTION: Remove trailing underscores from each element of a path.
406 * For example: \A___.B___.C___ becomes \A.B.C
408 ******************************************************************************/
410 void acpi_ns_normalize_pathname(char *original_path
)
412 char *input_path
= original_path
;
413 char *new_path_buffer
;
417 /* Allocate a temp buffer in which to construct the new path */
419 new_path_buffer
= ACPI_ALLOCATE_ZEROED(strlen(input_path
) + 1);
420 new_path
= new_path_buffer
;
421 if (!new_path_buffer
) {
425 /* Special characters may appear at the beginning of the path */
427 if (*input_path
== '\\') {
428 *new_path
= *input_path
;
433 while (*input_path
== '^') {
434 *new_path
= *input_path
;
439 /* Remainder of the path */
441 while (*input_path
) {
443 /* Do one nameseg at a time */
445 for (i
= 0; (i
< ACPI_NAMESEG_SIZE
) && *input_path
; i
++) {
446 if ((i
== 0) || (*input_path
!= '_')) { /* First char is allowed to be underscore */
447 *new_path
= *input_path
;
454 /* Dot means that there are more namesegs to come */
456 if (*input_path
== '.') {
457 *new_path
= *input_path
;
464 strcpy(original_path
, new_path_buffer
);
465 ACPI_FREE(new_path_buffer
);