IASL(1)

💖 iasl — ACPI Source Language compiler/decompiler 💖

okay bestie, sit down, hydrate, because we're about to talk about iasl, and honestly? she's iconic. this is the IASL(1) manual page, General Commands Manual energy, and i'm gonna walk you through it like we're texting at 2am. 🫶

---

✨ NAME ✨

iasl — the ACPI Source Language compiler/decompiler. that's her. that's the whole name. short, sweet, does literally everything. 💅

---

🌸 SYNOPSIS 🌸

iasl [<option>...] <input-file> ...

like. you give her options, you give her input files, she goes. that's the vibe. ✨

---

🦋 DESCRIPTION 🦋

so this manual page is a brief lil doc for the iasl command — the option list is pulled straight from iasl's interactive help, no cap. 📝

iasl is an ASL compiler and decompiler. she's giving both directions of the pipeline, main character energy fr fr:

• she can translate one or more ASL source files into their corresponding AML binary files ✨
• and she can translate AML binary files back into readable ASL source 🔄

if you want the much more detailed documentation (and bestie, sometimes you do), it lives at http://www.acpica.org/documentation/. go drink it in. 🍓

---

👑 OPTIONS 👑

🌈 Global

• -@ <file> — specify command file
• -I <dir> — specify an additional include directory
• -T <sig>|ALL|* — create a table template file for ACPI <sig>
• -v — display compiler version

---

🧚 Preprocessor

• -D <symbol> — define a symbol for preprocessor use
• -li — create a preprocessed output file (*.i)
• -P — preprocess only, and create the preprocessor output file (*.i)
• -Pn — disable the preprocessor

---

💜 General Output

• -p <prefix> — specify path/filename prefix for all output files
• -va — disable all errors and warnings (summary only)
• -vi — less verbose errors and warnings, for use with IDEs
• -vo — enable optimization comments
• -vr — disable remarks
• -vs — disable signon
• -w{1|2|3} — set the warning reporting level
• -we — report warnings as errors

---

🎀 AML and Data Output Files

• -s{a|c} — create an assembler or C source file (*.asm or *.c)
• -i{a|c} — create an assembler or C include file (*.inc or *.h)
• -t{a|c|s} — create an assembler, C, or ASL hex table (*.hex)

---

🔥 AML Code Generation

• -oa — disable all optimizations (compatibility mode)
• -of — disable constant folding
• -oi — disable integer optimization to Zero/One/Ones
• -on — disable named reference string optimization
• -cr — disable Resource Descriptor error checking
• -in — ignore NoOp operators
• -r <revision> — override the table header Revision (1-255)

---

⭐ ASL Listing Files

• -l — create a mixed listing file (ASL source and AML) (*.lst)
• -ln — create a namespace file (*.nsp)
• -ls — create a combined source file (expanded includes) (*.src)

---

💀 ACPI Data Tables

• -G — compile a custom table containing generic operators
• -vt — create verbose templates (full disassembly)

---

🌸 AML Disassembler

• -d [<file>] — disassemble AML to an ASL source code file (*.dsl)
• -da [<file1>,<file2>] — disassemble multiple tables from a single namespace
• -db — do not translate Buffers to Resource Templates
• -dc [<file>] — disassemble AML and immediately compile it (obtain DSDT from the current system if there's no input file)
• -e [<file1>,<file2>] — include ACPI table(s) for external symbol resolution
• -g — get ACPI tables and write them to files (*.dat)
• -in — ignore NoOp opcodes
• -vt — dump binary table data in hex format within the output file

---

🫶 Help

• -h — additional help and compiler debug options
• -hc — display operators allowed in constant expressions
• -hf — display help for output file name generation
• -hr — display ACPI reserved method names
• -ht — display currently supported ACPI table names

---

🙈 Debug

• -b{f|t} — create a debug file (full, or parse tree only) (*.txt)
• -f — ignore errors, force creation of the AML output file(s)

bestie. listen. -f literally means ignore errors and force it anyway. that's not a suggestion, that's a warning label. 💀

• -n — parse only, no output generation
• -ot — display compile times and statistics
• -x <level> — set the debug level for trace output
• -z — do not insert a new compiler ID for DataTables

---

💖 AUTHOR 💖

iasl was written by Robert Moore <robert.moore@intel.com>. 👑

this manual page was written by Mattia Dongili <malattia@debian.org>, for the Debian project (but it may be used by others). it was updated for the Fedora project by Al Stone <ahs3@redhat.com> (and may also be used by others). 🫶

---

and that's the whole page, bestie!! 💅✨ this version of the iasl man page is dated January 23, 2013, it belongs to the IASL(1) era of things, and honestly? she ate. go compile something. periodt. 🎀🦋