]>
Commit | Line | Data |
---|---|---|
77760c90 JB |
1 | .\" First parameter, NAME, should be all caps |
2 | .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection | |
3 | .\" other parameters are allowed: see man(7), man(1) | |
4 | .TH IASL 1 "January 23, 2013" | |
5 | .\" Please adjust this date whenever revising the manpage. | |
6 | .\" | |
7 | .\" Some roff macros, for reference: | |
8 | .\" .nh disable hyphenation | |
9 | .\" .hy enable hyphenation | |
10 | .\" .ad l left justify | |
11 | .\" .ad b justify to both left and right margins | |
12 | .\" .nf disable filling | |
13 | .\" .fi enable filling | |
14 | .\" .br insert line break | |
15 | .\" .sp <n> insert n+1 empty lines | |
16 | .\" for manpage-specific macros, see man(7) | |
17 | .SH NAME | |
18 | iasl \- ACPI Source Language compiler/decompiler | |
19 | .SH SYNOPSIS | |
20 | .B iasl | |
21 | .RI [ <option> ... ] | |
22 | .RI <input-file> | |
23 | .B ... | |
24 | .SH DESCRIPTION | |
25 | This manual page briefly documents the | |
26 | .B iasl | |
27 | command. The option list is taken from the iasl interactive help. | |
28 | .PP | |
29 | .\" TeX users may be more comfortable with the \fB<whatever>\fP and | |
30 | .\" \fI<whatever>\fP escape sequences to invode bold face and italics, | |
31 | .\" respectively. | |
32 | .B iasl | |
33 | is an ASL compiler and decompiler. This command provides both the ability | |
34 | to translate one or more ASL source files to their corresponding AML binary | |
35 | files, and the ability to translate AML binary files back to readable | |
36 | ASL source. | |
37 | .PP | |
38 | Much more detailed documentation may be found at | |
39 | http://www.acpica.org/documentation/. | |
40 | ||
41 | .SH OPTIONS | |
42 | ||
43 | .PP | |
44 | .SS Global | |
45 | .TP | |
46 | .B \-@ <file> | |
47 | Specify command file | |
48 | .TP | |
49 | .B \-I <dir> | |
50 | Specify additional include directory | |
51 | .TP | |
52 | .B \-T <sig>|ALL|* | |
53 | Create table template file for ACPI <sig> | |
54 | .TP | |
55 | .B \-v | |
56 | Display compiler version | |
57 | ||
58 | .PP | |
59 | .SS Preprocessor | |
60 | .TP | |
61 | .B \-D <symbol> | |
62 | Define sybol for preprocessor use | |
63 | .TP | |
64 | .B \-li | |
65 | Create prepocessed output file (*.i) | |
66 | .TP | |
67 | .B \-P | |
68 | Preprocess only and create preprocessor output file (*.i) | |
69 | .TP | |
70 | .B \-Pn | |
71 | Disable preprocessor | |
72 | ||
73 | .PP | |
74 | .SS General Output | |
75 | .TP | |
76 | .B \-p <prefix> | |
77 | Specify path/filename prefix for all output files | |
78 | .TP | |
79 | .B \-va | |
80 | Disable all errors and warnings (summary only) | |
81 | .TP | |
82 | .B \-vi | |
83 | Less verbose errors and warnings for use with IDEs | |
84 | .TP | |
85 | .B \-vo | |
86 | Enable optimization comments | |
87 | .TP | |
88 | .B \-vr | |
89 | Disable remarks | |
90 | .TP | |
91 | .B \-vs | |
92 | Disable signon | |
93 | .TP | |
94 | .B \-w{1|2|3} | |
95 | Set warning reporting level | |
96 | .TP | |
97 | .B \-we | |
98 | Report warnings as errors | |
99 | ||
100 | .PP | |
101 | .SS AML and Data Output Files | |
102 | .TP | |
103 | .B \-s{a|c} | |
104 | Create assembler or C source file (*.asm or *.c) | |
105 | .TP | |
106 | .B \-i{a|c} | |
107 | Create assembler or C include file (*.inc or *.h) | |
108 | .TP | |
109 | .B \-t{a|c|s} | |
110 | Create assembler, C, or ASL hex table (*.hex) | |
111 | ||
112 | .PP | |
113 | .SS AML Code Generation | |
114 | .TP | |
115 | .B \-oa | |
116 | Disable all optimizations (compatibility mode) | |
117 | .TP | |
118 | .B \-of | |
119 | Disable constant folding | |
120 | .TP | |
121 | .B \-oi | |
122 | Disable integer optimization to Zero/One/Ones | |
123 | .TP | |
124 | .B \-on | |
125 | Disable named reference string optimization | |
126 | .TP | |
127 | .B \-cr | |
128 | Disable Resource Descriptor error checking | |
129 | .TP | |
130 | .B \-in | |
131 | Ignore NoOp operators | |
132 | .TP | |
133 | .B \-r <revision> | |
134 | Override table header Revision (1-255) | |
135 | ||
136 | .PP | |
137 | .SS ASL Listing Files | |
138 | .TP | |
139 | .B \-l | |
140 | Create mixed listing file (ASL source and AML) (*.lst) | |
141 | .TP | |
142 | .B \-ln | |
143 | Create namespace file (*.nsp) | |
144 | .TP | |
145 | .B \-ls | |
146 | Create combined source file (expanded includes) (*.src) | |
147 | ||
148 | .PP | |
149 | .SS ACPI Data Tables | |
150 | .TP | |
151 | .B \-G | |
152 | Compile custom table containing generic operators | |
153 | .TP | |
154 | .B \-vt | |
155 | Create verbose templates (full disassembly) | |
156 | ||
157 | .PP | |
158 | .SS AML Disassembler | |
159 | .TP | |
160 | .B \-d [<file>] | |
161 | Disassemble AML to ASL source code file (*.dsl) | |
162 | .TP | |
163 | .B \-da [<file1>,<file2>] | |
164 | Disassemble multiple tables from single namespace | |
165 | .TP | |
166 | .B \-db | |
167 | Do not translate Buffers to Resource Templates | |
168 | .TP | |
169 | .B \-dc [<file>] | |
170 | Disassemble AML and immediately compile it | |
171 | .br | |
172 | (Obtain DSDT from current system if no input file) | |
173 | .TP | |
174 | .B \-e [<file1>,<file2>] | |
175 | Include ACPI table(s) for external symbol resolution | |
176 | .TP | |
177 | .B \-g | |
178 | Get ACPI tables and write to files (*.dat) | |
179 | .TP | |
180 | .B \-in | |
181 | Ignore NoOp opcodes | |
182 | .TP | |
183 | .B \-vt | |
184 | Dump binary table date in hex format within output file | |
185 | ||
186 | .PP | |
187 | .SS Help | |
188 | .TP | |
189 | .B \-h | |
190 | Additional help and compiler debug options | |
191 | .TP | |
192 | .B \-hc | |
193 | Display operators allowed in constant expressions | |
194 | .TP | |
195 | .B \-hf | |
196 | Display help for output file name generation | |
197 | .TP | |
198 | .B \-hr | |
199 | Display ACPI reserved method names | |
200 | .TP | |
201 | .B \-ht | |
202 | Display currently supported ACPI table names | |
203 | ||
204 | .PP | |
205 | .SS Debug | |
206 | .TP | |
207 | .B \-b{f|t} | |
208 | Create debug file (full or parse tree only) (*.txt) | |
209 | .TP | |
210 | .B \-f | |
211 | Ignore errors, force creation of AML output file(s) | |
212 | .TP | |
213 | .B \-n | |
214 | Parse only, no output generation | |
215 | .TP | |
216 | .B \-ot | |
217 | Display compiles times and statistics | |
218 | .TP | |
219 | .B \-x <level> | |
220 | Set debug level for trace output | |
221 | .TP | |
222 | .B \-z | |
223 | Do not insert new compiler ID for DataTables | |
224 | ||
225 | .SH AUTHOR | |
226 | iasl was written by Robert Moore <robert.moore@intel.com>. | |
227 | .PP | |
228 | This manual page was written by Mattia Dongili <malattia@debian.org>, | |
229 | for the Debian project (but may be used by others). It was updated for | |
230 | the Fedora project by Al Stone <ahs3@redhat.com> (and may also be used | |
231 | by others). |