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
->owner_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
.owner_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
->owner_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
);