2 .\" Copyright (c) 2003 Nate Lawson
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer
10 .\" in this position and unchanged.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. The name of the author may not be used to endorse or promote products
15 .\" derived from this software without specific prior written permission.
17 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 .\" $FreeBSD: src/usr.sbin/acpi/iasl/iasl.8,v 1.2 2004/06/13 18:03:39 ru Exp $
29 .\" $DragonFly: src/usr.sbin/acpi/iasl/iasl.8,v 1.1 2004/07/05 00:22:43 dillon Exp $
36 .Nd Intel ACPI compiler/decompiler
65 utility is a compiler/decompiler for ACPI Source Language (ASL)
66 and ACPI Machine Language (AML).
70 .Bl -bullet -offset indent
72 Full support for the ACPI 2.0b Specification including ASL grammar
73 elements and operators.
75 Extensive compiler syntax and semantic error checking, especially in
76 the area of control methods.
77 This reduces the number of errors that are
78 not discovered until the AML code is actually interpreted (i.e., the
79 compile-time error checking reduces the number of run-time errors).
81 Multiple types of output files, including formatted listing files with
82 intermixed source, several types of AML files, and error messages.
85 .Bl -tag -width indent
86 .It Fl b Sm Cm p | t | b Sm
87 Create compiler debug/trace file
89 Types: Parse/Tree/Both.
91 Parse only, no output generation.
93 Disassemble AML to ASL source code file
96 Disassemble AML and immediately compile it.
97 (Obtain DSDT from current system if no input file.)
101 statements for unresolved symbols.
103 Ignore errors, force creation of AML output file(s).
105 Get ACPI tables and write to files
108 Additional help and compiler debug options.
110 Display operators allowed in constant expressions.
112 Display ACPI reserved method names.
113 .It Fl i Sm Cm a | c Sm
114 Create assembler or C include file
119 Create mixed listing file (ASL source and AML)
122 Create namespace file
125 Create combined source file (expanded includes)
128 Disable all optimizations (compatibility mode).
130 Disable constant folding.
132 Disable integer optimization to Zero/One/Ones.
134 Disable named reference string optimization.
136 Display compile times.
138 Specify filename prefix for all output files (including
140 .It Fl s Sm Cm a | c Sm
141 Create AML in assembler or C source file
146 Create AML in assembler or C hex table
149 Less verbose errors and warnings for use with IDEs.
151 Enable optimization comments.
157 Set debug level for trace output.
165 utility is provided with Intel ACPI-CA.
172 utility was written by
174 This manual page was written by