Al Stone afae4e
.\" First parameter, NAME, should be all caps
Al Stone afae4e
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
Al Stone afae4e
.\" other parameters are allowed: see man(7), man(1)
Al Stone afae4e
.TH IASL 1 "January 23, 2013"
Al Stone afae4e
.\" Please adjust this date whenever revising the manpage.
Al Stone afae4e
.\"
Al Stone afae4e
.\" Some roff macros, for reference:
Al Stone afae4e
.\" .nh        disable hyphenation
Al Stone afae4e
.\" .hy        enable hyphenation
Al Stone afae4e
.\" .ad l      left justify
Al Stone afae4e
.\" .ad b      justify to both left and right margins
Al Stone afae4e
.\" .nf        disable filling
Al Stone afae4e
.\" .fi        enable filling
Al Stone afae4e
.\" .br        insert line break
Al Stone afae4e
.\" .sp <n>    insert n+1 empty lines
Al Stone afae4e
.\" for manpage-specific macros, see man(7)
Al Stone afae4e
.SH NAME
Al Stone afae4e
iasl \- ACPI Source Language compiler/decompiler
Al Stone afae4e
.SH SYNOPSIS
Al Stone afae4e
.B iasl
Al Stone afae4e
.RI [ <option> ... ]
Al Stone afae4e
.RI <input-file>
Al Stone afae4e
.B ...
Al Stone afae4e
.SH DESCRIPTION
Al Stone afae4e
This manual page briefly documents the
Al Stone afae4e
.B iasl
Al Stone afae4e
command. The option list is taken from the iasl interactive help.
Al Stone afae4e
.PP
Al Stone afae4e
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
Al Stone afae4e
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
Al Stone afae4e
.\" respectively.
Al Stone afae4e
.B iasl
Al Stone afae4e
is an ASL compiler and decompiler.  This command provides both the ability
Al Stone afae4e
to translate one or more ASL source files to their corresponding AML binary
Al Stone afae4e
files, and the ability to translate AML binary files back to readable
Al Stone afae4e
ASL source.
Al Stone afae4e
.PP
Al Stone afae4e
Much more detailed documentation may be found at
Al Stone afae4e
http://www.acpica.org/documentation/.
Al Stone afae4e
Al Stone afae4e
.SH OPTIONS
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS Global
Al Stone afae4e
.TP
Al Stone afae4e
.B \-@ <file>
Al Stone afae4e
Specify command file
Al Stone afae4e
.TP
Al Stone afae4e
.B \-I <dir>
Al Stone afae4e
Specify additional include directory
Al Stone afae4e
.TP
Al Stone afae4e
.B \-T <sig>|ALL|*
Al Stone afae4e
Create table template file for ACPI <sig>
Al Stone afae4e
.TP
Al Stone afae4e
.B \-v
Al Stone afae4e
Display compiler version
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS Preprocessor
Al Stone afae4e
.TP
Al Stone afae4e
.B \-D <symbol>
Al Stone afae4e
Define sybol for preprocessor use
Al Stone afae4e
.TP
Al Stone afae4e
.B \-li
Al Stone afae4e
Create prepocessed output file (*.i)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-P
Al Stone afae4e
Preprocess only and create preprocessor output file (*.i)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-Pn
Al Stone afae4e
Disable preprocessor
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS General Output
Al Stone afae4e
.TP
Al Stone afae4e
.B \-p <prefix>
Al Stone afae4e
Specify path/filename prefix for all output files
Al Stone afae4e
.TP
Al Stone afae4e
.B \-va
Al Stone afae4e
Disable all errors and warnings (summary only)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-vi
Al Stone afae4e
Less verbose errors and warnings for use with IDEs
Al Stone afae4e
.TP
Al Stone afae4e
.B \-vo
Al Stone afae4e
Enable optimization comments
Al Stone afae4e
.TP
Al Stone afae4e
.B \-vr
Al Stone afae4e
Disable remarks
Al Stone afae4e
.TP
Al Stone afae4e
.B \-vs
Al Stone afae4e
Disable signon
Al Stone afae4e
.TP
Al Stone afae4e
.B \-w{1|2|3}
Al Stone afae4e
Set warning reporting level
Al Stone afae4e
.TP
Al Stone afae4e
.B \-we
Al Stone afae4e
Report warnings as errors
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS AML and Data Output Files
Al Stone afae4e
.TP
Al Stone afae4e
.B \-s{a|c}
Al Stone afae4e
Create assembler or C source file (*.asm or *.c)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-i{a|c}
Al Stone afae4e
Create assembler or C include file (*.inc or *.h)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-t{a|c|s}
Al Stone afae4e
Create assembler, C, or ASL hex table (*.hex)
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS AML Code Generation
Al Stone afae4e
.TP
Al Stone afae4e
.B \-oa
Al Stone afae4e
Disable all optimizations (compatibility mode)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-of
Al Stone afae4e
Disable constant folding
Al Stone afae4e
.TP
Al Stone afae4e
.B \-oi
Al Stone afae4e
Disable integer optimization to Zero/One/Ones
Al Stone afae4e
.TP
Al Stone afae4e
.B \-on
Al Stone afae4e
Disable named reference string optimization
Al Stone afae4e
.TP
Al Stone afae4e
.B \-cr
Al Stone afae4e
Disable Resource Descriptor error checking
Al Stone afae4e
.TP
Al Stone afae4e
.B \-in
Al Stone afae4e
Ignore NoOp operators
Al Stone afae4e
.TP
Al Stone afae4e
.B \-r <revision>
Al Stone afae4e
Override table header Revision (1-255)
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS ASL Listing Files
Al Stone afae4e
.TP
Al Stone afae4e
.B \-l
Al Stone afae4e
Create mixed listing file (ASL source and AML) (*.lst)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-ln
Al Stone afae4e
Create namespace file (*.nsp)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-ls
Al Stone afae4e
Create combined source file (expanded includes) (*.src)
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS ACPI Data Tables
Al Stone afae4e
.TP
Al Stone afae4e
.B \-G
Al Stone afae4e
Compile custom table containing generic operators
Al Stone afae4e
.TP
Al Stone afae4e
.B \-vt
Al Stone afae4e
Create verbose templates (full disassembly)
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS AML Disassembler
Al Stone afae4e
.TP
Al Stone afae4e
.B \-d [<file>]
Al Stone afae4e
Disassemble AML to ASL source code file (*.dsl)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-da [<file1>,<file2>]
Al Stone afae4e
Disassemble multiple tables from single namespace
Al Stone afae4e
.TP
Al Stone afae4e
.B \-db
Al Stone afae4e
Do not translate Buffers to Resource Templates
Al Stone afae4e
.TP
Al Stone afae4e
.B \-dc [<file>]
Al Stone afae4e
Disassemble AML and immediately compile it
Al Stone afae4e
.br
Al Stone afae4e
(Obtain DSDT from current system if no input file)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-e [<file1>,<file2>]
Al Stone afae4e
Include ACPI table(s) for external symbol resolution
Al Stone afae4e
.TP
Al Stone afae4e
.B \-g
Al Stone afae4e
Get ACPI tables and write to files (*.dat)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-in
Al Stone afae4e
Ignore NoOp opcodes
Al Stone afae4e
.TP
Al Stone afae4e
.B \-vt
Al Stone afae4e
Dump binary table date in hex format within output file
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS Help
Al Stone afae4e
.TP
Al Stone afae4e
.B \-h
Al Stone afae4e
Additional help and compiler debug options
Al Stone afae4e
.TP
Al Stone afae4e
.B \-hc
Al Stone afae4e
Display operators allowed in constant expressions
Al Stone afae4e
.TP
Al Stone afae4e
.B \-hf
Al Stone afae4e
Display help for output file name generation
Al Stone afae4e
.TP
Al Stone afae4e
.B \-hr
Al Stone afae4e
Display ACPI reserved method names
Al Stone afae4e
.TP
Al Stone afae4e
.B \-ht
Al Stone afae4e
Display currently supported ACPI table names
Al Stone afae4e
Al Stone afae4e
.PP
Al Stone afae4e
.SS Debug
Al Stone afae4e
.TP
Al Stone afae4e
.B \-b{f|t}
Al Stone afae4e
Create debug file (full or parse tree only) (*.txt)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-f
Al Stone afae4e
Ignore errors, force creation of AML output file(s)
Al Stone afae4e
.TP
Al Stone afae4e
.B \-n
Al Stone afae4e
Parse only, no output generation
Al Stone afae4e
.TP
Al Stone afae4e
.B \-ot
Al Stone afae4e
Display compiles times and statistics
Al Stone afae4e
.TP
Al Stone afae4e
.B \-x <level>
Al Stone afae4e
Set debug level for trace output
Al Stone afae4e
.TP
Al Stone afae4e
.B \-z
Al Stone afae4e
Do not insert new compiler ID for DataTables
Al Stone afae4e
Al Stone afae4e
.SH AUTHOR
Al Stone afae4e
iasl was written by Robert Moore <robert.moore@intel.com>.
Al Stone afae4e
.PP
Al Stone afae4e
This manual page was written by Mattia Dongili <malattia@debian.org>,
Al Stone afae4e
for the Debian project (but may be used by others).  It was updated for
Al Stone afae4e
the Fedora project by Al Stone <ahs3@redhat.com> (and may also be used
Al Stone afae4e
by others).