2 .\" Copyright (c) 2014 The DragonFly Project. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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
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.
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
36 .Nd ACPI Source Language compiler, ACPI table compiler, and AML disassembler
42 The following options are supported:
43 .Bl -tag -width indent
47 Enable reference typechecking.
49 Create debug file (full tree only) (*.txt).
53 Create debug file (parse tree only) (*.txt).
55 Object type to be pruned from the parse tree.
57 Disable Resource Descriptor error checking.
58 .It Fl d Ar file1 Op Ar file2
59 Disassemble or decode binary ACPI tables to file (*.dsl).
62 is optional, file type is automatically detected.
64 Define symbol for preprocessor use.
66 Disassemble multiple tables from single namespace.
68 Do not translate Buffers to Resource Templates.
70 Disassemble AML and immediately compile it.
71 Obtain the DSDT from the current system if no input file has it.
73 Force the disassembler to assume the table contains valid AML.
75 Emit legacy ASL code only (no C-style operators).
79 Include ACPI table(s) for external symbol resolution.
81 Ignore errors, force creation of AML output file(s).
83 Specify external symbol declaration file.
85 Compile custom table that contains generic operators.
87 Display the help message.
89 Display operators allowed in constant expressions.
91 Info for obtaining and disassembling binary ACPI tables.
93 Display help for output filename generation.
95 Display ACPI reserved method names.
97 Display currently supported ACPI table names.
99 Specify additional include directory.
101 Create include file in assembler (*.inc).
103 Create include file in C (*.h).
105 When disassembling, ignore NoOp opcodes.
106 When compiling, ignore NoOp operators.
108 When compiling, create mixed listing file (ASL source and AML) (*.lst).
109 When disassembling, disassemble to mixed ASL and AML code.
111 Create preprocessed output file (*.i).
113 Create hardware summary map file (*.map).
115 Create namespace file (*.nsp).
117 Create combined source file (expanded includes) (*.src).
119 Create cross-reference file (*.xrf).
121 Set internal line buffer size (in Kbytes).
123 Parse only, no output generation.
125 Disable all optimizations (compatibility mode).
127 Display compile times and statistics.
129 Disable constant folding.
131 Disable integer optimization to Zero/One/Ones.
133 Disable named reference string optimization.
135 Disable typechecking.
137 Preprocess only and create preprocessor output file (*.i).
139 Specify path/filename prefix for all output files.
141 Disable preprocessor.
143 Override table header Revision (1-255).
145 Create source file in assembler (*.asm).
147 Create source file in C (*.c).
149 Create offset table in C (*.offset.h).
150 .It Fl T Ar sig ... | ALL
151 Create ACPI table template/example files.
157 Create hex AML table in assembler (*.hex).
159 Create hex AML table in C (*.hex).
161 Create hex AML table in ASL (*.hex).
163 Display compiler version.
165 Disable all errors/warnings/remarks.
167 Display compiler build date and time.
169 Report only errors (ignore warnings and remarks).
171 Less verbose errors and warnings for use with IDEs.
173 Enable optimization comments.
179 Create verbose template files (full disassembly).
181 Dump binary table data in hex format within output file.
182 .It Fl vw Ar message_id
183 Disable specific warning or remark.
184 .It Fl w Ar 1 | 2 | 3
185 Set warning reporting level.
187 Report warnings as errors.
189 Set debug level for trace output.
191 Do not insert new compiler ID for DataTables.
204 .Lk https://acpica.org/documentation/
206 .Lk https://acpica.org/sites/acpica/files/aslcompiler_9.pdf
210 utility is provided by
216 This manual page was written by