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