1 .. SPDX-License-Identifier: GPL-2.0
2
3 ====================
4 ACPI CA Debug Output
5 ====================
6
7 The ACPI CA can generate debug output. This d
8 facility.
9
10 Compile-time configuration
11 ==========================
12
13 The ACPI CA debug output is globally enabled b
14 config option is not set, the debug messages a
15
16 Boot- and run-time configuration
17 ================================
18
19 When CONFIG_ACPI_DEBUG=y, you can select the c
20 you're interested in. At boot-time, use the a
21 acpi.debug_level kernel command line options.
22 debug_layer and debug_level files in /sys/modu
23 the debug messages.
24
25 debug_layer (component)
26 =======================
27
28 The "debug_layer" is a mask that selects compo
29 specific part of the ACPI interpreter. To bui
30 for the "#define _COMPONENT" in an ACPI source
31
32 You can set the debug_layer mask at boot-time
33 command line argument, and you can change it a
34 to /sys/module/acpi/parameters/debug_layer.
35
36 The possible components are defined in include
37
38 Reading /sys/module/acpi/parameters/debug_laye
39
40 ACPI_UTILITIES 0x00000001
41 ACPI_HARDWARE 0x00000002
42 ACPI_EVENTS 0x00000004
43 ACPI_TABLES 0x00000008
44 ACPI_NAMESPACE 0x00000010
45 ACPI_PARSER 0x00000020
46 ACPI_DISPATCHER 0x00000040
47 ACPI_EXECUTER 0x00000080
48 ACPI_RESOURCES 0x00000100
49 ACPI_CA_DEBUGGER 0x00000200
50 ACPI_OS_SERVICES 0x00000400
51 ACPI_CA_DISASSEMBLER 0x00000800
52 ACPI_COMPILER 0x00001000
53 ACPI_TOOLS 0x00002000
54
55 debug_level
56 ===========
57
58 The "debug_level" is a mask that selects diffe
59 those related to initialization, method execut
60 To build debug_level, look at the level specif
61 statement.
62
63 The ACPI interpreter uses several different le
64 ACPI core and ACPI drivers generally only use
65
66 You can set the debug_level mask at boot-time
67 command line argument, and you can change it a
68 to /sys/module/acpi/parameters/debug_level.
69
70 The possible levels are defined in include/acp
71 /sys/module/acpi/parameters/debug_level shows
72 currently these::
73
74 ACPI_LV_INIT 0x00000001
75 ACPI_LV_DEBUG_OBJECT 0x00000002
76 ACPI_LV_INFO 0x00000004
77 ACPI_LV_INIT_NAMES 0x00000020
78 ACPI_LV_PARSE 0x00000040
79 ACPI_LV_LOAD 0x00000080
80 ACPI_LV_DISPATCH 0x00000100
81 ACPI_LV_EXEC 0x00000200
82 ACPI_LV_NAMES 0x00000400
83 ACPI_LV_OPREGION 0x00000800
84 ACPI_LV_BFIELD 0x00001000
85 ACPI_LV_TABLES 0x00002000
86 ACPI_LV_VALUES 0x00004000
87 ACPI_LV_OBJECTS 0x00008000
88 ACPI_LV_RESOURCES 0x00010000
89 ACPI_LV_USER_REQUESTS 0x00020000
90 ACPI_LV_PACKAGE 0x00040000
91 ACPI_LV_ALLOCATIONS 0x00100000
92 ACPI_LV_FUNCTIONS 0x00200000
93 ACPI_LV_OPTIMIZATIONS 0x00400000
94 ACPI_LV_MUTEX 0x01000000
95 ACPI_LV_THREADS 0x02000000
96 ACPI_LV_IO 0x04000000
97 ACPI_LV_INTERRUPTS 0x08000000
98 ACPI_LV_AML_DISASSEMBLE 0x10000000
99 ACPI_LV_VERBOSE_INFO 0x20000000
100 ACPI_LV_FULL_TABLES 0x40000000
101 ACPI_LV_EVENTS 0x80000000
102
103 Examples
104 ========
105
106 For example, drivers/acpi/acpica/evxfevnt.c co
107
108 #define _COMPONENT ACPI_EVENTS
109 ...
110 ACPI_DEBUG_PRINT((ACPI_DB_INIT, "ACPI mode
111
112 To turn on this message, set the ACPI_EVENTS b
113 and the ACPI_LV_INIT bit in acpi.debug_level.
114 statement uses ACPI_DB_INIT, which is a macro
115 definition.)
116
117 Enable all AML "Debug" output (stores to the D
118 AML) during boot::
119
120 acpi.debug_layer=0xffffffff acpi.debug_lev
121
122 Enable all ACPI hardware-related messages::
123
124 acpi.debug_layer=0x2 acpi.debug_level=0xff
125
126 Enable all ACPI_DB_INFO messages after boot::
127
128 # echo 0x4 > /sys/module/acpi/parameters/d
129
130 Show all valid component values::
131
132 # cat /sys/module/acpi/parameters/debug_la
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.