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). Major features of 66.Nm 67include: 68.Pp 69.Bl -bullet -compact -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. This 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 b Ar p|t|b 85Create compiler debug/trace file (*.txt). Types: Parse/Tree/Both 86.It Fl c 87Parse only, no output generation 88.It Fl d Ar file 89Disassemble AML to ASL source code file (*.dsl) 90.It Fl dc Ar file 91Disassemble AML and immediately compile it 92(Obtain DSDT from current system if no input file) 93.It Fl e 94Generate External() statements for unresolved symbols 95.It Fl f 96Ignore errors, force creation of AML output file(s) 97.It Fl g 98Get ACPI tables and write to files (*.dat) 99.It Fl h 100Additional help and compiler debug options 101.It Fl hc 102Display operators allowed in constant expressions 103.It Fl hr 104Display ACPI reserved method names 105.It Fl i Ar a|c 106Create assembler or C include file (*.inc or *.h) 107.It Fl l 108Create mixed listing file (ASL source and AML) (*.lst) 109.It Fl ln 110Create namespace file (*.nsp) 111.It Fl ls 112Create combined source file (expanded includes) (*.src) 113.It Fl oa 114Disable all optimizations (compatibility mode) 115.It Fl of 116Disable constant folding 117.It Fl oi 118Disable integer optimization to Zero/One/Ones 119.It Fl on 120Disable named reference string optimization 121.It Fl ot 122Display compile times 123.It Fl p Ar prefix 124Specify filename prefix for all output files (including .aml) 125.It Fl s Ar a|c 126Create AML in assembler or C source file (*.asm or *.c) 127.It Fl t Ar a|c 128Create AML in assembler or C hex table (*.hex) 129.It Fl vi 130Less verbose errors and warnings for use with IDEs 131.It Fl vo 132Enable optimization comments 133.It Fl vr 134Disable remarks 135.It Fl vs 136Disable signon 137.It Fl x Ar level 138Set debug level for trace output 139.El 140.Sh SEE ALSO 141.Xr acpi 4 , 142.Xr acpidump 8 143.Sh HISTORY 144The 145.Nm 146utility is provided with Intel ACPI-CA. It first appeared in 147.Fx 5.2 . 148.Sh AUTHORS 149.An -nosplit 150The 151.Nm 152utility was written by 153.An Intel . 154This manual page was written by 155.An Nate Lawson . 156