utdelete.c revision 1.1.1.2.4.2 1 1.1.1.2.4.2 rmind /*******************************************************************************
2 1.1.1.2.4.2 rmind *
3 1.1.1.2.4.2 rmind * Module Name: utdelete - object deletion and reference count utilities
4 1.1.1.2.4.2 rmind *
5 1.1.1.2.4.2 rmind ******************************************************************************/
6 1.1.1.2.4.2 rmind
7 1.1.1.2.4.2 rmind /*
8 1.1.1.2.4.2 rmind * Copyright (C) 2000 - 2011, Intel Corp.
9 1.1.1.2.4.2 rmind * All rights reserved.
10 1.1.1.2.4.2 rmind *
11 1.1.1.2.4.2 rmind * Redistribution and use in source and binary forms, with or without
12 1.1.1.2.4.2 rmind * modification, are permitted provided that the following conditions
13 1.1.1.2.4.2 rmind * are met:
14 1.1.1.2.4.2 rmind * 1. Redistributions of source code must retain the above copyright
15 1.1.1.2.4.2 rmind * notice, this list of conditions, and the following disclaimer,
16 1.1.1.2.4.2 rmind * without modification.
17 1.1.1.2.4.2 rmind * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 1.1.1.2.4.2 rmind * substantially similar to the "NO WARRANTY" disclaimer below
19 1.1.1.2.4.2 rmind * ("Disclaimer") and any redistribution must be conditioned upon
20 1.1.1.2.4.2 rmind * including a substantially similar Disclaimer requirement for further
21 1.1.1.2.4.2 rmind * binary redistribution.
22 1.1.1.2.4.2 rmind * 3. Neither the names of the above-listed copyright holders nor the names
23 1.1.1.2.4.2 rmind * of any contributors may be used to endorse or promote products derived
24 1.1.1.2.4.2 rmind * from this software without specific prior written permission.
25 1.1.1.2.4.2 rmind *
26 1.1.1.2.4.2 rmind * Alternatively, this software may be distributed under the terms of the
27 1.1.1.2.4.2 rmind * GNU General Public License ("GPL") version 2 as published by the Free
28 1.1.1.2.4.2 rmind * Software Foundation.
29 1.1.1.2.4.2 rmind *
30 1.1.1.2.4.2 rmind * NO WARRANTY
31 1.1.1.2.4.2 rmind * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 1.1.1.2.4.2 rmind * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 1.1.1.2.4.2 rmind * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 1.1.1.2.4.2 rmind * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 1.1.1.2.4.2 rmind * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 1.1.1.2.4.2 rmind * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 1.1.1.2.4.2 rmind * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 1.1.1.2.4.2 rmind * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 1.1.1.2.4.2 rmind * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 1.1.1.2.4.2 rmind * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 1.1.1.2.4.2 rmind * POSSIBILITY OF SUCH DAMAGES.
42 1.1.1.2.4.2 rmind */
43 1.1.1.2.4.2 rmind
44 1.1.1.2.4.2 rmind #define __UTDELETE_C__
45 1.1.1.2.4.2 rmind
46 1.1.1.2.4.2 rmind #include "acpi.h"
47 1.1.1.2.4.2 rmind #include "accommon.h"
48 1.1.1.2.4.2 rmind #include "acinterp.h"
49 1.1.1.2.4.2 rmind #include "acnamesp.h"
50 1.1.1.2.4.2 rmind #include "acevents.h"
51 1.1.1.2.4.2 rmind
52 1.1.1.2.4.2 rmind
53 1.1.1.2.4.2 rmind #define _COMPONENT ACPI_UTILITIES
54 1.1.1.2.4.2 rmind ACPI_MODULE_NAME ("utdelete")
55 1.1.1.2.4.2 rmind
56 1.1.1.2.4.2 rmind /* Local prototypes */
57 1.1.1.2.4.2 rmind
58 1.1.1.2.4.2 rmind static void
59 1.1.1.2.4.2 rmind AcpiUtDeleteInternalObj (
60 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object);
61 1.1.1.2.4.2 rmind
62 1.1.1.2.4.2 rmind static void
63 1.1.1.2.4.2 rmind AcpiUtUpdateRefCount (
64 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object,
65 1.1.1.2.4.2 rmind UINT32 Action);
66 1.1.1.2.4.2 rmind
67 1.1.1.2.4.2 rmind
68 1.1.1.2.4.2 rmind /*******************************************************************************
69 1.1.1.2.4.2 rmind *
70 1.1.1.2.4.2 rmind * FUNCTION: AcpiUtDeleteInternalObj
71 1.1.1.2.4.2 rmind *
72 1.1.1.2.4.2 rmind * PARAMETERS: Object - Object to be deleted
73 1.1.1.2.4.2 rmind *
74 1.1.1.2.4.2 rmind * RETURN: None
75 1.1.1.2.4.2 rmind *
76 1.1.1.2.4.2 rmind * DESCRIPTION: Low level object deletion, after reference counts have been
77 1.1.1.2.4.2 rmind * updated (All reference counts, including sub-objects!)
78 1.1.1.2.4.2 rmind *
79 1.1.1.2.4.2 rmind ******************************************************************************/
80 1.1.1.2.4.2 rmind
81 1.1.1.2.4.2 rmind static void
82 1.1.1.2.4.2 rmind AcpiUtDeleteInternalObj (
83 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object)
84 1.1.1.2.4.2 rmind {
85 1.1.1.2.4.2 rmind void *ObjPointer = NULL;
86 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *HandlerDesc;
87 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *SecondDesc;
88 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *NextDesc;
89 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT **LastObjPtr;
90 1.1.1.2.4.2 rmind
91 1.1.1.2.4.2 rmind
92 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE_PTR (UtDeleteInternalObj, Object);
93 1.1.1.2.4.2 rmind
94 1.1.1.2.4.2 rmind
95 1.1.1.2.4.2 rmind if (!Object)
96 1.1.1.2.4.2 rmind {
97 1.1.1.2.4.2 rmind return_VOID;
98 1.1.1.2.4.2 rmind }
99 1.1.1.2.4.2 rmind
100 1.1.1.2.4.2 rmind /*
101 1.1.1.2.4.2 rmind * Must delete or free any pointers within the object that are not
102 1.1.1.2.4.2 rmind * actual ACPI objects (for example, a raw buffer pointer).
103 1.1.1.2.4.2 rmind */
104 1.1.1.2.4.2 rmind switch (Object->Common.Type)
105 1.1.1.2.4.2 rmind {
106 1.1.1.2.4.2 rmind case ACPI_TYPE_STRING:
107 1.1.1.2.4.2 rmind
108 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "**** String %p, ptr %p\n",
109 1.1.1.2.4.2 rmind Object, Object->String.Pointer));
110 1.1.1.2.4.2 rmind
111 1.1.1.2.4.2 rmind /* Free the actual string buffer */
112 1.1.1.2.4.2 rmind
113 1.1.1.2.4.2 rmind if (!(Object->Common.Flags & AOPOBJ_STATIC_POINTER))
114 1.1.1.2.4.2 rmind {
115 1.1.1.2.4.2 rmind /* But only if it is NOT a pointer into an ACPI table */
116 1.1.1.2.4.2 rmind
117 1.1.1.2.4.2 rmind ObjPointer = Object->String.Pointer;
118 1.1.1.2.4.2 rmind }
119 1.1.1.2.4.2 rmind break;
120 1.1.1.2.4.2 rmind
121 1.1.1.2.4.2 rmind
122 1.1.1.2.4.2 rmind case ACPI_TYPE_BUFFER:
123 1.1.1.2.4.2 rmind
124 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "**** Buffer %p, ptr %p\n",
125 1.1.1.2.4.2 rmind Object, Object->Buffer.Pointer));
126 1.1.1.2.4.2 rmind
127 1.1.1.2.4.2 rmind /* Free the actual buffer */
128 1.1.1.2.4.2 rmind
129 1.1.1.2.4.2 rmind if (!(Object->Common.Flags & AOPOBJ_STATIC_POINTER))
130 1.1.1.2.4.2 rmind {
131 1.1.1.2.4.2 rmind /* But only if it is NOT a pointer into an ACPI table */
132 1.1.1.2.4.2 rmind
133 1.1.1.2.4.2 rmind ObjPointer = Object->Buffer.Pointer;
134 1.1.1.2.4.2 rmind }
135 1.1.1.2.4.2 rmind break;
136 1.1.1.2.4.2 rmind
137 1.1.1.2.4.2 rmind
138 1.1.1.2.4.2 rmind case ACPI_TYPE_PACKAGE:
139 1.1.1.2.4.2 rmind
140 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, " **** Package of count %X\n",
141 1.1.1.2.4.2 rmind Object->Package.Count));
142 1.1.1.2.4.2 rmind
143 1.1.1.2.4.2 rmind /*
144 1.1.1.2.4.2 rmind * Elements of the package are not handled here, they are deleted
145 1.1.1.2.4.2 rmind * separately
146 1.1.1.2.4.2 rmind */
147 1.1.1.2.4.2 rmind
148 1.1.1.2.4.2 rmind /* Free the (variable length) element pointer array */
149 1.1.1.2.4.2 rmind
150 1.1.1.2.4.2 rmind ObjPointer = Object->Package.Elements;
151 1.1.1.2.4.2 rmind break;
152 1.1.1.2.4.2 rmind
153 1.1.1.2.4.2 rmind
154 1.1.1.2.4.2 rmind /*
155 1.1.1.2.4.2 rmind * These objects have a possible list of notify handlers.
156 1.1.1.2.4.2 rmind * Device object also may have a GPE block.
157 1.1.1.2.4.2 rmind */
158 1.1.1.2.4.2 rmind case ACPI_TYPE_DEVICE:
159 1.1.1.2.4.2 rmind
160 1.1.1.2.4.2 rmind if (Object->Device.GpeBlock)
161 1.1.1.2.4.2 rmind {
162 1.1.1.2.4.2 rmind (void) AcpiEvDeleteGpeBlock (Object->Device.GpeBlock);
163 1.1.1.2.4.2 rmind }
164 1.1.1.2.4.2 rmind
165 1.1.1.2.4.2 rmind /*lint -fallthrough */
166 1.1.1.2.4.2 rmind
167 1.1.1.2.4.2 rmind case ACPI_TYPE_PROCESSOR:
168 1.1.1.2.4.2 rmind case ACPI_TYPE_THERMAL:
169 1.1.1.2.4.2 rmind
170 1.1.1.2.4.2 rmind /* Walk the notify handler list for this object */
171 1.1.1.2.4.2 rmind
172 1.1.1.2.4.2 rmind HandlerDesc = Object->CommonNotify.Handler;
173 1.1.1.2.4.2 rmind while (HandlerDesc)
174 1.1.1.2.4.2 rmind {
175 1.1.1.2.4.2 rmind NextDesc = HandlerDesc->AddressSpace.Next;
176 1.1.1.2.4.2 rmind AcpiUtRemoveReference (HandlerDesc);
177 1.1.1.2.4.2 rmind HandlerDesc = NextDesc;
178 1.1.1.2.4.2 rmind }
179 1.1.1.2.4.2 rmind break;
180 1.1.1.2.4.2 rmind
181 1.1.1.2.4.2 rmind
182 1.1.1.2.4.2 rmind case ACPI_TYPE_MUTEX:
183 1.1.1.2.4.2 rmind
184 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
185 1.1.1.2.4.2 rmind "***** Mutex %p, OS Mutex %p\n",
186 1.1.1.2.4.2 rmind Object, Object->Mutex.OsMutex));
187 1.1.1.2.4.2 rmind
188 1.1.1.2.4.2 rmind if (Object == AcpiGbl_GlobalLockMutex)
189 1.1.1.2.4.2 rmind {
190 1.1.1.2.4.2 rmind /* Global Lock has extra semaphore */
191 1.1.1.2.4.2 rmind
192 1.1.1.2.4.2 rmind (void) AcpiOsDeleteSemaphore (AcpiGbl_GlobalLockSemaphore);
193 1.1.1.2.4.2 rmind AcpiGbl_GlobalLockSemaphore = NULL;
194 1.1.1.2.4.2 rmind
195 1.1.1.2.4.2 rmind AcpiOsDeleteMutex (Object->Mutex.OsMutex);
196 1.1.1.2.4.2 rmind AcpiGbl_GlobalLockMutex = NULL;
197 1.1.1.2.4.2 rmind }
198 1.1.1.2.4.2 rmind else
199 1.1.1.2.4.2 rmind {
200 1.1.1.2.4.2 rmind AcpiExUnlinkMutex (Object);
201 1.1.1.2.4.2 rmind AcpiOsDeleteMutex (Object->Mutex.OsMutex);
202 1.1.1.2.4.2 rmind }
203 1.1.1.2.4.2 rmind break;
204 1.1.1.2.4.2 rmind
205 1.1.1.2.4.2 rmind
206 1.1.1.2.4.2 rmind case ACPI_TYPE_EVENT:
207 1.1.1.2.4.2 rmind
208 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
209 1.1.1.2.4.2 rmind "***** Event %p, OS Semaphore %p\n",
210 1.1.1.2.4.2 rmind Object, Object->Event.OsSemaphore));
211 1.1.1.2.4.2 rmind
212 1.1.1.2.4.2 rmind (void) AcpiOsDeleteSemaphore (Object->Event.OsSemaphore);
213 1.1.1.2.4.2 rmind Object->Event.OsSemaphore = NULL;
214 1.1.1.2.4.2 rmind break;
215 1.1.1.2.4.2 rmind
216 1.1.1.2.4.2 rmind
217 1.1.1.2.4.2 rmind case ACPI_TYPE_METHOD:
218 1.1.1.2.4.2 rmind
219 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
220 1.1.1.2.4.2 rmind "***** Method %p\n", Object));
221 1.1.1.2.4.2 rmind
222 1.1.1.2.4.2 rmind /* Delete the method mutex if it exists */
223 1.1.1.2.4.2 rmind
224 1.1.1.2.4.2 rmind if (Object->Method.Mutex)
225 1.1.1.2.4.2 rmind {
226 1.1.1.2.4.2 rmind AcpiOsDeleteMutex (Object->Method.Mutex->Mutex.OsMutex);
227 1.1.1.2.4.2 rmind AcpiUtDeleteObjectDesc (Object->Method.Mutex);
228 1.1.1.2.4.2 rmind Object->Method.Mutex = NULL;
229 1.1.1.2.4.2 rmind }
230 1.1.1.2.4.2 rmind break;
231 1.1.1.2.4.2 rmind
232 1.1.1.2.4.2 rmind
233 1.1.1.2.4.2 rmind case ACPI_TYPE_REGION:
234 1.1.1.2.4.2 rmind
235 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
236 1.1.1.2.4.2 rmind "***** Region %p\n", Object));
237 1.1.1.2.4.2 rmind
238 1.1.1.2.4.2 rmind SecondDesc = AcpiNsGetSecondaryObject (Object);
239 1.1.1.2.4.2 rmind if (SecondDesc)
240 1.1.1.2.4.2 rmind {
241 1.1.1.2.4.2 rmind /*
242 1.1.1.2.4.2 rmind * Free the RegionContext if and only if the handler is one of the
243 1.1.1.2.4.2 rmind * default handlers -- and therefore, we created the context object
244 1.1.1.2.4.2 rmind * locally, it was not created by an external caller.
245 1.1.1.2.4.2 rmind */
246 1.1.1.2.4.2 rmind HandlerDesc = Object->Region.Handler;
247 1.1.1.2.4.2 rmind if (HandlerDesc)
248 1.1.1.2.4.2 rmind {
249 1.1.1.2.4.2 rmind NextDesc = HandlerDesc->AddressSpace.RegionList;
250 1.1.1.2.4.2 rmind LastObjPtr = &HandlerDesc->AddressSpace.RegionList;
251 1.1.1.2.4.2 rmind
252 1.1.1.2.4.2 rmind /* Remove the region object from the handler's list */
253 1.1.1.2.4.2 rmind
254 1.1.1.2.4.2 rmind while (NextDesc)
255 1.1.1.2.4.2 rmind {
256 1.1.1.2.4.2 rmind if (NextDesc == Object)
257 1.1.1.2.4.2 rmind {
258 1.1.1.2.4.2 rmind *LastObjPtr = NextDesc->Region.Next;
259 1.1.1.2.4.2 rmind break;
260 1.1.1.2.4.2 rmind }
261 1.1.1.2.4.2 rmind
262 1.1.1.2.4.2 rmind /* Walk the linked list of handler */
263 1.1.1.2.4.2 rmind
264 1.1.1.2.4.2 rmind LastObjPtr = &NextDesc->Region.Next;
265 1.1.1.2.4.2 rmind NextDesc = NextDesc->Region.Next;
266 1.1.1.2.4.2 rmind }
267 1.1.1.2.4.2 rmind
268 1.1.1.2.4.2 rmind if (HandlerDesc->AddressSpace.HandlerFlags &
269 1.1.1.2.4.2 rmind ACPI_ADDR_HANDLER_DEFAULT_INSTALLED)
270 1.1.1.2.4.2 rmind {
271 1.1.1.2.4.2 rmind /* Deactivate region and free region context */
272 1.1.1.2.4.2 rmind
273 1.1.1.2.4.2 rmind if (HandlerDesc->AddressSpace.Setup)
274 1.1.1.2.4.2 rmind {
275 1.1.1.2.4.2 rmind (void) HandlerDesc->AddressSpace.Setup (Object,
276 1.1.1.2.4.2 rmind ACPI_REGION_DEACTIVATE,
277 1.1.1.2.4.2 rmind HandlerDesc->AddressSpace.Context,
278 1.1.1.2.4.2 rmind &SecondDesc->Extra.RegionContext);
279 1.1.1.2.4.2 rmind }
280 1.1.1.2.4.2 rmind }
281 1.1.1.2.4.2 rmind
282 1.1.1.2.4.2 rmind AcpiUtRemoveReference (HandlerDesc);
283 1.1.1.2.4.2 rmind }
284 1.1.1.2.4.2 rmind
285 1.1.1.2.4.2 rmind /* Now we can free the Extra object */
286 1.1.1.2.4.2 rmind
287 1.1.1.2.4.2 rmind AcpiUtDeleteObjectDesc (SecondDesc);
288 1.1.1.2.4.2 rmind }
289 1.1.1.2.4.2 rmind break;
290 1.1.1.2.4.2 rmind
291 1.1.1.2.4.2 rmind
292 1.1.1.2.4.2 rmind case ACPI_TYPE_BUFFER_FIELD:
293 1.1.1.2.4.2 rmind
294 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
295 1.1.1.2.4.2 rmind "***** Buffer Field %p\n", Object));
296 1.1.1.2.4.2 rmind
297 1.1.1.2.4.2 rmind SecondDesc = AcpiNsGetSecondaryObject (Object);
298 1.1.1.2.4.2 rmind if (SecondDesc)
299 1.1.1.2.4.2 rmind {
300 1.1.1.2.4.2 rmind AcpiUtDeleteObjectDesc (SecondDesc);
301 1.1.1.2.4.2 rmind }
302 1.1.1.2.4.2 rmind break;
303 1.1.1.2.4.2 rmind
304 1.1.1.2.4.2 rmind
305 1.1.1.2.4.2 rmind case ACPI_TYPE_LOCAL_BANK_FIELD:
306 1.1.1.2.4.2 rmind
307 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
308 1.1.1.2.4.2 rmind "***** Bank Field %p\n", Object));
309 1.1.1.2.4.2 rmind
310 1.1.1.2.4.2 rmind SecondDesc = AcpiNsGetSecondaryObject (Object);
311 1.1.1.2.4.2 rmind if (SecondDesc)
312 1.1.1.2.4.2 rmind {
313 1.1.1.2.4.2 rmind AcpiUtDeleteObjectDesc (SecondDesc);
314 1.1.1.2.4.2 rmind }
315 1.1.1.2.4.2 rmind break;
316 1.1.1.2.4.2 rmind
317 1.1.1.2.4.2 rmind
318 1.1.1.2.4.2 rmind default:
319 1.1.1.2.4.2 rmind break;
320 1.1.1.2.4.2 rmind }
321 1.1.1.2.4.2 rmind
322 1.1.1.2.4.2 rmind /* Free any allocated memory (pointer within the object) found above */
323 1.1.1.2.4.2 rmind
324 1.1.1.2.4.2 rmind if (ObjPointer)
325 1.1.1.2.4.2 rmind {
326 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "Deleting Object Subptr %p\n",
327 1.1.1.2.4.2 rmind ObjPointer));
328 1.1.1.2.4.2 rmind ACPI_FREE (ObjPointer);
329 1.1.1.2.4.2 rmind }
330 1.1.1.2.4.2 rmind
331 1.1.1.2.4.2 rmind /* Now the object can be safely deleted */
332 1.1.1.2.4.2 rmind
333 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "Deleting Object %p [%s]\n",
334 1.1.1.2.4.2 rmind Object, AcpiUtGetObjectTypeName (Object)));
335 1.1.1.2.4.2 rmind
336 1.1.1.2.4.2 rmind AcpiUtDeleteObjectDesc (Object);
337 1.1.1.2.4.2 rmind return_VOID;
338 1.1.1.2.4.2 rmind }
339 1.1.1.2.4.2 rmind
340 1.1.1.2.4.2 rmind
341 1.1.1.2.4.2 rmind /*******************************************************************************
342 1.1.1.2.4.2 rmind *
343 1.1.1.2.4.2 rmind * FUNCTION: AcpiUtDeleteInternalObjectList
344 1.1.1.2.4.2 rmind *
345 1.1.1.2.4.2 rmind * PARAMETERS: ObjList - Pointer to the list to be deleted
346 1.1.1.2.4.2 rmind *
347 1.1.1.2.4.2 rmind * RETURN: None
348 1.1.1.2.4.2 rmind *
349 1.1.1.2.4.2 rmind * DESCRIPTION: This function deletes an internal object list, including both
350 1.1.1.2.4.2 rmind * simple objects and package objects
351 1.1.1.2.4.2 rmind *
352 1.1.1.2.4.2 rmind ******************************************************************************/
353 1.1.1.2.4.2 rmind
354 1.1.1.2.4.2 rmind void
355 1.1.1.2.4.2 rmind AcpiUtDeleteInternalObjectList (
356 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT **ObjList)
357 1.1.1.2.4.2 rmind {
358 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT **InternalObj;
359 1.1.1.2.4.2 rmind
360 1.1.1.2.4.2 rmind
361 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (UtDeleteInternalObjectList);
362 1.1.1.2.4.2 rmind
363 1.1.1.2.4.2 rmind
364 1.1.1.2.4.2 rmind /* Walk the null-terminated internal list */
365 1.1.1.2.4.2 rmind
366 1.1.1.2.4.2 rmind for (InternalObj = ObjList; *InternalObj; InternalObj++)
367 1.1.1.2.4.2 rmind {
368 1.1.1.2.4.2 rmind AcpiUtRemoveReference (*InternalObj);
369 1.1.1.2.4.2 rmind }
370 1.1.1.2.4.2 rmind
371 1.1.1.2.4.2 rmind /* Free the combined parameter pointer list and object array */
372 1.1.1.2.4.2 rmind
373 1.1.1.2.4.2 rmind ACPI_FREE (ObjList);
374 1.1.1.2.4.2 rmind return_VOID;
375 1.1.1.2.4.2 rmind }
376 1.1.1.2.4.2 rmind
377 1.1.1.2.4.2 rmind
378 1.1.1.2.4.2 rmind /*******************************************************************************
379 1.1.1.2.4.2 rmind *
380 1.1.1.2.4.2 rmind * FUNCTION: AcpiUtUpdateRefCount
381 1.1.1.2.4.2 rmind *
382 1.1.1.2.4.2 rmind * PARAMETERS: Object - Object whose ref count is to be updated
383 1.1.1.2.4.2 rmind * Action - What to do
384 1.1.1.2.4.2 rmind *
385 1.1.1.2.4.2 rmind * RETURN: New ref count
386 1.1.1.2.4.2 rmind *
387 1.1.1.2.4.2 rmind * DESCRIPTION: Modify the ref count and return it.
388 1.1.1.2.4.2 rmind *
389 1.1.1.2.4.2 rmind ******************************************************************************/
390 1.1.1.2.4.2 rmind
391 1.1.1.2.4.2 rmind static void
392 1.1.1.2.4.2 rmind AcpiUtUpdateRefCount (
393 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object,
394 1.1.1.2.4.2 rmind UINT32 Action)
395 1.1.1.2.4.2 rmind {
396 1.1.1.2.4.2 rmind UINT16 Count;
397 1.1.1.2.4.2 rmind UINT16 NewCount;
398 1.1.1.2.4.2 rmind
399 1.1.1.2.4.2 rmind
400 1.1.1.2.4.2 rmind ACPI_FUNCTION_NAME (UtUpdateRefCount);
401 1.1.1.2.4.2 rmind
402 1.1.1.2.4.2 rmind
403 1.1.1.2.4.2 rmind if (!Object)
404 1.1.1.2.4.2 rmind {
405 1.1.1.2.4.2 rmind return;
406 1.1.1.2.4.2 rmind }
407 1.1.1.2.4.2 rmind
408 1.1.1.2.4.2 rmind Count = Object->Common.ReferenceCount;
409 1.1.1.2.4.2 rmind NewCount = Count;
410 1.1.1.2.4.2 rmind
411 1.1.1.2.4.2 rmind /*
412 1.1.1.2.4.2 rmind * Perform the reference count action (increment, decrement, force delete)
413 1.1.1.2.4.2 rmind */
414 1.1.1.2.4.2 rmind switch (Action)
415 1.1.1.2.4.2 rmind {
416 1.1.1.2.4.2 rmind case REF_INCREMENT:
417 1.1.1.2.4.2 rmind
418 1.1.1.2.4.2 rmind NewCount++;
419 1.1.1.2.4.2 rmind Object->Common.ReferenceCount = NewCount;
420 1.1.1.2.4.2 rmind
421 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
422 1.1.1.2.4.2 rmind "Obj %p Refs=%X, [Incremented]\n",
423 1.1.1.2.4.2 rmind Object, NewCount));
424 1.1.1.2.4.2 rmind break;
425 1.1.1.2.4.2 rmind
426 1.1.1.2.4.2 rmind case REF_DECREMENT:
427 1.1.1.2.4.2 rmind
428 1.1.1.2.4.2 rmind if (Count < 1)
429 1.1.1.2.4.2 rmind {
430 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
431 1.1.1.2.4.2 rmind "Obj %p Refs=%X, can't decrement! (Set to 0)\n",
432 1.1.1.2.4.2 rmind Object, NewCount));
433 1.1.1.2.4.2 rmind
434 1.1.1.2.4.2 rmind NewCount = 0;
435 1.1.1.2.4.2 rmind }
436 1.1.1.2.4.2 rmind else
437 1.1.1.2.4.2 rmind {
438 1.1.1.2.4.2 rmind NewCount--;
439 1.1.1.2.4.2 rmind
440 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
441 1.1.1.2.4.2 rmind "Obj %p Refs=%X, [Decremented]\n",
442 1.1.1.2.4.2 rmind Object, NewCount));
443 1.1.1.2.4.2 rmind }
444 1.1.1.2.4.2 rmind
445 1.1.1.2.4.2 rmind if (Object->Common.Type == ACPI_TYPE_METHOD)
446 1.1.1.2.4.2 rmind {
447 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
448 1.1.1.2.4.2 rmind "Method Obj %p Refs=%X, [Decremented]\n", Object, NewCount));
449 1.1.1.2.4.2 rmind }
450 1.1.1.2.4.2 rmind
451 1.1.1.2.4.2 rmind Object->Common.ReferenceCount = NewCount;
452 1.1.1.2.4.2 rmind if (NewCount == 0)
453 1.1.1.2.4.2 rmind {
454 1.1.1.2.4.2 rmind AcpiUtDeleteInternalObj (Object);
455 1.1.1.2.4.2 rmind }
456 1.1.1.2.4.2 rmind break;
457 1.1.1.2.4.2 rmind
458 1.1.1.2.4.2 rmind case REF_FORCE_DELETE:
459 1.1.1.2.4.2 rmind
460 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
461 1.1.1.2.4.2 rmind "Obj %p Refs=%X, Force delete! (Set to 0)\n", Object, Count));
462 1.1.1.2.4.2 rmind
463 1.1.1.2.4.2 rmind NewCount = 0;
464 1.1.1.2.4.2 rmind Object->Common.ReferenceCount = NewCount;
465 1.1.1.2.4.2 rmind AcpiUtDeleteInternalObj (Object);
466 1.1.1.2.4.2 rmind break;
467 1.1.1.2.4.2 rmind
468 1.1.1.2.4.2 rmind default:
469 1.1.1.2.4.2 rmind
470 1.1.1.2.4.2 rmind ACPI_ERROR ((AE_INFO, "Unknown action (0x%X)", Action));
471 1.1.1.2.4.2 rmind break;
472 1.1.1.2.4.2 rmind }
473 1.1.1.2.4.2 rmind
474 1.1.1.2.4.2 rmind /*
475 1.1.1.2.4.2 rmind * Sanity check the reference count, for debug purposes only.
476 1.1.1.2.4.2 rmind * (A deleted object will have a huge reference count)
477 1.1.1.2.4.2 rmind */
478 1.1.1.2.4.2 rmind if (Count > ACPI_MAX_REFERENCE_COUNT)
479 1.1.1.2.4.2 rmind {
480 1.1.1.2.4.2 rmind ACPI_WARNING ((AE_INFO,
481 1.1.1.2.4.2 rmind "Large Reference Count (0x%X) in object %p", Count, Object));
482 1.1.1.2.4.2 rmind }
483 1.1.1.2.4.2 rmind }
484 1.1.1.2.4.2 rmind
485 1.1.1.2.4.2 rmind
486 1.1.1.2.4.2 rmind /*******************************************************************************
487 1.1.1.2.4.2 rmind *
488 1.1.1.2.4.2 rmind * FUNCTION: AcpiUtUpdateObjectReference
489 1.1.1.2.4.2 rmind *
490 1.1.1.2.4.2 rmind * PARAMETERS: Object - Increment ref count for this object
491 1.1.1.2.4.2 rmind * and all sub-objects
492 1.1.1.2.4.2 rmind * Action - Either REF_INCREMENT or REF_DECREMENT or
493 1.1.1.2.4.2 rmind * REF_FORCE_DELETE
494 1.1.1.2.4.2 rmind *
495 1.1.1.2.4.2 rmind * RETURN: Status
496 1.1.1.2.4.2 rmind *
497 1.1.1.2.4.2 rmind * DESCRIPTION: Increment the object reference count
498 1.1.1.2.4.2 rmind *
499 1.1.1.2.4.2 rmind * Object references are incremented when:
500 1.1.1.2.4.2 rmind * 1) An object is attached to a Node (namespace object)
501 1.1.1.2.4.2 rmind * 2) An object is copied (all subobjects must be incremented)
502 1.1.1.2.4.2 rmind *
503 1.1.1.2.4.2 rmind * Object references are decremented when:
504 1.1.1.2.4.2 rmind * 1) An object is detached from an Node
505 1.1.1.2.4.2 rmind *
506 1.1.1.2.4.2 rmind ******************************************************************************/
507 1.1.1.2.4.2 rmind
508 1.1.1.2.4.2 rmind ACPI_STATUS
509 1.1.1.2.4.2 rmind AcpiUtUpdateObjectReference (
510 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object,
511 1.1.1.2.4.2 rmind UINT16 Action)
512 1.1.1.2.4.2 rmind {
513 1.1.1.2.4.2 rmind ACPI_STATUS Status = AE_OK;
514 1.1.1.2.4.2 rmind ACPI_GENERIC_STATE *StateList = NULL;
515 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *NextObject = NULL;
516 1.1.1.2.4.2 rmind ACPI_GENERIC_STATE *State;
517 1.1.1.2.4.2 rmind UINT32 i;
518 1.1.1.2.4.2 rmind
519 1.1.1.2.4.2 rmind
520 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE_PTR (UtUpdateObjectReference, Object);
521 1.1.1.2.4.2 rmind
522 1.1.1.2.4.2 rmind
523 1.1.1.2.4.2 rmind while (Object)
524 1.1.1.2.4.2 rmind {
525 1.1.1.2.4.2 rmind /* Make sure that this isn't a namespace handle */
526 1.1.1.2.4.2 rmind
527 1.1.1.2.4.2 rmind if (ACPI_GET_DESCRIPTOR_TYPE (Object) == ACPI_DESC_TYPE_NAMED)
528 1.1.1.2.4.2 rmind {
529 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
530 1.1.1.2.4.2 rmind "Object %p is NS handle\n", Object));
531 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_OK);
532 1.1.1.2.4.2 rmind }
533 1.1.1.2.4.2 rmind
534 1.1.1.2.4.2 rmind /*
535 1.1.1.2.4.2 rmind * All sub-objects must have their reference count incremented also.
536 1.1.1.2.4.2 rmind * Different object types have different subobjects.
537 1.1.1.2.4.2 rmind */
538 1.1.1.2.4.2 rmind switch (Object->Common.Type)
539 1.1.1.2.4.2 rmind {
540 1.1.1.2.4.2 rmind case ACPI_TYPE_DEVICE:
541 1.1.1.2.4.2 rmind case ACPI_TYPE_PROCESSOR:
542 1.1.1.2.4.2 rmind case ACPI_TYPE_POWER:
543 1.1.1.2.4.2 rmind case ACPI_TYPE_THERMAL:
544 1.1.1.2.4.2 rmind
545 1.1.1.2.4.2 rmind /* Update the notify objects for these types (if present) */
546 1.1.1.2.4.2 rmind
547 1.1.1.2.4.2 rmind AcpiUtUpdateRefCount (Object->CommonNotify.SystemNotify, Action);
548 1.1.1.2.4.2 rmind AcpiUtUpdateRefCount (Object->CommonNotify.DeviceNotify, Action);
549 1.1.1.2.4.2 rmind break;
550 1.1.1.2.4.2 rmind
551 1.1.1.2.4.2 rmind case ACPI_TYPE_PACKAGE:
552 1.1.1.2.4.2 rmind /*
553 1.1.1.2.4.2 rmind * We must update all the sub-objects of the package,
554 1.1.1.2.4.2 rmind * each of whom may have their own sub-objects.
555 1.1.1.2.4.2 rmind */
556 1.1.1.2.4.2 rmind for (i = 0; i < Object->Package.Count; i++)
557 1.1.1.2.4.2 rmind {
558 1.1.1.2.4.2 rmind /*
559 1.1.1.2.4.2 rmind * Push each element onto the stack for later processing.
560 1.1.1.2.4.2 rmind * Note: There can be null elements within the package,
561 1.1.1.2.4.2 rmind * these are simply ignored
562 1.1.1.2.4.2 rmind */
563 1.1.1.2.4.2 rmind Status = AcpiUtCreateUpdateStateAndPush (
564 1.1.1.2.4.2 rmind Object->Package.Elements[i], Action, &StateList);
565 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status))
566 1.1.1.2.4.2 rmind {
567 1.1.1.2.4.2 rmind goto ErrorExit;
568 1.1.1.2.4.2 rmind }
569 1.1.1.2.4.2 rmind }
570 1.1.1.2.4.2 rmind break;
571 1.1.1.2.4.2 rmind
572 1.1.1.2.4.2 rmind case ACPI_TYPE_BUFFER_FIELD:
573 1.1.1.2.4.2 rmind
574 1.1.1.2.4.2 rmind NextObject = Object->BufferField.BufferObj;
575 1.1.1.2.4.2 rmind break;
576 1.1.1.2.4.2 rmind
577 1.1.1.2.4.2 rmind case ACPI_TYPE_LOCAL_REGION_FIELD:
578 1.1.1.2.4.2 rmind
579 1.1.1.2.4.2 rmind NextObject = Object->Field.RegionObj;
580 1.1.1.2.4.2 rmind break;
581 1.1.1.2.4.2 rmind
582 1.1.1.2.4.2 rmind case ACPI_TYPE_LOCAL_BANK_FIELD:
583 1.1.1.2.4.2 rmind
584 1.1.1.2.4.2 rmind NextObject = Object->BankField.BankObj;
585 1.1.1.2.4.2 rmind Status = AcpiUtCreateUpdateStateAndPush (
586 1.1.1.2.4.2 rmind Object->BankField.RegionObj, Action, &StateList);
587 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status))
588 1.1.1.2.4.2 rmind {
589 1.1.1.2.4.2 rmind goto ErrorExit;
590 1.1.1.2.4.2 rmind }
591 1.1.1.2.4.2 rmind break;
592 1.1.1.2.4.2 rmind
593 1.1.1.2.4.2 rmind case ACPI_TYPE_LOCAL_INDEX_FIELD:
594 1.1.1.2.4.2 rmind
595 1.1.1.2.4.2 rmind NextObject = Object->IndexField.IndexObj;
596 1.1.1.2.4.2 rmind Status = AcpiUtCreateUpdateStateAndPush (
597 1.1.1.2.4.2 rmind Object->IndexField.DataObj, Action, &StateList);
598 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status))
599 1.1.1.2.4.2 rmind {
600 1.1.1.2.4.2 rmind goto ErrorExit;
601 1.1.1.2.4.2 rmind }
602 1.1.1.2.4.2 rmind break;
603 1.1.1.2.4.2 rmind
604 1.1.1.2.4.2 rmind case ACPI_TYPE_LOCAL_REFERENCE:
605 1.1.1.2.4.2 rmind /*
606 1.1.1.2.4.2 rmind * The target of an Index (a package, string, or buffer) or a named
607 1.1.1.2.4.2 rmind * reference must track changes to the ref count of the index or
608 1.1.1.2.4.2 rmind * target object.
609 1.1.1.2.4.2 rmind */
610 1.1.1.2.4.2 rmind if ((Object->Reference.Class == ACPI_REFCLASS_INDEX) ||
611 1.1.1.2.4.2 rmind (Object->Reference.Class== ACPI_REFCLASS_NAME))
612 1.1.1.2.4.2 rmind {
613 1.1.1.2.4.2 rmind NextObject = Object->Reference.Object;
614 1.1.1.2.4.2 rmind }
615 1.1.1.2.4.2 rmind break;
616 1.1.1.2.4.2 rmind
617 1.1.1.2.4.2 rmind case ACPI_TYPE_REGION:
618 1.1.1.2.4.2 rmind default:
619 1.1.1.2.4.2 rmind break; /* No subobjects for all other types */
620 1.1.1.2.4.2 rmind }
621 1.1.1.2.4.2 rmind
622 1.1.1.2.4.2 rmind /*
623 1.1.1.2.4.2 rmind * Now we can update the count in the main object. This can only
624 1.1.1.2.4.2 rmind * happen after we update the sub-objects in case this causes the
625 1.1.1.2.4.2 rmind * main object to be deleted.
626 1.1.1.2.4.2 rmind */
627 1.1.1.2.4.2 rmind AcpiUtUpdateRefCount (Object, Action);
628 1.1.1.2.4.2 rmind Object = NULL;
629 1.1.1.2.4.2 rmind
630 1.1.1.2.4.2 rmind /* Move on to the next object to be updated */
631 1.1.1.2.4.2 rmind
632 1.1.1.2.4.2 rmind if (NextObject)
633 1.1.1.2.4.2 rmind {
634 1.1.1.2.4.2 rmind Object = NextObject;
635 1.1.1.2.4.2 rmind NextObject = NULL;
636 1.1.1.2.4.2 rmind }
637 1.1.1.2.4.2 rmind else if (StateList)
638 1.1.1.2.4.2 rmind {
639 1.1.1.2.4.2 rmind State = AcpiUtPopGenericState (&StateList);
640 1.1.1.2.4.2 rmind Object = State->Update.Object;
641 1.1.1.2.4.2 rmind AcpiUtDeleteGenericState (State);
642 1.1.1.2.4.2 rmind }
643 1.1.1.2.4.2 rmind }
644 1.1.1.2.4.2 rmind
645 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_OK);
646 1.1.1.2.4.2 rmind
647 1.1.1.2.4.2 rmind
648 1.1.1.2.4.2 rmind ErrorExit:
649 1.1.1.2.4.2 rmind
650 1.1.1.2.4.2 rmind ACPI_EXCEPTION ((AE_INFO, Status,
651 1.1.1.2.4.2 rmind "Could not update object reference count"));
652 1.1.1.2.4.2 rmind
653 1.1.1.2.4.2 rmind /* Free any stacked Update State objects */
654 1.1.1.2.4.2 rmind
655 1.1.1.2.4.2 rmind while (StateList)
656 1.1.1.2.4.2 rmind {
657 1.1.1.2.4.2 rmind State = AcpiUtPopGenericState (&StateList);
658 1.1.1.2.4.2 rmind AcpiUtDeleteGenericState (State);
659 1.1.1.2.4.2 rmind }
660 1.1.1.2.4.2 rmind
661 1.1.1.2.4.2 rmind return_ACPI_STATUS (Status);
662 1.1.1.2.4.2 rmind }
663 1.1.1.2.4.2 rmind
664 1.1.1.2.4.2 rmind
665 1.1.1.2.4.2 rmind /*******************************************************************************
666 1.1.1.2.4.2 rmind *
667 1.1.1.2.4.2 rmind * FUNCTION: AcpiUtAddReference
668 1.1.1.2.4.2 rmind *
669 1.1.1.2.4.2 rmind * PARAMETERS: Object - Object whose reference count is to be
670 1.1.1.2.4.2 rmind * incremented
671 1.1.1.2.4.2 rmind *
672 1.1.1.2.4.2 rmind * RETURN: None
673 1.1.1.2.4.2 rmind *
674 1.1.1.2.4.2 rmind * DESCRIPTION: Add one reference to an ACPI object
675 1.1.1.2.4.2 rmind *
676 1.1.1.2.4.2 rmind ******************************************************************************/
677 1.1.1.2.4.2 rmind
678 1.1.1.2.4.2 rmind void
679 1.1.1.2.4.2 rmind AcpiUtAddReference (
680 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object)
681 1.1.1.2.4.2 rmind {
682 1.1.1.2.4.2 rmind
683 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE_PTR (UtAddReference, Object);
684 1.1.1.2.4.2 rmind
685 1.1.1.2.4.2 rmind
686 1.1.1.2.4.2 rmind /* Ensure that we have a valid object */
687 1.1.1.2.4.2 rmind
688 1.1.1.2.4.2 rmind if (!AcpiUtValidInternalObject (Object))
689 1.1.1.2.4.2 rmind {
690 1.1.1.2.4.2 rmind return_VOID;
691 1.1.1.2.4.2 rmind }
692 1.1.1.2.4.2 rmind
693 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
694 1.1.1.2.4.2 rmind "Obj %p Current Refs=%X [To Be Incremented]\n",
695 1.1.1.2.4.2 rmind Object, Object->Common.ReferenceCount));
696 1.1.1.2.4.2 rmind
697 1.1.1.2.4.2 rmind /* Increment the reference count */
698 1.1.1.2.4.2 rmind
699 1.1.1.2.4.2 rmind (void) AcpiUtUpdateObjectReference (Object, REF_INCREMENT);
700 1.1.1.2.4.2 rmind return_VOID;
701 1.1.1.2.4.2 rmind }
702 1.1.1.2.4.2 rmind
703 1.1.1.2.4.2 rmind
704 1.1.1.2.4.2 rmind /*******************************************************************************
705 1.1.1.2.4.2 rmind *
706 1.1.1.2.4.2 rmind * FUNCTION: AcpiUtRemoveReference
707 1.1.1.2.4.2 rmind *
708 1.1.1.2.4.2 rmind * PARAMETERS: Object - Object whose ref count will be decremented
709 1.1.1.2.4.2 rmind *
710 1.1.1.2.4.2 rmind * RETURN: None
711 1.1.1.2.4.2 rmind *
712 1.1.1.2.4.2 rmind * DESCRIPTION: Decrement the reference count of an ACPI internal object
713 1.1.1.2.4.2 rmind *
714 1.1.1.2.4.2 rmind ******************************************************************************/
715 1.1.1.2.4.2 rmind
716 1.1.1.2.4.2 rmind void
717 1.1.1.2.4.2 rmind AcpiUtRemoveReference (
718 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *Object)
719 1.1.1.2.4.2 rmind {
720 1.1.1.2.4.2 rmind
721 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE_PTR (UtRemoveReference, Object);
722 1.1.1.2.4.2 rmind
723 1.1.1.2.4.2 rmind
724 1.1.1.2.4.2 rmind /*
725 1.1.1.2.4.2 rmind * Allow a NULL pointer to be passed in, just ignore it. This saves
726 1.1.1.2.4.2 rmind * each caller from having to check. Also, ignore NS nodes.
727 1.1.1.2.4.2 rmind *
728 1.1.1.2.4.2 rmind */
729 1.1.1.2.4.2 rmind if (!Object ||
730 1.1.1.2.4.2 rmind (ACPI_GET_DESCRIPTOR_TYPE (Object) == ACPI_DESC_TYPE_NAMED))
731 1.1.1.2.4.2 rmind
732 1.1.1.2.4.2 rmind {
733 1.1.1.2.4.2 rmind return_VOID;
734 1.1.1.2.4.2 rmind }
735 1.1.1.2.4.2 rmind
736 1.1.1.2.4.2 rmind /* Ensure that we have a valid object */
737 1.1.1.2.4.2 rmind
738 1.1.1.2.4.2 rmind if (!AcpiUtValidInternalObject (Object))
739 1.1.1.2.4.2 rmind {
740 1.1.1.2.4.2 rmind return_VOID;
741 1.1.1.2.4.2 rmind }
742 1.1.1.2.4.2 rmind
743 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
744 1.1.1.2.4.2 rmind "Obj %p Current Refs=%X [To Be Decremented]\n",
745 1.1.1.2.4.2 rmind Object, Object->Common.ReferenceCount));
746 1.1.1.2.4.2 rmind
747 1.1.1.2.4.2 rmind /*
748 1.1.1.2.4.2 rmind * Decrement the reference count, and only actually delete the object
749 1.1.1.2.4.2 rmind * if the reference count becomes 0. (Must also decrement the ref count
750 1.1.1.2.4.2 rmind * of all subobjects!)
751 1.1.1.2.4.2 rmind */
752 1.1.1.2.4.2 rmind (void) AcpiUtUpdateObjectReference (Object, REF_DECREMENT);
753 1.1.1.2.4.2 rmind return_VOID;
754 1.1.1.2.4.2 rmind }
755 1.1.1.2.4.2 rmind
756 1.1.1.2.4.2 rmind
757