2 .\" Copyright (c) 2003 Nate Lawson
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer
10 .\" in this position and unchanged.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. The name of the author may not be used to endorse or promote products
15 .\" derived from this software without specific prior written permission.
17 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 .Nd ACPI DSDT debugger
42 utility is a debugger for the ACPI DSDT.
43 It can parse and execute various
44 AML methods and display the result.
46 .Ss General-Purpose Commands
47 .Bl -tag -width indent
49 Display list of current memory allocations
50 .It Ic Dump Ar Address | Namepath Op Cm Byte | Word | Dword | Qword
51 Display ACPI objects or memory
53 Enable ACPI (hardware) mode
55 Show various help screens
57 Display command history buffer
58 .It Ic Level Ar DebugLevel Op Cm console
59 Get/Set debug level for file or console
61 Current status of internal mutexes
62 .It Ic Quit No or Ic Exit
64 .It Ic Stats Op Cm Allocations | Memory | Misc | Objects | Tables
65 Display namespace and memory statistics
67 Display info about loaded ACPI tables
68 .It Ic Unload Ar TableSig Op Ar Instance
70 .It Ic !\& Ar CommandNumber
71 Execute command from history buffer
73 Execute last command again
75 .Ss Namespace Access Commands
76 .Bl -tag -width indent
77 .It Ic Event Cm F | G Ar Value
78 Generate AcpiEvent (Fixed/GPE)
80 Find ACPI name(s) with wildcards
84 Display list of loaded control methods
85 .It Ic Namespace Oo Ar Addr | Path Oc Op Ar Depth
86 Display loaded namespace tree/subtree
87 .It Ic Notify Ar NamePath Value
89 .It Ic Objects Ar ObjectType
90 Display all objects of the given type
91 .It Ic Owner Ar OwnerId Op Ar Depth
92 Display loaded namespace by object owner
93 .It Ic Prefix Op Ar NamePath
94 Set or Get current execution prefix
95 .It Ic References Ar Addr
96 Find all references to object at addr
98 Get and display resources
100 Delete namespace and all internal objects
101 .It Ic Thread Ar Threads Loops NamePath
102 Spawn threads to execute method(s)
104 .Ss Control Method Execution Commands
105 .Bl -tag -width indent
108 Display method arguments
109 .It Ic Breakpoint Ar AmlOffset
110 Set an AML execution breakpoint
112 Run to next control method invocation
113 .It Ic Debug Ar Namepath Op Ar Arguments
114 Single Step a control method
115 .It Ic Execute Ar Namepath Op Arguments
116 Execute control method
118 Allow method to run to completion
120 Display info about the current method
122 Step into (not over) a method call
123 .It Ic List Op OpcodeCount
124 Display method ASL statements
126 Display method local variables
128 Display method result stack
129 .It Ic Set Cm A | L Ar # Value
130 Set method data (Arguments/Locals)
132 Terminate control method
134 Display control method calling tree
136 Single step next AML opcode (over calls)
138 .Ss File I/O Commands
139 .Bl -tag -width indent
141 Close debug output file
142 .It Ic Open Ar Filename
143 Open a file for debug output
144 .It Ic Load Ar Filename
145 Load ACPI table from a file
154 utility first appeared in the
163 utility was written by
164 .An Mitsuru Iwasaki Aq iwasaki@FreeBSD.org
165 and uses Intel ACPI-CA for the backend.
166 This manual page was written by