18285491eSNate Lawson.\"- 28285491eSNate Lawson.\" Copyright (c) 2003 Nate Lawson 38285491eSNate Lawson.\" All rights reserved. 48285491eSNate Lawson.\" 58285491eSNate Lawson.\" Redistribution and use in source and binary forms, with or without 68285491eSNate Lawson.\" modification, are permitted provided that the following conditions 78285491eSNate Lawson.\" are met: 88285491eSNate Lawson.\" 1. Redistributions of source code must retain the above copyright 98285491eSNate Lawson.\" notice, this list of conditions and the following disclaimer 108285491eSNate Lawson.\" in this position and unchanged. 118285491eSNate Lawson.\" 2. Redistributions in binary form must reproduce the above copyright 128285491eSNate Lawson.\" notice, this list of conditions and the following disclaimer in the 138285491eSNate Lawson.\" documentation and/or other materials provided with the distribution. 148285491eSNate Lawson.\" 3. The name of the author may not be used to endorse or promote products 158285491eSNate Lawson.\" derived from this software without specific prior written permission. 168285491eSNate Lawson.\" 178285491eSNate Lawson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 188285491eSNate Lawson.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 198285491eSNate Lawson.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 208285491eSNate Lawson.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 218285491eSNate Lawson.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 228285491eSNate Lawson.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 238285491eSNate Lawson.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 248285491eSNate Lawson.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 258285491eSNate Lawson.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 268285491eSNate Lawson.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 278285491eSNate Lawson.\" 2876c586c6SRui Paulo.Dd May 20, 2008 298285491eSNate Lawson.Dt IASL 8 308285491eSNate Lawson.Os 318285491eSNate Lawson.Sh NAME 328285491eSNate Lawson.Nm iasl 338285491eSNate Lawson.Nd Intel ACPI compiler/decompiler 348285491eSNate Lawson.Sh SYNOPSIS 358285491eSNate Lawson.Nm 3676c586c6SRui Paulo.Op Fl 2cefghl 378285491eSNate Lawson.Op Fl b Ar type 388285491eSNate Lawson.Op Fl d Ar file 398285491eSNate Lawson.Op Fl dc Ar file 408285491eSNate Lawson.Op Fl hc 418285491eSNate Lawson.Op Fl hr 428285491eSNate Lawson.Op Fl i Ar type 438285491eSNate Lawson.Op Fl ln 448285491eSNate Lawson.Op Fl ls 458285491eSNate Lawson.Op Fl oa 468285491eSNate Lawson.Op Fl of 478285491eSNate Lawson.Op Fl oi 488285491eSNate Lawson.Op Fl on 498285491eSNate Lawson.Op Fl ot 508285491eSNate Lawson.Op Fl p Ar prefix 518285491eSNate Lawson.Op Fl s Ar type 528285491eSNate Lawson.Op Fl t Ar type 538285491eSNate Lawson.Op Fl vi 548285491eSNate Lawson.Op Fl vo 558285491eSNate Lawson.Op Fl vr 568285491eSNate Lawson.Op Fl vs 578285491eSNate Lawson.Op Fl x Ar level 5876c586c6SRui Paulo.Op Fl w Ar level 598285491eSNate Lawson.Ar input-file 608285491eSNate Lawson.Sh DESCRIPTION 618285491eSNate LawsonThe 628285491eSNate Lawson.Nm 638285491eSNate Lawsonutility is a compiler/decompiler for ACPI Source Language (ASL) 649cdb6ee1SRuslan Ermilovand ACPI Machine Language (AML). 659cdb6ee1SRuslan ErmilovMajor features of 668285491eSNate Lawson.Nm 678285491eSNate Lawsoninclude: 689cdb6ee1SRuslan Ermilov.Bl -bullet -offset indent 698285491eSNate Lawson.It 7076c586c6SRui PauloFull support for the ACPI 3.0b Specification including ASL grammar 718285491eSNate Lawsonelements and operators. 728285491eSNate Lawson.It 738285491eSNate LawsonExtensive compiler syntax and semantic error checking, especially in 749cdb6ee1SRuslan Ermilovthe area of control methods. 759cdb6ee1SRuslan ErmilovThis reduces the number of errors that are 768285491eSNate Lawsonnot discovered until the AML code is actually interpreted (i.e., the 779cdb6ee1SRuslan Ermilovcompile-time error checking reduces the number of run-time errors). 788285491eSNate Lawson.It 798285491eSNate LawsonMultiple types of output files, including formatted listing files with 808285491eSNate Lawsonintermixed source, several types of AML files, and error messages. 818285491eSNate Lawson.El 828285491eSNate Lawson.Sh OPTIONS 838285491eSNate Lawson.Bl -tag -width indent 8476c586c6SRui Paulo.It Fl 2 8576c586c6SRui PauloEmit ACPI 2.0 compatible ASL code. 869cdb6ee1SRuslan Ermilov.It Fl b Sm Cm p | t | b Sm 879cdb6ee1SRuslan ErmilovCreate compiler debug/trace file 889cdb6ee1SRuslan Ermilov.Pq Pa *.txt . 899cdb6ee1SRuslan ErmilovTypes: Parse/Tree/Both. 908285491eSNate Lawson.It Fl c 919cdb6ee1SRuslan ErmilovParse only, no output generation. 928285491eSNate Lawson.It Fl d Ar file 939cdb6ee1SRuslan ErmilovDisassemble AML to ASL source code file 949cdb6ee1SRuslan Ermilov.Pq Pa *.dsl . 958285491eSNate Lawson.It Fl dc Ar file 969cdb6ee1SRuslan ErmilovDisassemble AML and immediately compile it. 979cdb6ee1SRuslan Ermilov(Obtain DSDT from current system if no input file.) 988285491eSNate Lawson.It Fl e 999cdb6ee1SRuslan ErmilovGenerate 1009cdb6ee1SRuslan Ermilov.Fn External 1019cdb6ee1SRuslan Ermilovstatements for unresolved symbols. 1028285491eSNate Lawson.It Fl f 1039cdb6ee1SRuslan ErmilovIgnore errors, force creation of AML output file(s). 1048285491eSNate Lawson.It Fl g 1059cdb6ee1SRuslan ErmilovGet ACPI tables and write to files 1069cdb6ee1SRuslan Ermilov.Pq Pa *.dat . 1078285491eSNate Lawson.It Fl h 1089cdb6ee1SRuslan ErmilovAdditional help and compiler debug options. 1098285491eSNate Lawson.It Fl hc 1109cdb6ee1SRuslan ErmilovDisplay operators allowed in constant expressions. 1118285491eSNate Lawson.It Fl hr 1129cdb6ee1SRuslan ErmilovDisplay ACPI reserved method names. 1139cdb6ee1SRuslan Ermilov.It Fl i Sm Cm a | c Sm 1149cdb6ee1SRuslan ErmilovCreate assembler or C include file 1159cdb6ee1SRuslan Ermilov.Pa ( *.inc 1169cdb6ee1SRuslan Ermilovor 1179cdb6ee1SRuslan Ermilov.Pa *.h ) . 1188285491eSNate Lawson.It Fl l 1199cdb6ee1SRuslan ErmilovCreate mixed listing file (ASL source and AML) 1209cdb6ee1SRuslan Ermilov.Pq Pa *.lst . 1218285491eSNate Lawson.It Fl ln 1229cdb6ee1SRuslan ErmilovCreate namespace file 1239cdb6ee1SRuslan Ermilov.Pq Pa *.nsp . 1248285491eSNate Lawson.It Fl ls 1259cdb6ee1SRuslan ErmilovCreate combined source file (expanded includes) 1269cdb6ee1SRuslan Ermilov.Pq Pa *.src . 1278285491eSNate Lawson.It Fl oa 1289cdb6ee1SRuslan ErmilovDisable all optimizations (compatibility mode). 1298285491eSNate Lawson.It Fl of 1309cdb6ee1SRuslan ErmilovDisable constant folding. 1318285491eSNate Lawson.It Fl oi 1329cdb6ee1SRuslan ErmilovDisable integer optimization to Zero/One/Ones. 1338285491eSNate Lawson.It Fl on 1349cdb6ee1SRuslan ErmilovDisable named reference string optimization. 1358285491eSNate Lawson.It Fl ot 1369cdb6ee1SRuslan ErmilovDisplay compile times. 1378285491eSNate Lawson.It Fl p Ar prefix 1389cdb6ee1SRuslan ErmilovSpecify filename prefix for all output files (including 1399cdb6ee1SRuslan Ermilov.Pa .aml ) . 1409cdb6ee1SRuslan Ermilov.It Fl s Sm Cm a | c Sm 1419cdb6ee1SRuslan ErmilovCreate AML in assembler or C source file 1429cdb6ee1SRuslan Ermilov.Pa ( *.asm 1439cdb6ee1SRuslan Ermilovor 1449cdb6ee1SRuslan Ermilov.Pa *.c ) . 1458285491eSNate Lawson.It Fl t Ar a|c 1469cdb6ee1SRuslan ErmilovCreate AML in assembler or C hex table 1479cdb6ee1SRuslan Ermilov.Pq Pa *.hex . 1488285491eSNate Lawson.It Fl vi 1499cdb6ee1SRuslan ErmilovLess verbose errors and warnings for use with IDEs. 1508285491eSNate Lawson.It Fl vo 1519cdb6ee1SRuslan ErmilovEnable optimization comments. 1528285491eSNate Lawson.It Fl vr 1539cdb6ee1SRuslan ErmilovDisable remarks. 1548285491eSNate Lawson.It Fl vs 1559cdb6ee1SRuslan ErmilovDisable signon. 1568285491eSNate Lawson.It Fl x Ar level 1579cdb6ee1SRuslan ErmilovSet debug level for trace output. 15876c586c6SRui Paulo.It Fl w Ar level 15976c586c6SRui PauloSet warning level. 1608285491eSNate Lawson.El 1618285491eSNate Lawson.Sh SEE ALSO 1628285491eSNate Lawson.Xr acpi 4 , 1638285491eSNate Lawson.Xr acpidump 8 1648285491eSNate Lawson.Sh HISTORY 1658285491eSNate LawsonThe 1668285491eSNate Lawson.Nm 1679cdb6ee1SRuslan Ermilovutility is provided with Intel ACPI-CA. 1689cdb6ee1SRuslan ErmilovIt first appeared in 1698285491eSNate Lawson.Fx 5.2 . 1708285491eSNate Lawson.Sh AUTHORS 1718285491eSNate Lawson.An -nosplit 1728285491eSNate LawsonThe 1738285491eSNate Lawson.Nm 1748285491eSNate Lawsonutility was written by 1758285491eSNate Lawson.An Intel . 1768285491eSNate LawsonThis manual page was written by 1778285491eSNate Lawson.An Nate Lawson . 178