sys/contrib/dev/acpica/acutils.h

   1 /******************************************************************************
   2  *
   3  * Name: acutils.h -- prototypes for the common (subsystem-wide) procedures
   4  *       $Revision: 164 $
   5  *
   6  *****************************************************************************/
   7
   8 /******************************************************************************
   9  *
  10  * 1. Copyright Notice
  11  *
  12  * Some or all of this work - Copyright (c) 1999 - 2005, Intel Corp.
  13  * All rights reserved.
  14  *
  15  * 2. License
  16  *
  17  * 2.1. This is your license from Intel Corp. under its intellectual property
  18  * rights.  You may have additional license terms from the party that provided
  19  * you this software, covering your right to use that party's intellectual
  20  * property rights.
  21  *
  22  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
  23  * copy of the source code appearing in this file ("Covered Code") an
  24  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
  25  * base code distributed originally by Intel ("Original Intel Code") to copy,
  26  * make derivatives, distribute, use and display any portion of the Covered
  27  * Code in any form, with the right to sublicense such rights; and
  28  *
  29  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
  30  * license (with the right to sublicense), under only those claims of Intel
  31  * patents that are infringed by the Original Intel Code, to make, use, sell,
  32  * offer to sell, and import the Covered Code and derivative works thereof
  33  * solely to the minimum extent necessary to exercise the above copyright
  34  * license, and in no event shall the patent license extend to any additions
  35  * to or modifications of the Original Intel Code.  No other license or right
  36  * is granted directly or by implication, estoppel or otherwise;
  37  *
  38  * The above copyright and patent license is granted only if the following
  39  * conditions are met:
  40  *
  41  * 3. Conditions
  42  *
  43  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
  44  * Redistribution of source code of any substantial portion of the Covered
  45  * Code or modification with rights to further distribute source must include
  46  * the above Copyright Notice, the above License, this list of Conditions,
  47  * and the following Disclaimer and Export Compliance provision.  In addition,
  48  * Licensee must cause all Covered Code to which Licensee contributes to
  49  * contain a file documenting the changes Licensee made to create that Covered
  50  * Code and the date of any change.  Licensee must include in that file the
  51  * documentation of any changes made by any predecessor Licensee.  Licensee
  52  * must include a prominent statement that the modification is derived,
  53  * directly or indirectly, from Original Intel Code.
  54  *
  55  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
  56  * Redistribution of source code of any substantial portion of the Covered
  57  * Code or modification without rights to further distribute source must
  58  * include the following Disclaimer and Export Compliance provision in the
  59  * documentation and/or other materials provided with distribution.  In
  60  * addition, Licensee may not authorize further sublicense of source of any
  61  * portion of the Covered Code, and must include terms to the effect that the
  62  * license from Licensee to its licensee is limited to the intellectual
  63  * property embodied in the software Licensee provides to its licensee, and
  64  * not to intellectual property embodied in modifications its licensee may
  65  * make.
  66  *
  67  * 3.3. Redistribution of Executable. Redistribution in executable form of any
  68  * substantial portion of the Covered Code or modification must reproduce the
  69  * above Copyright Notice, and the following Disclaimer and Export Compliance
  70  * provision in the documentation and/or other materials provided with the
  71  * distribution.
  72  *
  73  * 3.4. Intel retains all right, title, and interest in and to the Original
  74  * Intel Code.
  75  *
  76  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
  77  * Intel shall be used in advertising or otherwise to promote the sale, use or
  78  * other dealings in products derived from or relating to the Covered Code
  79  * without prior written authorization from Intel.
  80  *
  81  * 4. Disclaimer and Export Compliance
  82  *
  83  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
  84  * HERE.  ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
  85  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT,  ASSISTANCE,
  86  * INSTALLATION, TRAINING OR OTHER SERVICES.  INTEL WILL NOT PROVIDE ANY
  87  * UPDATES, ENHANCEMENTS OR EXTENSIONS.  INTEL SPECIFICALLY DISCLAIMS ANY
  88  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
  89  * PARTICULAR PURPOSE.
  90  *
  91  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
  92  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
  93  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
  94  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
  95  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
  96  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS
  97  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
  98  * LIMITED REMEDY.
  99  *
 100  * 4.3. Licensee shall not export, either directly or indirectly, any of this
 101  * software or system incorporating such software without first obtaining any
 102  * required license or other approval from the U. S. Department of Commerce or
 103  * any other agency or department of the United States Government.  In the
 104  * event Licensee exports any such software from the United States or
 105  * re-exports any such software from a foreign destination, Licensee shall
 106  * ensure that the distribution and export/re-export of the software is in
 107  * compliance with all laws, regulations, orders, or other restrictions of the
 108  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
 109  * any of its subsidiaries will export/re-export any technical data, process,
 110  * software, or service, directly or indirectly, to any country for which the
 111  * United States government or any agency thereof requires an export license,
 112  * other governmental approval, or letter of assurance, without first obtaining
 113  * such license, approval or letter.
 114  *
 115  *****************************************************************************/
 116
 117 #ifndef _ACUTILS_H
 118 #define _ACUTILS_H
 119
 120
 121 typedef
 122 ACPI_STATUS (*ACPI_PKG_CALLBACK) (
 123     UINT8                   ObjectType,
 124     ACPI_OPERAND_OBJECT     *SourceObject,
 125     ACPI_GENERIC_STATE      *State,
 126     void                    *Context);
 127
 128 typedef struct acpi_pkg_info
 129 {
 130     UINT8                   *FreeSpace;
 131     ACPI_SIZE               Length;
 132     UINT32                  ObjectSpace;
 133     UINT32                  NumPackages;
 134
 135 } ACPI_PKG_INFO;
 136
 137 #define REF_INCREMENT       (UINT16) 0
 138 #define REF_DECREMENT       (UINT16) 1
 139 #define REF_FORCE_DELETE    (UINT16) 2
 140
 141 /* AcpiUtDumpBuffer */
 142
 143 #define DB_BYTE_DISPLAY     1
 144 #define DB_WORD_DISPLAY     2
 145 #define DB_DWORD_DISPLAY    4
 146 #define DB_QWORD_DISPLAY    8
 147
 148
 149 /*
 150  * utglobal - Global data structures and procedures
 151  */
 152 void
 153 AcpiUtInitGlobals (
 154     void);
 155
 156 #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
 157
 158 char *
 159 AcpiUtGetMutexName (
 160     UINT32                  MutexId);
 161
 162 #endif
 163
 164 char *
 165 AcpiUtGetTypeName (
 166     ACPI_OBJECT_TYPE        Type);
 167
 168 char *
 169 AcpiUtGetNodeName (
 170     void                    *Object);
 171
 172 char *
 173 AcpiUtGetDescriptorName (
 174     void                    *Object);
 175
 176 char *
 177 AcpiUtGetObjectTypeName (
 178     ACPI_OPERAND_OBJECT     *ObjDesc);
 179
 180 char *
 181 AcpiUtGetRegionName (
 182     UINT8                   SpaceId);
 183
 184 char *
 185 AcpiUtGetEventName (
 186     UINT32                  EventId);
 187
 188 char
 189 AcpiUtHexToAsciiChar (
 190     ACPI_INTEGER            Integer,
 191     UINT32                  Position);
 192
 193 BOOLEAN
 194 AcpiUtValidObjectType (
 195     ACPI_OBJECT_TYPE        Type);
 196
 197
 198 /*
 199  * utinit - miscellaneous initialization and shutdown
 200  */
 201 ACPI_STATUS
 202 AcpiUtHardwareInitialize (
 203     void);
 204
 205 void
 206 AcpiUtSubsystemShutdown (
 207     void);
 208
 209 ACPI_STATUS
 210 AcpiUtValidateFadt (
 211     void);
 212
 213
 214 /*
 215  * utclib - Local implementations of C library functions
 216  */
 217 #ifndef ACPI_USE_SYSTEM_CLIBRARY
 218
 219 ACPI_SIZE
 220 AcpiUtStrlen (
 221     const char              *String);
 222
 223 char *
 224 AcpiUtStrcpy (
 225     char                    *DstString,
 226     const char              *SrcString);
 227
 228 char *
 229 AcpiUtStrncpy (
 230     char                    *DstString,
 231     const char              *SrcString,
 232     ACPI_SIZE               Count);
 233
 234 int
 235 AcpiUtMemcmp (
 236     const char              *Buffer1,
 237     const char              *Buffer2,
 238     ACPI_SIZE               Count);
 239
 240 int
 241 AcpiUtStrncmp (
 242     const char              *String1,
 243     const char              *String2,
 244     ACPI_SIZE               Count);
 245
 246 int
 247 AcpiUtStrcmp (
 248     const char              *String1,
 249     const char              *String2);
 250
 251 char *
 252 AcpiUtStrcat (
 253     char                    *DstString,
 254     const char              *SrcString);
 255
 256 char *
 257 AcpiUtStrncat (
 258     char                    *DstString,
 259     const char              *SrcString,
 260     ACPI_SIZE               Count);
 261
 262 UINT32
 263 AcpiUtStrtoul (
 264     const char              *String,
 265     char                    **Terminator,
 266     UINT32                  Base);
 267
 268 char *
 269 AcpiUtStrstr (
 270     char                    *String1,
 271     char                    *String2);
 272
 273 void *
 274 AcpiUtMemcpy (
 275     void                    *Dest,
 276     const void              *Src,
 277     ACPI_SIZE               Count);
 278
 279 void *
 280 AcpiUtMemset (
 281     void                    *Dest,
 282     ACPI_NATIVE_UINT        Value,
 283     ACPI_SIZE               Count);
 284
 285 int
 286 AcpiUtToUpper (
 287     int                     c);
 288
 289 int
 290 AcpiUtToLower (
 291     int                     c);
 292
 293 extern const UINT8 _acpi_ctype[];
 294
 295 #define _ACPI_XA     0x00    /* extra alphabetic - not supported */
 296 #define _ACPI_XS     0x40    /* extra space */
 297 #define _ACPI_BB     0x00    /* BEL, BS, etc. - not supported */
 298 #define _ACPI_CN     0x20    /* CR, FF, HT, NL, VT */
 299 #define _ACPI_DI     0x04    /* '0'-'9' */
 300 #define _ACPI_LO     0x02    /* 'a'-'z' */
 301 #define _ACPI_PU     0x10    /* punctuation */
 302 #define _ACPI_SP     0x08    /* space */
 303 #define _ACPI_UP     0x01    /* 'A'-'Z' */
 304 #define _ACPI_XD     0x80    /* '0'-'9', 'A'-'F', 'a'-'f' */
 305
 306 #define ACPI_IS_DIGIT(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_DI))
 307 #define ACPI_IS_SPACE(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_SP))
 308 #define ACPI_IS_XDIGIT(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_XD))
 309 #define ACPI_IS_UPPER(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_UP))
 310 #define ACPI_IS_LOWER(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO))
 311 #define ACPI_IS_PRINT(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP | _ACPI_DI | _ACPI_SP | _ACPI_PU))
 312 #define ACPI_IS_ALPHA(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP))
 313
 314 #endif /* ACPI_USE_SYSTEM_CLIBRARY */
 315
 316
 317 /*
 318  * utcopy - Object construction and conversion interfaces
 319  */
 320 ACPI_STATUS
 321 AcpiUtBuildSimpleObject(
 322     ACPI_OPERAND_OBJECT     *Obj,
 323     ACPI_OBJECT             *UserObj,
 324     UINT8                   *DataSpace,
 325     UINT32                  *BufferSpaceUsed);
 326
 327 ACPI_STATUS
 328 AcpiUtBuildPackageObject (
 329     ACPI_OPERAND_OBJECT     *Obj,
 330     UINT8                   *Buffer,
 331     UINT32                  *SpaceUsed);
 332
 333 ACPI_STATUS
 334 AcpiUtCopyIobjectToEobject (
 335     ACPI_OPERAND_OBJECT     *Obj,
 336     ACPI_BUFFER             *RetBuffer);
 337
 338 ACPI_STATUS
 339 AcpiUtCopyEobjectToIobject (
 340     ACPI_OBJECT             *Obj,
 341     ACPI_OPERAND_OBJECT     **InternalObj);
 342
 343 ACPI_STATUS
 344 AcpiUtCopyISimpleToIsimple (
 345     ACPI_OPERAND_OBJECT     *SourceObj,
 346     ACPI_OPERAND_OBJECT     *DestObj);
 347
 348 ACPI_STATUS
 349 AcpiUtCopyIobjectToIobject (
 350     ACPI_OPERAND_OBJECT     *SourceDesc,
 351     ACPI_OPERAND_OBJECT     **DestDesc,
 352     ACPI_WALK_STATE         *WalkState);
 353
 354
 355 /*
 356  * utcreate - Object creation
 357  */
 358 ACPI_STATUS
 359 AcpiUtUpdateObjectReference (
 360     ACPI_OPERAND_OBJECT     *Object,
 361     UINT16                  Action);
 362
 363
 364 /*
 365  * utdebug - Debug interfaces
 366  */
 367 void
 368 AcpiUtInitStackPtrTrace (
 369     void);
 370
 371 void
 372 AcpiUtTrackStackPtr (
 373     void);
 374
 375 void
 376 AcpiUtTrace (
 377     UINT32                  LineNumber,
 378     const char              *FunctionName,
 379     char                    *ModuleName,
 380     UINT32                  ComponentId);
 381
 382 void
 383 AcpiUtTracePtr (
 384     UINT32                  LineNumber,
 385     const char              *FunctionName,
 386     char                    *ModuleName,
 387     UINT32                  ComponentId,
 388     void                    *Pointer);
 389
 390 void
 391 AcpiUtTraceU32 (
 392     UINT32                  LineNumber,
 393     const char              *FunctionName,
 394     char                    *ModuleName,
 395     UINT32                  ComponentId,
 396     UINT32                  Integer);
 397
 398 void
 399 AcpiUtTraceStr (
 400     UINT32                  LineNumber,
 401     const char              *FunctionName,
 402     char                    *ModuleName,
 403     UINT32                  ComponentId,
 404     char                    *String);
 405
 406 void
 407 AcpiUtExit (
 408     UINT32                  LineNumber,
 409     const char              *FunctionName,
 410     char                    *ModuleName,
 411     UINT32                  ComponentId);
 412
 413 void
 414 AcpiUtStatusExit (
 415     UINT32                  LineNumber,
 416     const char              *FunctionName,
 417     char                    *ModuleName,
 418     UINT32                  ComponentId,
 419     ACPI_STATUS             Status);
 420
 421 void
 422 AcpiUtValueExit (
 423     UINT32                  LineNumber,
 424     const char              *FunctionName,
 425     char                    *ModuleName,
 426     UINT32                  ComponentId,
 427     ACPI_INTEGER            Value);
 428
 429 void
 430 AcpiUtPtrExit (
 431     UINT32                  LineNumber,
 432     const char              *FunctionName,
 433     char                    *ModuleName,
 434     UINT32                  ComponentId,
 435     UINT8                   *Ptr);
 436
 437 void
 438 AcpiUtReportInfo (
 439     char                    *ModuleName,
 440     UINT32                  LineNumber,
 441     UINT32                  ComponentId);
 442
 443 void
 444 AcpiUtReportError (
 445     char                    *ModuleName,
 446     UINT32                  LineNumber,
 447     UINT32                  ComponentId);
 448
 449 void
 450 AcpiUtReportWarning (
 451     char                    *ModuleName,
 452     UINT32                  LineNumber,
 453     UINT32                  ComponentId);
 454
 455 void
 456 AcpiUtDumpBuffer (
 457     UINT8                   *Buffer,
 458     UINT32                  Count,
 459     UINT32                  Display,
 460     UINT32                  componentId);
 461
 462 void ACPI_INTERNAL_VAR_XFACE
 463 AcpiUtDebugPrint (
 464     UINT32                  RequestedDebugLevel,
 465     UINT32                  LineNumber,
 466     const char              *FunctionName,
 467     char                    *ModuleName,
 468     UINT32                  ComponentId,
 469     char                    *Format,
 470     ...) ACPI_PRINTF_LIKE_FUNC;
 471
 472 void ACPI_INTERNAL_VAR_XFACE
 473 AcpiUtDebugPrintRaw (
 474     UINT32                  RequestedDebugLevel,
 475     UINT32                  LineNumber,
 476     const char              *FunctionName,
 477     char                    *ModuleName,
 478     UINT32                  ComponentId,
 479     char                    *Format,
 480     ...) ACPI_PRINTF_LIKE_FUNC;
 481
 482
 483 /*
 484  * utdelete - Object deletion and reference counts
 485  */
 486 void
 487 AcpiUtAddReference (
 488     ACPI_OPERAND_OBJECT     *Object);
 489
 490 void
 491 AcpiUtRemoveReference (
 492     ACPI_OPERAND_OBJECT     *Object);
 493
 494 void
 495 AcpiUtDeleteInternalPackageObject (
 496     ACPI_OPERAND_OBJECT     *Object);
 497
 498 void
 499 AcpiUtDeleteInternalSimpleObject (
 500     ACPI_OPERAND_OBJECT     *Object);
 501
 502 void
 503 AcpiUtDeleteInternalObjectList (
 504     ACPI_OPERAND_OBJECT     **ObjList);
 505
 506
 507 /*
 508  * uteval - object evaluation
 509  */
 510 ACPI_STATUS
 511 AcpiUtOsiImplementation (
 512     ACPI_WALK_STATE         *WalkState);
 513
 514 ACPI_STATUS
 515 AcpiUtEvaluateObject (
 516     ACPI_NAMESPACE_NODE     *PrefixNode,
 517     char                    *Path,
 518     UINT32                  ExpectedReturnBtypes,
 519     ACPI_OPERAND_OBJECT     **ReturnDesc);
 520
 521 ACPI_STATUS
 522 AcpiUtEvaluateNumericObject (
 523     char                    *ObjectName,
 524     ACPI_NAMESPACE_NODE     *DeviceNode,
 525     ACPI_INTEGER            *Address);
 526
 527 ACPI_STATUS
 528 AcpiUtExecute_HID (
 529     ACPI_NAMESPACE_NODE     *DeviceNode,
 530     ACPI_DEVICE_ID          *Hid);
 531
 532 ACPI_STATUS
 533 AcpiUtExecute_CID (
 534     ACPI_NAMESPACE_NODE     *DeviceNode,
 535     ACPI_COMPATIBLE_ID_LIST **ReturnCidList);
 536
 537 ACPI_STATUS
 538 AcpiUtExecute_STA (
 539     ACPI_NAMESPACE_NODE     *DeviceNode,
 540     UINT32                  *StatusFlags);
 541
 542 ACPI_STATUS
 543 AcpiUtExecute_UID (
 544     ACPI_NAMESPACE_NODE     *DeviceNode,
 545     ACPI_DEVICE_ID          *Uid);
 546
 547 ACPI_STATUS
 548 AcpiUtExecute_Sxds (
 549     ACPI_NAMESPACE_NODE     *DeviceNode,
 550     UINT8                   *Highest);
 551
 552
 553 /*
 554  * utobject - internal object create/delete/cache routines
 555  */
 556 ACPI_OPERAND_OBJECT  *
 557 AcpiUtCreateInternalObjectDbg (
 558     char                    *ModuleName,
 559     UINT32                  LineNumber,
 560     UINT32                  ComponentId,
 561     ACPI_OBJECT_TYPE        Type);
 562
 563 void *
 564 AcpiUtAllocateObjectDescDbg (
 565     char                    *ModuleName,
 566     UINT32                  LineNumber,
 567     UINT32                  ComponentId);
 568
 569 #define AcpiUtCreateInternalObject(t)   AcpiUtCreateInternalObjectDbg (_AcpiModuleName,__LINE__,_COMPONENT,t)
 570 #define AcpiUtAllocateObjectDesc()      AcpiUtAllocateObjectDescDbg (_AcpiModuleName,__LINE__,_COMPONENT)
 571
 572 void
 573 AcpiUtDeleteObjectDesc (
 574     ACPI_OPERAND_OBJECT     *Object);
 575
 576 BOOLEAN
 577 AcpiUtValidInternalObject (
 578     void                    *Object);
 579
 580 ACPI_OPERAND_OBJECT *
 581 AcpiUtCreateBufferObject (
 582     ACPI_SIZE               BufferSize);
 583
 584 ACPI_OPERAND_OBJECT *
 585 AcpiUtCreateStringObject (
 586     ACPI_SIZE               StringSize);
 587
 588 ACPI_STATUS
 589 AcpiUtGetObjectSize(
 590     ACPI_OPERAND_OBJECT     *Obj,
 591     ACPI_SIZE               *ObjLength);
 592
 593
 594 /*
 595  * utstate - Generic state creation/cache routines
 596  */
 597 void
 598 AcpiUtPushGenericState (
 599     ACPI_GENERIC_STATE      **ListHead,
 600     ACPI_GENERIC_STATE      *State);
 601
 602 ACPI_GENERIC_STATE *
 603 AcpiUtPopGenericState (
 604     ACPI_GENERIC_STATE      **ListHead);
 605
 606
 607 ACPI_GENERIC_STATE *
 608 AcpiUtCreateGenericState (
 609     void);
 610
 611 ACPI_THREAD_STATE *
 612 AcpiUtCreateThreadState (
 613     void);
 614
 615 ACPI_GENERIC_STATE *
 616 AcpiUtCreateUpdateState (
 617     ACPI_OPERAND_OBJECT     *Object,
 618     UINT16                  Action);
 619
 620 ACPI_GENERIC_STATE *
 621 AcpiUtCreatePkgState (
 622     void                    *InternalObject,
 623     void                    *ExternalObject,
 624     UINT16                  Index);
 625
 626 ACPI_STATUS
 627 AcpiUtCreateUpdateStateAndPush (
 628     ACPI_OPERAND_OBJECT     *Object,
 629     UINT16                  Action,
 630     ACPI_GENERIC_STATE      **StateList);
 631
 632 ACPI_STATUS
 633 AcpiUtCreatePkgStateAndPush (
 634     void                    *InternalObject,
 635     void                    *ExternalObject,
 636     UINT16                  Index,
 637     ACPI_GENERIC_STATE      **StateList);
 638
 639 ACPI_GENERIC_STATE *
 640 AcpiUtCreateControlState (
 641     void);
 642
 643 void
 644 AcpiUtDeleteGenericState (
 645     ACPI_GENERIC_STATE      *State);
 646
 647
 648 /*
 649  * utmath
 650  */
 651 ACPI_STATUS
 652 AcpiUtDivide (
 653     ACPI_INTEGER            InDividend,
 654     ACPI_INTEGER            InDivisor,
 655     ACPI_INTEGER            *OutQuotient,
 656     ACPI_INTEGER            *OutRemainder);
 657
 658 ACPI_STATUS
 659 AcpiUtShortDivide (
 660     ACPI_INTEGER            InDividend,
 661     UINT32                  Divisor,
 662     ACPI_INTEGER            *OutQuotient,
 663     UINT32                  *OutRemainder);
 664
 665 /*
 666  * utmisc
 667  */
 668 ACPI_STATUS
 669 AcpiUtAllocateOwnerId (
 670     ACPI_OWNER_ID           *OwnerId);
 671
 672 void
 673 AcpiUtReleaseOwnerId (
 674     ACPI_OWNER_ID           *OwnerId);
 675
 676 ACPI_STATUS
 677 AcpiUtWalkPackageTree (
 678     ACPI_OPERAND_OBJECT     *SourceObject,
 679     void                    *TargetObject,
 680     ACPI_PKG_CALLBACK       WalkCallback,
 681     void                    *Context);
 682
 683 void
 684 AcpiUtStrupr (
 685     char                    *SrcString);
 686
 687 void
 688 AcpiUtPrintString (
 689     char                    *String,
 690     UINT8                   MaxLength);
 691
 692 BOOLEAN
 693 AcpiUtValidAcpiName (
 694     UINT32                  Name);
 695
 696 BOOLEAN
 697 AcpiUtValidAcpiCharacter (
 698     char                    Character);
 699
 700 ACPI_STATUS
 701 AcpiUtStrtoul64 (
 702     char                    *String,
 703     UINT32                  Base,
 704     ACPI_INTEGER            *RetInteger);
 705
 706 /* Values for Base above (16=Hex, 10=Decimal) */
 707
 708 #define ACPI_ANY_BASE        0
 709
 710 UINT32
 711 AcpiUtGetDescriptorLength (
 712     void                    *Aml);
 713
 714 UINT16
 715 AcpiUtGetResourceLength (
 716     void                    *Aml);
 717
 718 UINT8
 719 AcpiUtGetResourceType (
 720     void                    *Aml);
 721
 722 UINT8 *
 723 AcpiUtGetResourceEndTag (
 724     ACPI_OPERAND_OBJECT     *ObjDesc);
 725
 726 UINT8
 727 AcpiUtGenerateChecksum (
 728     UINT8                   *Buffer,
 729     UINT32                  Length);
 730
 731 UINT32
 732 AcpiUtDwordByteSwap (
 733     UINT32                  Value);
 734
 735 void
 736 AcpiUtSetIntegerWidth (
 737     UINT8                   Revision);
 738
 739 #ifdef ACPI_DEBUG_OUTPUT
 740 void
 741 AcpiUtDisplayInitPathname (
 742     UINT8                   Type,
 743     ACPI_NAMESPACE_NODE     *ObjHandle,
 744     char                    *Path);
 745
 746 #endif
 747
 748
 749 /*
 750  * utmutex - mutex support
 751  */
 752 ACPI_STATUS
 753 AcpiUtMutexInitialize (
 754     void);
 755
 756 void
 757 AcpiUtMutexTerminate (
 758     void);
 759
 760 ACPI_STATUS
 761 AcpiUtAcquireMutex (
 762     ACPI_MUTEX_HANDLE       MutexId);
 763
 764 ACPI_STATUS
 765 AcpiUtReleaseMutex (
 766     ACPI_MUTEX_HANDLE       MutexId);
 767
 768
 769 /*
 770  * utalloc - memory allocation and object caching
 771  */
 772 ACPI_STATUS
 773 AcpiUtCreateCaches (
 774     void);
 775
 776 ACPI_STATUS
 777 AcpiUtDeleteCaches (
 778     void);
 779
 780 ACPI_STATUS
 781 AcpiUtValidateBuffer (
 782     ACPI_BUFFER             *Buffer);
 783
 784 ACPI_STATUS
 785 AcpiUtInitializeBuffer (
 786     ACPI_BUFFER             *Buffer,
 787     ACPI_SIZE               RequiredLength);
 788
 789 void *
 790 AcpiUtAllocate (
 791     ACPI_SIZE               Size,
 792     UINT32                  Component,
 793     char                    *Module,
 794     UINT32                  Line);
 795
 796 void *
 797 AcpiUtCallocate (
 798     ACPI_SIZE               Size,
 799     UINT32                  Component,
 800     char                    *Module,
 801     UINT32                  Line);
 802
 803 #ifdef ACPI_DBG_TRACK_ALLOCATIONS
 804 void *
 805 AcpiUtAllocateAndTrack (
 806     ACPI_SIZE               Size,
 807     UINT32                  Component,
 808     char                    *Module,
 809     UINT32                  Line);
 810
 811 void *
 812 AcpiUtCallocateAndTrack (
 813     ACPI_SIZE               Size,
 814     UINT32                  Component,
 815     char                    *Module,
 816     UINT32                  Line);
 817
 818 void
 819 AcpiUtFreeAndTrack (
 820     void                    *Address,
 821     UINT32                  Component,
 822     char                    *Module,
 823     UINT32                  Line);
 824
 825 void
 826 AcpiUtDumpAllocationInfo (
 827     void);
 828
 829 void
 830 AcpiUtDumpAllocations (
 831     UINT32                  Component,
 832     char                    *Module);
 833 #endif
 834
 835 #endif /* _ACUTILS_H */