2003-08-07 18:09:17 +00:00
|
|
|
.\"-
|
|
|
|
.\" Copyright (c) 2003 Nate Lawson
|
|
|
|
.\" All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer
|
|
|
|
.\" in this position and unchanged.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
|
|
.\" derived from this software without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
.\"
|
2004-06-06 17:49:57 +00:00
|
|
|
.\" $FreeBSD$
|
2003-08-07 18:09:17 +00:00
|
|
|
.\"
|
|
|
|
.Dd August 7, 2003
|
|
|
|
.Dt ACPIDB 8
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm acpidb
|
|
|
|
.Nd ACPI DSDT debugger
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
|
|
|
.Ar input-file
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
|
|
|
.Nm
|
2004-06-06 17:49:57 +00:00
|
|
|
utility is a debugger for the ACPI DSDT.
|
|
|
|
It can parse and execute various
|
2003-08-07 18:09:17 +00:00
|
|
|
AML methods and display the result.
|
|
|
|
.Sh COMMANDS
|
|
|
|
.Ss General-Purpose Commands
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Ic Allocations
|
|
|
|
Display list of current memory allocations
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Dump Ar Address | Namepath Op Cm Byte | Word | Dword | Qword
|
2003-08-07 18:09:17 +00:00
|
|
|
Display ACPI objects or memory
|
|
|
|
.It Ic EnableAcpi
|
|
|
|
Enable ACPI (hardware) mode
|
|
|
|
.It Ic Help
|
2004-06-06 17:49:57 +00:00
|
|
|
Show various help screens
|
2003-08-07 18:09:17 +00:00
|
|
|
.It Ic History
|
|
|
|
Display command history buffer
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Level Ar DebugLevel Op Cm console
|
2003-08-07 18:09:17 +00:00
|
|
|
Get/Set debug level for file or console
|
|
|
|
.It Ic Locks
|
|
|
|
Current status of internal mutexes
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Quit No or Ic Exit
|
2003-08-07 18:09:17 +00:00
|
|
|
Exit the debugger
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Stats Op Cm Allocations | Memory | Misc | Objects | Tables
|
2003-08-07 18:09:17 +00:00
|
|
|
Display namespace and memory statistics
|
|
|
|
.It Ic Tables
|
|
|
|
Display info about loaded ACPI tables
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Unload Ar TableSig Op Ar Instance
|
2003-08-07 18:09:17 +00:00
|
|
|
Unload an ACPI table
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic !\& Ar CommandNumber
|
2003-08-07 18:09:17 +00:00
|
|
|
Execute command from history buffer
|
|
|
|
.It Ic !!
|
|
|
|
Execute last command again
|
|
|
|
.El
|
|
|
|
.Ss Namespace Access Commands
|
|
|
|
.Bl -tag -width indent
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Event Cm F | G Ar Value
|
2003-08-07 18:09:17 +00:00
|
|
|
Generate AcpiEvent (Fixed/GPE)
|
|
|
|
.It Ic Find Ar Name
|
2004-06-06 17:49:57 +00:00
|
|
|
Find ACPI name(s) with wildcards
|
|
|
|
.Ql ( ?\&
|
|
|
|
is wildcard)
|
2003-08-07 18:09:17 +00:00
|
|
|
.It Ic Method
|
|
|
|
Display list of loaded control methods
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Namespace Oo Ar Addr | Path Oc Op Ar Depth
|
2003-08-07 18:09:17 +00:00
|
|
|
Display loaded namespace tree/subtree
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Notify Ar NamePath Value
|
2003-08-07 18:09:17 +00:00
|
|
|
Send a notification
|
|
|
|
.It Ic Objects Ar ObjectType
|
|
|
|
Display all objects of the given type
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Owner Ar OwnerId Op Ar Depth
|
2003-08-07 18:09:17 +00:00
|
|
|
Display loaded namespace by object owner
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Prefix Op Ar NamePath
|
2003-08-07 18:09:17 +00:00
|
|
|
Set or Get current execution prefix
|
|
|
|
.It Ic References Ar Addr
|
|
|
|
Find all references to object at addr
|
|
|
|
.It Ic Resources
|
|
|
|
Get and display resources
|
|
|
|
.It Ic Terminate
|
|
|
|
Delete namespace and all internal objects
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Thread Ar Threads Loops NamePath
|
2003-08-07 18:09:17 +00:00
|
|
|
Spawn threads to execute method(s)
|
|
|
|
.El
|
|
|
|
.Ss Control Method Execution Commands
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Ic Arguments
|
|
|
|
.Pq Ic Args
|
|
|
|
Display method arguments
|
|
|
|
.It Ic Breakpoint Ar AmlOffset
|
|
|
|
Set an AML execution breakpoint
|
|
|
|
.It Ic Call
|
|
|
|
Run to next control method invocation
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Debug Ar Namepath Op Ar Arguments
|
2003-08-07 18:09:17 +00:00
|
|
|
Single Step a control method
|
|
|
|
.It Ic Execute Ar Namepath Op Arguments
|
|
|
|
Execute control method
|
|
|
|
.It Ic Go
|
|
|
|
Allow method to run to completion
|
|
|
|
.It Ic Information
|
|
|
|
Display info about the current method
|
|
|
|
.It Ic Into
|
|
|
|
Step into (not over) a method call
|
|
|
|
.It Ic List Op OpcodeCount
|
|
|
|
Display method ASL statements
|
|
|
|
.It Ic Locals
|
|
|
|
Display method local variables
|
|
|
|
.It Ic Results
|
|
|
|
Display method result stack
|
2004-06-06 17:49:57 +00:00
|
|
|
.It Ic Set Cm A | L Ar # Value
|
2003-08-07 18:09:17 +00:00
|
|
|
Set method data (Arguments/Locals)
|
|
|
|
.It Ic Stop
|
|
|
|
Terminate control method
|
|
|
|
.It Ic Tree
|
|
|
|
Display control method calling tree
|
|
|
|
.It Ic <Enter>
|
|
|
|
Single step next AML opcode (over calls)
|
|
|
|
.El
|
|
|
|
.Ss File I/O Commands
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Ic Close
|
|
|
|
Close debug output file
|
|
|
|
.It Ic Open Ar Filename
|
|
|
|
Open a file for debug output
|
|
|
|
.It Ic Load Ar Filename
|
|
|
|
Load ACPI table from a file
|
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr acpi 4 ,
|
|
|
|
.Xr acpidump 8 ,
|
|
|
|
.Xr iasl 8
|
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm
|
2004-06-06 17:49:57 +00:00
|
|
|
utility first appeared in the
|
|
|
|
.Nm acpicatools
|
|
|
|
port.
|
2003-08-07 18:09:17 +00:00
|
|
|
It was imported for
|
|
|
|
.Fx 5.2 .
|
|
|
|
.Sh AUTHORS
|
|
|
|
.An -nosplit
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility was written by
|
2014-06-20 09:57:27 +00:00
|
|
|
.An Mitsuru Iwasaki Aq Mt iwasaki@FreeBSD.org
|
2003-08-07 18:09:17 +00:00
|
|
|
and uses Intel ACPI-CA for the backend.
|
|
|
|
This manual page was written by
|
|
|
|
.An Nate Lawson .
|