1.\" $NetBSD: iasl.8,v 1.4 2014/03/18 18:20:36 riastradh Exp $ 2.\" 3.\" Copyright (c) 2010 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Jukka Ruohonen. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd April 10, 2010 31.Os 32.Dt IASL 8 33.Sh NAME 34.Nm iasl 35.Nd Intel ASL compiler and disassembler 36.Tn Pq iASL 37.Sh SYNOPSIS 38.Nm 39.Op Ar options 40.Ao Ar input file Ac 41.Sh DESCRIPTION 42The 43.Nm 44is a fully-featured compiler for the 45.Tn ACPI 46Source Language 47.Tn Pq ASL . 48It translates 49.Tn ASL 50to 51.Tn ACPI 52Machine Language 53.Tn Pq AML , 54but 55.Nm 56can also act as a disassembler, translating 57.Tn AML 58to 59.Tn ASL . 60.Sh OPTIONS 61.Ss Global 62.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 63.It Fl @ Ar file 64Specify command file. 65.It Fl I Ar dir 66Specify additional include directory. 67.El 68.Ss General Output 69.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 70.It Fl p Ar prefix 71Specify a path or filename 72.Ar prefix 73for all output files. 74.It Fl va 75Disable all errors and warnings in the summary. 76.It Fl vi 77Use less verbose errors and warnings. 78.It Fl vo 79Enable optimization comments. 80.It Fl vr 81Disable remarks. 82.It Fl vs 83Disable signon. 84.It Fl w Ar 1 | 2 | 3 85Set warning reporting level. 86.El 87.Ss AML Output Files 88.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 89.It Fl s Ar a | c 90Create 91.Tn AML 92in assembler 93.Pq Pa *.asm 94or C 95.Pq Pa *.c 96source file. 97.It Fl i Ar a | c 98Create assembler 99.Pq Pa *.inc 100or C 101.Pq Pa *.h 102include file. 103.It Fl t Ar a | c 104Create AML in assembler or C hex table 105.Pq Pa *.hex . 106.El 107.Ss AML Code Generation 108.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 109.It Fl oa 110Disable all optimizations (compatibility mode). 111.It Fl of 112Disable constant folding. 113.It Fl oi 114Disable integer optimization to operation codes. 115.It Fl on 116Disable named reference string optimization. 117.It Fl r Ar revision 118Override table header 119.Ar revision 120(1-255). 121.El 122.Ss Listings 123.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 124.It Fl l 125Create mixed, 126.Tn ASL 127and 128.Tn AML , 129listing file 130.Pq Pa *.lst . 131.It Fl ln 132Create namespace file 133.Pq Pa *.nsp . 134.It Fl ls 135Create combined source file 136.Pq Pa *.src . 137.El 138.Ss AML Disassembler 139.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 140.It Fl d Ar file 141Disassemble binary 142.Tn ACPI 143table to a 144.Ar file 145.Pq Pa *.dsl . 146.It Fl dc Ar file 147Disassemble 148.Tn AML 149and immediately compile it. 150.It Fl e Ar f1 , f2 151Include 152.Tn ACPI 153table(s) for external symbol resolution. 154.It Fl 2 155Emit 156.Tn ACPI 2.0 157compatible 158.Tn ASL 159code. 160.It Fl g 161Get 162.Tn ACPI 163tables and write to files 164.Pq Pa *.dat . 165.El 166.Ss Help 167.Bl -tag -width "w 1 | 2 | 3 " -offset 4n -compact 168.It Fl h 169Display additional help and compiler debug options. 170.It Fl hc 171Display operators allowed in constant expressions. 172.It Fl hr 173Display 174.Tn ACPI 175reserved method names. 176.El 177.Sh SEE ALSO 178.Xr acpi 4 , 179.Xr acpidump 8 , 180.Xr amldb 8 181.Rs 182.%A Intel Corporation 183.%T iASL Compiler/Disassembler User Reference 184.%N Revision 2.00 185.%D September 18, 2009 186.%U http://www.acpica.org/download/aslcompiler.pdf 187.Re 188.Sh HISTORY 189The 190.Nm 191compiler/disassembler is part of the Intel 192.Tn ACPI 193Component Architecture 194.Tn Pq ACPICA . 195It first appeared in 196.Nx 6.0 . 197.Sh AUTHORS 198.An -nosplit 199Among Intel engineers, 200.An Robert Moore Aq Mt robert.moore@intel.com 201was the chief architect behind 202.Nm . 203This manual page was written for 204.Nx 205by 206.An Jukka Ruohonen Aq Mt jruohonen@iki.fi . 207