xref: /freebsd/usr.sbin/acpi/iasl/iasl.8 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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