ACPIDB(8)

💅 ACPIDB(8) — the ACPI DSDT debugger, bestie edition

okay so real talk, this is the acpidb page from the System Manager's Manual, and it's genuinely iconic — it's a whole debugger for the ACPI DSDT. It parses and executes various AML methods and shows you the result. That's the vibe. Let's get into it 🫶

---

✨ SYNOPSIS ✨

acpidb input-file

---

🦋 DESCRIPTION 🦋

The acpidb utility is a debugger for the ACPI DSDT. It can parse and execute various AML methods and display the result. Like, it literally just does all that. No cap. 🌸

---

🎀 COMMANDS 🎀

💖 General-Purpose Commands 💖

These are your everyday baddies. The main characters, honestly.

• Allocations — display the list of current memory allocations.
• Dump Address | Namepath [Byte | Word | Dword | Qword] — display ACPI objects or memory.
• EnableAcpi — enable ACPI (hardware) mode.
• Help — show the various help screens.
• History — display the command history buffer.
• Level DebugLevel [console] — get/set the debug level for file or console.
• Locks — show the current status of internal mutexes.
• Quit or Exit — exit the debugger. sad but necessary 😭
• Stats [Allocations | Memory | Misc | Objects | Tables] — display namespace and memory statistics.
• Tables — display info about the loaded ACPI tables.
• Unload TableSig [Instance] — unload an ACPI table.
• ! CommandNumber — execute a command from the history buffer.
• !! — execute the last command again. the lazy girlboss classic ✨

🌈 Namespace Access Commands 🌈

All about poking around the namespace. peak main character energy.

• Event F | G Value — generate an AcpiEvent (Fixed/GPE).
• Find Name — find ACPI name(s) with wildcards ('?' is wildcard).
• Method — display the list of loaded control methods.
• Namespace [Addr | Path] [Depth] — display the loaded namespace tree/subtree.
• Notify NamePath Value — send a notification.
• Objects ObjectType — display all objects of the given type.
• Owner OwnerId [Depth] — display the loaded namespace by object owner.
• Prefix [NamePath] — set or get the current execution prefix.
• References Addr — find all references to the object at addr.
• Resources — get and display resources.
• Terminate — delete the namespace and all internal objects. ruthless 💀
• Thread Threads Loops NamePath — spawn threads to execute method(s).

🔥 Control Method Execution Commands 🔥

This is where it gets juicy — actually stepping through methods. step-by-step slay.

• Arguments — (Args) display method arguments.
• Breakpoint AmlOffset — set an AML execution breakpoint.
• Call — run to the next control method invocation.
• Debug Namepath [Arguments] — single step a control method.
• Execute Namepath [Arguments] — execute a control method.
• Go — allow the method to run to completion.
• Information — 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 — display the method result stack.
• Set A | L # Value — set method data (Arguments/Locals).
• Stop — terminate the control method.
• Tree — display the control method calling tree.
• <Enter> — single step the next AML opcode (over calls).

🍓 File I/O Commands 🍓

Filing, but make it cute.

• Close — close the debug output file.
• Open Filename — open a file for debug output.
• Load Filename — load an ACPI table from a file.

---

👑 SEE ALSO 👑

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

---

⭐ HISTORY ⭐

The acpidb utility first appeared in the acpicatools port. It was imported for FreeBSD 5.2. a true veteran, honestly 💜

---

🧚 AUTHORS 🧚

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. absolute legends, both of them 🌟

---

Debian, August 7, 2003 — that's the source, the version era, and the date, bestie. she's been serving since forever and she still ate 💅✨