Blame SOURCES/iasl.1

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