NAME    [Toc]    [Back]

     acpidb -- ACPI DSDT debugger

SYNOPSIS    [Toc]    [Back]

     acpidb input-file

DESCRIPTION    [Toc]    [Back]

     The acpidb utility is a debugger for the ACPI DSDT.  It can parse and
     execute various AML methods and display the result.

COMMANDS    [Toc]    [Back]

   General-Purpose Commands
     Allocations
	     Display list of current memory allocations

     Dump Address|Namepath [Byte|Word|Dword|Qword]
	     Display ACPI objects or memory

     EnableAcpi    [Toc]    [Back]
	     Enable ACPI (hardware) mode

     Help    Show various help screens.

     History    [Toc]    [Back]
	     Display command history buffer

     Level DebugLevel [console]
	     Get/Set debug level for file or console

     Locks   Current status of internal mutexes

     Quit or Exit    [Toc]    [Back]
	     Exit the debugger

     Stats [Allocations|Memory|Misc|Objects|Tables]
	     Display namespace and memory statistics

     Tables  Display info about loaded ACPI tables

     Unload TableSig [Instance]
	     Unload an ACPI table

     ! CommandNumber
	     Execute command from history buffer

     !!      Execute last command again

   Namespace Access Commands    [Toc]    [Back]
     Event F|G Value
	     Generate AcpiEvent (Fixed/GPE)

     Find Name
	     Find ACPI name(s) with wildcards (? is wildcard).

     Method  Display list of loaded control methods

     Namespace [<Addr>|<Path> [Depth]]
	     Display loaded namespace tree/subtree

     Notify NamePath Value
	     Send a notification

     Objects ObjectType
	     Display all objects of the given type

     Owner OwnerId [Depth]
	     Display loaded namespace by object owner

     Prefix [NamePath]
	     Set or Get current execution prefix

     References Addr
	     Find all references to object at addr

     Resources    [Toc]    [Back]
	     Get and display resources

     Terminate    [Toc]    [Back]
	     Delete namespace and all internal objects

     Thread Threads Loops NamePath
	     Spawn threads to execute method(s)

   Control Method Execution Commands    [Toc]    [Back]
     Arguments
	     (Args) Display method arguments

     Breakpoint AmlOffset
	     Set an AML execution breakpoint

     Call    Run to next control method invocation

     Debug Namepath [Arguments]
	     Single Step a control method

     Execute Namepath [Arguments]
	     Execute control method

     Go      Allow method to run to completion

     Information    [Toc]    [Back]
	     Display info about the current method

     Into    Step into (not over) a method call

     List [OpcodeCount]
	     Display method ASL statements

     Locals  Display method local variables

     Results    [Toc]    [Back]
	     Display method result stack

     Set A|L # Value
	     Set method data (Arguments/Locals)

     Stop    Terminate control method

     Tree    Display control method calling tree

     <Enter>
	     Single step next AML opcode (over calls)

   File I/O Commands
     Close   Close debug output file

     Open Filename
	     Open a file for debug output

     Load Filename
	     Load ACPI table from a file

SEE ALSO    [Toc]    [Back]

     acpi(4), acpidump(8), iasl(8)

HISTORY    [Toc]    [Back]

     The acpidb utility first appeared in the acpicatools port.  It was
     imported for FreeBSD 5.2.

AUTHORS    [Toc]    [Back]

     The acpidb utility was written by Mitsuru Iwasaki <iwasaki@FreeBSD.org>
     and uses Intel ACPI-CA for the backend.  This manual page was written by
     Nate Lawson.


FreeBSD 5.2.1			August 7, 2003			 FreeBSD 5.2.1