1 /******************************************************************************
2  *
3  * Name: acutils.h -- prototypes for the common (subsystem-wide) procedures
4  *
5  *****************************************************************************/
6 
7 /*
8  * Copyright (C) 2000 - 2014, 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 #ifndef _ACUTILS_H
45 #define _ACUTILS_H
46 
47 
48 extern const UINT8                      AcpiGbl_ResourceAmlSizes[];
49 extern const UINT8                      AcpiGbl_ResourceAmlSerialBusSizes[];
50 
51 /* Strings used by the disassembler and debugger resource dump routines */
52 
53 #if defined(ACPI_DEBUG_OUTPUT) || defined (ACPI_DISASSEMBLER) || defined (ACPI_DEBUGGER)
54 
55 extern const char                       *AcpiGbl_BmDecode[];
56 extern const char                       *AcpiGbl_ConfigDecode[];
57 extern const char                       *AcpiGbl_ConsumeDecode[];
58 extern const char                       *AcpiGbl_DecDecode[];
59 extern const char                       *AcpiGbl_HeDecode[];
60 extern const char                       *AcpiGbl_IoDecode[];
61 extern const char                       *AcpiGbl_LlDecode[];
62 extern const char                       *AcpiGbl_MaxDecode[];
63 extern const char                       *AcpiGbl_MemDecode[];
64 extern const char                       *AcpiGbl_MinDecode[];
65 extern const char                       *AcpiGbl_MtpDecode[];
66 extern const char                       *AcpiGbl_RngDecode[];
67 extern const char                       *AcpiGbl_RwDecode[];
68 extern const char                       *AcpiGbl_ShrDecode[];
69 extern const char                       *AcpiGbl_SizDecode[];
70 extern const char                       *AcpiGbl_TrsDecode[];
71 extern const char                       *AcpiGbl_TtpDecode[];
72 extern const char                       *AcpiGbl_TypDecode[];
73 extern const char                       *AcpiGbl_PpcDecode[];
74 extern const char                       *AcpiGbl_IorDecode[];
75 extern const char                       *AcpiGbl_DtsDecode[];
76 extern const char                       *AcpiGbl_CtDecode[];
77 extern const char                       *AcpiGbl_SbtDecode[];
78 extern const char                       *AcpiGbl_AmDecode[];
79 extern const char                       *AcpiGbl_SmDecode[];
80 extern const char                       *AcpiGbl_WmDecode[];
81 extern const char                       *AcpiGbl_CphDecode[];
82 extern const char                       *AcpiGbl_CpoDecode[];
83 extern const char                       *AcpiGbl_DpDecode[];
84 extern const char                       *AcpiGbl_EdDecode[];
85 extern const char                       *AcpiGbl_BpbDecode[];
86 extern const char                       *AcpiGbl_SbDecode[];
87 extern const char                       *AcpiGbl_FcDecode[];
88 extern const char                       *AcpiGbl_PtDecode[];
89 #endif
90 
91 /*
92  * For the iASL compiler case, the output is redirected to stderr so that
93  * any of the various ACPI errors and warnings do not appear in the output
94  * files, for either the compiler or disassembler portions of the tool.
95  */
96 #ifdef ACPI_ASL_COMPILER
97 
98 #include <stdio.h>
99 extern FILE                 *AcpiGbl_OutputFile;
100 
101 #define ACPI_MSG_REDIRECT_BEGIN \
102     FILE                    *OutputFile = AcpiGbl_OutputFile; \
103     AcpiOsRedirectOutput (stderr);
104 
105 #define ACPI_MSG_REDIRECT_END \
106     AcpiOsRedirectOutput (OutputFile);
107 
108 #else
109 /*
110  * non-iASL case - no redirection, nothing to do
111  */
112 #define ACPI_MSG_REDIRECT_BEGIN
113 #define ACPI_MSG_REDIRECT_END
114 #endif
115 
116 /*
117  * Common error message prefixes
118  */
119 #define ACPI_MSG_ERROR          "ACPI Error: "
120 #define ACPI_MSG_EXCEPTION      "ACPI Exception: "
121 #define ACPI_MSG_WARNING        "ACPI Warning: "
122 #define ACPI_MSG_INFO           "ACPI: "
123 
124 #define ACPI_MSG_BIOS_ERROR     "ACPI BIOS Error (bug): "
125 #define ACPI_MSG_BIOS_WARNING   "ACPI BIOS Warning (bug): "
126 
127 /*
128  * Common message suffix
129  */
130 #define ACPI_MSG_SUFFIX \
131     AcpiOsPrintf (" (%8.8X/%s-%u)\n", ACPI_CA_VERSION, ModuleName, LineNumber)
132 
133 
134 /* Types for Resource descriptor entries */
135 
136 #define ACPI_INVALID_RESOURCE           0
137 #define ACPI_FIXED_LENGTH               1
138 #define ACPI_VARIABLE_LENGTH            2
139 #define ACPI_SMALL_VARIABLE_LENGTH      3
140 
141 typedef
142 ACPI_STATUS (*ACPI_WALK_AML_CALLBACK) (
143     UINT8                   *Aml,
144     UINT32                  Length,
145     UINT32                  Offset,
146     UINT8                   ResourceIndex,
147     void                    **Context);
148 
149 typedef
150 ACPI_STATUS (*ACPI_PKG_CALLBACK) (
151     UINT8                   ObjectType,
152     ACPI_OPERAND_OBJECT     *SourceObject,
153     ACPI_GENERIC_STATE      *State,
154     void                    *Context);
155 
156 typedef struct acpi_pkg_info
157 {
158     UINT8                   *FreeSpace;
159     ACPI_SIZE               Length;
160     UINT32                  ObjectSpace;
161     UINT32                  NumPackages;
162 
163 } ACPI_PKG_INFO;
164 
165 /* Object reference counts */
166 
167 #define REF_INCREMENT       (UINT16) 0
168 #define REF_DECREMENT       (UINT16) 1
169 
170 /* AcpiUtDumpBuffer */
171 
172 #define DB_BYTE_DISPLAY     1
173 #define DB_WORD_DISPLAY     2
174 #define DB_DWORD_DISPLAY    4
175 #define DB_QWORD_DISPLAY    8
176 
177 /*
178  * utglobal - Global data structures and procedures
179  */
180 ACPI_STATUS
181 AcpiUtInitGlobals (
182     void);
183 
184 #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
185 
186 char *
187 AcpiUtGetMutexName (
188     UINT32                  MutexId);
189 
190 const char *
191 AcpiUtGetNotifyName (
192     UINT32                  NotifyValue,
193     ACPI_OBJECT_TYPE        Type);
194 #endif
195 
196 char *
197 AcpiUtGetTypeName (
198     ACPI_OBJECT_TYPE        Type);
199 
200 char *
201 AcpiUtGetNodeName (
202     void                    *Object);
203 
204 char *
205 AcpiUtGetDescriptorName (
206     void                    *Object);
207 
208 const char *
209 AcpiUtGetReferenceName (
210     ACPI_OPERAND_OBJECT     *Object);
211 
212 char *
213 AcpiUtGetObjectTypeName (
214     ACPI_OPERAND_OBJECT     *ObjDesc);
215 
216 char *
217 AcpiUtGetRegionName (
218     UINT8                   SpaceId);
219 
220 char *
221 AcpiUtGetEventName (
222     UINT32                  EventId);
223 
224 char
225 AcpiUtHexToAsciiChar (
226     UINT64                  Integer,
227     UINT32                  Position);
228 
229 BOOLEAN
230 AcpiUtValidObjectType (
231     ACPI_OBJECT_TYPE        Type);
232 
233 
234 /*
235  * utinit - miscellaneous initialization and shutdown
236  */
237 ACPI_STATUS
238 AcpiUtHardwareInitialize (
239     void);
240 
241 void
242 AcpiUtSubsystemShutdown (
243     void);
244 
245 
246 /*
247  * utclib - Local implementations of C library functions
248  */
249 #ifndef ACPI_USE_SYSTEM_CLIBRARY
250 
251 ACPI_SIZE
252 AcpiUtStrlen (
253     const char              *String);
254 
255 char *
256 AcpiUtStrcpy (
257     char                    *DstString,
258     const char              *SrcString);
259 
260 char *
261 AcpiUtStrncpy (
262     char                    *DstString,
263     const char              *SrcString,
264     ACPI_SIZE               Count);
265 
266 int
267 AcpiUtMemcmp (
268     const char              *Buffer1,
269     const char              *Buffer2,
270     ACPI_SIZE               Count);
271 
272 int
273 AcpiUtStrncmp (
274     const char              *String1,
275     const char              *String2,
276     ACPI_SIZE               Count);
277 
278 int
279 AcpiUtStrcmp (
280     const char              *String1,
281     const char              *String2);
282 
283 char *
284 AcpiUtStrcat (
285     char                    *DstString,
286     const char              *SrcString);
287 
288 char *
289 AcpiUtStrncat (
290     char                    *DstString,
291     const char              *SrcString,
292     ACPI_SIZE               Count);
293 
294 UINT32
295 AcpiUtStrtoul (
296     const char              *String,
297     char                    **Terminator,
298     UINT32                  Base);
299 
300 char *
301 AcpiUtStrstr (
302     char                    *String1,
303     char                    *String2);
304 
305 void *
306 AcpiUtMemcpy (
307     void                    *Dest,
308     const void              *Src,
309     ACPI_SIZE               Count);
310 
311 void *
312 AcpiUtMemset (
313     void                    *Dest,
314     UINT8                   Value,
315     ACPI_SIZE               Count);
316 
317 int
318 AcpiUtToUpper (
319     int                     c);
320 
321 int
322 AcpiUtToLower (
323     int                     c);
324 
325 extern const UINT8 _acpi_ctype[];
326 
327 #define _ACPI_XA     0x00    /* extra alphabetic - not supported */
328 #define _ACPI_XS     0x40    /* extra space */
329 #define _ACPI_BB     0x00    /* BEL, BS, etc. - not supported */
330 #define _ACPI_CN     0x20    /* CR, FF, HT, NL, VT */
331 #define _ACPI_DI     0x04    /* '0'-'9' */
332 #define _ACPI_LO     0x02    /* 'a'-'z' */
333 #define _ACPI_PU     0x10    /* punctuation */
334 #define _ACPI_SP     0x08    /* space */
335 #define _ACPI_UP     0x01    /* 'A'-'Z' */
336 #define _ACPI_XD     0x80    /* '0'-'9', 'A'-'F', 'a'-'f' */
337 
338 #define ACPI_IS_DIGIT(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_DI))
339 #define ACPI_IS_SPACE(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_SP))
340 #define ACPI_IS_XDIGIT(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_XD))
341 #define ACPI_IS_UPPER(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_UP))
342 #define ACPI_IS_LOWER(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO))
343 #define ACPI_IS_PRINT(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP | _ACPI_DI | _ACPI_SP | _ACPI_PU))
344 #define ACPI_IS_ALPHA(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP))
345 
346 #endif /* !ACPI_USE_SYSTEM_CLIBRARY */
347 
348 #define ACPI_IS_ASCII(c)  ((c) < 0x80)
349 
350 
351 /*
352  * utcopy - Object construction and conversion interfaces
353  */
354 ACPI_STATUS
355 AcpiUtBuildSimpleObject(
356     ACPI_OPERAND_OBJECT     *Obj,
357     ACPI_OBJECT             *UserObj,
358     UINT8                   *DataSpace,
359     UINT32                  *BufferSpaceUsed);
360 
361 ACPI_STATUS
362 AcpiUtBuildPackageObject (
363     ACPI_OPERAND_OBJECT     *Obj,
364     UINT8                   *Buffer,
365     UINT32                  *SpaceUsed);
366 
367 ACPI_STATUS
368 AcpiUtCopyIobjectToEobject (
369     ACPI_OPERAND_OBJECT     *Obj,
370     ACPI_BUFFER             *RetBuffer);
371 
372 ACPI_STATUS
373 AcpiUtCopyEobjectToIobject (
374     ACPI_OBJECT             *Obj,
375     ACPI_OPERAND_OBJECT     **InternalObj);
376 
377 ACPI_STATUS
378 AcpiUtCopyISimpleToIsimple (
379     ACPI_OPERAND_OBJECT     *SourceObj,
380     ACPI_OPERAND_OBJECT     *DestObj);
381 
382 ACPI_STATUS
383 AcpiUtCopyIobjectToIobject (
384     ACPI_OPERAND_OBJECT     *SourceDesc,
385     ACPI_OPERAND_OBJECT     **DestDesc,
386     ACPI_WALK_STATE         *WalkState);
387 
388 
389 /*
390  * utcreate - Object creation
391  */
392 ACPI_STATUS
393 AcpiUtUpdateObjectReference (
394     ACPI_OPERAND_OBJECT     *Object,
395     UINT16                  Action);
396 
397 
398 /*
399  * utdebug - Debug interfaces
400  */
401 void
402 AcpiUtInitStackPtrTrace (
403     void);
404 
405 void
406 AcpiUtTrackStackPtr (
407     void);
408 
409 void
410 AcpiUtTrace (
411     UINT32                  LineNumber,
412     const char              *FunctionName,
413     const char              *ModuleName,
414     UINT32                  ComponentId);
415 
416 void
417 AcpiUtTracePtr (
418     UINT32                  LineNumber,
419     const char              *FunctionName,
420     const char              *ModuleName,
421     UINT32                  ComponentId,
422     void                    *Pointer);
423 
424 void
425 AcpiUtTraceU32 (
426     UINT32                  LineNumber,
427     const char              *FunctionName,
428     const char              *ModuleName,
429     UINT32                  ComponentId,
430     UINT32                  Integer);
431 
432 void
433 AcpiUtTraceStr (
434     UINT32                  LineNumber,
435     const char              *FunctionName,
436     const char              *ModuleName,
437     UINT32                  ComponentId,
438     char                    *String);
439 
440 void
441 AcpiUtExit (
442     UINT32                  LineNumber,
443     const char              *FunctionName,
444     const char              *ModuleName,
445     UINT32                  ComponentId);
446 
447 void
448 AcpiUtStatusExit (
449     UINT32                  LineNumber,
450     const char              *FunctionName,
451     const char              *ModuleName,
452     UINT32                  ComponentId,
453     ACPI_STATUS             Status);
454 
455 void
456 AcpiUtValueExit (
457     UINT32                  LineNumber,
458     const char              *FunctionName,
459     const char              *ModuleName,
460     UINT32                  ComponentId,
461     UINT64                  Value);
462 
463 void
464 AcpiUtPtrExit (
465     UINT32                  LineNumber,
466     const char              *FunctionName,
467     const char              *ModuleName,
468     UINT32                  ComponentId,
469     UINT8                   *Ptr);
470 
471 void
472 AcpiUtDebugDumpBuffer (
473     UINT8                   *Buffer,
474     UINT32                  Count,
475     UINT32                  Display,
476     UINT32                  ComponentId);
477 
478 void
479 AcpiUtDumpBuffer (
480     UINT8                   *Buffer,
481     UINT32                  Count,
482     UINT32                  Display,
483     UINT32                  Offset);
484 
485 void
486 AcpiUtReportError (
487     char                    *ModuleName,
488     UINT32                  LineNumber);
489 
490 void
491 AcpiUtReportInfo (
492     char                    *ModuleName,
493     UINT32                  LineNumber);
494 
495 void
496 AcpiUtReportWarning (
497     char                    *ModuleName,
498     UINT32                  LineNumber);
499 
500 /*
501  * utdelete - Object deletion and reference counts
502  */
503 void
504 AcpiUtAddReference (
505     ACPI_OPERAND_OBJECT     *Object);
506 
507 void
508 AcpiUtRemoveReference (
509     ACPI_OPERAND_OBJECT     *Object);
510 
511 void
512 AcpiUtDeleteInternalPackageObject (
513     ACPI_OPERAND_OBJECT     *Object);
514 
515 void
516 AcpiUtDeleteInternalSimpleObject (
517     ACPI_OPERAND_OBJECT     *Object);
518 
519 void
520 AcpiUtDeleteInternalObjectList (
521     ACPI_OPERAND_OBJECT     **ObjList);
522 
523 
524 /*
525  * uteval - object evaluation
526  */
527 ACPI_STATUS
528 AcpiUtEvaluateObject (
529     ACPI_NAMESPACE_NODE     *PrefixNode,
530     char                    *Path,
531     UINT32                  ExpectedReturnBtypes,
532     ACPI_OPERAND_OBJECT     **ReturnDesc);
533 
534 ACPI_STATUS
535 AcpiUtEvaluateNumericObject (
536     char                    *ObjectName,
537     ACPI_NAMESPACE_NODE     *DeviceNode,
538     UINT64                  *Value);
539 
540 ACPI_STATUS
541 AcpiUtExecute_STA (
542     ACPI_NAMESPACE_NODE     *DeviceNode,
543     UINT32                  *StatusFlags);
544 
545 ACPI_STATUS
546 AcpiUtExecutePowerMethods (
547     ACPI_NAMESPACE_NODE     *DeviceNode,
548     const char              **MethodNames,
549     UINT8                   MethodCount,
550     UINT8                   *OutValues);
551 
552 
553 /*
554  * utids - device ID support
555  */
556 ACPI_STATUS
557 AcpiUtExecute_HID (
558     ACPI_NAMESPACE_NODE     *DeviceNode,
559     ACPI_PNP_DEVICE_ID      **ReturnId);
560 
561 ACPI_STATUS
562 AcpiUtExecute_UID (
563     ACPI_NAMESPACE_NODE     *DeviceNode,
564     ACPI_PNP_DEVICE_ID      **ReturnId);
565 
566 ACPI_STATUS
567 AcpiUtExecute_SUB (
568     ACPI_NAMESPACE_NODE     *DeviceNode,
569     ACPI_PNP_DEVICE_ID      **ReturnId);
570 
571 ACPI_STATUS
572 AcpiUtExecute_CID (
573     ACPI_NAMESPACE_NODE     *DeviceNode,
574     ACPI_PNP_DEVICE_ID_LIST **ReturnCidList);
575 
576 
577 /*
578  * utlock - reader/writer locks
579  */
580 ACPI_STATUS
581 AcpiUtCreateRwLock (
582     ACPI_RW_LOCK            *Lock);
583 
584 void
585 AcpiUtDeleteRwLock (
586     ACPI_RW_LOCK            *Lock);
587 
588 ACPI_STATUS
589 AcpiUtAcquireReadLock (
590     ACPI_RW_LOCK            *Lock);
591 
592 ACPI_STATUS
593 AcpiUtReleaseReadLock (
594     ACPI_RW_LOCK            *Lock);
595 
596 ACPI_STATUS
597 AcpiUtAcquireWriteLock (
598     ACPI_RW_LOCK            *Lock);
599 
600 void
601 AcpiUtReleaseWriteLock (
602     ACPI_RW_LOCK            *Lock);
603 
604 
605 /*
606  * utobject - internal object create/delete/cache routines
607  */
608 ACPI_OPERAND_OBJECT  *
609 AcpiUtCreateInternalObjectDbg (
610     const char              *ModuleName,
611     UINT32                  LineNumber,
612     UINT32                  ComponentId,
613     ACPI_OBJECT_TYPE        Type);
614 
615 void *
616 AcpiUtAllocateObjectDescDbg (
617     const char              *ModuleName,
618     UINT32                  LineNumber,
619     UINT32                  ComponentId);
620 
621 #define AcpiUtCreateInternalObject(t)   AcpiUtCreateInternalObjectDbg (_AcpiModuleName,__LINE__,_COMPONENT,t)
622 #define AcpiUtAllocateObjectDesc()      AcpiUtAllocateObjectDescDbg (_AcpiModuleName,__LINE__,_COMPONENT)
623 
624 void
625 AcpiUtDeleteObjectDesc (
626     ACPI_OPERAND_OBJECT     *Object);
627 
628 BOOLEAN
629 AcpiUtValidInternalObject (
630     void                    *Object);
631 
632 ACPI_OPERAND_OBJECT *
633 AcpiUtCreatePackageObject (
634     UINT32                  Count);
635 
636 ACPI_OPERAND_OBJECT *
637 AcpiUtCreateIntegerObject (
638     UINT64                  Value);
639 
640 ACPI_OPERAND_OBJECT *
641 AcpiUtCreateBufferObject (
642     ACPI_SIZE               BufferSize);
643 
644 ACPI_OPERAND_OBJECT *
645 AcpiUtCreateStringObject (
646     ACPI_SIZE               StringSize);
647 
648 ACPI_STATUS
649 AcpiUtGetObjectSize(
650     ACPI_OPERAND_OBJECT     *Obj,
651     ACPI_SIZE               *ObjLength);
652 
653 
654 /*
655  * utosi - Support for the _OSI predefined control method
656  */
657 ACPI_STATUS
658 AcpiUtInitializeInterfaces (
659     void);
660 
661 ACPI_STATUS
662 AcpiUtInterfaceTerminate (
663     void);
664 
665 ACPI_STATUS
666 AcpiUtInstallInterface (
667     ACPI_STRING             InterfaceName);
668 
669 ACPI_STATUS
670 AcpiUtRemoveInterface (
671     ACPI_STRING             InterfaceName);
672 
673 ACPI_STATUS
674 AcpiUtUpdateInterfaces (
675     UINT8                   Action);
676 
677 ACPI_INTERFACE_INFO *
678 AcpiUtGetInterface (
679     ACPI_STRING             InterfaceName);
680 
681 ACPI_STATUS
682 AcpiUtOsiImplementation (
683     ACPI_WALK_STATE         *WalkState);
684 
685 
686 /*
687  * utpredef - support for predefined names
688  */
689 const ACPI_PREDEFINED_INFO *
690 AcpiUtGetNextPredefinedMethod (
691     const ACPI_PREDEFINED_INFO  *ThisName);
692 
693 const ACPI_PREDEFINED_INFO *
694 AcpiUtMatchPredefinedMethod (
695     char                        *Name);
696 
697 const ACPI_PREDEFINED_INFO *
698 AcpiUtMatchResourceName (
699     char                        *Name);
700 
701 void
702 AcpiUtDisplayPredefinedMethod (
703     char                        *Buffer,
704     const ACPI_PREDEFINED_INFO  *ThisName,
705     BOOLEAN                     MultiLine);
706 
707 void
708 AcpiUtGetExpectedReturnTypes (
709     char                    *Buffer,
710     UINT32                  ExpectedBtypes);
711 
712 UINT32
713 AcpiUtGetResourceBitWidth (
714     char                    *Buffer,
715     UINT16                  Types);
716 
717 
718 /*
719  * utstate - Generic state creation/cache routines
720  */
721 void
722 AcpiUtPushGenericState (
723     ACPI_GENERIC_STATE      **ListHead,
724     ACPI_GENERIC_STATE      *State);
725 
726 ACPI_GENERIC_STATE *
727 AcpiUtPopGenericState (
728     ACPI_GENERIC_STATE      **ListHead);
729 
730 
731 ACPI_GENERIC_STATE *
732 AcpiUtCreateGenericState (
733     void);
734 
735 ACPI_THREAD_STATE *
736 AcpiUtCreateThreadState (
737     void);
738 
739 ACPI_GENERIC_STATE *
740 AcpiUtCreateUpdateState (
741     ACPI_OPERAND_OBJECT     *Object,
742     UINT16                  Action);
743 
744 ACPI_GENERIC_STATE *
745 AcpiUtCreatePkgState (
746     void                    *InternalObject,
747     void                    *ExternalObject,
748     UINT16                  Index);
749 
750 ACPI_STATUS
751 AcpiUtCreateUpdateStateAndPush (
752     ACPI_OPERAND_OBJECT     *Object,
753     UINT16                  Action,
754     ACPI_GENERIC_STATE      **StateList);
755 
756 ACPI_STATUS
757 AcpiUtCreatePkgStateAndPush (
758     void                    *InternalObject,
759     void                    *ExternalObject,
760     UINT16                  Index,
761     ACPI_GENERIC_STATE      **StateList);
762 
763 ACPI_GENERIC_STATE *
764 AcpiUtCreateControlState (
765     void);
766 
767 void
768 AcpiUtDeleteGenericState (
769     ACPI_GENERIC_STATE      *State);
770 
771 
772 /*
773  * utmath
774  */
775 ACPI_STATUS
776 AcpiUtDivide (
777     UINT64                  InDividend,
778     UINT64                  InDivisor,
779     UINT64                  *OutQuotient,
780     UINT64                  *OutRemainder);
781 
782 ACPI_STATUS
783 AcpiUtShortDivide (
784     UINT64                  InDividend,
785     UINT32                  Divisor,
786     UINT64                  *OutQuotient,
787     UINT32                  *OutRemainder);
788 
789 
790 /*
791  * utmisc
792  */
793 const ACPI_EXCEPTION_INFO *
794 AcpiUtValidateException (
795     ACPI_STATUS             Status);
796 
797 BOOLEAN
798 AcpiUtIsPciRootBridge (
799     char                    *Id);
800 
801 BOOLEAN
802 AcpiUtIsAmlTable (
803     ACPI_TABLE_HEADER       *Table);
804 
805 ACPI_STATUS
806 AcpiUtWalkPackageTree (
807     ACPI_OPERAND_OBJECT     *SourceObject,
808     void                    *TargetObject,
809     ACPI_PKG_CALLBACK       WalkCallback,
810     void                    *Context);
811 
812 
813 /* Values for Base above (16=Hex, 10=Decimal) */
814 
815 #define ACPI_ANY_BASE        0
816 
817 UINT32
818 AcpiUtDwordByteSwap (
819     UINT32                  Value);
820 
821 void
822 AcpiUtSetIntegerWidth (
823     UINT8                   Revision);
824 
825 #ifdef ACPI_DEBUG_OUTPUT
826 void
827 AcpiUtDisplayInitPathname (
828     UINT8                   Type,
829     ACPI_NAMESPACE_NODE     *ObjHandle,
830     char                    *Path);
831 #endif
832 
833 
834 /*
835  * utownerid - Support for Table/Method Owner IDs
836  */
837 ACPI_STATUS
838 AcpiUtAllocateOwnerId (
839     ACPI_OWNER_ID           *OwnerId);
840 
841 void
842 AcpiUtReleaseOwnerId (
843     ACPI_OWNER_ID           *OwnerId);
844 
845 
846 /*
847  * utresrc
848  */
849 ACPI_STATUS
850 AcpiUtWalkAmlResources (
851     ACPI_WALK_STATE         *WalkState,
852     UINT8                   *Aml,
853     ACPI_SIZE               AmlLength,
854     ACPI_WALK_AML_CALLBACK  UserFunction,
855     void                    **Context);
856 
857 ACPI_STATUS
858 AcpiUtValidateResource (
859     ACPI_WALK_STATE         *WalkState,
860     void                    *Aml,
861     UINT8                   *ReturnIndex);
862 
863 UINT32
864 AcpiUtGetDescriptorLength (
865     void                    *Aml);
866 
867 UINT16
868 AcpiUtGetResourceLength (
869     void                    *Aml);
870 
871 UINT8
872 AcpiUtGetResourceHeaderLength (
873     void                    *Aml);
874 
875 UINT8
876 AcpiUtGetResourceType (
877     void                    *Aml);
878 
879 ACPI_STATUS
880 AcpiUtGetResourceEndTag (
881     ACPI_OPERAND_OBJECT     *ObjDesc,
882     UINT8                   **EndTag);
883 
884 
885 /*
886  * utstring - String and character utilities
887  */
888 void
889 AcpiUtStrupr (
890     char                    *SrcString);
891 
892 void
893 AcpiUtStrlwr (
894     char                    *SrcString);
895 
896 int
897 AcpiUtStricmp (
898     char                    *String1,
899     char                    *String2);
900 
901 ACPI_STATUS
902 AcpiUtStrtoul64 (
903     char                    *String,
904     UINT32                  Base,
905     UINT64                  *RetInteger);
906 
907 void
908 AcpiUtPrintString (
909     char                    *String,
910     UINT16                  MaxLength);
911 
912 void
913 UtConvertBackslashes (
914     char                    *Pathname);
915 
916 BOOLEAN
917 AcpiUtValidAcpiName (
918     char                    *Name);
919 
920 BOOLEAN
921 AcpiUtValidAcpiChar (
922     char                    Character,
923     UINT32                  Position);
924 
925 void
926 AcpiUtRepairName (
927     char                    *Name);
928 
929 #if defined (ACPI_DEBUGGER) || defined (ACPI_APPLICATION)
930 BOOLEAN
931 AcpiUtSafeStrcpy (
932     char                    *Dest,
933     ACPI_SIZE               DestSize,
934     char                    *Source);
935 
936 BOOLEAN
937 AcpiUtSafeStrcat (
938     char                    *Dest,
939     ACPI_SIZE               DestSize,
940     char                    *Source);
941 
942 BOOLEAN
943 AcpiUtSafeStrncat (
944     char                    *Dest,
945     ACPI_SIZE               DestSize,
946     char                    *Source,
947     ACPI_SIZE               MaxTransferLength);
948 #endif
949 
950 
951 /*
952  * utmutex - mutex support
953  */
954 ACPI_STATUS
955 AcpiUtMutexInitialize (
956     void);
957 
958 void
959 AcpiUtMutexTerminate (
960     void);
961 
962 ACPI_STATUS
963 AcpiUtAcquireMutex (
964     ACPI_MUTEX_HANDLE       MutexId);
965 
966 ACPI_STATUS
967 AcpiUtReleaseMutex (
968     ACPI_MUTEX_HANDLE       MutexId);
969 
970 
971 /*
972  * utalloc - memory allocation and object caching
973  */
974 ACPI_STATUS
975 AcpiUtCreateCaches (
976     void);
977 
978 ACPI_STATUS
979 AcpiUtDeleteCaches (
980     void);
981 
982 ACPI_STATUS
983 AcpiUtValidateBuffer (
984     ACPI_BUFFER             *Buffer);
985 
986 ACPI_STATUS
987 AcpiUtInitializeBuffer (
988     ACPI_BUFFER             *Buffer,
989     ACPI_SIZE               RequiredLength);
990 
991 #ifdef ACPI_DBG_TRACK_ALLOCATIONS
992 void *
993 AcpiUtAllocateAndTrack (
994     ACPI_SIZE               Size,
995     UINT32                  Component,
996     const char              *Module,
997     UINT32                  Line);
998 
999 void *
1000 AcpiUtAllocateZeroedAndTrack (
1001     ACPI_SIZE               Size,
1002     UINT32                  Component,
1003     const char              *Module,
1004     UINT32                  Line);
1005 
1006 void
1007 AcpiUtFreeAndTrack (
1008     void                    *Address,
1009     UINT32                  Component,
1010     const char              *Module,
1011     UINT32                  Line);
1012 
1013 void
1014 AcpiUtDumpAllocationInfo (
1015     void);
1016 
1017 void
1018 AcpiUtDumpAllocations (
1019     UINT32                  Component,
1020     const char              *Module);
1021 
1022 ACPI_STATUS
1023 AcpiUtCreateList (
1024     char                    *ListName,
1025     UINT16                  ObjectSize,
1026     ACPI_MEMORY_LIST        **ReturnCache);
1027 
1028 #endif /* ACPI_DBG_TRACK_ALLOCATIONS */
1029 
1030 /*
1031  * utaddress - address range check
1032  */
1033 ACPI_STATUS
1034 AcpiUtAddAddressRange (
1035     ACPI_ADR_SPACE_TYPE     SpaceId,
1036     ACPI_PHYSICAL_ADDRESS   Address,
1037     UINT32                  Length,
1038     ACPI_NAMESPACE_NODE     *RegionNode);
1039 
1040 void
1041 AcpiUtRemoveAddressRange (
1042     ACPI_ADR_SPACE_TYPE     SpaceId,
1043     ACPI_NAMESPACE_NODE     *RegionNode);
1044 
1045 UINT32
1046 AcpiUtCheckAddressRange (
1047     ACPI_ADR_SPACE_TYPE     SpaceId,
1048     ACPI_PHYSICAL_ADDRESS   Address,
1049     UINT32                  Length,
1050     BOOLEAN                 Warn);
1051 
1052 void
1053 AcpiUtDeleteAddressLists (
1054     void);
1055 
1056 /*
1057  * utxferror - various error/warning output functions
1058  */
1059 void ACPI_INTERNAL_VAR_XFACE
1060 AcpiUtPredefinedWarning (
1061     const char              *ModuleName,
1062     UINT32                  LineNumber,
1063     char                    *Pathname,
1064     UINT8                   NodeFlags,
1065     const char              *Format,
1066     ...);
1067 
1068 void ACPI_INTERNAL_VAR_XFACE
1069 AcpiUtPredefinedInfo (
1070     const char              *ModuleName,
1071     UINT32                  LineNumber,
1072     char                    *Pathname,
1073     UINT8                   NodeFlags,
1074     const char              *Format,
1075     ...);
1076 
1077 void ACPI_INTERNAL_VAR_XFACE
1078 AcpiUtPredefinedBiosError (
1079     const char              *ModuleName,
1080     UINT32                  LineNumber,
1081     char                    *Pathname,
1082     UINT8                   NodeFlags,
1083     const char              *Format,
1084     ...);
1085 
1086 void
1087 AcpiUtNamespaceError (
1088     const char              *ModuleName,
1089     UINT32                  LineNumber,
1090     const char              *InternalName,
1091     ACPI_STATUS             LookupStatus);
1092 
1093 void
1094 AcpiUtMethodError (
1095     const char              *ModuleName,
1096     UINT32                  LineNumber,
1097     const char              *Message,
1098     ACPI_NAMESPACE_NODE     *Node,
1099     const char              *Path,
1100     ACPI_STATUS             LookupStatus);
1101 
1102 /*
1103  * Utility functions for ACPI names and IDs
1104  */
1105 const AH_PREDEFINED_NAME *
1106 AcpiAhMatchPredefinedName (
1107     char                    *Nameseg);
1108 
1109 const AH_DEVICE_ID *
1110 AcpiAhMatchHardwareId (
1111     char                    *Hid);
1112 
1113 #endif /* _ACUTILS_H */
1114