1 /******************************************************************************
3 * Module Name: dsinit - Object initialization namespace walk
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2005, R. Byron Moore
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
45 #include <acpi/acpi.h>
46 #include <acpi/acdispat.h>
47 #include <acpi/acnamesp.h>
49 #define _COMPONENT ACPI_DISPATCHER
50 ACPI_MODULE_NAME ("dsinit")
52 /* Local prototypes */
55 acpi_ds_init_one_object (
56 acpi_handle obj_handle,
62 /*******************************************************************************
64 * FUNCTION: acpi_ds_init_one_object
66 * PARAMETERS: obj_handle - Node for the object
67 * Level - Current nesting level
68 * Context - Points to a init info struct
69 * return_value - Not used
73 * DESCRIPTION: Callback from acpi_walk_namespace. Invoked for every object
74 * within the namespace.
76 * Currently, the only objects that require initialization are:
78 * 2) Operation Regions
80 ******************************************************************************/
83 acpi_ds_init_one_object (
84 acpi_handle obj_handle,
89 acpi_object_type type;
91 struct acpi_init_walk_info *info = (struct acpi_init_walk_info *) context;
94 ACPI_FUNCTION_NAME ("ds_init_one_object");
98 * We are only interested in objects owned by the table that
101 if (((struct acpi_namespace_node *) obj_handle)->owner_id !=
102 info->table_desc->table_id) {
106 info->object_count++;
108 /* And even then, we are only interested in a few object types */
110 type = acpi_ns_get_type (obj_handle);
113 case ACPI_TYPE_REGION:
115 status = acpi_ds_initialize_region (obj_handle);
116 if (ACPI_FAILURE (status)) {
117 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR,
118 "Region %p [%4.4s] - Init failure, %s\n",
119 obj_handle, acpi_ut_get_node_name (obj_handle),
120 acpi_format_exception (status)));
123 info->op_region_count++;
127 case ACPI_TYPE_METHOD:
129 info->method_count++;
132 * Print a dot for each method unless we are going to print
133 * the entire pathname
135 if (!(acpi_dbg_level & ACPI_LV_INIT_NAMES)) {
136 ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, "."));
140 * Set the execution data width (32 or 64) based upon the
141 * revision number of the parent ACPI table.
142 * TBD: This is really for possible future support of integer width
143 * on a per-table basis. Currently, we just use a global for the width.
145 if (info->table_desc->pointer->revision == 1) {
146 ((struct acpi_namespace_node *) obj_handle)->flags |= ANOBJ_DATA_WIDTH_32;
150 * Always parse methods to detect errors, we will delete
151 * the parse tree below
153 status = acpi_ds_parse_method (obj_handle);
154 if (ACPI_FAILURE (status)) {
155 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR,
156 "Method %p [%4.4s] - parse failure, %s\n",
157 obj_handle, acpi_ut_get_node_name (obj_handle),
158 acpi_format_exception (status)));
160 /* This parse failed, but we will continue parsing more methods */
166 * Delete the parse tree. We simply re-parse the method
167 * for every execution since there isn't much overhead
169 acpi_ns_delete_namespace_subtree (obj_handle);
170 acpi_ns_delete_namespace_by_owner (
171 ((struct acpi_namespace_node *) obj_handle)->object->method.owning_id);
175 case ACPI_TYPE_DEVICE:
177 info->device_count++;
186 * We ignore errors from above, and always return OK, since
187 * we don't want to abort the walk on a single error.
193 /*******************************************************************************
195 * FUNCTION: acpi_ds_initialize_objects
197 * PARAMETERS: table_desc - Descriptor for parent ACPI table
198 * start_node - Root of subtree to be initialized.
202 * DESCRIPTION: Walk the namespace starting at "start_node" and perform any
203 * necessary initialization on the objects found therein
205 ******************************************************************************/
208 acpi_ds_initialize_objects (
209 struct acpi_table_desc *table_desc,
210 struct acpi_namespace_node *start_node)
213 struct acpi_init_walk_info info;
216 ACPI_FUNCTION_TRACE ("ds_initialize_objects");
219 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
220 "**** Starting initialization of namespace objects ****\n"));
221 ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, "Parsing all Control Methods:"));
223 info.method_count = 0;
224 info.op_region_count = 0;
225 info.object_count = 0;
226 info.device_count = 0;
227 info.table_desc = table_desc;
229 /* Walk entire namespace from the supplied root */
231 status = acpi_walk_namespace (ACPI_TYPE_ANY, start_node, ACPI_UINT32_MAX,
232 acpi_ds_init_one_object, &info, NULL);
233 if (ACPI_FAILURE (status)) {
234 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "walk_namespace failed, %s\n",
235 acpi_format_exception (status)));
238 ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT,
239 "\nTable [%4.4s](id %4.4X) - %hd Objects with %hd Devices %hd Methods %hd Regions\n",
240 table_desc->pointer->signature, table_desc->table_id, info.object_count,
241 info.device_count, info.method_count, info.op_region_count));
243 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
244 "%hd Methods, %hd Regions\n", info.method_count, info.op_region_count));
246 return_ACPI_STATUS (AE_OK);