OS Manuals

/usr/bin/iasl

The ACPI Component Architecture (ACPICA) project provides an open-source operating system-independent implementation of the Advanced Configuration and Power Interface specification (ACPI)

From acpica 20260930-r0 (enterprise-packages), captured 2026-11-08 by running iasl -h (exit 0). permalink

Intel ACPI Component Architecture
ASL+ Optimizing Compiler/Disassembler version 20260930
Copyright (c) 2000 - 2026 Intel Corporation

Supports ACPI Specification Revision 6.5

Usage: iasl [Options] [Files]
Options:

General:
  -@  <file>          Specify command file
  -I  <dir>           Specify additional include directory
  -p  <prefix>        Specify path/filename prefix for all output files
  -v                  Display compiler version
  -vd                 Display compiler build date and time
  -vo                 Enable optimization comments
  -vs                 Disable signon
  -ld                 Disable deterministic output

Help:
  -h                  This message
  -hc                 Display operators allowed in constant expressions
  -hd                 Info for obtaining and disassembling binary ACPI tables
  -hf                 Display help for output filename generation
  -hr                 Display ACPI reserved method names
  -ht                 Display currently supported ACPI table names

Preprocessor:
  -D <symbol>         Define symbol for preprocessor use
  -li                 Create preprocessed output file (*.i)
  -P                  Preprocess only and create preprocessor output file (*.i)
  -Pn                 Disable preprocessor

Errors, Warnings, and Remarks:
  -va                 Disable all errors/warnings/remarks
  -ve                 Report only errors (ignore warnings and remarks)
  -vi                 Less verbose errors and warnings for use with IDEs
  -vr                 Disable remarks
  -vw <messageid>     Ignore specific error, warning or remark
  -vx <messageid>     Expect a specific warning, remark, or error
  -w <1|2|3>          Set warning reporting level
  -we                 Report warnings as errors
  -ww <messageid>     Report specific warning or remark as error

AML Bytecode Generation (*.aml):
  -oa                 Disable all optimizations (compatibility mode)
  -of                 Disable constant folding
  -oi                 Disable integer optimization to Zero/One/Ones
  -on                 Disable named reference string optimization
  -ot                 Disable typechecking
  -cr                 Disable Resource Descriptor error checking
  -in                 Ignore NoOp operators
  -r <revision>       Override table header Revision (1-255)

Listings:
  -l                  Create mixed listing file (ASL source and AML) (*.lst)
  -lm                 Create hardware summary map file (*.map)
  -ln                 Create namespace file (*.nsp)
  -ls                 Create combined source file (expanded includes) (*.src)
  -lx                 Create cross-reference file (*.xrf)

Firmware Support - C Text Output:
  -tc                 Create hex AML table in C (*.hex)
  -sc                 Create named hex AML arrays in C (*.c)
  -ic                 Create include file in C for -sc symbols (*.h)
  -so                 Create namespace AML offset table in C (*.offset.h)

Firmware Support - Assembler Text Output:
  -ta                 Create hex AML table in assembler (*.hex)
  -sa                 Create named hex AML arrays in assembler (*.asm)
  -ia                 Create include file in assembler for -sa symbols (*.inc)

Firmware Support - ASL Text Output:
  -ts                 Create hex AML table in ASL (Buffer object) (*.hex)

Legacy-ASL to ASL+ Converter:
  -ca <file>          Convert legacy-ASL source file to new ASL+ file
                        (Original comments are passed through to ASL+ file)

Data Table Compiler:
  -tp                 Compile tables with flex/bison prototype
  -G                  Compile custom table that contains generic operators
  -T <sig list>|ALL   Create ACPI table template/example files
  -T <count>          Emit DSDT and <count> SSDTs to same file
  -vt                 Create verbose template files (full disassembly)

AML Disassembler:
  -d  <f1 f2 ...>     Disassemble or decode binary ACPI tables to file (*.dsl)
                        (Optional, file type is automatically detected)
  -da <f1 f2 ...>     Disassemble multiple tables from single namespace
  -db                 Do not translate Buffers to Resource Templates
  -dc <f1 f2 ...>     Disassemble AML and immediately compile it
                        (Obtain DSDT from current system if no input file)
  -df                 Force disassembler to assume table contains valid AML
  -dl                 Emit legacy ASL code only (no C-style operators)
  -ds <signature(4)>  Specify a table signature(4) (CDAT table only)
  -e  <f1 f2 ...>     Include ACPI table(s) for external symbol resolution
  -fe <file>          Specify external symbol declaration file
  -in                 Ignore NoOp opcodes
  -l                  Disassemble to mixed ASL and AML code
  -vt                 Dump binary table data in hex format within output file

