1.\"- 2.\" Copyright (c) 2003 Nate Lawson 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 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. 16.\" 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. 27.\" 28.Dd May 20, 2008 29.Dt IASL 8 30.Os 31.Sh NAME 32.Nm iasl 33.Nd Intel ACPI compiler/decompiler 34.Sh SYNOPSIS 35.Nm 36.Op Fl 2cefghl 37.Op Fl b Ar type 38.Op Fl d Ar file 39.Op Fl dc Ar file 40.Op Fl hc 41.Op Fl hr 42.Op Fl i Ar type 43.Op Fl ln 44.Op Fl ls 45.Op Fl oa 46.Op Fl of 47.Op Fl oi 48.Op Fl on 49.Op Fl ot 50.Op Fl p Ar prefix 51.Op Fl s Ar type 52.Op Fl t Ar type 53.Op Fl vi 54.Op Fl vo 55.Op Fl vr 56.Op Fl vs 57.Op Fl x Ar level 58.Op Fl w Ar level 59.Ar input-file 60.Sh DESCRIPTION 61The 62.Nm 63utility is a compiler/decompiler for ACPI Source Language (ASL) 64and ACPI Machine Language (AML). 65Major features of 66.Nm 67include: 68.Bl -bullet -offset indent 69.It 70Full support for the ACPI 3.0b Specification including ASL grammar 71elements and operators. 72.It 73Extensive compiler syntax and semantic error checking, especially in 74the area of control methods. 75This reduces the number of errors that are 76not discovered until the AML code is actually interpreted (i.e., the 77compile-time error checking reduces the number of run-time errors). 78.It 79Multiple types of output files, including formatted listing files with 80intermixed source, several types of AML files, and error messages. 81.El 82.Sh OPTIONS 83.Bl -tag -width indent 84.It Fl 2 85Emit ACPI 2.0 compatible ASL code. 86.It Fl b Sm Cm p | t | b Sm 87Create compiler debug/trace file 88.Pq Pa *.txt . 89Types: Parse/Tree/Both. 90.It Fl c 91Parse only, no output generation. 92.It Fl d Ar file 93Disassemble AML to ASL source code file 94.Pq Pa *.dsl . 95.It Fl dc Ar file 96Disassemble AML and immediately compile it. 97(Obtain DSDT from current system if no input file.) 98.It Fl e 99Generate 100.Fn External 101statements for unresolved symbols. 102.It Fl f 103Ignore errors, force creation of AML output file(s). 104.It Fl g 105Get ACPI tables and write to files 106.Pq Pa *.dat . 107.It Fl h 108Additional help and compiler debug options. 109.It Fl hc 110Display operators allowed in constant expressions. 111.It Fl hr 112Display ACPI reserved method names. 113.It Fl i Sm Cm a | c Sm 114Create assembler or C include file 115.Pa ( *.inc 116or 117.Pa *.h ) . 118.It Fl l 119Create mixed listing file (ASL source and AML) 120.Pq Pa *.lst . 121.It Fl ln 122Create namespace file 123.Pq Pa *.nsp . 124.It Fl ls 125Create combined source file (expanded includes) 126.Pq Pa *.src . 127.It Fl oa 128Disable all optimizations (compatibility mode). 129.It Fl of 130Disable constant folding. 131.It Fl oi 132Disable integer optimization to Zero/One/Ones. 133.It Fl on 134Disable named reference string optimization. 135.It Fl ot 136Display compile times. 137.It Fl p Ar prefix 138Specify filename prefix for all output files (including 139.Pa .aml ) . 140.It Fl s Sm Cm a | c Sm 141Create AML in assembler or C source file 142.Pa ( *.asm 143or 144.Pa *.c ) . 145.It Fl t Ar a|c 146Create AML in assembler or C hex table 147.Pq Pa *.hex . 148.It Fl vi 149Less verbose errors and warnings for use with IDEs. 150.It Fl vo 151Enable optimization comments. 152.It Fl vr 153Disable remarks. 154.It Fl vs 155Disable signon. 156.It Fl x Ar level 157Set debug level for trace output. 158.It Fl w Ar level 159Set warning level. 160.El 161.Sh SEE ALSO 162.Xr acpi 4 , 163.Xr acpidump 8 164.Sh HISTORY 165The 166.Nm 167utility is provided with Intel ACPI-CA. 168It first appeared in 169.Fx 5.2 . 170.Sh AUTHORS 171.An -nosplit 172The 173.Nm 174utility was written by 175.An Intel . 176This manual page was written by 177.An Nate Lawson . 178