Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1/******************************************************************************
2 *
3 * Name: acdisasm.h - AML disassembler
4 *
5 *****************************************************************************/
6
7/*
8 * Copyright (C) 2000 - 2008, Intel Corp.
9 * All rights reserved.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
25 *
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
29 *
30 * NO WARRANTY
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
42 */
43
44#ifndef __ACDISASM_H__
45#define __ACDISASM_H__
46
47#include "amlresrc.h"
48
49#define BLOCK_NONE 0
50#define BLOCK_PAREN 1
51#define BLOCK_BRACE 2
52#define BLOCK_COMMA_LIST 4
53#define ACPI_DEFAULT_RESNAME *(u32 *) "__RD"
54
55struct acpi_external_list {
56 char *path;
57 char *internal_path;
58 struct acpi_external_list *next;
59 u32 value;
60 u16 length;
61 u8 type;
62};
63
64extern struct acpi_external_list *acpi_gbl_external_list;
65
66typedef const struct acpi_dmtable_info {
67 u8 opcode;
68 u8 offset;
69 char *name;
70
71} acpi_dmtable_info;
72
73/*
74 * Values for Opcode above.
75 * Note: 0-7 must not change, used as a flag shift value
76 */
77#define ACPI_DMT_FLAG0 0
78#define ACPI_DMT_FLAG1 1
79#define ACPI_DMT_FLAG2 2
80#define ACPI_DMT_FLAG3 3
81#define ACPI_DMT_FLAG4 4
82#define ACPI_DMT_FLAG5 5
83#define ACPI_DMT_FLAG6 6
84#define ACPI_DMT_FLAG7 7
85#define ACPI_DMT_FLAGS0 8
86#define ACPI_DMT_FLAGS2 9
87#define ACPI_DMT_UINT8 10
88#define ACPI_DMT_UINT16 11
89#define ACPI_DMT_UINT24 12
90#define ACPI_DMT_UINT32 13
91#define ACPI_DMT_UINT56 14
92#define ACPI_DMT_UINT64 15
93#define ACPI_DMT_STRING 16
94#define ACPI_DMT_NAME4 17
95#define ACPI_DMT_NAME6 18
96#define ACPI_DMT_NAME8 19
97#define ACPI_DMT_CHKSUM 20
98#define ACPI_DMT_SPACEID 21
99#define ACPI_DMT_GAS 22
100#define ACPI_DMT_ASF 23
101#define ACPI_DMT_DMAR 24
102#define ACPI_DMT_HEST 25
103#define ACPI_DMT_HESTNTFY 26
104#define ACPI_DMT_HESTNTYP 27
105#define ACPI_DMT_MADT 28
106#define ACPI_DMT_SRAT 29
107#define ACPI_DMT_EXIT 30
108#define ACPI_DMT_SIG 31
109
110typedef
111void (*acpi_dmtable_handler) (struct acpi_table_header * table);
112
113struct acpi_dmtable_data {
114 char *signature;
115 struct acpi_dmtable_info *table_info;
116 acpi_dmtable_handler table_handler;
117 char *name;
118};
119
120struct acpi_op_walk_info {
121 u32 level;
122 u32 last_level;
123 u32 count;
124 u32 bit_offset;
125 u32 flags;
126 struct acpi_walk_state *walk_state;
127};
128
129typedef
130acpi_status(*asl_walk_callback) (union acpi_parse_object * op,
131 u32 level, void *context);
132
133struct acpi_resource_tag {
134 u32 bit_index;
135 char *tag;
136};
137
138/* Strings used for decoding flags to ASL keywords */
139
140extern const char *acpi_gbl_word_decode[];
141extern const char *acpi_gbl_irq_decode[];
142extern const char *acpi_gbl_lock_rule[];
143extern const char *acpi_gbl_access_types[];
144extern const char *acpi_gbl_update_rules[];
145extern const char *acpi_gbl_match_ops[];
146
147extern struct acpi_dmtable_info acpi_dm_table_info_asf0[];
148extern struct acpi_dmtable_info acpi_dm_table_info_asf1[];
149extern struct acpi_dmtable_info acpi_dm_table_info_asf1a[];
150extern struct acpi_dmtable_info acpi_dm_table_info_asf2[];
151extern struct acpi_dmtable_info acpi_dm_table_info_asf2a[];
152extern struct acpi_dmtable_info acpi_dm_table_info_asf3[];
153extern struct acpi_dmtable_info acpi_dm_table_info_asf4[];
154extern struct acpi_dmtable_info acpi_dm_table_info_asf_hdr[];
155extern struct acpi_dmtable_info acpi_dm_table_info_boot[];
156extern struct acpi_dmtable_info acpi_dm_table_info_bert[];
157extern struct acpi_dmtable_info acpi_dm_table_info_cpep[];
158extern struct acpi_dmtable_info acpi_dm_table_info_cpep0[];
159extern struct acpi_dmtable_info acpi_dm_table_info_dbgp[];
160extern struct acpi_dmtable_info acpi_dm_table_info_dmar[];
161extern struct acpi_dmtable_info acpi_dm_table_info_dmar_hdr[];
162extern struct acpi_dmtable_info acpi_dm_table_info_dmar_scope[];
163extern struct acpi_dmtable_info acpi_dm_table_info_dmar0[];
164extern struct acpi_dmtable_info acpi_dm_table_info_dmar1[];
165extern struct acpi_dmtable_info acpi_dm_table_info_dmar2[];
166extern struct acpi_dmtable_info acpi_dm_table_info_ecdt[];
167extern struct acpi_dmtable_info acpi_dm_table_info_einj[];
168extern struct acpi_dmtable_info acpi_dm_table_info_einj0[];
169extern struct acpi_dmtable_info acpi_dm_table_info_erst[];
170extern struct acpi_dmtable_info acpi_dm_table_info_facs[];
171extern struct acpi_dmtable_info acpi_dm_table_info_fadt1[];
172extern struct acpi_dmtable_info acpi_dm_table_info_fadt2[];
173extern struct acpi_dmtable_info acpi_dm_table_info_gas[];
174extern struct acpi_dmtable_info acpi_dm_table_info_header[];
175extern struct acpi_dmtable_info acpi_dm_table_info_hest[];
176extern struct acpi_dmtable_info acpi_dm_table_info_hest9[];
177extern struct acpi_dmtable_info acpi_dm_table_info_hest_notify[];
178extern struct acpi_dmtable_info acpi_dm_table_info_hpet[];
179extern struct acpi_dmtable_info acpi_dm_table_info_madt[];
180extern struct acpi_dmtable_info acpi_dm_table_info_madt0[];
181extern struct acpi_dmtable_info acpi_dm_table_info_madt1[];
182extern struct acpi_dmtable_info acpi_dm_table_info_madt2[];
183extern struct acpi_dmtable_info acpi_dm_table_info_madt3[];
184extern struct acpi_dmtable_info acpi_dm_table_info_madt4[];
185extern struct acpi_dmtable_info acpi_dm_table_info_madt5[];
186extern struct acpi_dmtable_info acpi_dm_table_info_madt6[];
187extern struct acpi_dmtable_info acpi_dm_table_info_madt7[];
188extern struct acpi_dmtable_info acpi_dm_table_info_madt8[];
189extern struct acpi_dmtable_info acpi_dm_table_info_madt_hdr[];
190extern struct acpi_dmtable_info acpi_dm_table_info_mcfg[];
191extern struct acpi_dmtable_info acpi_dm_table_info_mcfg0[];
192extern struct acpi_dmtable_info acpi_dm_table_info_rsdp1[];
193extern struct acpi_dmtable_info acpi_dm_table_info_rsdp2[];
194extern struct acpi_dmtable_info acpi_dm_table_info_sbst[];
195extern struct acpi_dmtable_info acpi_dm_table_info_slic[];
196extern struct acpi_dmtable_info acpi_dm_table_info_slit[];
197extern struct acpi_dmtable_info acpi_dm_table_info_spcr[];
198extern struct acpi_dmtable_info acpi_dm_table_info_spmi[];
199extern struct acpi_dmtable_info acpi_dm_table_info_srat[];
200extern struct acpi_dmtable_info acpi_dm_table_info_srat0[];
201extern struct acpi_dmtable_info acpi_dm_table_info_srat1[];
202extern struct acpi_dmtable_info acpi_dm_table_info_tcpa[];
203extern struct acpi_dmtable_info acpi_dm_table_info_wdrt[];
204
205/*
206 * dmtable
207 */
208void acpi_dm_dump_data_table(struct acpi_table_header *table);
209
210acpi_status
211acpi_dm_dump_table(u32 table_length,
212 u32 table_offset,
213 void *table,
214 u32 sub_table_length, struct acpi_dmtable_info *info);
215
216void acpi_dm_line_header(u32 offset, u32 byte_length, char *name);
217
218void acpi_dm_line_header2(u32 offset, u32 byte_length, char *name, u32 value);
219
220/*
221 * dmtbdump
222 */
223void acpi_dm_dump_asf(struct acpi_table_header *table);
224
225void acpi_dm_dump_cpep(struct acpi_table_header *table);
226
227void acpi_dm_dump_dmar(struct acpi_table_header *table);
228
229void acpi_dm_dump_einj(struct acpi_table_header *table);
230
231void acpi_dm_dump_erst(struct acpi_table_header *table);
232
233void acpi_dm_dump_fadt(struct acpi_table_header *table);
234
235void acpi_dm_dump_hest(struct acpi_table_header *table);
236
237void acpi_dm_dump_mcfg(struct acpi_table_header *table);
238
239void acpi_dm_dump_madt(struct acpi_table_header *table);
240
241u32 acpi_dm_dump_rsdp(struct acpi_table_header *table);
242
243void acpi_dm_dump_rsdt(struct acpi_table_header *table);
244
245void acpi_dm_dump_slit(struct acpi_table_header *table);
246
247void acpi_dm_dump_srat(struct acpi_table_header *table);
248
249void acpi_dm_dump_xsdt(struct acpi_table_header *table);
250
251/*
252 * dmwalk
253 */
254void
255acpi_dm_disassemble(struct acpi_walk_state *walk_state,
256 union acpi_parse_object *origin, u32 num_opcodes);
257
258void
259acpi_dm_walk_parse_tree(union acpi_parse_object *op,
260 asl_walk_callback descending_callback,
261 asl_walk_callback ascending_callback, void *context);
262
263/*
264 * dmopcode
265 */
266void
267acpi_dm_disassemble_one_op(struct acpi_walk_state *walk_state,
268 struct acpi_op_walk_info *info,
269 union acpi_parse_object *op);
270
271void acpi_dm_decode_internal_object(union acpi_operand_object *obj_desc);
272
273u32 acpi_dm_list_type(union acpi_parse_object *op);
274
275void acpi_dm_method_flags(union acpi_parse_object *op);
276
277void acpi_dm_field_flags(union acpi_parse_object *op);
278
279void acpi_dm_address_space(u8 space_id);
280
281void acpi_dm_region_flags(union acpi_parse_object *op);
282
283void acpi_dm_match_op(union acpi_parse_object *op);
284
285u8 acpi_dm_comma_if_list_member(union acpi_parse_object *op);
286
287void acpi_dm_comma_if_field_member(union acpi_parse_object *op);
288
289/*
290 * dmnames
291 */
292u32 acpi_dm_dump_name(char *name);
293
294acpi_status
295acpi_ps_display_object_pathname(struct acpi_walk_state *walk_state,
296 union acpi_parse_object *op);
297
298void acpi_dm_namestring(char *name);
299
300/*
301 * dmobject
302 */
303void
304acpi_dm_display_internal_object(union acpi_operand_object *obj_desc,
305 struct acpi_walk_state *walk_state);
306
307void acpi_dm_display_arguments(struct acpi_walk_state *walk_state);
308
309void acpi_dm_display_locals(struct acpi_walk_state *walk_state);
310
311void
312acpi_dm_dump_method_info(acpi_status status,
313 struct acpi_walk_state *walk_state,
314 union acpi_parse_object *op);
315
316/*
317 * dmbuffer
318 */
319void acpi_dm_disasm_byte_list(u32 level, u8 * byte_data, u32 byte_count);
320
321void
322acpi_dm_byte_list(struct acpi_op_walk_info *info, union acpi_parse_object *op);
323
324void acpi_dm_is_eisa_id(union acpi_parse_object *op);
325
326void acpi_dm_eisa_id(u32 encoded_id);
327
328u8 acpi_dm_is_unicode_buffer(union acpi_parse_object *op);
329
330u8 acpi_dm_is_string_buffer(union acpi_parse_object *op);
331
332/*
333 * dmresrc
334 */
335void acpi_dm_dump_integer8(u8 value, char *name);
336
337void acpi_dm_dump_integer16(u16 value, char *name);
338
339void acpi_dm_dump_integer32(u32 value, char *name);
340
341void acpi_dm_dump_integer64(u64 value, char *name);
342
343void
344acpi_dm_resource_template(struct acpi_op_walk_info *info,
345 union acpi_parse_object *op,
346 u8 * byte_data, u32 byte_count);
347
348acpi_status acpi_dm_is_resource_template(union acpi_parse_object *op);
349
350void acpi_dm_indent(u32 level);
351
352void acpi_dm_bit_list(u16 mask);
353
354void acpi_dm_decode_attribute(u8 attribute);
355
356void acpi_dm_descriptor_name(void);
357
358/*
359 * dmresrcl
360 */
361void
362acpi_dm_word_descriptor(union aml_resource *resource, u32 length, u32 level);
363
364void
365acpi_dm_dword_descriptor(union aml_resource *resource, u32 length, u32 level);
366
367void
368acpi_dm_extended_descriptor(union aml_resource *resource,
369 u32 length, u32 level);
370
371void
372acpi_dm_qword_descriptor(union aml_resource *resource, u32 length, u32 level);
373
374void
375acpi_dm_memory24_descriptor(union aml_resource *resource,
376 u32 length, u32 level);
377
378void
379acpi_dm_memory32_descriptor(union aml_resource *resource,
380 u32 length, u32 level);
381
382void
383acpi_dm_fixed_memory32_descriptor(union aml_resource *resource,
384 u32 length, u32 level);
385
386void
387acpi_dm_generic_register_descriptor(union aml_resource *resource,
388 u32 length, u32 level);
389
390void
391acpi_dm_interrupt_descriptor(union aml_resource *resource,
392 u32 length, u32 level);
393
394void
395acpi_dm_vendor_large_descriptor(union aml_resource *resource,
396 u32 length, u32 level);
397
398void acpi_dm_vendor_common(char *name, u8 * byte_data, u32 length, u32 level);
399
400/*
401 * dmresrcs
402 */
403void
404acpi_dm_irq_descriptor(union aml_resource *resource, u32 length, u32 level);
405
406void
407acpi_dm_dma_descriptor(union aml_resource *resource, u32 length, u32 level);
408
409void acpi_dm_io_descriptor(union aml_resource *resource, u32 length, u32 level);
410
411void
412acpi_dm_fixed_io_descriptor(union aml_resource *resource,
413 u32 length, u32 level);
414
415void
416acpi_dm_start_dependent_descriptor(union aml_resource *resource,
417 u32 length, u32 level);
418
419void
420acpi_dm_end_dependent_descriptor(union aml_resource *resource,
421 u32 length, u32 level);
422
423void
424acpi_dm_vendor_small_descriptor(union aml_resource *resource,
425 u32 length, u32 level);
426
427/*
428 * dmutils
429 */
430void acpi_dm_add_to_external_list(char *path, u8 type, u32 value);
431
432/*
433 * dmrestag
434 */
435void acpi_dm_find_resources(union acpi_parse_object *root);
436
437void
438acpi_dm_check_resource_reference(union acpi_parse_object *op,
439 struct acpi_walk_state *walk_state);
440
441#endif /* __ACDISASM_H__ */