Debug Options:
  -bc                 Create converter debug file (*.cdb)
  -bf                 Create debug file (full output) (*.txt)
  -bs                 Create debug file (parse tree only) (*.txt)
  -bp <depth>         Prune ASL parse tree
  -bt <type>          Object type to be pruned from the parse tree
  -f                  Ignore errors, force creation of AML output file(s)
  -m <size>           Set internal line buffer size (in Kbytes)
  -n                  Parse only, no output generation
  -oc                 Display compile times and statistics
  -x <level>          Set debug level for trace output
  -z                  Do not insert new compiler ID for DataTables
Options (73)
OptionDescriptionSource
-@<file> Specify command filehelp
-I<dir> Specify additional include directoryhelp
-p<prefix> Specify path/filename prefix for all output fileshelp
-vDisplay compiler versionhelp
-vdDisplay compiler build date and timehelp
-voEnable optimization commentshelp
-vsDisable signonhelp
-ldDisable deterministic outputhelp
-hThis messagehelp
-hcDisplay operators allowed in constant expressionshelp
-hdInfo for obtaining and disassembling binary ACPI tableshelp
-hfDisplay help for output filename generationhelp
-hrDisplay ACPI reserved method nameshelp
-htDisplay currently supported ACPI table nameshelp
-D symbolDefine symbol for preprocessor usehelp
-liCreate preprocessed output file (*.i)help
-PPreprocess only and create preprocessor output file (*.i)help
-PnDisable preprocessorhelp
-vaDisable all errors/warnings/remarkshelp
-veReport only errors (ignore warnings and remarks)help
-viLess verbose errors and warnings for use with IDEshelp
-vrDisable remarkshelp
-vw messageidIgnore specific error, warning or remarkhelp
-vx messageidExpect a specific warning, remark, or errorhelp
-w 1|2|3Set warning reporting levelhelp
-weReport warnings as errorshelp
-ww messageidReport specific warning or remark as errorhelp
-oaDisable all optimizations (compatibility mode)help
-ofDisable constant foldinghelp
-oiDisable integer optimization to Zero/One/Oneshelp
-onDisable named reference string optimizationhelp
-otDisable typecheckinghelp
-crDisable Resource Descriptor error checkinghelp
-inIgnore NoOp operatorshelp
-r revisionOverride table header Revision (1-255)help
-lCreate mixed listing file (ASL source and AML) (*.lst)help
-lmCreate hardware summary map file (*.map)help
-lnCreate namespace file (*.nsp)help
-lsCreate combined source file (expanded includes) (*.src)help
-lxCreate cross-reference file (*.xrf)help
-tcCreate hex AML table in C (*.hex)help
-scCreate named hex AML arrays in C (*.c)help
-icCreate include file in C for -sc symbols (*.h)help
-soCreate namespace AML offset table in C (*.offset.h)help
-taCreate hex AML table in assembler (*.hex)help
-saCreate named hex AML arrays in assembler (*.asm)help
-iaCreate include file in assembler for -sa symbols (*.inc)help
-tsCreate hex AML table in ASL (Buffer object) (*.hex)help
-ca fileConvert legacy-ASL source file to new ASL+ file (Original comments are passed through to ASL+ file)help
-tpCompile tables with flex/bison prototypehelp
-GCompile custom table that contains generic operatorshelp
-T sigCreate ACPI table template/example fileshelp
-vtCreate verbose template files (full disassembly)help
-d<f1 f2 ...> Disassemble or decode binary ACPI tables to file (*.dsl) (Optional, file type is automatically detected)help
-da f1Disassemble multiple tables from single namespacehelp
-dbDo not translate Buffers to Resource Templateshelp
-dc f1Disassemble AML and immediately compile it (Obtain DSDT from current system if no input file)help
-dfForce disassembler to assume table contains valid AMLhelp
-dlEmit legacy ASL code only (no C-style operators)help
-ds signature(4)Specify a table signature(4) (CDAT table only)help
-e<f1 f2 ...> Include ACPI table(s) for external symbol resolutionhelp
-fe fileSpecify external symbol declaration filehelp
-bcCreate converter debug file (*.cdb)help
-bfCreate debug file (full output) (*.txt)help
-bsCreate debug file (parse tree only) (*.txt)help
-bp depthPrune ASL parse treehelp
-bt typeObject type to be pruned from the parse treehelp
-fIgnore errors, force creation of AML output file(s)help
-m sizeSet internal line buffer size (in Kbytes)help
-nParse only, no output generationhelp
-ocDisplay compile times and statisticshelp
-x levelSet debug level for trace outputhelp
-zDo not insert new compiler ID for DataTableshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.