iasl.1

   1 .\" First parameter, NAME, should be all caps
   2 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
   3 .\" other parameters are allowed: see man(7), man(1)
   4 .TH IASL 1 "January 23, 2013"
   5 .\" Please adjust this date whenever revising the manpage.
   6 .\"
   7 .\" Some roff macros, for reference:
   8 .\" .nh        disable hyphenation
   9 .\" .hy        enable hyphenation
  10 .\" .ad l      left justify
  11 .\" .ad b      justify to both left and right margins
  12 .\" .nf        disable filling
  13 .\" .fi        enable filling
  14 .\" .br        insert line break
  15 .\" .sp <n>    insert n+1 empty lines
  16 .\" for manpage-specific macros, see man(7)
  17 .SH NAME
  18 iasl \- ACPI Source Language compiler/decompiler
  19 .SH SYNOPSIS
  20 .B iasl
  21 .RI [ <option> ... ]
  22 .RI <input-file>
  23 .B ...
  24 .SH DESCRIPTION
  25 This manual page briefly documents the
  26 .B iasl
  27 command. The option list is taken from the iasl interactive help.
  28 .PP
  29 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
  30 .\" \fI<whatever>\fP escape sequences to invode bold face and italics,
  31 .\" respectively.
  32 .B iasl
  33 is an ASL compiler and decompiler.  This command provides both the ability
  34 to translate one or more ASL source files to their corresponding AML binary
  35 files, and the ability to translate AML binary files back to readable
  36 ASL source.
  37 .PP
  38 Much more detailed documentation may be found at
  39 http://www.acpica.org/documentation/.
  40
  41 .SH OPTIONS
  42
  43 .PP
  44 .SS Global
  45 .TP
  46 .B \-@ <file>
  47 Specify command file
  48 .TP
  49 .B \-I <dir>
  50 Specify additional include directory
  51 .TP
  52 .B \-T <sig>|ALL|*
  53 Create table template file for ACPI <sig>
  54 .TP
  55 .B \-v
  56 Display compiler version
  57
  58 .PP
  59 .SS Preprocessor
  60 .TP
  61 .B \-D <symbol>
  62 Define sybol for preprocessor use
  63 .TP
  64 .B \-li
  65 Create prepocessed output file (*.i)
  66 .TP
  67 .B \-P
  68 Preprocess only and create preprocessor output file (*.i)
  69 .TP
  70 .B \-Pn
  71 Disable preprocessor
  72
  73 .PP
  74 .SS General Output
  75 .TP
  76 .B \-p <prefix>
  77 Specify path/filename prefix for all output files
  78 .TP
  79 .B \-va
  80 Disable all errors and warnings (summary only)
  81 .TP
  82 .B \-vi
  83 Less verbose errors and warnings for use with IDEs
  84 .TP
  85 .B \-vo
  86 Enable optimization comments
  87 .TP
  88 .B \-vr
  89 Disable remarks
  90 .TP
  91 .B \-vs
  92 Disable signon
  93 .TP
  94 .B \-w{1|2|3}
  95 Set warning reporting level
  96 .TP
  97 .B \-we
  98 Report warnings as errors
  99
 100 .PP
 101 .SS AML and Data Output Files
 102 .TP
 103 .B \-s{a|c}
 104 Create assembler or C source file (*.asm or *.c)
 105 .TP
 106 .B \-i{a|c}
 107 Create assembler or C include file (*.inc or *.h)
 108 .TP
 109 .B \-t{a|c|s}
 110 Create assembler, C, or ASL hex table (*.hex)
 111
 112 .PP
 113 .SS AML Code Generation
 114 .TP
 115 .B \-oa
 116 Disable all optimizations (compatibility mode)
 117 .TP
 118 .B \-of
 119 Disable constant folding
 120 .TP
 121 .B \-oi
 122 Disable integer optimization to Zero/One/Ones
 123 .TP
 124 .B \-on
 125 Disable named reference string optimization
 126 .TP
 127 .B \-cr
 128 Disable Resource Descriptor error checking
 129 .TP
 130 .B \-in
 131 Ignore NoOp operators
 132 .TP
 133 .B \-r <revision>
 134 Override table header Revision (1-255)
 135
 136 .PP
 137 .SS ASL Listing Files
 138 .TP
 139 .B \-l
 140 Create mixed listing file (ASL source and AML) (*.lst)
 141 .TP
 142 .B \-ln
 143 Create namespace file (*.nsp)
 144 .TP
 145 .B \-ls
 146 Create combined source file (expanded includes) (*.src)
 147
 148 .PP
 149 .SS ACPI Data Tables
 150 .TP
 151 .B \-G
 152 Compile custom table containing generic operators
 153 .TP
 154 .B \-vt
 155 Create verbose templates (full disassembly)
 156
 157 .PP
 158 .SS AML Disassembler
 159 .TP
 160 .B \-d [<file>]
 161 Disassemble AML to ASL source code file (*.dsl)
 162 .TP
 163 .B \-da [<file1>,<file2>]
 164 Disassemble multiple tables from single namespace
 165 .TP
 166 .B \-db
 167 Do not translate Buffers to Resource Templates
 168 .TP
 169 .B \-dc [<file>]
 170 Disassemble AML and immediately compile it
 171 .br
 172 (Obtain DSDT from current system if no input file)
 173 .TP
 174 .B \-e [<file1>,<file2>]
 175 Include ACPI table(s) for external symbol resolution
 176 .TP
 177 .B \-g
 178 Get ACPI tables and write to files (*.dat)
 179 .TP
 180 .B \-in
 181 Ignore NoOp opcodes
 182 .TP
 183 .B \-vt
 184 Dump binary table date in hex format within output file
 185
 186 .PP
 187 .SS Help
 188 .TP
 189 .B \-h
 190 Additional help and compiler debug options
 191 .TP
 192 .B \-hc
 193 Display operators allowed in constant expressions
 194 .TP
 195 .B \-hf
 196 Display help for output file name generation
 197 .TP
 198 .B \-hr
 199 Display ACPI reserved method names
 200 .TP
 201 .B \-ht
 202 Display currently supported ACPI table names
 203
 204 .PP
 205 .SS Debug
 206 .TP
 207 .B \-b{f|t}
 208 Create debug file (full or parse tree only) (*.txt)
 209 .TP
 210 .B \-f
 211 Ignore errors, force creation of AML output file(s)
 212 .TP
 213 .B \-n
 214 Parse only, no output generation
 215 .TP
 216 .B \-ot
 217 Display compiles times and statistics
 218 .TP
 219 .B \-x <level>
 220 Set debug level for trace output
 221 .TP
 222 .B \-z
 223 Do not insert new compiler ID for DataTables
 224
 225 .SH AUTHOR
 226 iasl was written by Robert Moore <robert.moore@intel.com>.
 227 .PP
 228 This manual page was written by Mattia Dongili <malattia@debian.org>,
 229 for the Debian project (but may be used by others).  It was updated for
 230 the Fedora project by Al Stone <ahs3@redhat.com> (and may also be used
 231 by others).