1 /******************************************************************************
3 * Module Name: nsutils - Utilities for accessing ACPI namespace, accessing
4 * parents and siblings and Scope manipulation
6 *****************************************************************************/
9 * Copyright (C) 2000 - 2006, R. Byron Moore
10 * All rights reserved.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions, and the following disclaimer,
17 * without modification.
18 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
19 * substantially similar to the "NO WARRANTY" disclaimer below
20 * ("Disclaimer") and any redistribution must be conditioned upon
21 * including a substantially similar Disclaimer requirement for further
22 * binary redistribution.
23 * 3. Neither the names of the above-listed copyright holders nor the names
24 * of any contributors may be used to endorse or promote products derived
25 * from this software without specific prior written permission.
27 * Alternatively, this software may be distributed under the terms of the
28 * GNU General Public License ("GPL") version 2 as published by the Free
29 * Software Foundation.
32 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
33 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
34 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
35 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
36 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
40 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
41 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
42 * POSSIBILITY OF SUCH DAMAGES.
45 #include <acpi/acpi.h>
46 #include <acpi/acnamesp.h>
47 #include <acpi/amlcode.h>
48 #include <acpi/actables.h>
50 #define _COMPONENT ACPI_NAMESPACE
51 ACPI_MODULE_NAME("nsutils")
53 /* Local prototypes */
54 static u8 acpi_ns_valid_path_separator(char sep);
56 #ifdef ACPI_OBSOLETE_FUNCTIONS
57 acpi_name acpi_ns_find_parent_name(struct acpi_namespace_node *node_to_search);
60 /*******************************************************************************
62 * FUNCTION: acpi_ns_report_error
64 * PARAMETERS: module_name - Caller's module name (for error output)
65 * line_number - Caller's line number (for error output)
66 * internal_name - Name or path of the namespace node
67 * lookup_status - Exception code from NS lookup
71 * DESCRIPTION: Print warning message with full pathname
73 ******************************************************************************/
76 acpi_ns_report_error(char *module_name,
78 char *internal_name, acpi_status lookup_status)
83 acpi_ut_report_error(module_name, line_number);
85 if (lookup_status == AE_BAD_CHARACTER) {
87 /* There is a non-ascii character in the name */
89 acpi_os_printf("[0x%4.4X] (NON-ASCII)",
90 *(ACPI_CAST_PTR(u32, internal_name)));
92 /* Convert path to external format */
94 status = acpi_ns_externalize_name(ACPI_UINT32_MAX,
95 internal_name, NULL, &name);
97 /* Print target name */
99 if (ACPI_SUCCESS(status)) {
100 acpi_os_printf("[%s]", name);
102 acpi_os_printf("[COULD NOT EXTERNALIZE NAME]");
110 acpi_os_printf(" Namespace lookup failure, %s\n",
111 acpi_format_exception(lookup_status));
114 /*******************************************************************************
116 * FUNCTION: acpi_ns_report_method_error
118 * PARAMETERS: module_name - Caller's module name (for error output)
119 * line_number - Caller's line number (for error output)
120 * Message - Error message to use on failure
121 * prefix_node - Prefix relative to the path
122 * Path - Path to the node (optional)
123 * method_status - Execution status
127 * DESCRIPTION: Print warning message with full pathname
129 ******************************************************************************/
132 acpi_ns_report_method_error(char *module_name,
135 struct acpi_namespace_node *prefix_node,
136 char *path, acpi_status method_status)
139 struct acpi_namespace_node *node = prefix_node;
141 acpi_ut_report_error(module_name, line_number);
144 status = acpi_ns_get_node_by_path(path, prefix_node,
145 ACPI_NS_NO_UPSEARCH, &node);
146 if (ACPI_FAILURE(status)) {
147 acpi_os_printf("[Could not get node by pathname]");
151 acpi_ns_print_node_pathname(node, message);
152 acpi_os_printf(", %s\n", acpi_format_exception(method_status));
155 /*******************************************************************************
157 * FUNCTION: acpi_ns_print_node_pathname
159 * PARAMETERS: Node - Object
160 * Message - Prefix message
162 * DESCRIPTION: Print an object's full namespace pathname
163 * Manages allocation/freeing of a pathname buffer
165 ******************************************************************************/
168 acpi_ns_print_node_pathname(struct acpi_namespace_node *node, char *message)
170 struct acpi_buffer buffer;
174 acpi_os_printf("[NULL NAME]");
178 /* Convert handle to full pathname and print it (with supplied message) */
180 buffer.length = ACPI_ALLOCATE_LOCAL_BUFFER;
182 status = acpi_ns_handle_to_pathname(node, &buffer);
183 if (ACPI_SUCCESS(status)) {
185 acpi_os_printf("%s ", message);
188 acpi_os_printf("[%s] (Node %p)", (char *)buffer.pointer, node);
189 ACPI_MEM_FREE(buffer.pointer);
193 /*******************************************************************************
195 * FUNCTION: acpi_ns_valid_root_prefix
197 * PARAMETERS: Prefix - Character to be checked
199 * RETURN: TRUE if a valid prefix
201 * DESCRIPTION: Check if a character is a valid ACPI Root prefix
203 ******************************************************************************/
205 u8 acpi_ns_valid_root_prefix(char prefix)
208 return ((u8) (prefix == '\\'));
211 /*******************************************************************************
213 * FUNCTION: acpi_ns_valid_path_separator
215 * PARAMETERS: Sep - Character to be checked
217 * RETURN: TRUE if a valid path separator
219 * DESCRIPTION: Check if a character is a valid ACPI path separator
221 ******************************************************************************/
223 static u8 acpi_ns_valid_path_separator(char sep)
226 return ((u8) (sep == '.'));
229 /*******************************************************************************
231 * FUNCTION: acpi_ns_get_type
233 * PARAMETERS: Node - Parent Node to be examined
235 * RETURN: Type field from Node whose handle is passed
237 * DESCRIPTION: Return the type of a Namespace node
239 ******************************************************************************/
241 acpi_object_type acpi_ns_get_type(struct acpi_namespace_node * node)
243 ACPI_FUNCTION_TRACE("ns_get_type");
246 ACPI_WARNING((AE_INFO, "Null Node parameter"));
247 return_UINT32(ACPI_TYPE_ANY);
250 return_UINT32((acpi_object_type) node->type);
253 /*******************************************************************************
255 * FUNCTION: acpi_ns_local
257 * PARAMETERS: Type - A namespace object type
259 * RETURN: LOCAL if names must be found locally in objects of the
260 * passed type, 0 if enclosing scopes should be searched
262 * DESCRIPTION: Returns scope rule for the given object type.
264 ******************************************************************************/
266 u32 acpi_ns_local(acpi_object_type type)
268 ACPI_FUNCTION_TRACE("ns_local");
270 if (!acpi_ut_valid_object_type(type)) {
272 /* Type code out of range */
274 ACPI_WARNING((AE_INFO, "Invalid Object Type %X", type));
275 return_UINT32(ACPI_NS_NORMAL);
278 return_UINT32((u32) acpi_gbl_ns_properties[type] & ACPI_NS_LOCAL);
281 /*******************************************************************************
283 * FUNCTION: acpi_ns_get_internal_name_length
285 * PARAMETERS: Info - Info struct initialized with the
286 * external name pointer.
290 * DESCRIPTION: Calculate the length of the internal (AML) namestring
291 * corresponding to the external (ASL) namestring.
293 ******************************************************************************/
295 void acpi_ns_get_internal_name_length(struct acpi_namestring_info *info)
297 char *next_external_char;
300 ACPI_FUNCTION_ENTRY();
302 next_external_char = info->external_name;
303 info->num_carats = 0;
304 info->num_segments = 0;
305 info->fully_qualified = FALSE;
308 * For the internal name, the required length is 4 bytes per segment, plus
309 * 1 each for root_prefix, multi_name_prefix_op, segment count, trailing null
310 * (which is not really needed, but no there's harm in putting it there)
312 * strlen() + 1 covers the first name_seg, which has no path separator
314 if (acpi_ns_valid_root_prefix(next_external_char[0])) {
315 info->fully_qualified = TRUE;
316 next_external_char++;
319 * Handle Carat prefixes
321 while (*next_external_char == '^') {
323 next_external_char++;
328 * Determine the number of ACPI name "segments" by counting the number of
329 * path separators within the string. Start with one segment since the
330 * segment count is [(# separators) + 1], and zero separators is ok.
332 if (*next_external_char) {
333 info->num_segments = 1;
334 for (i = 0; next_external_char[i]; i++) {
335 if (acpi_ns_valid_path_separator(next_external_char[i])) {
336 info->num_segments++;
341 info->length = (ACPI_NAME_SIZE * info->num_segments) +
342 4 + info->num_carats;
344 info->next_external_char = next_external_char;
347 /*******************************************************************************
349 * FUNCTION: acpi_ns_build_internal_name
351 * PARAMETERS: Info - Info struct fully initialized
355 * DESCRIPTION: Construct the internal (AML) namestring
356 * corresponding to the external (ASL) namestring.
358 ******************************************************************************/
360 acpi_status acpi_ns_build_internal_name(struct acpi_namestring_info *info)
362 u32 num_segments = info->num_segments;
363 char *internal_name = info->internal_name;
364 char *external_name = info->next_external_char;
368 ACPI_FUNCTION_TRACE("ns_build_internal_name");
370 /* Setup the correct prefixes, counts, and pointers */
372 if (info->fully_qualified) {
373 internal_name[0] = '\\';
375 if (num_segments <= 1) {
376 result = &internal_name[1];
377 } else if (num_segments == 2) {
378 internal_name[1] = AML_DUAL_NAME_PREFIX;
379 result = &internal_name[2];
381 internal_name[1] = AML_MULTI_NAME_PREFIX_OP;
382 internal_name[2] = (char)num_segments;
383 result = &internal_name[3];
387 * Not fully qualified.
388 * Handle Carats first, then append the name segments
391 if (info->num_carats) {
392 for (i = 0; i < info->num_carats; i++) {
393 internal_name[i] = '^';
397 if (num_segments <= 1) {
398 result = &internal_name[i];
399 } else if (num_segments == 2) {
400 internal_name[i] = AML_DUAL_NAME_PREFIX;
401 result = &internal_name[(acpi_native_uint) (i + 1)];
403 internal_name[i] = AML_MULTI_NAME_PREFIX_OP;
404 internal_name[(acpi_native_uint) (i + 1)] =
406 result = &internal_name[(acpi_native_uint) (i + 2)];
410 /* Build the name (minus path separators) */
412 for (; num_segments; num_segments--) {
413 for (i = 0; i < ACPI_NAME_SIZE; i++) {
414 if (acpi_ns_valid_path_separator(*external_name) ||
415 (*external_name == 0)) {
417 /* Pad the segment with underscore(s) if segment is short */
421 /* Convert the character to uppercase and save it */
424 (char)ACPI_TOUPPER((int)*external_name);
429 /* Now we must have a path separator, or the pathname is bad */
431 if (!acpi_ns_valid_path_separator(*external_name) &&
432 (*external_name != 0)) {
433 return_ACPI_STATUS(AE_BAD_PARAMETER);
436 /* Move on the next segment */
439 result += ACPI_NAME_SIZE;
442 /* Terminate the string */
446 if (info->fully_qualified) {
447 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
448 "Returning [%p] (abs) \"\\%s\"\n",
449 internal_name, internal_name));
451 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Returning [%p] (rel) \"%s\"\n",
452 internal_name, internal_name));
455 return_ACPI_STATUS(AE_OK);
458 /*******************************************************************************
460 * FUNCTION: acpi_ns_internalize_name
462 * PARAMETERS: *external_name - External representation of name
463 * **Converted Name - Where to return the resulting
464 * internal represention of the name
468 * DESCRIPTION: Convert an external representation (e.g. "\_PR_.CPU0")
469 * to internal form (e.g. 5c 2f 02 5f 50 52 5f 43 50 55 30)
471 *******************************************************************************/
473 acpi_status acpi_ns_internalize_name(char *external_name, char **converted_name)
476 struct acpi_namestring_info info;
479 ACPI_FUNCTION_TRACE("ns_internalize_name");
481 if ((!external_name) || (*external_name == 0) || (!converted_name)) {
482 return_ACPI_STATUS(AE_BAD_PARAMETER);
485 /* Get the length of the new internal name */
487 info.external_name = external_name;
488 acpi_ns_get_internal_name_length(&info);
490 /* We need a segment to store the internal name */
492 internal_name = ACPI_MEM_CALLOCATE(info.length);
493 if (!internal_name) {
494 return_ACPI_STATUS(AE_NO_MEMORY);
499 info.internal_name = internal_name;
500 status = acpi_ns_build_internal_name(&info);
501 if (ACPI_FAILURE(status)) {
502 ACPI_MEM_FREE(internal_name);
503 return_ACPI_STATUS(status);
506 *converted_name = internal_name;
507 return_ACPI_STATUS(AE_OK);
510 /*******************************************************************************
512 * FUNCTION: acpi_ns_externalize_name
514 * PARAMETERS: internal_name_length - Lenth of the internal name below
515 * internal_name - Internal representation of name
516 * converted_name_length - Where the length is returned
517 * converted_name - Where the resulting external name
522 * DESCRIPTION: Convert internal name (e.g. 5c 2f 02 5f 50 52 5f 43 50 55 30)
523 * to its external (printable) form (e.g. "\_PR_.CPU0")
525 ******************************************************************************/
528 acpi_ns_externalize_name(u32 internal_name_length,
530 u32 * converted_name_length, char **converted_name)
532 acpi_native_uint names_index = 0;
533 acpi_native_uint num_segments = 0;
534 acpi_native_uint required_length;
535 acpi_native_uint prefix_length = 0;
536 acpi_native_uint i = 0;
537 acpi_native_uint j = 0;
539 ACPI_FUNCTION_TRACE("ns_externalize_name");
541 if (!internal_name_length || !internal_name || !converted_name) {
542 return_ACPI_STATUS(AE_BAD_PARAMETER);
546 * Check for a prefix (one '\' | one or more '^').
548 switch (internal_name[0]) {
554 for (i = 0; i < internal_name_length; i++) {
555 if (internal_name[i] == '^') {
556 prefix_length = i + 1;
562 if (i == internal_name_length) {
573 * Check for object names. Note that there could be 0-255 of these
576 if (prefix_length < internal_name_length) {
577 switch (internal_name[prefix_length]) {
578 case AML_MULTI_NAME_PREFIX_OP:
580 /* <count> 4-byte names */
582 names_index = prefix_length + 2;
583 num_segments = (acpi_native_uint) (u8)
584 internal_name[(acpi_native_uint)
585 (prefix_length + 1)];
588 case AML_DUAL_NAME_PREFIX:
590 /* Two 4-byte names */
592 names_index = prefix_length + 1;
606 /* one 4-byte name */
608 names_index = prefix_length;
615 * Calculate the length of converted_name, which equals the length
616 * of the prefix, length of all object names, length of any required
617 * punctuation ('.') between object names, plus the NULL terminator.
619 required_length = prefix_length + (4 * num_segments) +
620 ((num_segments > 0) ? (num_segments - 1) : 0) + 1;
623 * Check to see if we're still in bounds. If not, there's a problem
624 * with internal_name (invalid format).
626 if (required_length > internal_name_length) {
627 ACPI_ERROR((AE_INFO, "Invalid internal name"));
628 return_ACPI_STATUS(AE_BAD_PATHNAME);
632 * Build converted_name
634 *converted_name = ACPI_MEM_CALLOCATE(required_length);
635 if (!(*converted_name)) {
636 return_ACPI_STATUS(AE_NO_MEMORY);
641 for (i = 0; i < prefix_length; i++) {
642 (*converted_name)[j++] = internal_name[i];
645 if (num_segments > 0) {
646 for (i = 0; i < num_segments; i++) {
648 (*converted_name)[j++] = '.';
651 (*converted_name)[j++] = internal_name[names_index++];
652 (*converted_name)[j++] = internal_name[names_index++];
653 (*converted_name)[j++] = internal_name[names_index++];
654 (*converted_name)[j++] = internal_name[names_index++];
658 if (converted_name_length) {
659 *converted_name_length = (u32) required_length;
662 return_ACPI_STATUS(AE_OK);
665 /*******************************************************************************
667 * FUNCTION: acpi_ns_map_handle_to_node
669 * PARAMETERS: Handle - Handle to be converted to an Node
671 * RETURN: A Name table entry pointer
673 * DESCRIPTION: Convert a namespace handle to a real Node
675 * Note: Real integer handles would allow for more verification
676 * and keep all pointers within this subsystem - however this introduces
677 * more (and perhaps unnecessary) overhead.
679 ******************************************************************************/
681 struct acpi_namespace_node *acpi_ns_map_handle_to_node(acpi_handle handle)
684 ACPI_FUNCTION_ENTRY();
687 * Simple implementation.
693 if (handle == ACPI_ROOT_OBJECT) {
694 return (acpi_gbl_root_node);
697 /* We can at least attempt to verify the handle */
699 if (ACPI_GET_DESCRIPTOR_TYPE(handle) != ACPI_DESC_TYPE_NAMED) {
703 return ((struct acpi_namespace_node *)handle);
706 /*******************************************************************************
708 * FUNCTION: acpi_ns_convert_entry_to_handle
710 * PARAMETERS: Node - Node to be converted to a Handle
712 * RETURN: A user handle
714 * DESCRIPTION: Convert a real Node to a namespace handle
716 ******************************************************************************/
718 acpi_handle acpi_ns_convert_entry_to_handle(struct acpi_namespace_node *node)
722 * Simple implementation for now;
724 return ((acpi_handle) node);
726 /* Example future implementation ---------------------
733 if (Node == acpi_gbl_root_node)
735 return (ACPI_ROOT_OBJECT);
738 return ((acpi_handle) Node);
739 ------------------------------------------------------*/
742 /*******************************************************************************
744 * FUNCTION: acpi_ns_terminate
750 * DESCRIPTION: free memory allocated for namespace and ACPI table storage.
752 ******************************************************************************/
754 void acpi_ns_terminate(void)
756 union acpi_operand_object *obj_desc;
758 ACPI_FUNCTION_TRACE("ns_terminate");
761 * 1) Free the entire namespace -- all nodes and objects
763 * Delete all object descriptors attached to namepsace nodes
765 acpi_ns_delete_namespace_subtree(acpi_gbl_root_node);
767 /* Detach any objects attached to the root */
769 obj_desc = acpi_ns_get_attached_object(acpi_gbl_root_node);
771 acpi_ns_detach_object(acpi_gbl_root_node);
774 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Namespace freed\n"));
777 * 2) Now we can delete the ACPI tables
779 acpi_tb_delete_all_tables();
780 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "ACPI Tables freed\n"));
785 /*******************************************************************************
787 * FUNCTION: acpi_ns_opens_scope
789 * PARAMETERS: Type - A valid namespace type
791 * RETURN: NEWSCOPE if the passed type "opens a name scope" according
792 * to the ACPI specification, else 0
794 ******************************************************************************/
796 u32 acpi_ns_opens_scope(acpi_object_type type)
798 ACPI_FUNCTION_TRACE_STR("ns_opens_scope", acpi_ut_get_type_name(type));
800 if (!acpi_ut_valid_object_type(type)) {
802 /* type code out of range */
804 ACPI_WARNING((AE_INFO, "Invalid Object Type %X", type));
805 return_UINT32(ACPI_NS_NORMAL);
808 return_UINT32(((u32) acpi_gbl_ns_properties[type]) & ACPI_NS_NEWSCOPE);
811 /*******************************************************************************
813 * FUNCTION: acpi_ns_get_node_by_path
815 * PARAMETERS: *Pathname - Name to be found, in external (ASL) format. The
816 * \ (backslash) and ^ (carat) prefixes, and the
817 * . (period) to separate segments are supported.
818 * start_node - Root of subtree to be searched, or NS_ALL for the
819 * root of the name space. If Name is fully
820 * qualified (first s8 is '\'), the passed value
821 * of Scope will not be accessed.
822 * Flags - Used to indicate whether to perform upsearch or
824 * return_node - Where the Node is returned
826 * DESCRIPTION: Look up a name relative to a given scope and return the
827 * corresponding Node. NOTE: Scope can be null.
829 * MUTEX: Locks namespace
831 ******************************************************************************/
834 acpi_ns_get_node_by_path(char *pathname,
835 struct acpi_namespace_node *start_node,
836 u32 flags, struct acpi_namespace_node **return_node)
838 union acpi_generic_state scope_info;
840 char *internal_path = NULL;
842 ACPI_FUNCTION_TRACE_PTR("ns_get_node_by_path", pathname);
846 /* Convert path to internal representation */
848 status = acpi_ns_internalize_name(pathname, &internal_path);
849 if (ACPI_FAILURE(status)) {
850 return_ACPI_STATUS(status);
854 /* Must lock namespace during lookup */
856 status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
857 if (ACPI_FAILURE(status)) {
861 /* Setup lookup scope (search starting point) */
863 scope_info.scope.node = start_node;
865 /* Lookup the name in the namespace */
867 status = acpi_ns_lookup(&scope_info, internal_path,
868 ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
869 (flags | ACPI_NS_DONT_OPEN_SCOPE),
871 if (ACPI_FAILURE(status)) {
872 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "%s, %s\n",
874 acpi_format_exception(status)));
877 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
881 ACPI_MEM_FREE(internal_path);
883 return_ACPI_STATUS(status);
886 /*******************************************************************************
888 * FUNCTION: acpi_ns_get_parent_node
890 * PARAMETERS: Node - Current table entry
892 * RETURN: Parent entry of the given entry
894 * DESCRIPTION: Obtain the parent entry for a given entry in the namespace.
896 ******************************************************************************/
898 struct acpi_namespace_node *acpi_ns_get_parent_node(struct acpi_namespace_node
901 ACPI_FUNCTION_ENTRY();
908 * Walk to the end of this peer list. The last entry is marked with a flag
909 * and the peer pointer is really a pointer back to the parent. This saves
910 * putting a parent back pointer in each and every named object!
912 while (!(node->flags & ANOBJ_END_OF_PEER_LIST)) {
919 /*******************************************************************************
921 * FUNCTION: acpi_ns_get_next_valid_node
923 * PARAMETERS: Node - Current table entry
925 * RETURN: Next valid Node in the linked node list. NULL if no more valid
928 * DESCRIPTION: Find the next valid node within a name table.
929 * Useful for implementing NULL-end-of-list loops.
931 ******************************************************************************/
933 struct acpi_namespace_node *acpi_ns_get_next_valid_node(struct
938 /* If we are at the end of this peer list, return NULL */
940 if (node->flags & ANOBJ_END_OF_PEER_LIST) {
944 /* Otherwise just return the next peer */
949 #ifdef ACPI_OBSOLETE_FUNCTIONS
950 /*******************************************************************************
952 * FUNCTION: acpi_ns_find_parent_name
954 * PARAMETERS: *child_node - Named Obj whose name is to be found
956 * RETURN: The ACPI name
958 * DESCRIPTION: Search for the given obj in its parent scope and return the
959 * name segment, or "????" if the parent name can't be found
960 * (which "should not happen").
962 ******************************************************************************/
964 acpi_name acpi_ns_find_parent_name(struct acpi_namespace_node * child_node)
966 struct acpi_namespace_node *parent_node;
968 ACPI_FUNCTION_TRACE("ns_find_parent_name");
972 /* Valid entry. Get the parent Node */
974 parent_node = acpi_ns_get_parent_node(child_node);
976 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
977 "Parent of %p [%4.4s] is %p [%4.4s]\n",
979 acpi_ut_get_node_name(child_node),
981 acpi_ut_get_node_name(parent_node)));
983 if (parent_node->name.integer) {
984 return_VALUE((acpi_name) parent_node->name.
989 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
990 "Unable to find parent of %p (%4.4s)\n",
992 acpi_ut_get_node_name(child_node)));
995 return_VALUE(ACPI_UNKNOWN_NAME);