1.\" 2.\" Copyright (c) 2014 The DragonFly Project. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in 12.\" the documentation and/or other materials provided with the 13.\" distribution. 14.\" 3. Neither the name of The DragonFly Project nor the names of its 15.\" contributors may be used to endorse or promote products derived 16.\" from this software without specific, prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 21.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 22.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 23.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 24.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 25.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 26.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 27.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 28.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.Dd April 10, 2014 32.Dt IASL 8 33.Os 34.Sh NAME 35.Nm iasl 36.Nd ACPI Source Language compiler, ACPI table compiler, and AML disassembler 37.Sh SYNOPSIS 38.Nm 39.Op Ar option ... 40.Op Ar file ... 41.Sh DESCRIPTION 42The following options are supported: 43.Bl -tag -width indent 44.It Fl @ Ar file 45Specify command file. 46.It Fl bf 47Create debug file (full tree only) (*.txt). 48.It Fl bt 49Create debug file (parse tree only) (*.txt). 50.It Fl cr 51Disable Resource Descriptor error checking. 52.It Fl d Ar file1 Op Ar file2 53Disassemble or decode binary ACPI tables to file (*.dsl). 54The 55.Ar file2 56is optional, file type is automatically detected. 57.It Fl D Ar symbol 58Define symbol for preprocessor use. 59.It Fl da Ar file ... 60Disassemble multiple tables from single namespace. 61.It Fl db 62Do not translate Buffers to Resource Templates. 63.It Fl dc Ar file ... 64Disassemble AML and immediately compile it. 65Obtain the DSDT from the current system if no input file has it. 66.It Fl e Ar file ... 67Include ACPI table(s) for external symbol resolution. 68.It Fl f 69Ignore errors, force creation of AML output file(s). 70.It Fl fe Ar file 71Specify external symbol declaration file. 72.It Fl G 73Compile custom table that contains generic operators. 74.It Fl h 75Display the help message. 76.It Fl hc 77Display operators allowed in constant expressions. 78.It Fl hf 79Display help for output filename generation. 80.It Fl hr 81Display ACPI reserved method names. 82.It Fl ht 83Display currently supported ACPI table names. 84.It Fl I Ar directory 85Specify additional include directory. 86.It Fl ia 87Create include file in assembler (*.inc). 88.It Fl ic 89Create include file in C (*.h). 90.It Fl in 91Ignore NoOp opcodes. 92.It Fl in 93Ignore NoOp operators. 94.It Fl l 95Create mixed listing file (ASL source and AML) (*.lst). 96.It Fl li 97Create preprocessed output file (*.i). 98.It Fl ln 99Create namespace file (*.nsp). 100.It Fl ls 101Create combined source file (expanded includes) (*.src). 102.It Fl m Ar size 103Set internal line buffer size (in Kbytes). 104.It Fl n 105Parse only, no output generation. 106.It Fl oa 107Disable all optimizations (compatibility mode). 108.It Fl of 109Disable constant folding. 110.It Fl oi 111Disable integer optimization to Zero/One/Ones. 112.It Fl on 113Disable named reference string optimization. 114.It Fl ot 115Display compile times and statistics. 116.It Fl P 117Preprocess only and create preprocessor output file (*.i). 118.It Fl p Ar prefix 119Specify path/filename prefix for all output files. 120.It Fl Pn 121Disable preprocessor. 122.It Fl r Ar revision 123Override table header Revision (1-255). 124.It Fl sa 125Create source file in assembler (*.asm). 126.It Fl sc 127Create source file in C (*.c). 128.It Fl so 129Create offset table in C (*.offset.h). 130.It Fl T Ar sig | ALL | * 131Create table template file for ACPI 132.Ar sig . 133.It Fl ta 134Create hex AML table in assembler (*.hex). 135.It Fl tc 136Create hex AML table in C (*.hex). 137.It Fl ts 138Create hex AML table in ASL (*.hex). 139.It Fl v 140Display compiler version. 141.It Fl va 142Disable all errors/warnings/remarks. 143.It Fl ve 144Report only errors (ignore warnings and remarks). 145.It Fl vi 146Less verbose errors and warnings for use with IDEs. 147.It Fl vo 148Enable optimization comments. 149.It Fl vr 150Disable remarks. 151.It Fl vs 152Disable signon. 153.It Fl vt 154Create verbose template files (full disassembly). 155.It Fl vt 156Dump binary table data in hex format within output file. 157.It Fl vw Ar message_id 158Disable specific warning or remark. 159.It Fl w1 | Fl w2 | Fl w3 160Set warning reporting level. 161.It Fl we 162Report warnings as errors. 163.It Fl x Ar level 164Set debug level for trace output. 165.It Fl z 166Do not insert new compiler ID for DataTables. 167.El 168.Sh SEE ALSO 169.Xr acpi 4 , 170.Xr acpibin 8 , 171.Xr acpiconf 8 , 172.Xr acpidump 8 , 173.Xr acpiexec 8 , 174.Xr acpihelp 8 , 175.Xr acpinames 8 , 176.Xr acpixtract 8 177.Pp 178.Lk https://acpica.org/documentation/ 179.Pp 180.Lk https://acpica.org/sites/acpica/files/aslcompiler_5.pdf 181.Sh AUTHORS 182The 183.Nm 184utility is provided by 185.Tn Intel 186as part of their 187.Sy ACPICA 188distribution. 189.Pp 190This manual page was written by 191.An Sascha Wildner . 192