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