iasl.8 (8285491e78ad3a831f8fc124448b5e2be546f0aa) iasl.8 (9cdb6ee1641e84242a1640055e0072ad693e1a7d)
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

--- 11 unchanged lines hidden (view full) ---

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.\"
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

--- 11 unchanged lines hidden (view full) ---

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$
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

--- 20 unchanged lines hidden (view full) ---

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)
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

--- 20 unchanged lines hidden (view full) ---

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