acutils.h revision 1.3 1 1.1 jruoho /******************************************************************************
2 1.1 jruoho *
3 1.1 jruoho * Name: acutils.h -- prototypes for the common (subsystem-wide) procedures
4 1.1 jruoho *
5 1.1 jruoho *****************************************************************************/
6 1.1 jruoho
7 1.3 jruoho /*
8 1.3 jruoho * Copyright (C) 2000 - 2011, Intel Corp.
9 1.1 jruoho * All rights reserved.
10 1.1 jruoho *
11 1.3 jruoho * Redistribution and use in source and binary forms, with or without
12 1.3 jruoho * modification, are permitted provided that the following conditions
13 1.3 jruoho * are met:
14 1.3 jruoho * 1. Redistributions of source code must retain the above copyright
15 1.3 jruoho * notice, this list of conditions, and the following disclaimer,
16 1.3 jruoho * without modification.
17 1.3 jruoho * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 1.3 jruoho * substantially similar to the "NO WARRANTY" disclaimer below
19 1.3 jruoho * ("Disclaimer") and any redistribution must be conditioned upon
20 1.3 jruoho * including a substantially similar Disclaimer requirement for further
21 1.3 jruoho * binary redistribution.
22 1.3 jruoho * 3. Neither the names of the above-listed copyright holders nor the names
23 1.3 jruoho * of any contributors may be used to endorse or promote products derived
24 1.3 jruoho * from this software without specific prior written permission.
25 1.3 jruoho *
26 1.3 jruoho * Alternatively, this software may be distributed under the terms of the
27 1.3 jruoho * GNU General Public License ("GPL") version 2 as published by the Free
28 1.3 jruoho * Software Foundation.
29 1.3 jruoho *
30 1.3 jruoho * NO WARRANTY
31 1.3 jruoho * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 1.3 jruoho * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 1.3 jruoho * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 1.3 jruoho * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 1.3 jruoho * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 1.3 jruoho * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 1.3 jruoho * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 1.3 jruoho * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 1.3 jruoho * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 1.3 jruoho * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 1.3 jruoho * POSSIBILITY OF SUCH DAMAGES.
42 1.3 jruoho */
43 1.1 jruoho
44 1.1 jruoho #ifndef _ACUTILS_H
45 1.1 jruoho #define _ACUTILS_H
46 1.1 jruoho
47 1.1 jruoho
48 1.1 jruoho extern const UINT8 AcpiGbl_ResourceAmlSizes[];
49 1.1 jruoho
50 1.1 jruoho /* Strings used by the disassembler and debugger resource dump routines */
51 1.1 jruoho
52 1.1 jruoho #if defined(ACPI_DISASSEMBLER) || defined (ACPI_DEBUGGER)
53 1.1 jruoho
54 1.1 jruoho extern const char *AcpiGbl_BmDecode[];
55 1.1 jruoho extern const char *AcpiGbl_ConfigDecode[];
56 1.1 jruoho extern const char *AcpiGbl_ConsumeDecode[];
57 1.1 jruoho extern const char *AcpiGbl_DecDecode[];
58 1.1 jruoho extern const char *AcpiGbl_HeDecode[];
59 1.1 jruoho extern const char *AcpiGbl_IoDecode[];
60 1.1 jruoho extern const char *AcpiGbl_LlDecode[];
61 1.1 jruoho extern const char *AcpiGbl_MaxDecode[];
62 1.1 jruoho extern const char *AcpiGbl_MemDecode[];
63 1.1 jruoho extern const char *AcpiGbl_MinDecode[];
64 1.1 jruoho extern const char *AcpiGbl_MtpDecode[];
65 1.1 jruoho extern const char *AcpiGbl_RngDecode[];
66 1.1 jruoho extern const char *AcpiGbl_RwDecode[];
67 1.1 jruoho extern const char *AcpiGbl_ShrDecode[];
68 1.1 jruoho extern const char *AcpiGbl_SizDecode[];
69 1.1 jruoho extern const char *AcpiGbl_TrsDecode[];
70 1.1 jruoho extern const char *AcpiGbl_TtpDecode[];
71 1.1 jruoho extern const char *AcpiGbl_TypDecode[];
72 1.1 jruoho #endif
73 1.1 jruoho
74 1.1 jruoho /* Types for Resource descriptor entries */
75 1.1 jruoho
76 1.1 jruoho #define ACPI_INVALID_RESOURCE 0
77 1.1 jruoho #define ACPI_FIXED_LENGTH 1
78 1.1 jruoho #define ACPI_VARIABLE_LENGTH 2
79 1.1 jruoho #define ACPI_SMALL_VARIABLE_LENGTH 3
80 1.1 jruoho
81 1.1 jruoho typedef
82 1.1 jruoho ACPI_STATUS (*ACPI_WALK_AML_CALLBACK) (
83 1.1 jruoho UINT8 *Aml,
84 1.1 jruoho UINT32 Length,
85 1.1 jruoho UINT32 Offset,
86 1.1 jruoho UINT8 ResourceIndex,
87 1.1 jruoho void *Context);
88 1.1 jruoho
89 1.1 jruoho typedef
90 1.1 jruoho ACPI_STATUS (*ACPI_PKG_CALLBACK) (
91 1.1 jruoho UINT8 ObjectType,
92 1.1 jruoho ACPI_OPERAND_OBJECT *SourceObject,
93 1.1 jruoho ACPI_GENERIC_STATE *State,
94 1.1 jruoho void *Context);
95 1.1 jruoho
96 1.1 jruoho typedef struct acpi_pkg_info
97 1.1 jruoho {
98 1.1 jruoho UINT8 *FreeSpace;
99 1.1 jruoho ACPI_SIZE Length;
100 1.1 jruoho UINT32 ObjectSpace;
101 1.1 jruoho UINT32 NumPackages;
102 1.1 jruoho
103 1.1 jruoho } ACPI_PKG_INFO;
104 1.1 jruoho
105 1.1 jruoho #define REF_INCREMENT (UINT16) 0
106 1.1 jruoho #define REF_DECREMENT (UINT16) 1
107 1.1 jruoho #define REF_FORCE_DELETE (UINT16) 2
108 1.1 jruoho
109 1.1 jruoho /* AcpiUtDumpBuffer */
110 1.1 jruoho
111 1.1 jruoho #define DB_BYTE_DISPLAY 1
112 1.1 jruoho #define DB_WORD_DISPLAY 2
113 1.1 jruoho #define DB_DWORD_DISPLAY 4
114 1.1 jruoho #define DB_QWORD_DISPLAY 8
115 1.1 jruoho
116 1.1 jruoho
117 1.1 jruoho /*
118 1.1 jruoho * utglobal - Global data structures and procedures
119 1.1 jruoho */
120 1.1 jruoho ACPI_STATUS
121 1.1 jruoho AcpiUtInitGlobals (
122 1.1 jruoho void);
123 1.1 jruoho
124 1.1 jruoho #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
125 1.1 jruoho
126 1.2 jruoho const char *
127 1.1 jruoho AcpiUtGetMutexName (
128 1.1 jruoho UINT32 MutexId);
129 1.1 jruoho
130 1.1 jruoho const char *
131 1.1 jruoho AcpiUtGetNotifyName (
132 1.1 jruoho UINT32 NotifyValue);
133 1.1 jruoho
134 1.1 jruoho #endif
135 1.1 jruoho
136 1.1 jruoho char *
137 1.1 jruoho AcpiUtGetTypeName (
138 1.1 jruoho ACPI_OBJECT_TYPE Type);
139 1.1 jruoho
140 1.1 jruoho char *
141 1.1 jruoho AcpiUtGetNodeName (
142 1.1 jruoho void *Object);
143 1.1 jruoho
144 1.2 jruoho const char *
145 1.1 jruoho AcpiUtGetDescriptorName (
146 1.1 jruoho void *Object);
147 1.1 jruoho
148 1.1 jruoho const char *
149 1.1 jruoho AcpiUtGetReferenceName (
150 1.1 jruoho ACPI_OPERAND_OBJECT *Object);
151 1.1 jruoho
152 1.1 jruoho char *
153 1.1 jruoho AcpiUtGetObjectTypeName (
154 1.1 jruoho ACPI_OPERAND_OBJECT *ObjDesc);
155 1.1 jruoho
156 1.1 jruoho char *
157 1.1 jruoho AcpiUtGetRegionName (
158 1.1 jruoho UINT8 SpaceId);
159 1.1 jruoho
160 1.1 jruoho char *
161 1.1 jruoho AcpiUtGetEventName (
162 1.1 jruoho UINT32 EventId);
163 1.1 jruoho
164 1.1 jruoho char
165 1.1 jruoho AcpiUtHexToAsciiChar (
166 1.1 jruoho UINT64 Integer,
167 1.1 jruoho UINT32 Position);
168 1.1 jruoho
169 1.1 jruoho BOOLEAN
170 1.1 jruoho AcpiUtValidObjectType (
171 1.1 jruoho ACPI_OBJECT_TYPE Type);
172 1.1 jruoho
173 1.1 jruoho
174 1.1 jruoho /*
175 1.1 jruoho * utinit - miscellaneous initialization and shutdown
176 1.1 jruoho */
177 1.1 jruoho ACPI_STATUS
178 1.1 jruoho AcpiUtHardwareInitialize (
179 1.1 jruoho void);
180 1.1 jruoho
181 1.1 jruoho void
182 1.1 jruoho AcpiUtSubsystemShutdown (
183 1.1 jruoho void);
184 1.1 jruoho
185 1.1 jruoho
186 1.1 jruoho /*
187 1.1 jruoho * utclib - Local implementations of C library functions
188 1.1 jruoho */
189 1.1 jruoho #ifndef ACPI_USE_SYSTEM_CLIBRARY
190 1.1 jruoho
191 1.1 jruoho ACPI_SIZE
192 1.1 jruoho AcpiUtStrlen (
193 1.1 jruoho const char *String);
194 1.1 jruoho
195 1.1 jruoho char *
196 1.1 jruoho AcpiUtStrcpy (
197 1.1 jruoho char *DstString,
198 1.1 jruoho const char *SrcString);
199 1.1 jruoho
200 1.1 jruoho char *
201 1.1 jruoho AcpiUtStrncpy (
202 1.1 jruoho char *DstString,
203 1.1 jruoho const char *SrcString,
204 1.1 jruoho ACPI_SIZE Count);
205 1.1 jruoho
206 1.1 jruoho int
207 1.1 jruoho AcpiUtMemcmp (
208 1.1 jruoho const char *Buffer1,
209 1.1 jruoho const char *Buffer2,
210 1.1 jruoho ACPI_SIZE Count);
211 1.1 jruoho
212 1.1 jruoho int
213 1.1 jruoho AcpiUtStrncmp (
214 1.1 jruoho const char *String1,
215 1.1 jruoho const char *String2,
216 1.1 jruoho ACPI_SIZE Count);
217 1.1 jruoho
218 1.1 jruoho int
219 1.1 jruoho AcpiUtStrcmp (
220 1.1 jruoho const char *String1,
221 1.1 jruoho const char *String2);
222 1.1 jruoho
223 1.1 jruoho char *
224 1.1 jruoho AcpiUtStrcat (
225 1.1 jruoho char *DstString,
226 1.1 jruoho const char *SrcString);
227 1.1 jruoho
228 1.1 jruoho char *
229 1.1 jruoho AcpiUtStrncat (
230 1.1 jruoho char *DstString,
231 1.1 jruoho const char *SrcString,
232 1.1 jruoho ACPI_SIZE Count);
233 1.1 jruoho
234 1.1 jruoho UINT32
235 1.1 jruoho AcpiUtStrtoul (
236 1.1 jruoho const char *String,
237 1.1 jruoho char **Terminator,
238 1.1 jruoho UINT32 Base);
239 1.1 jruoho
240 1.1 jruoho char *
241 1.1 jruoho AcpiUtStrstr (
242 1.1 jruoho char *String1,
243 1.1 jruoho char *String2);
244 1.1 jruoho
245 1.1 jruoho void *
246 1.1 jruoho AcpiUtMemcpy (
247 1.1 jruoho void *Dest,
248 1.1 jruoho const void *Src,
249 1.1 jruoho ACPI_SIZE Count);
250 1.1 jruoho
251 1.1 jruoho void *
252 1.1 jruoho AcpiUtMemset (
253 1.1 jruoho void *Dest,
254 1.1 jruoho UINT8 Value,
255 1.1 jruoho ACPI_SIZE Count);
256 1.1 jruoho
257 1.1 jruoho int
258 1.1 jruoho AcpiUtToUpper (
259 1.1 jruoho int c);
260 1.1 jruoho
261 1.1 jruoho int
262 1.1 jruoho AcpiUtToLower (
263 1.1 jruoho int c);
264 1.1 jruoho
265 1.1 jruoho extern const UINT8 _acpi_ctype[];
266 1.1 jruoho
267 1.1 jruoho #define _ACPI_XA 0x00 /* extra alphabetic - not supported */
268 1.1 jruoho #define _ACPI_XS 0x40 /* extra space */
269 1.1 jruoho #define _ACPI_BB 0x00 /* BEL, BS, etc. - not supported */
270 1.1 jruoho #define _ACPI_CN 0x20 /* CR, FF, HT, NL, VT */
271 1.1 jruoho #define _ACPI_DI 0x04 /* '0'-'9' */
272 1.1 jruoho #define _ACPI_LO 0x02 /* 'a'-'z' */
273 1.1 jruoho #define _ACPI_PU 0x10 /* punctuation */
274 1.1 jruoho #define _ACPI_SP 0x08 /* space */
275 1.1 jruoho #define _ACPI_UP 0x01 /* 'A'-'Z' */
276 1.1 jruoho #define _ACPI_XD 0x80 /* '0'-'9', 'A'-'F', 'a'-'f' */
277 1.1 jruoho
278 1.1 jruoho #define ACPI_IS_DIGIT(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_DI))
279 1.1 jruoho #define ACPI_IS_SPACE(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_SP))
280 1.1 jruoho #define ACPI_IS_XDIGIT(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_XD))
281 1.1 jruoho #define ACPI_IS_UPPER(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_UP))
282 1.1 jruoho #define ACPI_IS_LOWER(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO))
283 1.1 jruoho #define ACPI_IS_PRINT(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP | _ACPI_DI | _ACPI_SP | _ACPI_PU))
284 1.1 jruoho #define ACPI_IS_ALPHA(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP))
285 1.1 jruoho
286 1.1 jruoho #endif /* !ACPI_USE_SYSTEM_CLIBRARY */
287 1.1 jruoho
288 1.1 jruoho #define ACPI_IS_ASCII(c) ((c) < 0x80)
289 1.1 jruoho
290 1.1 jruoho
291 1.1 jruoho /*
292 1.1 jruoho * utcopy - Object construction and conversion interfaces
293 1.1 jruoho */
294 1.1 jruoho ACPI_STATUS
295 1.1 jruoho AcpiUtBuildSimpleObject(
296 1.1 jruoho ACPI_OPERAND_OBJECT *Obj,
297 1.1 jruoho ACPI_OBJECT *UserObj,
298 1.1 jruoho UINT8 *DataSpace,
299 1.1 jruoho UINT32 *BufferSpaceUsed);
300 1.1 jruoho
301 1.1 jruoho ACPI_STATUS
302 1.1 jruoho AcpiUtBuildPackageObject (
303 1.1 jruoho ACPI_OPERAND_OBJECT *Obj,
304 1.1 jruoho UINT8 *Buffer,
305 1.1 jruoho UINT32 *SpaceUsed);
306 1.1 jruoho
307 1.1 jruoho ACPI_STATUS
308 1.1 jruoho AcpiUtCopyIobjectToEobject (
309 1.1 jruoho ACPI_OPERAND_OBJECT *Obj,
310 1.1 jruoho ACPI_BUFFER *RetBuffer);
311 1.1 jruoho
312 1.1 jruoho ACPI_STATUS
313 1.1 jruoho AcpiUtCopyEobjectToIobject (
314 1.1 jruoho ACPI_OBJECT *Obj,
315 1.1 jruoho ACPI_OPERAND_OBJECT **InternalObj);
316 1.1 jruoho
317 1.1 jruoho ACPI_STATUS
318 1.1 jruoho AcpiUtCopyISimpleToIsimple (
319 1.1 jruoho ACPI_OPERAND_OBJECT *SourceObj,
320 1.1 jruoho ACPI_OPERAND_OBJECT *DestObj);
321 1.1 jruoho
322 1.1 jruoho ACPI_STATUS
323 1.1 jruoho AcpiUtCopyIobjectToIobject (
324 1.1 jruoho ACPI_OPERAND_OBJECT *SourceDesc,
325 1.1 jruoho ACPI_OPERAND_OBJECT **DestDesc,
326 1.1 jruoho ACPI_WALK_STATE *WalkState);
327 1.1 jruoho
328 1.1 jruoho
329 1.1 jruoho /*
330 1.1 jruoho * utcreate - Object creation
331 1.1 jruoho */
332 1.1 jruoho ACPI_STATUS
333 1.1 jruoho AcpiUtUpdateObjectReference (
334 1.1 jruoho ACPI_OPERAND_OBJECT *Object,
335 1.1 jruoho UINT16 Action);
336 1.1 jruoho
337 1.1 jruoho
338 1.1 jruoho /*
339 1.1 jruoho * utdebug - Debug interfaces
340 1.1 jruoho */
341 1.1 jruoho void
342 1.1 jruoho AcpiUtInitStackPtrTrace (
343 1.1 jruoho void);
344 1.1 jruoho
345 1.1 jruoho void
346 1.1 jruoho AcpiUtTrackStackPtr (
347 1.1 jruoho void);
348 1.1 jruoho
349 1.1 jruoho void
350 1.1 jruoho AcpiUtTrace (
351 1.1 jruoho UINT32 LineNumber,
352 1.1 jruoho const char *FunctionName,
353 1.1 jruoho const char *ModuleName,
354 1.1 jruoho UINT32 ComponentId);
355 1.1 jruoho
356 1.1 jruoho void
357 1.1 jruoho AcpiUtTracePtr (
358 1.1 jruoho UINT32 LineNumber,
359 1.1 jruoho const char *FunctionName,
360 1.1 jruoho const char *ModuleName,
361 1.1 jruoho UINT32 ComponentId,
362 1.1 jruoho void *Pointer);
363 1.1 jruoho
364 1.1 jruoho void
365 1.1 jruoho AcpiUtTraceU32 (
366 1.1 jruoho UINT32 LineNumber,
367 1.1 jruoho const char *FunctionName,
368 1.1 jruoho const char *ModuleName,
369 1.1 jruoho UINT32 ComponentId,
370 1.1 jruoho UINT32 Integer);
371 1.1 jruoho
372 1.1 jruoho void
373 1.1 jruoho AcpiUtTraceStr (
374 1.1 jruoho UINT32 LineNumber,
375 1.1 jruoho const char *FunctionName,
376 1.1 jruoho const char *ModuleName,
377 1.1 jruoho UINT32 ComponentId,
378 1.1 jruoho char *String);
379 1.1 jruoho
380 1.1 jruoho void
381 1.1 jruoho AcpiUtExit (
382 1.1 jruoho UINT32 LineNumber,
383 1.1 jruoho const char *FunctionName,
384 1.1 jruoho const char *ModuleName,
385 1.1 jruoho UINT32 ComponentId);
386 1.1 jruoho
387 1.1 jruoho void
388 1.1 jruoho AcpiUtStatusExit (
389 1.1 jruoho UINT32 LineNumber,
390 1.1 jruoho const char *FunctionName,
391 1.1 jruoho const char *ModuleName,
392 1.1 jruoho UINT32 ComponentId,
393 1.1 jruoho ACPI_STATUS Status);
394 1.1 jruoho
395 1.1 jruoho void
396 1.1 jruoho AcpiUtValueExit (
397 1.1 jruoho UINT32 LineNumber,
398 1.1 jruoho const char *FunctionName,
399 1.1 jruoho const char *ModuleName,
400 1.1 jruoho UINT32 ComponentId,
401 1.1 jruoho UINT64 Value);
402 1.1 jruoho
403 1.1 jruoho void
404 1.1 jruoho AcpiUtPtrExit (
405 1.1 jruoho UINT32 LineNumber,
406 1.1 jruoho const char *FunctionName,
407 1.1 jruoho const char *ModuleName,
408 1.1 jruoho UINT32 ComponentId,
409 1.1 jruoho UINT8 *Ptr);
410 1.1 jruoho
411 1.1 jruoho void
412 1.1 jruoho AcpiUtDumpBuffer (
413 1.1 jruoho UINT8 *Buffer,
414 1.1 jruoho UINT32 Count,
415 1.1 jruoho UINT32 Display,
416 1.1 jruoho UINT32 componentId);
417 1.1 jruoho
418 1.1 jruoho void
419 1.1 jruoho AcpiUtDumpBuffer2 (
420 1.1 jruoho UINT8 *Buffer,
421 1.1 jruoho UINT32 Count,
422 1.1 jruoho UINT32 Display);
423 1.1 jruoho
424 1.1 jruoho void
425 1.1 jruoho AcpiUtReportError (
426 1.1 jruoho char *ModuleName,
427 1.1 jruoho UINT32 LineNumber);
428 1.1 jruoho
429 1.1 jruoho void
430 1.1 jruoho AcpiUtReportInfo (
431 1.1 jruoho char *ModuleName,
432 1.1 jruoho UINT32 LineNumber);
433 1.1 jruoho
434 1.1 jruoho void
435 1.1 jruoho AcpiUtReportWarning (
436 1.1 jruoho char *ModuleName,
437 1.1 jruoho UINT32 LineNumber);
438 1.1 jruoho
439 1.1 jruoho /*
440 1.1 jruoho * utdelete - Object deletion and reference counts
441 1.1 jruoho */
442 1.1 jruoho void
443 1.1 jruoho AcpiUtAddReference (
444 1.1 jruoho ACPI_OPERAND_OBJECT *Object);
445 1.1 jruoho
446 1.1 jruoho void
447 1.1 jruoho AcpiUtRemoveReference (
448 1.1 jruoho ACPI_OPERAND_OBJECT *Object);
449 1.1 jruoho
450 1.1 jruoho void
451 1.1 jruoho AcpiUtDeleteInternalPackageObject (
452 1.1 jruoho ACPI_OPERAND_OBJECT *Object);
453 1.1 jruoho
454 1.1 jruoho void
455 1.1 jruoho AcpiUtDeleteInternalSimpleObject (
456 1.1 jruoho ACPI_OPERAND_OBJECT *Object);
457 1.1 jruoho
458 1.1 jruoho void
459 1.1 jruoho AcpiUtDeleteInternalObjectList (
460 1.1 jruoho ACPI_OPERAND_OBJECT **ObjList);
461 1.1 jruoho
462 1.1 jruoho
463 1.1 jruoho /*
464 1.1 jruoho * uteval - object evaluation
465 1.1 jruoho */
466 1.1 jruoho ACPI_STATUS
467 1.1 jruoho AcpiUtEvaluateObject (
468 1.1 jruoho ACPI_NAMESPACE_NODE *PrefixNode,
469 1.2 jruoho const char *Path,
470 1.1 jruoho UINT32 ExpectedReturnBtypes,
471 1.1 jruoho ACPI_OPERAND_OBJECT **ReturnDesc);
472 1.1 jruoho
473 1.1 jruoho ACPI_STATUS
474 1.1 jruoho AcpiUtEvaluateNumericObject (
475 1.2 jruoho const char *ObjectName,
476 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode,
477 1.1 jruoho UINT64 *Value);
478 1.1 jruoho
479 1.1 jruoho ACPI_STATUS
480 1.1 jruoho AcpiUtExecute_STA (
481 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode,
482 1.1 jruoho UINT32 *StatusFlags);
483 1.1 jruoho
484 1.1 jruoho ACPI_STATUS
485 1.1 jruoho AcpiUtExecutePowerMethods (
486 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode,
487 1.1 jruoho const char **MethodNames,
488 1.1 jruoho UINT8 MethodCount,
489 1.1 jruoho UINT8 *OutValues);
490 1.1 jruoho
491 1.1 jruoho
492 1.1 jruoho /*
493 1.1 jruoho * utids - device ID support
494 1.1 jruoho */
495 1.1 jruoho ACPI_STATUS
496 1.1 jruoho AcpiUtExecute_HID (
497 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode,
498 1.1 jruoho ACPI_DEVICE_ID **ReturnId);
499 1.1 jruoho
500 1.1 jruoho ACPI_STATUS
501 1.1 jruoho AcpiUtExecute_UID (
502 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode,
503 1.1 jruoho ACPI_DEVICE_ID **ReturnId);
504 1.1 jruoho
505 1.1 jruoho ACPI_STATUS
506 1.1 jruoho AcpiUtExecute_CID (
507 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode,
508 1.1 jruoho ACPI_DEVICE_ID_LIST **ReturnCidList);
509 1.1 jruoho
510 1.1 jruoho
511 1.1 jruoho /*
512 1.1 jruoho * utlock - reader/writer locks
513 1.1 jruoho */
514 1.1 jruoho ACPI_STATUS
515 1.1 jruoho AcpiUtCreateRwLock (
516 1.1 jruoho ACPI_RW_LOCK *Lock);
517 1.1 jruoho
518 1.1 jruoho void
519 1.1 jruoho AcpiUtDeleteRwLock (
520 1.1 jruoho ACPI_RW_LOCK *Lock);
521 1.1 jruoho
522 1.1 jruoho ACPI_STATUS
523 1.1 jruoho AcpiUtAcquireReadLock (
524 1.1 jruoho ACPI_RW_LOCK *Lock);
525 1.1 jruoho
526 1.1 jruoho ACPI_STATUS
527 1.1 jruoho AcpiUtReleaseReadLock (
528 1.1 jruoho ACPI_RW_LOCK *Lock);
529 1.1 jruoho
530 1.1 jruoho ACPI_STATUS
531 1.1 jruoho AcpiUtAcquireWriteLock (
532 1.1 jruoho ACPI_RW_LOCK *Lock);
533 1.1 jruoho
534 1.1 jruoho void
535 1.1 jruoho AcpiUtReleaseWriteLock (
536 1.1 jruoho ACPI_RW_LOCK *Lock);
537 1.1 jruoho
538 1.1 jruoho
539 1.1 jruoho /*
540 1.1 jruoho * utobject - internal object create/delete/cache routines
541 1.1 jruoho */
542 1.1 jruoho ACPI_OPERAND_OBJECT *
543 1.1 jruoho AcpiUtCreateInternalObjectDbg (
544 1.1 jruoho const char *ModuleName,
545 1.1 jruoho UINT32 LineNumber,
546 1.1 jruoho UINT32 ComponentId,
547 1.1 jruoho ACPI_OBJECT_TYPE Type);
548 1.1 jruoho
549 1.1 jruoho void *
550 1.1 jruoho AcpiUtAllocateObjectDescDbg (
551 1.1 jruoho const char *ModuleName,
552 1.1 jruoho UINT32 LineNumber,
553 1.1 jruoho UINT32 ComponentId);
554 1.1 jruoho
555 1.1 jruoho #define AcpiUtCreateInternalObject(t) AcpiUtCreateInternalObjectDbg (_AcpiModuleName,__LINE__,_COMPONENT,t)
556 1.1 jruoho #define AcpiUtAllocateObjectDesc() AcpiUtAllocateObjectDescDbg (_AcpiModuleName,__LINE__,_COMPONENT)
557 1.1 jruoho
558 1.1 jruoho void
559 1.1 jruoho AcpiUtDeleteObjectDesc (
560 1.1 jruoho ACPI_OPERAND_OBJECT *Object);
561 1.1 jruoho
562 1.1 jruoho BOOLEAN
563 1.1 jruoho AcpiUtValidInternalObject (
564 1.1 jruoho void *Object);
565 1.1 jruoho
566 1.1 jruoho ACPI_OPERAND_OBJECT *
567 1.1 jruoho AcpiUtCreatePackageObject (
568 1.1 jruoho UINT32 Count);
569 1.1 jruoho
570 1.1 jruoho ACPI_OPERAND_OBJECT *
571 1.1 jruoho AcpiUtCreateIntegerObject (
572 1.1 jruoho UINT64 Value);
573 1.1 jruoho
574 1.1 jruoho ACPI_OPERAND_OBJECT *
575 1.1 jruoho AcpiUtCreateBufferObject (
576 1.1 jruoho ACPI_SIZE BufferSize);
577 1.1 jruoho
578 1.1 jruoho ACPI_OPERAND_OBJECT *
579 1.1 jruoho AcpiUtCreateStringObject (
580 1.1 jruoho ACPI_SIZE StringSize);
581 1.1 jruoho
582 1.1 jruoho ACPI_STATUS
583 1.1 jruoho AcpiUtGetObjectSize(
584 1.1 jruoho ACPI_OPERAND_OBJECT *Obj,
585 1.1 jruoho ACPI_SIZE *ObjLength);
586 1.1 jruoho
587 1.1 jruoho
588 1.1 jruoho /*
589 1.3 jruoho * utosi - Support for the _OSI predefined control method
590 1.3 jruoho */
591 1.3 jruoho ACPI_STATUS
592 1.3 jruoho AcpiUtInitializeInterfaces (
593 1.3 jruoho void);
594 1.3 jruoho
595 1.3 jruoho void
596 1.3 jruoho AcpiUtInterfaceTerminate (
597 1.3 jruoho void);
598 1.3 jruoho
599 1.3 jruoho ACPI_STATUS
600 1.3 jruoho AcpiUtInstallInterface (
601 1.3 jruoho ACPI_STRING InterfaceName);
602 1.3 jruoho
603 1.3 jruoho ACPI_STATUS
604 1.3 jruoho AcpiUtRemoveInterface (
605 1.3 jruoho ACPI_STRING InterfaceName);
606 1.3 jruoho
607 1.3 jruoho ACPI_INTERFACE_INFO *
608 1.3 jruoho AcpiUtGetInterface (
609 1.3 jruoho ACPI_STRING InterfaceName);
610 1.3 jruoho
611 1.3 jruoho ACPI_STATUS
612 1.3 jruoho AcpiUtOsiImplementation (
613 1.3 jruoho ACPI_WALK_STATE *WalkState);
614 1.3 jruoho
615 1.3 jruoho
616 1.3 jruoho /*
617 1.1 jruoho * utstate - Generic state creation/cache routines
618 1.1 jruoho */
619 1.1 jruoho void
620 1.1 jruoho AcpiUtPushGenericState (
621 1.1 jruoho ACPI_GENERIC_STATE **ListHead,
622 1.1 jruoho ACPI_GENERIC_STATE *State);
623 1.1 jruoho
624 1.1 jruoho ACPI_GENERIC_STATE *
625 1.1 jruoho AcpiUtPopGenericState (
626 1.1 jruoho ACPI_GENERIC_STATE **ListHead);
627 1.1 jruoho
628 1.1 jruoho
629 1.1 jruoho ACPI_GENERIC_STATE *
630 1.1 jruoho AcpiUtCreateGenericState (
631 1.1 jruoho void);
632 1.1 jruoho
633 1.1 jruoho ACPI_THREAD_STATE *
634 1.1 jruoho AcpiUtCreateThreadState (
635 1.1 jruoho void);
636 1.1 jruoho
637 1.1 jruoho ACPI_GENERIC_STATE *
638 1.1 jruoho AcpiUtCreateUpdateState (
639 1.1 jruoho ACPI_OPERAND_OBJECT *Object,
640 1.1 jruoho UINT16 Action);
641 1.1 jruoho
642 1.1 jruoho ACPI_GENERIC_STATE *
643 1.1 jruoho AcpiUtCreatePkgState (
644 1.1 jruoho void *InternalObject,
645 1.1 jruoho void *ExternalObject,
646 1.1 jruoho UINT16 Index);
647 1.1 jruoho
648 1.1 jruoho ACPI_STATUS
649 1.1 jruoho AcpiUtCreateUpdateStateAndPush (
650 1.1 jruoho ACPI_OPERAND_OBJECT *Object,
651 1.1 jruoho UINT16 Action,
652 1.1 jruoho ACPI_GENERIC_STATE **StateList);
653 1.1 jruoho
654 1.1 jruoho ACPI_STATUS
655 1.1 jruoho AcpiUtCreatePkgStateAndPush (
656 1.1 jruoho void *InternalObject,
657 1.1 jruoho void *ExternalObject,
658 1.1 jruoho UINT16 Index,
659 1.1 jruoho ACPI_GENERIC_STATE **StateList);
660 1.1 jruoho
661 1.1 jruoho ACPI_GENERIC_STATE *
662 1.1 jruoho AcpiUtCreateControlState (
663 1.1 jruoho void);
664 1.1 jruoho
665 1.1 jruoho void
666 1.1 jruoho AcpiUtDeleteGenericState (
667 1.1 jruoho ACPI_GENERIC_STATE *State);
668 1.1 jruoho
669 1.1 jruoho
670 1.1 jruoho /*
671 1.1 jruoho * utmath
672 1.1 jruoho */
673 1.1 jruoho ACPI_STATUS
674 1.1 jruoho AcpiUtDivide (
675 1.1 jruoho UINT64 InDividend,
676 1.1 jruoho UINT64 InDivisor,
677 1.1 jruoho UINT64 *OutQuotient,
678 1.1 jruoho UINT64 *OutRemainder);
679 1.1 jruoho
680 1.1 jruoho ACPI_STATUS
681 1.1 jruoho AcpiUtShortDivide (
682 1.1 jruoho UINT64 InDividend,
683 1.1 jruoho UINT32 Divisor,
684 1.1 jruoho UINT64 *OutQuotient,
685 1.1 jruoho UINT32 *OutRemainder);
686 1.1 jruoho
687 1.1 jruoho /*
688 1.1 jruoho * utmisc
689 1.1 jruoho */
690 1.1 jruoho const char *
691 1.1 jruoho AcpiUtValidateException (
692 1.1 jruoho ACPI_STATUS Status);
693 1.1 jruoho
694 1.1 jruoho BOOLEAN
695 1.1 jruoho AcpiUtIsPciRootBridge (
696 1.1 jruoho char *Id);
697 1.1 jruoho
698 1.1 jruoho BOOLEAN
699 1.1 jruoho AcpiUtIsAmlTable (
700 1.1 jruoho ACPI_TABLE_HEADER *Table);
701 1.1 jruoho
702 1.1 jruoho ACPI_STATUS
703 1.1 jruoho AcpiUtAllocateOwnerId (
704 1.1 jruoho ACPI_OWNER_ID *OwnerId);
705 1.1 jruoho
706 1.1 jruoho void
707 1.1 jruoho AcpiUtReleaseOwnerId (
708 1.1 jruoho ACPI_OWNER_ID *OwnerId);
709 1.1 jruoho
710 1.1 jruoho ACPI_STATUS
711 1.1 jruoho AcpiUtWalkPackageTree (
712 1.1 jruoho ACPI_OPERAND_OBJECT *SourceObject,
713 1.1 jruoho void *TargetObject,
714 1.1 jruoho ACPI_PKG_CALLBACK WalkCallback,
715 1.1 jruoho void *Context);
716 1.1 jruoho
717 1.1 jruoho void
718 1.1 jruoho AcpiUtStrupr (
719 1.1 jruoho char *SrcString);
720 1.1 jruoho
721 1.1 jruoho void
722 1.3 jruoho AcpiUtStrlwr (
723 1.3 jruoho char *SrcString);
724 1.3 jruoho
725 1.3 jruoho void
726 1.1 jruoho AcpiUtPrintString (
727 1.1 jruoho char *String,
728 1.1 jruoho UINT8 MaxLength);
729 1.1 jruoho
730 1.1 jruoho BOOLEAN
731 1.1 jruoho AcpiUtValidAcpiName (
732 1.1 jruoho UINT32 Name);
733 1.1 jruoho
734 1.1 jruoho void
735 1.1 jruoho AcpiUtRepairName (
736 1.1 jruoho char *Name);
737 1.1 jruoho
738 1.1 jruoho BOOLEAN
739 1.1 jruoho AcpiUtValidAcpiChar (
740 1.1 jruoho char Character,
741 1.1 jruoho UINT32 Position);
742 1.1 jruoho
743 1.1 jruoho ACPI_STATUS
744 1.1 jruoho AcpiUtStrtoul64 (
745 1.1 jruoho char *String,
746 1.1 jruoho UINT32 Base,
747 1.1 jruoho UINT64 *RetInteger);
748 1.1 jruoho
749 1.1 jruoho /* Values for Base above (16=Hex, 10=Decimal) */
750 1.1 jruoho
751 1.1 jruoho #define ACPI_ANY_BASE 0
752 1.1 jruoho
753 1.1 jruoho UINT32
754 1.1 jruoho AcpiUtDwordByteSwap (
755 1.1 jruoho UINT32 Value);
756 1.1 jruoho
757 1.1 jruoho void
758 1.1 jruoho AcpiUtSetIntegerWidth (
759 1.1 jruoho UINT8 Revision);
760 1.1 jruoho
761 1.1 jruoho #ifdef ACPI_DEBUG_OUTPUT
762 1.1 jruoho void
763 1.1 jruoho AcpiUtDisplayInitPathname (
764 1.1 jruoho UINT8 Type,
765 1.1 jruoho ACPI_NAMESPACE_NODE *ObjHandle,
766 1.2 jruoho const char *Path);
767 1.1 jruoho #endif
768 1.1 jruoho
769 1.1 jruoho
770 1.1 jruoho /*
771 1.1 jruoho * utresrc
772 1.1 jruoho */
773 1.1 jruoho ACPI_STATUS
774 1.1 jruoho AcpiUtWalkAmlResources (
775 1.1 jruoho UINT8 *Aml,
776 1.1 jruoho ACPI_SIZE AmlLength,
777 1.1 jruoho ACPI_WALK_AML_CALLBACK UserFunction,
778 1.1 jruoho void *Context);
779 1.1 jruoho
780 1.1 jruoho ACPI_STATUS
781 1.1 jruoho AcpiUtValidateResource (
782 1.1 jruoho void *Aml,
783 1.1 jruoho UINT8 *ReturnIndex);
784 1.1 jruoho
785 1.1 jruoho UINT32
786 1.1 jruoho AcpiUtGetDescriptorLength (
787 1.1 jruoho void *Aml);
788 1.1 jruoho
789 1.1 jruoho UINT16
790 1.1 jruoho AcpiUtGetResourceLength (
791 1.1 jruoho void *Aml);
792 1.1 jruoho
793 1.1 jruoho UINT8
794 1.1 jruoho AcpiUtGetResourceHeaderLength (
795 1.1 jruoho void *Aml);
796 1.1 jruoho
797 1.1 jruoho UINT8
798 1.1 jruoho AcpiUtGetResourceType (
799 1.1 jruoho void *Aml);
800 1.1 jruoho
801 1.1 jruoho ACPI_STATUS
802 1.1 jruoho AcpiUtGetResourceEndTag (
803 1.1 jruoho ACPI_OPERAND_OBJECT *ObjDesc,
804 1.1 jruoho UINT8 **EndTag);
805 1.1 jruoho
806 1.1 jruoho
807 1.1 jruoho /*
808 1.1 jruoho * utmutex - mutex support
809 1.1 jruoho */
810 1.1 jruoho ACPI_STATUS
811 1.1 jruoho AcpiUtMutexInitialize (
812 1.1 jruoho void);
813 1.1 jruoho
814 1.1 jruoho void
815 1.1 jruoho AcpiUtMutexTerminate (
816 1.1 jruoho void);
817 1.1 jruoho
818 1.1 jruoho ACPI_STATUS
819 1.1 jruoho AcpiUtAcquireMutex (
820 1.1 jruoho ACPI_MUTEX_HANDLE MutexId);
821 1.1 jruoho
822 1.1 jruoho ACPI_STATUS
823 1.1 jruoho AcpiUtReleaseMutex (
824 1.1 jruoho ACPI_MUTEX_HANDLE MutexId);
825 1.1 jruoho
826 1.1 jruoho
827 1.1 jruoho /*
828 1.1 jruoho * utalloc - memory allocation and object caching
829 1.1 jruoho */
830 1.1 jruoho ACPI_STATUS
831 1.1 jruoho AcpiUtCreateCaches (
832 1.1 jruoho void);
833 1.1 jruoho
834 1.1 jruoho ACPI_STATUS
835 1.1 jruoho AcpiUtDeleteCaches (
836 1.1 jruoho void);
837 1.1 jruoho
838 1.1 jruoho ACPI_STATUS
839 1.1 jruoho AcpiUtValidateBuffer (
840 1.1 jruoho ACPI_BUFFER *Buffer);
841 1.1 jruoho
842 1.1 jruoho ACPI_STATUS
843 1.1 jruoho AcpiUtInitializeBuffer (
844 1.1 jruoho ACPI_BUFFER *Buffer,
845 1.1 jruoho ACPI_SIZE RequiredLength);
846 1.1 jruoho
847 1.1 jruoho void *
848 1.1 jruoho AcpiUtAllocate (
849 1.1 jruoho ACPI_SIZE Size,
850 1.1 jruoho UINT32 Component,
851 1.1 jruoho const char *Module,
852 1.1 jruoho UINT32 Line);
853 1.1 jruoho
854 1.1 jruoho void *
855 1.1 jruoho AcpiUtAllocateZeroed (
856 1.1 jruoho ACPI_SIZE Size,
857 1.1 jruoho UINT32 Component,
858 1.1 jruoho const char *Module,
859 1.1 jruoho UINT32 Line);
860 1.1 jruoho
861 1.1 jruoho #ifdef ACPI_DBG_TRACK_ALLOCATIONS
862 1.1 jruoho void *
863 1.1 jruoho AcpiUtAllocateAndTrack (
864 1.1 jruoho ACPI_SIZE Size,
865 1.1 jruoho UINT32 Component,
866 1.1 jruoho const char *Module,
867 1.1 jruoho UINT32 Line);
868 1.1 jruoho
869 1.1 jruoho void *
870 1.1 jruoho AcpiUtAllocateZeroedAndTrack (
871 1.1 jruoho ACPI_SIZE Size,
872 1.1 jruoho UINT32 Component,
873 1.1 jruoho const char *Module,
874 1.1 jruoho UINT32 Line);
875 1.1 jruoho
876 1.1 jruoho void
877 1.1 jruoho AcpiUtFreeAndTrack (
878 1.1 jruoho void *Address,
879 1.1 jruoho UINT32 Component,
880 1.1 jruoho const char *Module,
881 1.1 jruoho UINT32 Line);
882 1.1 jruoho
883 1.1 jruoho void
884 1.1 jruoho AcpiUtDumpAllocationInfo (
885 1.1 jruoho void);
886 1.1 jruoho
887 1.1 jruoho void
888 1.1 jruoho AcpiUtDumpAllocations (
889 1.1 jruoho UINT32 Component,
890 1.1 jruoho const char *Module);
891 1.1 jruoho
892 1.1 jruoho ACPI_STATUS
893 1.1 jruoho AcpiUtCreateList (
894 1.2 jruoho const char *ListName,
895 1.1 jruoho UINT16 ObjectSize,
896 1.1 jruoho ACPI_MEMORY_LIST **ReturnCache);
897 1.1 jruoho
898 1.3 jruoho #endif /* ACPI_DBG_TRACK_ALLOCATIONS */
899 1.3 jruoho
900 1.3 jruoho
901 1.3 jruoho /*
902 1.3 jruoho * utxferror - various error/warning output functions
903 1.3 jruoho */
904 1.3 jruoho void ACPI_INTERNAL_VAR_XFACE
905 1.3 jruoho AcpiUtPredefinedWarning (
906 1.3 jruoho const char *ModuleName,
907 1.3 jruoho UINT32 LineNumber,
908 1.3 jruoho char *Pathname,
909 1.3 jruoho UINT8 NodeFlags,
910 1.3 jruoho const char *Format,
911 1.3 jruoho ...);
912 1.3 jruoho
913 1.3 jruoho void ACPI_INTERNAL_VAR_XFACE
914 1.3 jruoho AcpiUtPredefinedInfo (
915 1.3 jruoho const char *ModuleName,
916 1.3 jruoho UINT32 LineNumber,
917 1.3 jruoho char *Pathname,
918 1.3 jruoho UINT8 NodeFlags,
919 1.3 jruoho const char *Format,
920 1.3 jruoho ...);
921 1.3 jruoho
922 1.3 jruoho void
923 1.3 jruoho AcpiUtNamespaceError (
924 1.3 jruoho const char *ModuleName,
925 1.3 jruoho UINT32 LineNumber,
926 1.3 jruoho const char *InternalName,
927 1.3 jruoho ACPI_STATUS LookupStatus);
928 1.1 jruoho
929 1.3 jruoho void
930 1.3 jruoho AcpiUtMethodError (
931 1.3 jruoho const char *ModuleName,
932 1.3 jruoho UINT32 LineNumber,
933 1.3 jruoho const char *Message,
934 1.3 jruoho ACPI_NAMESPACE_NODE *Node,
935 1.3 jruoho const char *Path,
936 1.3 jruoho ACPI_STATUS LookupStatus);
937 1.1 jruoho
938 1.1 jruoho #endif /* _ACUTILS_H */
939