Home | History | Annotate | Line # | Download | only in utilities
utdebug.c revision 1.4.2.2
      1  1.4.2.2  rmind /******************************************************************************
      2  1.4.2.2  rmind  *
      3  1.4.2.2  rmind  * Module Name: utdebug - Debug print routines
      4  1.4.2.2  rmind  *
      5  1.4.2.2  rmind  *****************************************************************************/
      6  1.4.2.2  rmind 
      7  1.4.2.2  rmind /*
      8  1.4.2.2  rmind  * Copyright (C) 2000 - 2011, Intel Corp.
      9  1.4.2.2  rmind  * All rights reserved.
     10  1.4.2.2  rmind  *
     11  1.4.2.2  rmind  * Redistribution and use in source and binary forms, with or without
     12  1.4.2.2  rmind  * modification, are permitted provided that the following conditions
     13  1.4.2.2  rmind  * are met:
     14  1.4.2.2  rmind  * 1. Redistributions of source code must retain the above copyright
     15  1.4.2.2  rmind  *    notice, this list of conditions, and the following disclaimer,
     16  1.4.2.2  rmind  *    without modification.
     17  1.4.2.2  rmind  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.4.2.2  rmind  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.4.2.2  rmind  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.4.2.2  rmind  *    including a substantially similar Disclaimer requirement for further
     21  1.4.2.2  rmind  *    binary redistribution.
     22  1.4.2.2  rmind  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.4.2.2  rmind  *    of any contributors may be used to endorse or promote products derived
     24  1.4.2.2  rmind  *    from this software without specific prior written permission.
     25  1.4.2.2  rmind  *
     26  1.4.2.2  rmind  * Alternatively, this software may be distributed under the terms of the
     27  1.4.2.2  rmind  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.4.2.2  rmind  * Software Foundation.
     29  1.4.2.2  rmind  *
     30  1.4.2.2  rmind  * NO WARRANTY
     31  1.4.2.2  rmind  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.4.2.2  rmind  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.4.2.2  rmind  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.4.2.2  rmind  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.4.2.2  rmind  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.4.2.2  rmind  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.4.2.2  rmind  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.4.2.2  rmind  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.4.2.2  rmind  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.4.2.2  rmind  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.4.2.2  rmind  * POSSIBILITY OF SUCH DAMAGES.
     42  1.4.2.2  rmind  */
     43  1.4.2.2  rmind 
     44  1.4.2.2  rmind #define __UTDEBUG_C__
     45  1.4.2.2  rmind 
     46  1.4.2.2  rmind #include "acpi.h"
     47  1.4.2.2  rmind #include "accommon.h"
     48  1.4.2.2  rmind 
     49  1.4.2.2  rmind #define _COMPONENT          ACPI_UTILITIES
     50  1.4.2.2  rmind         ACPI_MODULE_NAME    ("utdebug")
     51  1.4.2.2  rmind 
     52  1.4.2.2  rmind 
     53  1.4.2.2  rmind #ifdef ACPI_DEBUG_OUTPUT
     54  1.4.2.2  rmind 
     55  1.4.2.2  rmind static ACPI_THREAD_ID       AcpiGbl_PrevThreadId = (ACPI_THREAD_ID) 0xFFFFFFFF;
     56  1.4.2.2  rmind static const char           *AcpiGbl_FnEntryStr = "----Entry";
     57  1.4.2.2  rmind static const char           *AcpiGbl_FnExitStr  = "----Exit-";
     58  1.4.2.2  rmind 
     59  1.4.2.2  rmind /* Local prototypes */
     60  1.4.2.2  rmind 
     61  1.4.2.2  rmind static const char *
     62  1.4.2.2  rmind AcpiUtTrimFunctionName (
     63  1.4.2.2  rmind     const char              *FunctionName);
     64  1.4.2.2  rmind 
     65  1.4.2.2  rmind 
     66  1.4.2.2  rmind /*******************************************************************************
     67  1.4.2.2  rmind  *
     68  1.4.2.2  rmind  * FUNCTION:    AcpiUtInitStackPtrTrace
     69  1.4.2.2  rmind  *
     70  1.4.2.2  rmind  * PARAMETERS:  None
     71  1.4.2.2  rmind  *
     72  1.4.2.2  rmind  * RETURN:      None
     73  1.4.2.2  rmind  *
     74  1.4.2.2  rmind  * DESCRIPTION: Save the current CPU stack pointer at subsystem startup
     75  1.4.2.2  rmind  *
     76  1.4.2.2  rmind  ******************************************************************************/
     77  1.4.2.2  rmind 
     78  1.4.2.2  rmind void
     79  1.4.2.2  rmind AcpiUtInitStackPtrTrace (
     80  1.4.2.2  rmind     void)
     81  1.4.2.2  rmind {
     82  1.4.2.2  rmind     ACPI_SIZE               CurrentSp;
     83  1.4.2.2  rmind 
     84  1.4.2.2  rmind 
     85  1.4.2.2  rmind     AcpiGbl_EntryStackPointer = &CurrentSp;
     86  1.4.2.2  rmind }
     87  1.4.2.2  rmind 
     88  1.4.2.2  rmind 
     89  1.4.2.2  rmind /*******************************************************************************
     90  1.4.2.2  rmind  *
     91  1.4.2.2  rmind  * FUNCTION:    AcpiUtTrackStackPtr
     92  1.4.2.2  rmind  *
     93  1.4.2.2  rmind  * PARAMETERS:  None
     94  1.4.2.2  rmind  *
     95  1.4.2.2  rmind  * RETURN:      None
     96  1.4.2.2  rmind  *
     97  1.4.2.2  rmind  * DESCRIPTION: Save the current CPU stack pointer
     98  1.4.2.2  rmind  *
     99  1.4.2.2  rmind  ******************************************************************************/
    100  1.4.2.2  rmind 
    101  1.4.2.2  rmind void
    102  1.4.2.2  rmind AcpiUtTrackStackPtr (
    103  1.4.2.2  rmind     void)
    104  1.4.2.2  rmind {
    105  1.4.2.2  rmind     ACPI_SIZE               CurrentSp;
    106  1.4.2.2  rmind 
    107  1.4.2.2  rmind 
    108  1.4.2.2  rmind     if (&CurrentSp < AcpiGbl_LowestStackPointer)
    109  1.4.2.2  rmind     {
    110  1.4.2.2  rmind         AcpiGbl_LowestStackPointer = &CurrentSp;
    111  1.4.2.2  rmind     }
    112  1.4.2.2  rmind 
    113  1.4.2.2  rmind     if (AcpiGbl_NestingLevel > AcpiGbl_DeepestNesting)
    114  1.4.2.2  rmind     {
    115  1.4.2.2  rmind         AcpiGbl_DeepestNesting = AcpiGbl_NestingLevel;
    116  1.4.2.2  rmind     }
    117  1.4.2.2  rmind }
    118  1.4.2.2  rmind 
    119  1.4.2.2  rmind 
    120  1.4.2.2  rmind /*******************************************************************************
    121  1.4.2.2  rmind  *
    122  1.4.2.2  rmind  * FUNCTION:    AcpiUtTrimFunctionName
    123  1.4.2.2  rmind  *
    124  1.4.2.2  rmind  * PARAMETERS:  FunctionName        - Ascii string containing a procedure name
    125  1.4.2.2  rmind  *
    126  1.4.2.2  rmind  * RETURN:      Updated pointer to the function name
    127  1.4.2.2  rmind  *
    128  1.4.2.2  rmind  * DESCRIPTION: Remove the "Acpi" prefix from the function name, if present.
    129  1.4.2.2  rmind  *              This allows compiler macros such as __FUNCTION__ to be used
    130  1.4.2.2  rmind  *              with no change to the debug output.
    131  1.4.2.2  rmind  *
    132  1.4.2.2  rmind  ******************************************************************************/
    133  1.4.2.2  rmind 
    134  1.4.2.2  rmind static const char *
    135  1.4.2.2  rmind AcpiUtTrimFunctionName (
    136  1.4.2.2  rmind     const char              *FunctionName)
    137  1.4.2.2  rmind {
    138  1.4.2.2  rmind 
    139  1.4.2.2  rmind     /* All Function names are longer than 4 chars, check is safe */
    140  1.4.2.2  rmind 
    141  1.4.2.2  rmind     if (*(ACPI_CAST_PTR (UINT32, FunctionName)) == ACPI_PREFIX_MIXED)
    142  1.4.2.2  rmind     {
    143  1.4.2.2  rmind         /* This is the case where the original source has not been modified */
    144  1.4.2.2  rmind 
    145  1.4.2.2  rmind         return (FunctionName + 4);
    146  1.4.2.2  rmind     }
    147  1.4.2.2  rmind 
    148  1.4.2.2  rmind     if (*(ACPI_CAST_PTR (UINT32, FunctionName)) == ACPI_PREFIX_LOWER)
    149  1.4.2.2  rmind     {
    150  1.4.2.2  rmind         /* This is the case where the source has been 'linuxized' */
    151  1.4.2.2  rmind 
    152  1.4.2.2  rmind         return (FunctionName + 5);
    153  1.4.2.2  rmind     }
    154  1.4.2.2  rmind 
    155  1.4.2.2  rmind     return (FunctionName);
    156  1.4.2.2  rmind }
    157  1.4.2.2  rmind 
    158  1.4.2.2  rmind 
    159  1.4.2.2  rmind /*******************************************************************************
    160  1.4.2.2  rmind  *
    161  1.4.2.2  rmind  * FUNCTION:    AcpiDebugPrint
    162  1.4.2.2  rmind  *
    163  1.4.2.2  rmind  * PARAMETERS:  RequestedDebugLevel - Requested debug print level
    164  1.4.2.2  rmind  *              LineNumber          - Caller's line number (for error output)
    165  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    166  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    167  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    168  1.4.2.2  rmind  *              Format              - Printf format field
    169  1.4.2.2  rmind  *              ...                 - Optional printf arguments
    170  1.4.2.2  rmind  *
    171  1.4.2.2  rmind  * RETURN:      None
    172  1.4.2.2  rmind  *
    173  1.4.2.2  rmind  * DESCRIPTION: Print error message with prefix consisting of the module name,
    174  1.4.2.2  rmind  *              line number, and component ID.
    175  1.4.2.2  rmind  *
    176  1.4.2.2  rmind  ******************************************************************************/
    177  1.4.2.2  rmind 
    178  1.4.2.2  rmind void  ACPI_INTERNAL_VAR_XFACE
    179  1.4.2.2  rmind AcpiDebugPrint (
    180  1.4.2.2  rmind     UINT32                  RequestedDebugLevel,
    181  1.4.2.2  rmind     UINT32                  LineNumber,
    182  1.4.2.2  rmind     const char              *FunctionName,
    183  1.4.2.2  rmind     const char              *ModuleName,
    184  1.4.2.2  rmind     UINT32                  ComponentId,
    185  1.4.2.2  rmind     const char              *Format,
    186  1.4.2.2  rmind     ...)
    187  1.4.2.2  rmind {
    188  1.4.2.2  rmind     ACPI_THREAD_ID          ThreadId;
    189  1.4.2.2  rmind     va_list                 args;
    190  1.4.2.2  rmind 
    191  1.4.2.2  rmind 
    192  1.4.2.2  rmind     /*
    193  1.4.2.2  rmind      * Stay silent if the debug level or component ID is disabled
    194  1.4.2.2  rmind      */
    195  1.4.2.2  rmind     if (!(RequestedDebugLevel & AcpiDbgLevel) ||
    196  1.4.2.2  rmind         !(ComponentId & AcpiDbgLayer))
    197  1.4.2.2  rmind     {
    198  1.4.2.2  rmind         return;
    199  1.4.2.2  rmind     }
    200  1.4.2.2  rmind 
    201  1.4.2.2  rmind     /*
    202  1.4.2.2  rmind      * Thread tracking and context switch notification
    203  1.4.2.2  rmind      */
    204  1.4.2.2  rmind     ThreadId = AcpiOsGetThreadId ();
    205  1.4.2.2  rmind     if (ThreadId != AcpiGbl_PrevThreadId)
    206  1.4.2.2  rmind     {
    207  1.4.2.2  rmind         if (ACPI_LV_THREADS & AcpiDbgLevel)
    208  1.4.2.2  rmind         {
    209  1.4.2.2  rmind             AcpiOsPrintf (
    210  1.4.2.2  rmind                 "\n**** Context Switch from TID %u to TID %u ****\n\n",
    211  1.4.2.2  rmind                 (UINT32) AcpiGbl_PrevThreadId, (UINT32) ThreadId);
    212  1.4.2.2  rmind         }
    213  1.4.2.2  rmind 
    214  1.4.2.2  rmind         AcpiGbl_PrevThreadId = ThreadId;
    215  1.4.2.2  rmind     }
    216  1.4.2.2  rmind 
    217  1.4.2.2  rmind     /*
    218  1.4.2.2  rmind      * Display the module name, current line number, thread ID (if requested),
    219  1.4.2.2  rmind      * current procedure nesting level, and the current procedure name
    220  1.4.2.2  rmind      */
    221  1.4.2.2  rmind     AcpiOsPrintf ("%8s-%04ld ", ModuleName, LineNumber);
    222  1.4.2.2  rmind 
    223  1.4.2.2  rmind     if (ACPI_LV_THREADS & AcpiDbgLevel)
    224  1.4.2.2  rmind     {
    225  1.4.2.2  rmind         AcpiOsPrintf ("[%u] ", (UINT32) ThreadId);
    226  1.4.2.2  rmind     }
    227  1.4.2.2  rmind 
    228  1.4.2.2  rmind     AcpiOsPrintf ("[%02ld] %-22.22s: ",
    229  1.4.2.2  rmind         AcpiGbl_NestingLevel, AcpiUtTrimFunctionName (FunctionName));
    230  1.4.2.2  rmind 
    231  1.4.2.2  rmind     va_start (args, Format);
    232  1.4.2.2  rmind     AcpiOsVprintf (Format, args);
    233  1.4.2.2  rmind     va_end (args);
    234  1.4.2.2  rmind }
    235  1.4.2.2  rmind 
    236  1.4.2.2  rmind ACPI_EXPORT_SYMBOL (AcpiDebugPrint)
    237  1.4.2.2  rmind 
    238  1.4.2.2  rmind 
    239  1.4.2.2  rmind /*******************************************************************************
    240  1.4.2.2  rmind  *
    241  1.4.2.2  rmind  * FUNCTION:    AcpiDebugPrintRaw
    242  1.4.2.2  rmind  *
    243  1.4.2.2  rmind  * PARAMETERS:  RequestedDebugLevel - Requested debug print level
    244  1.4.2.2  rmind  *              LineNumber          - Caller's line number
    245  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    246  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    247  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    248  1.4.2.2  rmind  *              Format              - Printf format field
    249  1.4.2.2  rmind  *              ...                 - Optional printf arguments
    250  1.4.2.2  rmind  *
    251  1.4.2.2  rmind  * RETURN:      None
    252  1.4.2.2  rmind  *
    253  1.4.2.2  rmind  * DESCRIPTION: Print message with no headers.  Has same interface as
    254  1.4.2.2  rmind  *              DebugPrint so that the same macros can be used.
    255  1.4.2.2  rmind  *
    256  1.4.2.2  rmind  ******************************************************************************/
    257  1.4.2.2  rmind 
    258  1.4.2.2  rmind void  ACPI_INTERNAL_VAR_XFACE
    259  1.4.2.2  rmind AcpiDebugPrintRaw (
    260  1.4.2.2  rmind     UINT32                  RequestedDebugLevel,
    261  1.4.2.2  rmind     UINT32                  LineNumber,
    262  1.4.2.2  rmind     const char              *FunctionName,
    263  1.4.2.2  rmind     const char              *ModuleName,
    264  1.4.2.2  rmind     UINT32                  ComponentId,
    265  1.4.2.2  rmind     const char              *Format,
    266  1.4.2.2  rmind     ...)
    267  1.4.2.2  rmind {
    268  1.4.2.2  rmind     va_list                 args;
    269  1.4.2.2  rmind 
    270  1.4.2.2  rmind 
    271  1.4.2.2  rmind     if (!(RequestedDebugLevel & AcpiDbgLevel) ||
    272  1.4.2.2  rmind         !(ComponentId & AcpiDbgLayer))
    273  1.4.2.2  rmind     {
    274  1.4.2.2  rmind         return;
    275  1.4.2.2  rmind     }
    276  1.4.2.2  rmind 
    277  1.4.2.2  rmind     va_start (args, Format);
    278  1.4.2.2  rmind     AcpiOsVprintf (Format, args);
    279  1.4.2.2  rmind     va_end (args);
    280  1.4.2.2  rmind }
    281  1.4.2.2  rmind 
    282  1.4.2.2  rmind ACPI_EXPORT_SYMBOL (AcpiDebugPrintRaw)
    283  1.4.2.2  rmind 
    284  1.4.2.2  rmind 
    285  1.4.2.2  rmind /*******************************************************************************
    286  1.4.2.2  rmind  *
    287  1.4.2.2  rmind  * FUNCTION:    AcpiUtTrace
    288  1.4.2.2  rmind  *
    289  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    290  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    291  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    292  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    293  1.4.2.2  rmind  *
    294  1.4.2.2  rmind  * RETURN:      None
    295  1.4.2.2  rmind  *
    296  1.4.2.2  rmind  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
    297  1.4.2.2  rmind  *              set in DebugLevel
    298  1.4.2.2  rmind  *
    299  1.4.2.2  rmind  ******************************************************************************/
    300  1.4.2.2  rmind 
    301  1.4.2.2  rmind void
    302  1.4.2.2  rmind AcpiUtTrace (
    303  1.4.2.2  rmind     UINT32                  LineNumber,
    304  1.4.2.2  rmind     const char              *FunctionName,
    305  1.4.2.2  rmind     const char              *ModuleName,
    306  1.4.2.2  rmind     UINT32                  ComponentId)
    307  1.4.2.2  rmind {
    308  1.4.2.2  rmind 
    309  1.4.2.2  rmind     AcpiGbl_NestingLevel++;
    310  1.4.2.2  rmind     AcpiUtTrackStackPtr ();
    311  1.4.2.2  rmind 
    312  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    313  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    314  1.4.2.2  rmind         "%s\n", AcpiGbl_FnEntryStr);
    315  1.4.2.2  rmind }
    316  1.4.2.2  rmind 
    317  1.4.2.2  rmind ACPI_EXPORT_SYMBOL (AcpiUtTrace)
    318  1.4.2.2  rmind 
    319  1.4.2.2  rmind 
    320  1.4.2.2  rmind /*******************************************************************************
    321  1.4.2.2  rmind  *
    322  1.4.2.2  rmind  * FUNCTION:    AcpiUtTracePtr
    323  1.4.2.2  rmind  *
    324  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    325  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    326  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    327  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    328  1.4.2.2  rmind  *              Pointer             - Pointer to display
    329  1.4.2.2  rmind  *
    330  1.4.2.2  rmind  * RETURN:      None
    331  1.4.2.2  rmind  *
    332  1.4.2.2  rmind  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
    333  1.4.2.2  rmind  *              set in DebugLevel
    334  1.4.2.2  rmind  *
    335  1.4.2.2  rmind  ******************************************************************************/
    336  1.4.2.2  rmind 
    337  1.4.2.2  rmind void
    338  1.4.2.2  rmind AcpiUtTracePtr (
    339  1.4.2.2  rmind     UINT32                  LineNumber,
    340  1.4.2.2  rmind     const char              *FunctionName,
    341  1.4.2.2  rmind     const char              *ModuleName,
    342  1.4.2.2  rmind     UINT32                  ComponentId,
    343  1.4.2.2  rmind     void                    *Pointer)
    344  1.4.2.2  rmind {
    345  1.4.2.2  rmind     AcpiGbl_NestingLevel++;
    346  1.4.2.2  rmind     AcpiUtTrackStackPtr ();
    347  1.4.2.2  rmind 
    348  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    349  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    350  1.4.2.2  rmind         "%s %p\n", AcpiGbl_FnEntryStr, Pointer);
    351  1.4.2.2  rmind }
    352  1.4.2.2  rmind 
    353  1.4.2.2  rmind 
    354  1.4.2.2  rmind /*******************************************************************************
    355  1.4.2.2  rmind  *
    356  1.4.2.2  rmind  * FUNCTION:    AcpiUtTraceStr
    357  1.4.2.2  rmind  *
    358  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    359  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    360  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    361  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    362  1.4.2.2  rmind  *              String              - Additional string to display
    363  1.4.2.2  rmind  *
    364  1.4.2.2  rmind  * RETURN:      None
    365  1.4.2.2  rmind  *
    366  1.4.2.2  rmind  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
    367  1.4.2.2  rmind  *              set in DebugLevel
    368  1.4.2.2  rmind  *
    369  1.4.2.2  rmind  ******************************************************************************/
    370  1.4.2.2  rmind 
    371  1.4.2.2  rmind void
    372  1.4.2.2  rmind AcpiUtTraceStr (
    373  1.4.2.2  rmind     UINT32                  LineNumber,
    374  1.4.2.2  rmind     const char              *FunctionName,
    375  1.4.2.2  rmind     const char              *ModuleName,
    376  1.4.2.2  rmind     UINT32                  ComponentId,
    377  1.4.2.2  rmind     const char              *String)
    378  1.4.2.2  rmind {
    379  1.4.2.2  rmind 
    380  1.4.2.2  rmind     AcpiGbl_NestingLevel++;
    381  1.4.2.2  rmind     AcpiUtTrackStackPtr ();
    382  1.4.2.2  rmind 
    383  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    384  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    385  1.4.2.2  rmind         "%s %s\n", AcpiGbl_FnEntryStr, String);
    386  1.4.2.2  rmind }
    387  1.4.2.2  rmind 
    388  1.4.2.2  rmind 
    389  1.4.2.2  rmind /*******************************************************************************
    390  1.4.2.2  rmind  *
    391  1.4.2.2  rmind  * FUNCTION:    AcpiUtTraceU32
    392  1.4.2.2  rmind  *
    393  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    394  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    395  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    396  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    397  1.4.2.2  rmind  *              Integer             - Integer to display
    398  1.4.2.2  rmind  *
    399  1.4.2.2  rmind  * RETURN:      None
    400  1.4.2.2  rmind  *
    401  1.4.2.2  rmind  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
    402  1.4.2.2  rmind  *              set in DebugLevel
    403  1.4.2.2  rmind  *
    404  1.4.2.2  rmind  ******************************************************************************/
    405  1.4.2.2  rmind 
    406  1.4.2.2  rmind void
    407  1.4.2.2  rmind AcpiUtTraceU32 (
    408  1.4.2.2  rmind     UINT32                  LineNumber,
    409  1.4.2.2  rmind     const char              *FunctionName,
    410  1.4.2.2  rmind     const char              *ModuleName,
    411  1.4.2.2  rmind     UINT32                  ComponentId,
    412  1.4.2.2  rmind     UINT32                  Integer)
    413  1.4.2.2  rmind {
    414  1.4.2.2  rmind 
    415  1.4.2.2  rmind     AcpiGbl_NestingLevel++;
    416  1.4.2.2  rmind     AcpiUtTrackStackPtr ();
    417  1.4.2.2  rmind 
    418  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    419  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    420  1.4.2.2  rmind         "%s %08X\n", AcpiGbl_FnEntryStr, Integer);
    421  1.4.2.2  rmind }
    422  1.4.2.2  rmind 
    423  1.4.2.2  rmind 
    424  1.4.2.2  rmind /*******************************************************************************
    425  1.4.2.2  rmind  *
    426  1.4.2.2  rmind  * FUNCTION:    AcpiUtExit
    427  1.4.2.2  rmind  *
    428  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    429  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    430  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    431  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    432  1.4.2.2  rmind  *
    433  1.4.2.2  rmind  * RETURN:      None
    434  1.4.2.2  rmind  *
    435  1.4.2.2  rmind  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
    436  1.4.2.2  rmind  *              set in DebugLevel
    437  1.4.2.2  rmind  *
    438  1.4.2.2  rmind  ******************************************************************************/
    439  1.4.2.2  rmind 
    440  1.4.2.2  rmind void
    441  1.4.2.2  rmind AcpiUtExit (
    442  1.4.2.2  rmind     UINT32                  LineNumber,
    443  1.4.2.2  rmind     const char              *FunctionName,
    444  1.4.2.2  rmind     const char              *ModuleName,
    445  1.4.2.2  rmind     UINT32                  ComponentId)
    446  1.4.2.2  rmind {
    447  1.4.2.2  rmind 
    448  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    449  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    450  1.4.2.2  rmind         "%s\n", AcpiGbl_FnExitStr);
    451  1.4.2.2  rmind 
    452  1.4.2.2  rmind     AcpiGbl_NestingLevel--;
    453  1.4.2.2  rmind }
    454  1.4.2.2  rmind 
    455  1.4.2.2  rmind ACPI_EXPORT_SYMBOL (AcpiUtExit)
    456  1.4.2.2  rmind 
    457  1.4.2.2  rmind 
    458  1.4.2.2  rmind /*******************************************************************************
    459  1.4.2.2  rmind  *
    460  1.4.2.2  rmind  * FUNCTION:    AcpiUtStatusExit
    461  1.4.2.2  rmind  *
    462  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    463  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    464  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    465  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    466  1.4.2.2  rmind  *              Status              - Exit status code
    467  1.4.2.2  rmind  *
    468  1.4.2.2  rmind  * RETURN:      None
    469  1.4.2.2  rmind  *
    470  1.4.2.2  rmind  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
    471  1.4.2.2  rmind  *              set in DebugLevel.  Prints exit status also.
    472  1.4.2.2  rmind  *
    473  1.4.2.2  rmind  ******************************************************************************/
    474  1.4.2.2  rmind 
    475  1.4.2.2  rmind void
    476  1.4.2.2  rmind AcpiUtStatusExit (
    477  1.4.2.2  rmind     UINT32                  LineNumber,
    478  1.4.2.2  rmind     const char              *FunctionName,
    479  1.4.2.2  rmind     const char              *ModuleName,
    480  1.4.2.2  rmind     UINT32                  ComponentId,
    481  1.4.2.2  rmind     ACPI_STATUS             Status)
    482  1.4.2.2  rmind {
    483  1.4.2.2  rmind 
    484  1.4.2.2  rmind     if (ACPI_SUCCESS (Status))
    485  1.4.2.2  rmind     {
    486  1.4.2.2  rmind         AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    487  1.4.2.2  rmind             LineNumber, FunctionName, ModuleName, ComponentId,
    488  1.4.2.2  rmind             "%s %s\n", AcpiGbl_FnExitStr,
    489  1.4.2.2  rmind             AcpiFormatException (Status));
    490  1.4.2.2  rmind     }
    491  1.4.2.2  rmind     else
    492  1.4.2.2  rmind     {
    493  1.4.2.2  rmind         AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    494  1.4.2.2  rmind             LineNumber, FunctionName, ModuleName, ComponentId,
    495  1.4.2.2  rmind             "%s ****Exception****: %s\n", AcpiGbl_FnExitStr,
    496  1.4.2.2  rmind             AcpiFormatException (Status));
    497  1.4.2.2  rmind     }
    498  1.4.2.2  rmind 
    499  1.4.2.2  rmind     AcpiGbl_NestingLevel--;
    500  1.4.2.2  rmind }
    501  1.4.2.2  rmind 
    502  1.4.2.2  rmind ACPI_EXPORT_SYMBOL (AcpiUtStatusExit)
    503  1.4.2.2  rmind 
    504  1.4.2.2  rmind 
    505  1.4.2.2  rmind /*******************************************************************************
    506  1.4.2.2  rmind  *
    507  1.4.2.2  rmind  * FUNCTION:    AcpiUtValueExit
    508  1.4.2.2  rmind  *
    509  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    510  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    511  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    512  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    513  1.4.2.2  rmind  *              Value               - Value to be printed with exit msg
    514  1.4.2.2  rmind  *
    515  1.4.2.2  rmind  * RETURN:      None
    516  1.4.2.2  rmind  *
    517  1.4.2.2  rmind  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
    518  1.4.2.2  rmind  *              set in DebugLevel.  Prints exit value also.
    519  1.4.2.2  rmind  *
    520  1.4.2.2  rmind  ******************************************************************************/
    521  1.4.2.2  rmind 
    522  1.4.2.2  rmind void
    523  1.4.2.2  rmind AcpiUtValueExit (
    524  1.4.2.2  rmind     UINT32                  LineNumber,
    525  1.4.2.2  rmind     const char              *FunctionName,
    526  1.4.2.2  rmind     const char              *ModuleName,
    527  1.4.2.2  rmind     UINT32                  ComponentId,
    528  1.4.2.2  rmind     UINT64                  Value)
    529  1.4.2.2  rmind {
    530  1.4.2.2  rmind 
    531  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    532  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    533  1.4.2.2  rmind         "%s %8.8X%8.8X\n", AcpiGbl_FnExitStr,
    534  1.4.2.2  rmind         ACPI_FORMAT_UINT64 (Value));
    535  1.4.2.2  rmind 
    536  1.4.2.2  rmind     AcpiGbl_NestingLevel--;
    537  1.4.2.2  rmind }
    538  1.4.2.2  rmind 
    539  1.4.2.2  rmind ACPI_EXPORT_SYMBOL (AcpiUtValueExit)
    540  1.4.2.2  rmind 
    541  1.4.2.2  rmind 
    542  1.4.2.2  rmind /*******************************************************************************
    543  1.4.2.2  rmind  *
    544  1.4.2.2  rmind  * FUNCTION:    AcpiUtPtrExit
    545  1.4.2.2  rmind  *
    546  1.4.2.2  rmind  * PARAMETERS:  LineNumber          - Caller's line number
    547  1.4.2.2  rmind  *              FunctionName        - Caller's procedure name
    548  1.4.2.2  rmind  *              ModuleName          - Caller's module name
    549  1.4.2.2  rmind  *              ComponentId         - Caller's component ID
    550  1.4.2.2  rmind  *              Ptr                 - Pointer to display
    551  1.4.2.2  rmind  *
    552  1.4.2.2  rmind  * RETURN:      None
    553  1.4.2.2  rmind  *
    554  1.4.2.2  rmind  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
    555  1.4.2.2  rmind  *              set in DebugLevel.  Prints exit value also.
    556  1.4.2.2  rmind  *
    557  1.4.2.2  rmind  ******************************************************************************/
    558  1.4.2.2  rmind 
    559  1.4.2.2  rmind void
    560  1.4.2.2  rmind AcpiUtPtrExit (
    561  1.4.2.2  rmind     UINT32                  LineNumber,
    562  1.4.2.2  rmind     const char              *FunctionName,
    563  1.4.2.2  rmind     const char              *ModuleName,
    564  1.4.2.2  rmind     UINT32                  ComponentId,
    565  1.4.2.2  rmind     UINT8                   *Ptr)
    566  1.4.2.2  rmind {
    567  1.4.2.2  rmind 
    568  1.4.2.2  rmind     AcpiDebugPrint (ACPI_LV_FUNCTIONS,
    569  1.4.2.2  rmind         LineNumber, FunctionName, ModuleName, ComponentId,
    570  1.4.2.2  rmind         "%s %p\n", AcpiGbl_FnExitStr, Ptr);
    571  1.4.2.2  rmind 
    572  1.4.2.2  rmind     AcpiGbl_NestingLevel--;
    573  1.4.2.2  rmind }
    574  1.4.2.2  rmind 
    575  1.4.2.2  rmind #endif
    576  1.4.2.2  rmind 
    577  1.4.2.2  rmind 
    578  1.4.2.2  rmind /*******************************************************************************
    579  1.4.2.2  rmind  *
    580  1.4.2.2  rmind  * FUNCTION:    AcpiUtDumpBuffer
    581  1.4.2.2  rmind  *
    582  1.4.2.2  rmind  * PARAMETERS:  Buffer              - Buffer to dump
    583  1.4.2.2  rmind  *              Count               - Amount to dump, in bytes
    584  1.4.2.2  rmind  *              Display             - BYTE, WORD, DWORD, or QWORD display
    585  1.4.2.2  rmind  *              ComponentID         - Caller's component ID
    586  1.4.2.2  rmind  *
    587  1.4.2.2  rmind  * RETURN:      None
    588  1.4.2.2  rmind  *
    589  1.4.2.2  rmind  * DESCRIPTION: Generic dump buffer in both hex and ascii.
    590  1.4.2.2  rmind  *
    591  1.4.2.2  rmind  ******************************************************************************/
    592  1.4.2.2  rmind 
    593  1.4.2.2  rmind void
    594  1.4.2.2  rmind AcpiUtDumpBuffer2 (
    595  1.4.2.2  rmind     UINT8                   *Buffer,
    596  1.4.2.2  rmind     UINT32                  Count,
    597  1.4.2.2  rmind     UINT32                  Display)
    598  1.4.2.2  rmind {
    599  1.4.2.2  rmind     UINT32                  i = 0;
    600  1.4.2.2  rmind     UINT32                  j;
    601  1.4.2.2  rmind     UINT32                  Temp32;
    602  1.4.2.2  rmind     UINT8                   BufChar;
    603  1.4.2.2  rmind 
    604  1.4.2.2  rmind 
    605  1.4.2.2  rmind     if (!Buffer)
    606  1.4.2.2  rmind     {
    607  1.4.2.2  rmind         AcpiOsPrintf ("Null Buffer Pointer in DumpBuffer!\n");
    608  1.4.2.2  rmind         return;
    609  1.4.2.2  rmind     }
    610  1.4.2.2  rmind 
    611  1.4.2.2  rmind     if ((Count < 4) || (Count & 0x01))
    612  1.4.2.2  rmind     {
    613  1.4.2.2  rmind         Display = DB_BYTE_DISPLAY;
    614  1.4.2.2  rmind     }
    615  1.4.2.2  rmind 
    616  1.4.2.2  rmind     /* Nasty little dump buffer routine! */
    617  1.4.2.2  rmind 
    618  1.4.2.2  rmind     while (i < Count)
    619  1.4.2.2  rmind     {
    620  1.4.2.2  rmind         /* Print current offset */
    621  1.4.2.2  rmind 
    622  1.4.2.2  rmind         AcpiOsPrintf ("%6.4X: ", i);
    623  1.4.2.2  rmind 
    624  1.4.2.2  rmind         /* Print 16 hex chars */
    625  1.4.2.2  rmind 
    626  1.4.2.2  rmind         for (j = 0; j < 16;)
    627  1.4.2.2  rmind         {
    628  1.4.2.2  rmind             if (i + j >= Count)
    629  1.4.2.2  rmind             {
    630  1.4.2.2  rmind                 /* Dump fill spaces */
    631  1.4.2.2  rmind 
    632  1.4.2.2  rmind                 AcpiOsPrintf ("%*s", ((Display * 2) + 1), " ");
    633  1.4.2.2  rmind                 j += Display;
    634  1.4.2.2  rmind                 continue;
    635  1.4.2.2  rmind             }
    636  1.4.2.2  rmind 
    637  1.4.2.2  rmind             switch (Display)
    638  1.4.2.2  rmind             {
    639  1.4.2.2  rmind             case DB_BYTE_DISPLAY:
    640  1.4.2.2  rmind             default:    /* Default is BYTE display */
    641  1.4.2.2  rmind 
    642  1.4.2.2  rmind                 AcpiOsPrintf ("%02X ", Buffer[(ACPI_SIZE) i + j]);
    643  1.4.2.2  rmind                 break;
    644  1.4.2.2  rmind 
    645  1.4.2.2  rmind 
    646  1.4.2.2  rmind             case DB_WORD_DISPLAY:
    647  1.4.2.2  rmind 
    648  1.4.2.2  rmind                 ACPI_MOVE_16_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j]);
    649  1.4.2.2  rmind                 AcpiOsPrintf ("%04X ", Temp32);
    650  1.4.2.2  rmind                 break;
    651  1.4.2.2  rmind 
    652  1.4.2.2  rmind 
    653  1.4.2.2  rmind             case DB_DWORD_DISPLAY:
    654  1.4.2.2  rmind 
    655  1.4.2.2  rmind                 ACPI_MOVE_32_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j]);
    656  1.4.2.2  rmind                 AcpiOsPrintf ("%08X ", Temp32);
    657  1.4.2.2  rmind                 break;
    658  1.4.2.2  rmind 
    659  1.4.2.2  rmind 
    660  1.4.2.2  rmind             case DB_QWORD_DISPLAY:
    661  1.4.2.2  rmind 
    662  1.4.2.2  rmind                 ACPI_MOVE_32_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j]);
    663  1.4.2.2  rmind                 AcpiOsPrintf ("%08X", Temp32);
    664  1.4.2.2  rmind 
    665  1.4.2.2  rmind                 ACPI_MOVE_32_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j + 4]);
    666  1.4.2.2  rmind                 AcpiOsPrintf ("%08X ", Temp32);
    667  1.4.2.2  rmind                 break;
    668  1.4.2.2  rmind             }
    669  1.4.2.2  rmind 
    670  1.4.2.2  rmind             j += Display;
    671  1.4.2.2  rmind         }
    672  1.4.2.2  rmind 
    673  1.4.2.2  rmind         /*
    674  1.4.2.2  rmind          * Print the ASCII equivalent characters but watch out for the bad
    675  1.4.2.2  rmind          * unprintable ones (printable chars are 0x20 through 0x7E)
    676  1.4.2.2  rmind          */
    677  1.4.2.2  rmind         AcpiOsPrintf (" ");
    678  1.4.2.2  rmind         for (j = 0; j < 16; j++)
    679  1.4.2.2  rmind         {
    680  1.4.2.2  rmind             if (i + j >= Count)
    681  1.4.2.2  rmind             {
    682  1.4.2.2  rmind                 AcpiOsPrintf ("\n");
    683  1.4.2.2  rmind                 return;
    684  1.4.2.2  rmind             }
    685  1.4.2.2  rmind 
    686  1.4.2.2  rmind             BufChar = Buffer[(ACPI_SIZE) i + j];
    687  1.4.2.2  rmind             if (ACPI_IS_PRINT (BufChar))
    688  1.4.2.2  rmind             {
    689  1.4.2.2  rmind                 AcpiOsPrintf ("%c", BufChar);
    690  1.4.2.2  rmind             }
    691  1.4.2.2  rmind             else
    692  1.4.2.2  rmind             {
    693  1.4.2.2  rmind                 AcpiOsPrintf (".");
    694  1.4.2.2  rmind             }
    695  1.4.2.2  rmind         }
    696  1.4.2.2  rmind 
    697  1.4.2.2  rmind         /* Done with that line. */
    698  1.4.2.2  rmind 
    699  1.4.2.2  rmind         AcpiOsPrintf ("\n");
    700  1.4.2.2  rmind         i += 16;
    701  1.4.2.2  rmind     }
    702  1.4.2.2  rmind 
    703  1.4.2.2  rmind     return;
    704  1.4.2.2  rmind }
    705  1.4.2.2  rmind 
    706  1.4.2.2  rmind 
    707  1.4.2.2  rmind /*******************************************************************************
    708  1.4.2.2  rmind  *
    709  1.4.2.2  rmind  * FUNCTION:    AcpiUtDumpBuffer
    710  1.4.2.2  rmind  *
    711  1.4.2.2  rmind  * PARAMETERS:  Buffer              - Buffer to dump
    712  1.4.2.2  rmind  *              Count               - Amount to dump, in bytes
    713  1.4.2.2  rmind  *              Display             - BYTE, WORD, DWORD, or QWORD display
    714  1.4.2.2  rmind  *              ComponentID         - Caller's component ID
    715  1.4.2.2  rmind  *
    716  1.4.2.2  rmind  * RETURN:      None
    717  1.4.2.2  rmind  *
    718  1.4.2.2  rmind  * DESCRIPTION: Generic dump buffer in both hex and ascii.
    719  1.4.2.2  rmind  *
    720  1.4.2.2  rmind  ******************************************************************************/
    721  1.4.2.2  rmind 
    722  1.4.2.2  rmind void
    723  1.4.2.2  rmind AcpiUtDumpBuffer (
    724  1.4.2.2  rmind     UINT8                   *Buffer,
    725  1.4.2.2  rmind     UINT32                  Count,
    726  1.4.2.2  rmind     UINT32                  Display,
    727  1.4.2.2  rmind     UINT32                  ComponentId)
    728  1.4.2.2  rmind {
    729  1.4.2.2  rmind 
    730  1.4.2.2  rmind     /* Only dump the buffer if tracing is enabled */
    731  1.4.2.2  rmind 
    732  1.4.2.2  rmind     if (!((ACPI_LV_TABLES & AcpiDbgLevel) &&
    733  1.4.2.2  rmind         (ComponentId & AcpiDbgLayer)))
    734  1.4.2.2  rmind     {
    735  1.4.2.2  rmind         return;
    736  1.4.2.2  rmind     }
    737  1.4.2.2  rmind 
    738  1.4.2.2  rmind     AcpiUtDumpBuffer2 (Buffer, Count, Display);
    739  1.4.2.2  rmind }
    740  1.4.2.2  rmind 
    741  1.4.2.2  rmind 
    742