V4L/DVB (9743): em28xx: fix oops audio
[linux-2.6] / drivers / acpi / namespace / nsload.c
1 /******************************************************************************
2  *
3  * Module Name: nsload - namespace loading/expanding/contracting procedures
4  *
5  *****************************************************************************/
6
7 /*
8  * Copyright (C) 2000 - 2008, Intel Corp.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
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.
25  *
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.
29  *
30  * NO WARRANTY
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.
42  */
43
44 #include <acpi/acpi.h>
45 #include <acpi/acnamesp.h>
46 #include <acpi/acdispat.h>
47 #include <acpi/actables.h>
48
49 #define _COMPONENT          ACPI_NAMESPACE
50 ACPI_MODULE_NAME("nsload")
51
52 /* Local prototypes */
53 #ifdef ACPI_FUTURE_IMPLEMENTATION
54 acpi_status acpi_ns_unload_namespace(acpi_handle handle);
55
56 static acpi_status acpi_ns_delete_subtree(acpi_handle start_handle);
57 #endif
58
59 #ifndef ACPI_NO_METHOD_EXECUTION
60 /*******************************************************************************
61  *
62  * FUNCTION:    acpi_ns_load_table
63  *
64  * PARAMETERS:  table_index     - Index for table to be loaded
65  *              Node            - Owning NS node
66  *
67  * RETURN:      Status
68  *
69  * DESCRIPTION: Load one ACPI table into the namespace
70  *
71  ******************************************************************************/
72
73 acpi_status
74 acpi_ns_load_table(u32 table_index, struct acpi_namespace_node *node)
75 {
76         acpi_status status;
77
78         ACPI_FUNCTION_TRACE(ns_load_table);
79
80         /*
81          * Parse the table and load the namespace with all named
82          * objects found within.  Control methods are NOT parsed
83          * at this time.  In fact, the control methods cannot be
84          * parsed until the entire namespace is loaded, because
85          * if a control method makes a forward reference (call)
86          * to another control method, we can't continue parsing
87          * because we don't know how many arguments to parse next!
88          */
89         status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
90         if (ACPI_FAILURE(status)) {
91                 return_ACPI_STATUS(status);
92         }
93
94         /* If table already loaded into namespace, just return */
95
96         if (acpi_tb_is_table_loaded(table_index)) {
97                 status = AE_ALREADY_EXISTS;
98                 goto unlock;
99         }
100
101         ACPI_DEBUG_PRINT((ACPI_DB_INFO,
102                           "**** Loading table into namespace ****\n"));
103
104         status = acpi_tb_allocate_owner_id(table_index);
105         if (ACPI_FAILURE(status)) {
106                 goto unlock;
107         }
108
109         status = acpi_ns_parse_table(table_index, node);
110         if (ACPI_SUCCESS(status)) {
111                 acpi_tb_set_table_loaded_flag(table_index, TRUE);
112         } else {
113                 (void)acpi_tb_release_owner_id(table_index);
114         }
115
116       unlock:
117         (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
118
119         if (ACPI_FAILURE(status)) {
120                 return_ACPI_STATUS(status);
121         }
122
123         /*
124          * Now we can parse the control methods.  We always parse
125          * them here for a sanity check, and if configured for
126          * just-in-time parsing, we delete the control method
127          * parse trees.
128          */
129         ACPI_DEBUG_PRINT((ACPI_DB_INFO,
130                           "**** Begin Table Method Parsing and Object Initialization ****\n"));
131
132         status = acpi_ds_initialize_objects(table_index, node);
133
134         ACPI_DEBUG_PRINT((ACPI_DB_INFO,
135                           "**** Completed Table Method Parsing and Object Initialization ****\n"));
136
137         return_ACPI_STATUS(status);
138 }
139
140 #ifdef ACPI_OBSOLETE_FUNCTIONS
141 /*******************************************************************************
142  *
143  * FUNCTION:    acpi_load_namespace
144  *
145  * PARAMETERS:  None
146  *
147  * RETURN:      Status
148  *
149  * DESCRIPTION: Load the name space from what ever is pointed to by DSDT.
150  *              (DSDT points to either the BIOS or a buffer.)
151  *
152  ******************************************************************************/
153
154 acpi_status acpi_ns_load_namespace(void)
155 {
156         acpi_status status;
157
158         ACPI_FUNCTION_TRACE(acpi_load_name_space);
159
160         /* There must be at least a DSDT installed */
161
162         if (acpi_gbl_DSDT == NULL) {
163                 ACPI_ERROR((AE_INFO, "DSDT is not in memory"));
164                 return_ACPI_STATUS(AE_NO_ACPI_TABLES);
165         }
166
167         /*
168          * Load the namespace.  The DSDT is required,
169          * but the SSDT and PSDT tables are optional.
170          */
171         status = acpi_ns_load_table_by_type(ACPI_TABLE_ID_DSDT);
172         if (ACPI_FAILURE(status)) {
173                 return_ACPI_STATUS(status);
174         }
175
176         /* Ignore exceptions from these */
177
178         (void)acpi_ns_load_table_by_type(ACPI_TABLE_ID_SSDT);
179         (void)acpi_ns_load_table_by_type(ACPI_TABLE_ID_PSDT);
180
181         ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT,
182                               "ACPI Namespace successfully loaded at root %p\n",
183                               acpi_gbl_root_node));
184
185         return_ACPI_STATUS(status);
186 }
187 #endif
188
189 #ifdef ACPI_FUTURE_IMPLEMENTATION
190 /*******************************************************************************
191  *
192  * FUNCTION:    acpi_ns_delete_subtree
193  *
194  * PARAMETERS:  start_handle        - Handle in namespace where search begins
195  *
196  * RETURNS      Status
197  *
198  * DESCRIPTION: Walks the namespace starting at the given handle and deletes
199  *              all objects, entries, and scopes in the entire subtree.
200  *
201  *              Namespace/Interpreter should be locked or the subsystem should
202  *              be in shutdown before this routine is called.
203  *
204  ******************************************************************************/
205
206 static acpi_status acpi_ns_delete_subtree(acpi_handle start_handle)
207 {
208         acpi_status status;
209         acpi_handle child_handle;
210         acpi_handle parent_handle;
211         acpi_handle next_child_handle;
212         acpi_handle dummy;
213         u32 level;
214
215         ACPI_FUNCTION_TRACE(ns_delete_subtree);
216
217         parent_handle = start_handle;
218         child_handle = NULL;
219         level = 1;
220
221         /*
222          * Traverse the tree of objects until we bubble back up
223          * to where we started.
224          */
225         while (level > 0) {
226
227                 /* Attempt to get the next object in this scope */
228
229                 status = acpi_get_next_object(ACPI_TYPE_ANY, parent_handle,
230                                               child_handle, &next_child_handle);
231
232                 child_handle = next_child_handle;
233
234                 /* Did we get a new object? */
235
236                 if (ACPI_SUCCESS(status)) {
237
238                         /* Check if this object has any children */
239
240                         if (ACPI_SUCCESS
241                             (acpi_get_next_object
242                              (ACPI_TYPE_ANY, child_handle, NULL, &dummy))) {
243                                 /*
244                                  * There is at least one child of this object,
245                                  * visit the object
246                                  */
247                                 level++;
248                                 parent_handle = child_handle;
249                                 child_handle = NULL;
250                         }
251                 } else {
252                         /*
253                          * No more children in this object, go back up to
254                          * the object's parent
255                          */
256                         level--;
257
258                         /* Delete all children now */
259
260                         acpi_ns_delete_children(child_handle);
261
262                         child_handle = parent_handle;
263                         status = acpi_get_parent(parent_handle, &parent_handle);
264                         if (ACPI_FAILURE(status)) {
265                                 return_ACPI_STATUS(status);
266                         }
267                 }
268         }
269
270         /* Now delete the starting object, and we are done */
271
272         acpi_ns_delete_node(child_handle);
273
274         return_ACPI_STATUS(AE_OK);
275 }
276
277 /*******************************************************************************
278  *
279  *  FUNCTION:       acpi_ns_unload_name_space
280  *
281  *  PARAMETERS:     Handle          - Root of namespace subtree to be deleted
282  *
283  *  RETURN:         Status
284  *
285  *  DESCRIPTION:    Shrinks the namespace, typically in response to an undocking
286  *                  event.  Deletes an entire subtree starting from (and
287  *                  including) the given handle.
288  *
289  ******************************************************************************/
290
291 acpi_status acpi_ns_unload_namespace(acpi_handle handle)
292 {
293         acpi_status status;
294
295         ACPI_FUNCTION_TRACE(ns_unload_name_space);
296
297         /* Parameter validation */
298
299         if (!acpi_gbl_root_node) {
300                 return_ACPI_STATUS(AE_NO_NAMESPACE);
301         }
302
303         if (!handle) {
304                 return_ACPI_STATUS(AE_BAD_PARAMETER);
305         }
306
307         /* This function does the real work */
308
309         status = acpi_ns_delete_subtree(handle);
310
311         return_ACPI_STATUS(status);
312 }
313 #endif
314 #endif