Blame SOURCES/iasl.1

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