usr.sbin/acpi/iasl/iasl.8

   1 .\"
   2 .\" Copyright (c) 2014 The DragonFly Project.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\"
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in
  12 .\"    the documentation and/or other materials provided with the
  13 .\"    distribution.
  14 .\" 3. Neither the name of The DragonFly Project nor the names of its
  15 .\"    contributors may be used to endorse or promote products derived
  16 .\"    from this software without specific, prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  21 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  22 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  24 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  26 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  27 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  28 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .Dd May 29, 2020
  32 .Dt IASL 8
  33 .Os
  34 .Sh NAME
  35 .Nm iasl
  36 .Nd ACPI Source Language compiler, ACPI table compiler, and AML disassembler
  37 .Sh SYNOPSIS
  38 .Nm
  39 .Op Ar option ...
  40 .Op Ar file ...
  41 .Sh DESCRIPTION
  42 The following options are supported:
  43 .Bl -tag -width indent
  44 .It Fl @ Ar file
  45 Specify command file.
  46 .It Fl ar
  47 Enable reference typechecking.
  48 .It Fl bc
  49 Create converter debug file (*.cdb).
  50 .It Fl bf
  51 Create debug file (full tree only) (*.txt).
  52 .It Fl bp Ar depth
  53 Prune ASL parse tree.
  54 .It Fl bs
  55 Create debug file (parse tree only) (*.txt).
  56 .It Fl bt Ar type
  57 Object type to be pruned from the parse tree.
  58 .It Fl ca
  59 Convert legacy-ASL source file to new ASL+ file
  60 (Original comments are passed through to ASL+ file).
  61 .It Fl cr
  62 Disable Resource Descriptor error checking.
  63 .It Fl d Ar file1 Op Ar file2
  64 Disassemble or decode binary ACPI tables to file (*.dsl).
  65 The
  66 .Ar file2
  67 is optional, file type is automatically detected.
  68 .It Fl D Ar symbol
  69 Define symbol for preprocessor use.
  70 .It Fl da Ar file ...
  71 Disassemble multiple tables from single namespace.
  72 .It Fl db
  73 Do not translate Buffers to Resource Templates.
  74 .It Fl dc Ar file ...
  75 Disassemble AML and immediately compile it.
  76 Obtain the DSDT from the current system if no input file has it.
  77 .It Fl df
  78 Force the disassembler to assume the table contains valid AML.
  79 .It Fl dl
  80 Emit legacy ASL code only (no C-style operators).
  81 .It Fl dv
  82 Set verbose option.
  83 .It Fl e Ar file ...
  84 Include ACPI table(s) for external symbol resolution.
  85 .It Fl f
  86 Ignore errors, force creation of AML output file(s).
  87 .It Fl fe Ar file
  88 Specify external symbol declaration file.
  89 .It Fl G
  90 Compile custom table that contains generic operators.
  91 .It Fl h
  92 Display the help message.
  93 .It Fl hc
  94 Display operators allowed in constant expressions.
  95 .It Fl hd
  96 Info for obtaining and disassembling binary ACPI tables.
  97 .It Fl hf
  98 Display help for output filename generation.
  99 .It Fl hr
 100 Display ACPI reserved method names.
 101 .It Fl ht
 102 Display currently supported ACPI table names.
 103 .It Fl I Ar directory
 104 Specify additional include directory.
 105 .It Fl ia
 106 Create include file in assembler (*.inc).
 107 .It Fl ic
 108 Create include file in C (*.h).
 109 .It Fl in
 110 When disassembling, ignore NoOp opcodes.
 111 When compiling, ignore NoOp operators.
 112 .It Fl l
 113 When compiling, create mixed listing file (ASL source and AML) (*.lst).
 114 When disassembling, disassemble to mixed ASL and AML code.
 115 .It Fl li
 116 Create preprocessed output file (*.i).
 117 .It Fl lm
 118 Create hardware summary map file (*.map).
 119 .It Fl ln
 120 Create namespace file (*.nsp).
 121 .It Fl ls
 122 Create combined source file (expanded includes) (*.src).
 123 .It Fl lx
 124 Create cross-reference file (*.xrf).
 125 .It Fl m Ar size
 126 Set internal line buffer size (in Kbytes).
 127 .It Fl n
 128 Parse only, no output generation.
 129 .It Fl oa
 130 Disable all optimizations (compatibility mode).
 131 .It Fl oc
 132 Display compile times and statistics.
 133 .It Fl od
 134 Disable disassembler code optimizations.
 135 .It Fl of
 136 Disable constant folding.
 137 .It Fl oi
 138 Disable integer optimization to Zero/One/Ones.
 139 .It Fl on
 140 Disable named reference string optimization.
 141 .It Fl ot
 142 Disable typechecking.
 143 .It Fl P
 144 Preprocess only and create preprocessor output file (*.i).
 145 .It Fl p Ar prefix
 146 Specify path/filename prefix for all output files.
 147 .It Fl Pn
 148 Disable preprocessor.
 149 .It Fl r Ar revision
 150 Override table header Revision (1-255).
 151 .It Fl sa
 152 Create source file in assembler (*.asm).
 153 .It Fl sc
 154 Create source file in C (*.c).
 155 .It Fl so
 156 Create offset table in C (*.offset.h).
 157 .It Fl T Ar sig ... | ALL
 158 Create ACPI table template/example files.
 159 .It Fl T Ar count
 160 Emit DSDT and
 161 .Ar count
 162 SSDTs to same file.
 163 .It Fl ta
 164 Create hex AML table in assembler (*.hex).
 165 .It Fl tc
 166 Create hex AML table in C (*.hex).
 167 .It Fl tp
 168 Compile tables with flex/bison prototype.
 169 .It Fl ts
 170 Create hex AML table in ASL (*.hex).
 171 .It Fl v
 172 Display compiler version.
 173 .It Fl va
 174 Disable all errors/warnings/remarks.
 175 .It Fl vd
 176 Display compiler build date and time.
 177 .It Fl ve
 178 Report only errors (ignore warnings and remarks).
 179 .It Fl vi
 180 Less verbose errors and warnings for use with IDEs.
 181 .It Fl vo
 182 Enable optimization comments.
 183 .It Fl vr
 184 Disable remarks.
 185 .It Fl vs
 186 Disable signon.
 187 .It Fl vt
 188 Create verbose template files (full disassembly).
 189 .It Fl vt
 190 Dump binary table data in hex format within output file.
 191 .It Fl vw Ar message_id
 192 Ignore specific error, warning or remark.
 193 .It Fl vx Ar message_id
 194 Expect a specific warning, remark, or error.
 195 .It Fl w Ar 1 | 2 | 3
 196 Set warning reporting level.
 197 .It Fl we
 198 Report warnings as errors.
 199 .It Fl ww Ar messageid
 200 Report a specific warning or remark as error.
 201 .It Fl x Ar level
 202 Set debug level for trace output.
 203 .It Fl z
 204 Do not insert new compiler ID for DataTables.
 205 .El
 206 .Sh SEE ALSO
 207 .Xr acpi 4 ,
 208 .Xr acpibin 8 ,
 209 .Xr acpicall 8 ,
 210 .Xr acpiconf 8 ,
 211 .Xr acpidump 8 ,
 212 .Xr acpiexec 8 ,
 213 .Xr acpihelp 8 ,
 214 .Xr acpixtract 8
 215 .Pp
 216 .Lk https://acpica.org/documentation/
 217 .Pp
 218 .Lk https://acpica.org/sites/acpica/files/aslcompiler_9.pdf
 219 .Sh AUTHORS
 220 The
 221 .Nm
 222 utility is provided by
 223 .Tn Intel
 224 as part of their
 225 .Sy ACPICA
 226 distribution.
 227 .Pp
 228 This manual page was written by
 229 .An Sascha Wildner .