Home | History | Annotate | Line # | Download | only in include
acoutput.h revision 1.9
      1 /******************************************************************************
      2  *
      3  * Name: acoutput.h -- debug output
      4  *
      5  *****************************************************************************/
      6 
      7 /*
      8  * Copyright (C) 2000 - 2018, 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 __ACOUTPUT_H__
     45 #define __ACOUTPUT_H__
     46 
     47 /*
     48  * Debug levels and component IDs. These are used to control the
     49  * granularity of the output of the ACPI_DEBUG_PRINT macro -- on a
     50  * per-component basis and a per-exception-type basis.
     51  */
     52 
     53 /* Component IDs are used in the global "DebugLayer" */
     54 
     55 #define ACPI_UTILITIES              0x00000001
     56 #define ACPI_HARDWARE               0x00000002
     57 #define ACPI_EVENTS                 0x00000004
     58 #define ACPI_TABLES                 0x00000008
     59 #define ACPI_NAMESPACE              0x00000010
     60 #define ACPI_PARSER                 0x00000020
     61 #define ACPI_DISPATCHER             0x00000040
     62 #define ACPI_EXECUTER               0x00000080
     63 #define ACPI_RESOURCES              0x00000100
     64 #define ACPI_CA_DEBUGGER            0x00000200
     65 #define ACPI_OS_SERVICES            0x00000400
     66 #define ACPI_CA_DISASSEMBLER        0x00000800
     67 
     68 /* Component IDs for ACPI tools and utilities */
     69 
     70 #define ACPI_COMPILER               0x00001000
     71 #define ACPI_TOOLS                  0x00002000
     72 #define ACPI_EXAMPLE                0x00004000
     73 #define ACPI_DRIVER                 0x00008000
     74 #define DT_COMPILER                 0x00010000
     75 #define ASL_PREPROCESSOR            0x00020000
     76 
     77 #define ACPI_ALL_COMPONENTS         0x0001FFFF
     78 #define ACPI_COMPONENT_DEFAULT      (ACPI_ALL_COMPONENTS)
     79 
     80 /* Component IDs reserved for ACPI drivers */
     81 
     82 #define ACPI_ALL_DRIVERS            0xFFFF0000
     83 
     84 
     85 /*
     86  * Raw debug output levels, do not use these in the ACPI_DEBUG_PRINT macros
     87  */
     88 #define ACPI_LV_INIT                0x00000001
     89 #define ACPI_LV_DEBUG_OBJECT        0x00000002
     90 #define ACPI_LV_INFO                0x00000004
     91 #define ACPI_LV_REPAIR              0x00000008
     92 #define ACPI_LV_TRACE_POINT         0x00000010
     93 #define ACPI_LV_ALL_EXCEPTIONS      0x0000001F
     94 
     95 /* Trace verbosity level 1 [Standard Trace Level] */
     96 
     97 #define ACPI_LV_INIT_NAMES          0x00000020
     98 #define ACPI_LV_PARSE               0x00000040
     99 #define ACPI_LV_LOAD                0x00000080
    100 #define ACPI_LV_DISPATCH            0x00000100
    101 #define ACPI_LV_EXEC                0x00000200
    102 #define ACPI_LV_NAMES               0x00000400
    103 #define ACPI_LV_OPREGION            0x00000800
    104 #define ACPI_LV_BFIELD              0x00001000
    105 #define ACPI_LV_TABLES              0x00002000
    106 #define ACPI_LV_VALUES              0x00004000
    107 #define ACPI_LV_OBJECTS             0x00008000
    108 #define ACPI_LV_RESOURCES           0x00010000
    109 #define ACPI_LV_USER_REQUESTS       0x00020000
    110 #define ACPI_LV_PACKAGE             0x00040000
    111 #define ACPI_LV_VERBOSITY1          0x0007FF40 | ACPI_LV_ALL_EXCEPTIONS
    112 
    113 /* Trace verbosity level 2 [Function tracing and memory allocation] */
    114 
    115 #define ACPI_LV_ALLOCATIONS         0x00100000
    116 #define ACPI_LV_FUNCTIONS           0x00200000
    117 #define ACPI_LV_OPTIMIZATIONS       0x00400000
    118 #define ACPI_LV_PARSE_TREES         0x00800000
    119 #define ACPI_LV_VERBOSITY2          0x00F00000 | ACPI_LV_VERBOSITY1
    120 #define ACPI_LV_ALL                 ACPI_LV_VERBOSITY2
    121 
    122 /* Trace verbosity level 3 [Threading, I/O, and Interrupts] */
    123 
    124 #define ACPI_LV_MUTEX               0x01000000
    125 #define ACPI_LV_THREADS             0x02000000
    126 #define ACPI_LV_IO                  0x04000000
    127 #define ACPI_LV_INTERRUPTS          0x08000000
    128 #define ACPI_LV_VERBOSITY3          0x0F000000 | ACPI_LV_VERBOSITY2
    129 
    130 /* Exceptionally verbose output -- also used in the global "DebugLevel"  */
    131 
    132 #define ACPI_LV_AML_DISASSEMBLE     0x10000000
    133 #define ACPI_LV_VERBOSE_INFO        0x20000000
    134 #define ACPI_LV_FULL_TABLES         0x40000000
    135 #define ACPI_LV_EVENTS              0x80000000
    136 #define ACPI_LV_VERBOSE             0xF0000000
    137 
    138 
    139 /*
    140  * Debug level macros that are used in the DEBUG_PRINT macros
    141  */
    142 #define ACPI_DEBUG_LEVEL(dl)        (UINT32) dl,ACPI_DEBUG_PARAMETERS
    143 
    144 /*
    145  * Exception level -- used in the global "DebugLevel"
    146  *
    147  * Note: For errors, use the ACPI_ERROR or ACPI_EXCEPTION interfaces.
    148  * For warnings, use ACPI_WARNING.
    149  */
    150 #define ACPI_DB_INIT                ACPI_DEBUG_LEVEL (ACPI_LV_INIT)
    151 #define ACPI_DB_DEBUG_OBJECT        ACPI_DEBUG_LEVEL (ACPI_LV_DEBUG_OBJECT)
    152 #define ACPI_DB_INFO                ACPI_DEBUG_LEVEL (ACPI_LV_INFO)
    153 #define ACPI_DB_REPAIR              ACPI_DEBUG_LEVEL (ACPI_LV_REPAIR)
    154 #define ACPI_DB_TRACE_POINT         ACPI_DEBUG_LEVEL (ACPI_LV_TRACE_POINT)
    155 #define ACPI_DB_ALL_EXCEPTIONS      ACPI_DEBUG_LEVEL (ACPI_LV_ALL_EXCEPTIONS)
    156 
    157 /* Trace level -- also used in the global "DebugLevel" */
    158 
    159 #define ACPI_DB_INIT_NAMES          ACPI_DEBUG_LEVEL (ACPI_LV_INIT_NAMES)
    160 #define ACPI_DB_THREADS             ACPI_DEBUG_LEVEL (ACPI_LV_THREADS)
    161 #define ACPI_DB_PARSE               ACPI_DEBUG_LEVEL (ACPI_LV_PARSE)
    162 #define ACPI_DB_DISPATCH            ACPI_DEBUG_LEVEL (ACPI_LV_DISPATCH)
    163 #define ACPI_DB_LOAD                ACPI_DEBUG_LEVEL (ACPI_LV_LOAD)
    164 #define ACPI_DB_EXEC                ACPI_DEBUG_LEVEL (ACPI_LV_EXEC)
    165 #define ACPI_DB_NAMES               ACPI_DEBUG_LEVEL (ACPI_LV_NAMES)
    166 #define ACPI_DB_OPREGION            ACPI_DEBUG_LEVEL (ACPI_LV_OPREGION)
    167 #define ACPI_DB_BFIELD              ACPI_DEBUG_LEVEL (ACPI_LV_BFIELD)
    168 #define ACPI_DB_TABLES              ACPI_DEBUG_LEVEL (ACPI_LV_TABLES)
    169 #define ACPI_DB_FUNCTIONS           ACPI_DEBUG_LEVEL (ACPI_LV_FUNCTIONS)
    170 #define ACPI_DB_OPTIMIZATIONS       ACPI_DEBUG_LEVEL (ACPI_LV_OPTIMIZATIONS)
    171 #define ACPI_DB_PARSE_TREES         ACPI_DEBUG_LEVEL (ACPI_LV_PARSE_TREES)
    172 #define ACPI_DB_VALUES              ACPI_DEBUG_LEVEL (ACPI_LV_VALUES)
    173 #define ACPI_DB_OBJECTS             ACPI_DEBUG_LEVEL (ACPI_LV_OBJECTS)
    174 #define ACPI_DB_ALLOCATIONS         ACPI_DEBUG_LEVEL (ACPI_LV_ALLOCATIONS)
    175 #define ACPI_DB_RESOURCES           ACPI_DEBUG_LEVEL (ACPI_LV_RESOURCES)
    176 #define ACPI_DB_IO                  ACPI_DEBUG_LEVEL (ACPI_LV_IO)
    177 #define ACPI_DB_INTERRUPTS          ACPI_DEBUG_LEVEL (ACPI_LV_INTERRUPTS)
    178 #define ACPI_DB_USER_REQUESTS       ACPI_DEBUG_LEVEL (ACPI_LV_USER_REQUESTS)
    179 #define ACPI_DB_PACKAGE             ACPI_DEBUG_LEVEL (ACPI_LV_PACKAGE)
    180 #define ACPI_DB_MUTEX               ACPI_DEBUG_LEVEL (ACPI_LV_MUTEX)
    181 #define ACPI_DB_EVENTS              ACPI_DEBUG_LEVEL (ACPI_LV_EVENTS)
    182 
    183 #define ACPI_DB_ALL                 ACPI_DEBUG_LEVEL (ACPI_LV_ALL)
    184 
    185 /* Defaults for DebugLevel, debug and normal */
    186 
    187 #define ACPI_DEBUG_DEFAULT          (ACPI_LV_INIT | ACPI_LV_DEBUG_OBJECT | ACPI_LV_REPAIR)
    188 #define ACPI_NORMAL_DEFAULT         (ACPI_LV_INIT | ACPI_LV_DEBUG_OBJECT | ACPI_LV_REPAIR)
    189 #define ACPI_DEBUG_ALL              (ACPI_LV_AML_DISASSEMBLE | ACPI_LV_ALL_EXCEPTIONS | ACPI_LV_ALL)
    190 
    191 
    192 /*
    193  * Global trace flags
    194  */
    195 #define ACPI_TRACE_ENABLED          ((UINT32) 4)
    196 #define ACPI_TRACE_ONESHOT          ((UINT32) 2)
    197 #define ACPI_TRACE_OPCODE           ((UINT32) 1)
    198 
    199 /* Defaults for trace debugging level/layer */
    200 
    201 #define ACPI_TRACE_LEVEL_ALL        ACPI_LV_ALL
    202 #define ACPI_TRACE_LAYER_ALL        0x000001FF
    203 #define ACPI_TRACE_LEVEL_DEFAULT    ACPI_LV_TRACE_POINT
    204 #define ACPI_TRACE_LAYER_DEFAULT    ACPI_EXECUTER
    205 
    206 
    207 #if defined (ACPI_DEBUG_OUTPUT) || !defined (ACPI_NO_ERROR_MESSAGES)
    208 /*
    209  * The module name is used primarily for error and debug messages.
    210  * The __FILE__ macro is not very useful for this, because it
    211  * usually includes the entire pathname to the module making the
    212  * debug output difficult to read.
    213  */
    214 #define ACPI_MODULE_NAME(Name)          static const char ACPI_UNUSED_VAR _AcpiModuleName[] = Name;
    215 #else
    216 /*
    217  * For the no-debug and no-error-msg cases, we must at least define
    218  * a null module name.
    219  */
    220 #define ACPI_MODULE_NAME(Name)
    221 #define _AcpiModuleName ""
    222 #endif
    223 
    224 /*
    225  * Ascii error messages can be configured out
    226  */
    227 #ifndef ACPI_NO_ERROR_MESSAGES
    228 #define AE_INFO                         _AcpiModuleName, __LINE__
    229 
    230 /*
    231  * Error reporting. Callers module and line number are inserted by AE_INFO,
    232  * the plist contains a set of parens to allow variable-length lists.
    233  * These macros are used for both the debug and non-debug versions of the code.
    234  */
    235 #define ACPI_INFO(plist)                AcpiInfo plist
    236 #define ACPI_WARNING(plist)             AcpiWarning plist
    237 #define ACPI_EXCEPTION(plist)           AcpiException plist
    238 #define ACPI_ERROR(plist)               AcpiError plist
    239 #define ACPI_BIOS_WARNING(plist)        AcpiBiosWarning plist
    240 #define ACPI_BIOS_ERROR(plist)          AcpiBiosError plist
    241 #define ACPI_DEBUG_OBJECT(obj,l,i)      AcpiExDoDebugObject(obj,l,i)
    242 
    243 #else
    244 
    245 /* No error messages */
    246 
    247 #define ACPI_INFO(plist)
    248 #define ACPI_WARNING(plist)
    249 #define ACPI_EXCEPTION(plist)
    250 #define ACPI_ERROR(plist)
    251 #define ACPI_BIOS_WARNING(plist)
    252 #define ACPI_BIOS_ERROR(plist)
    253 #define ACPI_DEBUG_OBJECT(obj,l,i)
    254 
    255 #endif /* ACPI_NO_ERROR_MESSAGES */
    256 
    257 
    258 /*
    259  * Debug macros that are conditionally compiled
    260  */
    261 #ifdef ACPI_DEBUG_OUTPUT
    262 
    263 /*
    264  * If ACPI_GET_FUNCTION_NAME was not defined in the compiler-dependent header,
    265  * define it now. This is the case where there the compiler does not support
    266  * a __FUNCTION__ macro or equivalent.
    267  */
    268 #ifndef ACPI_GET_FUNCTION_NAME
    269 #define ACPI_GET_FUNCTION_NAME          _AcpiFunctionName
    270 
    271 /*
    272  * The Name parameter should be the procedure name as a non-quoted string.
    273  * The function name is also used by the function exit macros below.
    274  * Note: (const char) is used to be compatible with the debug interfaces
    275  * and macros such as __FUNCTION__.
    276  */
    277 #define ACPI_FUNCTION_NAME(Name)        static const char _AcpiFunctionName[] = #Name;
    278 
    279 #else
    280 /* Compiler supports __FUNCTION__ (or equivalent) -- Ignore this macro */
    281 
    282 #define ACPI_FUNCTION_NAME(Name)
    283 #endif /* ACPI_GET_FUNCTION_NAME */
    284 
    285 /*
    286  * Common parameters used for debug output functions:
    287  * line number, function name, module(file) name, component ID
    288  */
    289 #define ACPI_DEBUG_PARAMETERS \
    290     __LINE__, ACPI_GET_FUNCTION_NAME, _AcpiModuleName, _COMPONENT
    291 
    292 /* Check if debug output is currently dynamically enabled */
    293 
    294 #define ACPI_IS_DEBUG_ENABLED(Level, Component) \
    295     ((Level & AcpiDbgLevel) && (Component & AcpiDbgLayer))
    296 
    297 /*
    298  * Master debug print macros
    299  * Print message if and only if:
    300  *    1) Debug print for the current component is enabled
    301  *    2) Debug error level or trace level for the print statement is enabled
    302  *
    303  * November 2012: Moved the runtime check for whether to actually emit the
    304  * debug message outside of the print function itself. This improves overall
    305  * performance at a relatively small code cost. Implementation involves the
    306  * use of variadic macros supported by C99.
    307  *
    308  * Note: the ACPI_DO_WHILE0 macro is used to prevent some compilers from
    309  * complaining about these constructs. On other compilers the do...while
    310  * adds some extra code, so this feature is optional.
    311  */
    312 #ifdef ACPI_USE_DO_WHILE_0
    313 #define ACPI_DO_WHILE0(a)               do a while(0)
    314 #else
    315 #define ACPI_DO_WHILE0(a)               a
    316 #endif
    317 
    318 /* DEBUG_PRINT functions */
    319 
    320 #ifndef COMPILER_VA_MACRO
    321 
    322 #define ACPI_DEBUG_PRINT(plist)         AcpiDebugPrint plist
    323 #define ACPI_DEBUG_PRINT_RAW(plist)     AcpiDebugPrintRaw plist
    324 
    325 #else
    326 
    327 /* Helper macros for DEBUG_PRINT */
    328 
    329 #define ACPI_DO_DEBUG_PRINT(Function, Level, Line, Filename, Modulename, Component, ...) \
    330     ACPI_DO_WHILE0 ({ \
    331         if (ACPI_IS_DEBUG_ENABLED (Level, Component)) \
    332         { \
    333             Function (Level, Line, Filename, Modulename, Component, __VA_ARGS__); \
    334         } \
    335     })
    336 
    337 #define ACPI_ACTUAL_DEBUG(Level, Line, Filename, Modulename, Component, ...) \
    338     ACPI_DO_DEBUG_PRINT (AcpiDebugPrint, Level, Line, \
    339         Filename, Modulename, Component, __VA_ARGS__)
    340 
    341 #define ACPI_ACTUAL_DEBUG_RAW(Level, Line, Filename, Modulename, Component, ...) \
    342     ACPI_DO_DEBUG_PRINT (AcpiDebugPrintRaw, Level, Line, \
    343         Filename, Modulename, Component, __VA_ARGS__)
    344 
    345 #define ACPI_DEBUG_PRINT(plist)         ACPI_ACTUAL_DEBUG plist
    346 #define ACPI_DEBUG_PRINT_RAW(plist)     ACPI_ACTUAL_DEBUG_RAW plist
    347 
    348 #endif
    349 
    350 
    351 /*
    352  * Function entry tracing
    353  *
    354  * The name of the function is emitted as a local variable that is
    355  * intended to be used by both the entry trace and the exit trace.
    356  */
    357 
    358 /* Helper macro */
    359 
    360 #define ACPI_TRACE_ENTRY(Name, Function, Type, Param) \
    361     ACPI_FUNCTION_NAME (Name) \
    362     Function (ACPI_DEBUG_PARAMETERS, (Type) (Param))
    363 
    364 /* The actual entry trace macros */
    365 
    366 #define ACPI_FUNCTION_TRACE(Name) \
    367     ACPI_FUNCTION_NAME(Name) \
    368     AcpiUtTrace (ACPI_DEBUG_PARAMETERS)
    369 
    370 #define ACPI_FUNCTION_TRACE_PTR(Name, Pointer) \
    371     ACPI_TRACE_ENTRY (Name, AcpiUtTracePtr, const void *, Pointer)
    372 
    373 #define ACPI_FUNCTION_TRACE_U32(Name, Value) \
    374     ACPI_TRACE_ENTRY (Name, AcpiUtTraceU32, const UINT32, Value)
    375 
    376 #define ACPI_FUNCTION_TRACE_STR(Name, String) \
    377     ACPI_TRACE_ENTRY (Name, AcpiUtTraceStr, const char *, String)
    378 
    379 #define ACPI_FUNCTION_ENTRY() \
    380     AcpiUtTrackStackPtr()
    381 
    382 
    383 /*
    384  * Function exit tracing
    385  *
    386  * These macros include a return statement. This is usually considered
    387  * bad form, but having a separate exit macro before the actual return
    388  * is very ugly and difficult to maintain.
    389  *
    390  * One of the FUNCTION_TRACE macros above must be used in conjunction
    391  * with these macros so that "_AcpiFunctionName" is defined.
    392  *
    393  * There are two versions of most of the return macros. The default version is
    394  * safer, since it avoids side-effects by guaranteeing that the argument will
    395  * not be evaluated twice.
    396  *
    397  * A less-safe version of the macros is provided for optional use if the
    398  * compiler uses excessive CPU stack (for example, this may happen in the
    399  * debug case if code optimzation is disabled.)
    400  */
    401 
    402 /* Exit trace helper macro */
    403 
    404 #ifndef ACPI_SIMPLE_RETURN_MACROS
    405 
    406 #define ACPI_TRACE_EXIT(Function, Type, Param) \
    407     ACPI_DO_WHILE0 ({ \
    408         register Type _Param = (Type) (Param); \
    409         Function (ACPI_DEBUG_PARAMETERS, _Param); \
    410         return (_Param); \
    411     })
    412 
    413 #else /* Use original less-safe macros */
    414 
    415 #define ACPI_TRACE_EXIT(Function, Type, Param) \
    416     ACPI_DO_WHILE0 ({ \
    417         Function (ACPI_DEBUG_PARAMETERS, (Type) (Param)); \
    418         return (Param); \
    419     })
    420 
    421 #endif /* ACPI_SIMPLE_RETURN_MACROS */
    422 
    423 /* The actual exit macros */
    424 
    425 #define return_VOID \
    426     ACPI_DO_WHILE0 ({ \
    427         AcpiUtExit (ACPI_DEBUG_PARAMETERS); \
    428         return; \
    429     })
    430 
    431 #define return_ACPI_STATUS(Status) \
    432     ACPI_TRACE_EXIT (AcpiUtStatusExit, ACPI_STATUS, Status)
    433 
    434 #define return_PTR(Pointer) \
    435     ACPI_TRACE_EXIT (AcpiUtPtrExit, void *, Pointer)
    436 
    437 #define return_STR(String) \
    438     ACPI_TRACE_EXIT (AcpiUtStrExit, const char *, String)
    439 
    440 #define return_VALUE(Value) \
    441     ACPI_TRACE_EXIT (AcpiUtValueExit, UINT64, Value)
    442 
    443 #define return_UINT32(Value) \
    444     ACPI_TRACE_EXIT (AcpiUtValueExit, UINT32, Value)
    445 
    446 #define return_UINT8(Value) \
    447     ACPI_TRACE_EXIT (AcpiUtValueExit, UINT8, Value)
    448 
    449 /* Conditional execution */
    450 
    451 #define ACPI_DEBUG_EXEC(a)              a
    452 #define ACPI_DEBUG_ONLY_MEMBERS(a)      a;
    453 #define _VERBOSE_STRUCTURES
    454 
    455 
    456 /* Various object display routines for debug */
    457 
    458 #define ACPI_DUMP_STACK_ENTRY(a)        AcpiExDumpOperand((a), 0)
    459 #define ACPI_DUMP_OPERANDS(a, b ,c)     AcpiExDumpOperands(a, b, c)
    460 #define ACPI_DUMP_ENTRY(a, b)           AcpiNsDumpEntry (a, b)
    461 #define ACPI_DUMP_PATHNAME(a, b, c, d)  AcpiNsDumpPathname(a, b, c, d)
    462 #define ACPI_DUMP_BUFFER(a, b)          AcpiUtDebugDumpBuffer((UINT8 *) a, b, DB_BYTE_DISPLAY, _COMPONENT)
    463 
    464 #define ACPI_TRACE_POINT(a, b, c, d)    AcpiTracePoint (a, b, c, d)
    465 
    466 #else /* ACPI_DEBUG_OUTPUT */
    467 /*
    468  * This is the non-debug case -- make everything go away,
    469  * leaving no executable debug code!
    470  */
    471 #define ACPI_DEBUG_PRINT(pl)
    472 #define ACPI_DEBUG_PRINT_RAW(pl)
    473 #define ACPI_DEBUG_EXEC(a)
    474 #define ACPI_DEBUG_ONLY_MEMBERS(a)
    475 #define ACPI_FUNCTION_NAME(a)
    476 #define ACPI_FUNCTION_TRACE(a)
    477 #define ACPI_FUNCTION_TRACE_PTR(a, b)
    478 #define ACPI_FUNCTION_TRACE_U32(a, b)
    479 #define ACPI_FUNCTION_TRACE_STR(a, b)
    480 #define ACPI_FUNCTION_ENTRY()
    481 #define ACPI_DUMP_STACK_ENTRY(a)
    482 #define ACPI_DUMP_OPERANDS(a, b, c)
    483 #define ACPI_DUMP_ENTRY(a, b)
    484 #define ACPI_DUMP_PATHNAME(a, b, c, d)
    485 #define ACPI_DUMP_BUFFER(a, b)
    486 #define ACPI_IS_DEBUG_ENABLED(Level, Component) 0
    487 #define ACPI_TRACE_POINT(a, b, c, d)
    488 
    489 /* Return macros must have a return statement at the minimum */
    490 
    491 #define return_VOID                     return
    492 #define return_ACPI_STATUS(s)           return(s)
    493 #define return_PTR(s)                   return(s)
    494 #define return_STR(s)                   return(s)
    495 #define return_VALUE(s)                 return(s)
    496 #define return_UINT8(s)                 return(s)
    497 #define return_UINT32(s)                return(s)
    498 
    499 #endif /* ACPI_DEBUG_OUTPUT */
    500 
    501 
    502 #endif /* __ACOUTPUT_H__ */
    503