1 | // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 |
2 | /****************************************************************************** |
3 | * |
4 | * Module Name: dsinit - Object initialization namespace walk |
5 | * |
6 | * Copyright (C) 2000 - 2023, Intel Corp. |
7 | * |
8 | *****************************************************************************/ |
9 | |
10 | #include <acpi/acpi.h> |
11 | #include "accommon.h" |
12 | #include "acdispat.h" |
13 | #include "acnamesp.h" |
14 | #include "actables.h" |
15 | #include "acinterp.h" |
16 | |
17 | #define _COMPONENT ACPI_DISPATCHER |
18 | ACPI_MODULE_NAME("dsinit" ) |
19 | |
20 | /* Local prototypes */ |
21 | static acpi_status |
22 | acpi_ds_init_one_object(acpi_handle obj_handle, |
23 | u32 level, void *context, void **return_value); |
24 | |
25 | /******************************************************************************* |
26 | * |
27 | * FUNCTION: acpi_ds_init_one_object |
28 | * |
29 | * PARAMETERS: obj_handle - Node for the object |
30 | * level - Current nesting level |
31 | * context - Points to a init info struct |
32 | * return_value - Not used |
33 | * |
34 | * RETURN: Status |
35 | * |
36 | * DESCRIPTION: Callback from acpi_walk_namespace. Invoked for every object |
37 | * within the namespace. |
38 | * |
39 | * Currently, the only objects that require initialization are: |
40 | * 1) Methods |
41 | * 2) Operation Regions |
42 | * |
43 | ******************************************************************************/ |
44 | |
45 | static acpi_status |
46 | acpi_ds_init_one_object(acpi_handle obj_handle, |
47 | u32 level, void *context, void **return_value) |
48 | { |
49 | struct acpi_init_walk_info *info = |
50 | (struct acpi_init_walk_info *)context; |
51 | struct acpi_namespace_node *node = |
52 | (struct acpi_namespace_node *)obj_handle; |
53 | acpi_status status; |
54 | union acpi_operand_object *obj_desc; |
55 | |
56 | ACPI_FUNCTION_ENTRY(); |
57 | |
58 | /* |
59 | * We are only interested in NS nodes owned by the table that |
60 | * was just loaded |
61 | */ |
62 | if (node->owner_id != info->owner_id) { |
63 | return (AE_OK); |
64 | } |
65 | |
66 | info->object_count++; |
67 | |
68 | /* And even then, we are only interested in a few object types */ |
69 | |
70 | switch (acpi_ns_get_type(node: obj_handle)) { |
71 | case ACPI_TYPE_REGION: |
72 | |
73 | status = acpi_ds_initialize_region(obj_handle); |
74 | if (ACPI_FAILURE(status)) { |
75 | ACPI_EXCEPTION((AE_INFO, status, |
76 | "During Region initialization %p [%4.4s]" , |
77 | obj_handle, |
78 | acpi_ut_get_node_name(obj_handle))); |
79 | } |
80 | |
81 | info->op_region_count++; |
82 | break; |
83 | |
84 | case ACPI_TYPE_METHOD: |
85 | /* |
86 | * Auto-serialization support. We will examine each method that is |
87 | * not_serialized to determine if it creates any Named objects. If |
88 | * it does, it will be marked serialized to prevent problems if |
89 | * the method is entered by two or more threads and an attempt is |
90 | * made to create the same named object twice -- which results in |
91 | * an AE_ALREADY_EXISTS exception and method abort. |
92 | */ |
93 | info->method_count++; |
94 | obj_desc = acpi_ns_get_attached_object(node); |
95 | if (!obj_desc) { |
96 | break; |
97 | } |
98 | |
99 | /* Ignore if already serialized */ |
100 | |
101 | if (obj_desc->method.info_flags & ACPI_METHOD_SERIALIZED) { |
102 | info->serial_method_count++; |
103 | break; |
104 | } |
105 | |
106 | if (acpi_gbl_auto_serialize_methods) { |
107 | |
108 | /* Parse/scan method and serialize it if necessary */ |
109 | |
110 | acpi_ds_auto_serialize_method(node, obj_desc); |
111 | if (obj_desc->method. |
112 | info_flags & ACPI_METHOD_SERIALIZED) { |
113 | |
114 | /* Method was just converted to Serialized */ |
115 | |
116 | info->serial_method_count++; |
117 | info->serialized_method_count++; |
118 | break; |
119 | } |
120 | } |
121 | |
122 | info->non_serial_method_count++; |
123 | break; |
124 | |
125 | case ACPI_TYPE_DEVICE: |
126 | |
127 | info->device_count++; |
128 | break; |
129 | |
130 | default: |
131 | |
132 | break; |
133 | } |
134 | |
135 | /* |
136 | * We ignore errors from above, and always return OK, since |
137 | * we don't want to abort the walk on a single error. |
138 | */ |
139 | return (AE_OK); |
140 | } |
141 | |
142 | /******************************************************************************* |
143 | * |
144 | * FUNCTION: acpi_ds_initialize_objects |
145 | * |
146 | * PARAMETERS: table_desc - Descriptor for parent ACPI table |
147 | * start_node - Root of subtree to be initialized. |
148 | * |
149 | * RETURN: Status |
150 | * |
151 | * DESCRIPTION: Walk the namespace starting at "StartNode" and perform any |
152 | * necessary initialization on the objects found therein |
153 | * |
154 | ******************************************************************************/ |
155 | |
156 | acpi_status |
157 | acpi_ds_initialize_objects(u32 table_index, |
158 | struct acpi_namespace_node *start_node) |
159 | { |
160 | acpi_status status; |
161 | struct acpi_init_walk_info info; |
162 | struct acpi_table_header *table; |
163 | acpi_owner_id owner_id; |
164 | |
165 | ACPI_FUNCTION_TRACE(ds_initialize_objects); |
166 | |
167 | status = acpi_tb_get_owner_id(table_index, owner_id: &owner_id); |
168 | if (ACPI_FAILURE(status)) { |
169 | return_ACPI_STATUS(status); |
170 | } |
171 | |
172 | ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH, |
173 | "**** Starting initialization of namespace objects ****\n" )); |
174 | |
175 | /* Set all init info to zero */ |
176 | |
177 | memset(&info, 0, sizeof(struct acpi_init_walk_info)); |
178 | |
179 | info.owner_id = owner_id; |
180 | info.table_index = table_index; |
181 | |
182 | /* Walk entire namespace from the supplied root */ |
183 | |
184 | /* |
185 | * We don't use acpi_walk_namespace since we do not want to acquire |
186 | * the namespace reader lock. |
187 | */ |
188 | status = |
189 | acpi_ns_walk_namespace(ACPI_TYPE_ANY, start_object: start_node, ACPI_UINT32_MAX, |
190 | ACPI_NS_WALK_NO_UNLOCK, |
191 | descending_callback: acpi_ds_init_one_object, NULL, context: &info, NULL); |
192 | if (ACPI_FAILURE(status)) { |
193 | ACPI_EXCEPTION((AE_INFO, status, "During WalkNamespace" )); |
194 | } |
195 | |
196 | status = acpi_get_table_by_index(table_index, out_table: &table); |
197 | if (ACPI_FAILURE(status)) { |
198 | return_ACPI_STATUS(status); |
199 | } |
200 | |
201 | /* DSDT is always the first AML table */ |
202 | |
203 | if (ACPI_COMPARE_NAMESEG(table->signature, ACPI_SIG_DSDT)) { |
204 | ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT, |
205 | "\nACPI table initialization:\n" )); |
206 | } |
207 | |
208 | /* Summary of objects initialized */ |
209 | |
210 | ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT, |
211 | "Table [%4.4s: %-8.8s] (id %.2X) - %4u Objects with %3u Devices, " |
212 | "%3u Regions, %4u Methods (%u/%u/%u Serial/Non/Cvt)\n" , |
213 | table->signature, table->oem_table_id, owner_id, |
214 | info.object_count, info.device_count, |
215 | info.op_region_count, info.method_count, |
216 | info.serial_method_count, |
217 | info.non_serial_method_count, |
218 | info.serialized_method_count)); |
219 | |
220 | ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH, "%u Methods, %u Regions\n" , |
221 | info.method_count, info.op_region_count)); |
222 | |
223 | return_ACPI_STATUS(AE_OK); |
224 | } |
225 | |