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 - 2006, R. Byron Moore
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_MADT 23
101#define ACPI_DMT_SRAT 24
102#define ACPI_DMT_EXIT 25
103
104typedef
105void (*ACPI_TABLE_HANDLER) (struct acpi_table_header * table);
106
107struct acpi_dmtable_data {
108 char *signature;
109 struct acpi_dmtable_info *table_info;
110 ACPI_TABLE_HANDLER table_handler;
111};
112
113struct acpi_op_walk_info {
114 u32 level;
115 u32 last_level;
116 u32 count;
117 u32 bit_offset;
118 u32 flags;
119 struct acpi_walk_state *walk_state;
120};
121
122typedef
123acpi_status(*asl_walk_callback) (union acpi_parse_object * op,
124 u32 level, void *context);
125
126struct acpi_resource_tag {
127 u32 bit_index;
128 char *tag;
129};
130
131/* Strings used for decoding flags to ASL keywords */
132
133extern const char *acpi_gbl_word_decode[];
134extern const char *acpi_gbl_irq_decode[];
135extern const char *acpi_gbl_lock_rule[];
136extern const char *acpi_gbl_access_types[];
137extern const char *acpi_gbl_update_rules[];
138extern const char *acpi_gbl_match_ops[];
139
140extern struct acpi_dmtable_info acpi_dm_table_info_asf0[];
141extern struct acpi_dmtable_info acpi_dm_table_info_asf1[];
142extern struct acpi_dmtable_info acpi_dm_table_info_asf2[];
143extern struct acpi_dmtable_info acpi_dm_table_info_asf3[];
144extern struct acpi_dmtable_info acpi_dm_table_info_asf4[];
145extern struct acpi_dmtable_info acpi_dm_table_info_asf_hdr[];
146extern struct acpi_dmtable_info acpi_dm_table_info_boot[];
147extern struct acpi_dmtable_info acpi_dm_table_info_cpep[];
148extern struct acpi_dmtable_info acpi_dm_table_info_cpep0[];
149extern struct acpi_dmtable_info acpi_dm_table_info_dbgp[];
150extern struct acpi_dmtable_info acpi_dm_table_info_ecdt[];
151extern struct acpi_dmtable_info acpi_dm_table_info_facs[];
152extern struct acpi_dmtable_info acpi_dm_table_info_fadt1[];
153extern struct acpi_dmtable_info acpi_dm_table_info_fadt2[];
154extern struct acpi_dmtable_info acpi_dm_table_info_gas[];
155extern struct acpi_dmtable_info acpi_dm_table_info_header[];
156extern struct acpi_dmtable_info acpi_dm_table_info_hpet[];
157extern struct acpi_dmtable_info acpi_dm_table_info_madt[];
158extern struct acpi_dmtable_info acpi_dm_table_info_madt0[];
159extern struct acpi_dmtable_info acpi_dm_table_info_madt1[];
160extern struct acpi_dmtable_info acpi_dm_table_info_madt2[];
161extern struct acpi_dmtable_info acpi_dm_table_info_madt3[];
162extern struct acpi_dmtable_info acpi_dm_table_info_madt4[];
163extern struct acpi_dmtable_info acpi_dm_table_info_madt5[];
164extern struct acpi_dmtable_info acpi_dm_table_info_madt6[];
165extern struct acpi_dmtable_info acpi_dm_table_info_madt7[];
166extern struct acpi_dmtable_info acpi_dm_table_info_madt8[];
167extern struct acpi_dmtable_info acpi_dm_table_info_madt_hdr[];
168extern struct acpi_dmtable_info acpi_dm_table_info_mcfg[];
169extern struct acpi_dmtable_info acpi_dm_table_info_mcfg0[];
170extern struct acpi_dmtable_info acpi_dm_table_info_rsdp1[];
171extern struct acpi_dmtable_info acpi_dm_table_info_rsdp2[];
172extern struct acpi_dmtable_info acpi_dm_table_info_sbst[];
173extern struct acpi_dmtable_info acpi_dm_table_info_slit[];
174extern struct acpi_dmtable_info acpi_dm_table_info_spcr[];
175extern struct acpi_dmtable_info acpi_dm_table_info_spmi[];
176extern struct acpi_dmtable_info acpi_dm_table_info_srat[];
177extern struct acpi_dmtable_info acpi_dm_table_info_srat0[];
178extern struct acpi_dmtable_info acpi_dm_table_info_srat1[];
179extern struct acpi_dmtable_info acpi_dm_table_info_tcpa[];
180extern struct acpi_dmtable_info acpi_dm_table_info_wdrt[];
181
182/*
183 * dmtable
184 */
185void acpi_dm_dump_data_table(struct acpi_table_header *table);
186
187void
188acpi_dm_dump_table(u32 table_length,
189 u32 table_offset,
190 void *table,
191 u32 sub_table_length, struct acpi_dmtable_info *info);
192
193void acpi_dm_line_header(u32 offset, u32 byte_length, char *name);
194
195void acpi_dm_line_header2(u32 offset, u32 byte_length, char *name, u32 value);
196
197/*
198 * dmtbdump
199 */
200void acpi_dm_dump_asf(struct acpi_table_header *table);
201
202void acpi_dm_dump_cpep(struct acpi_table_header *table);
203
204void acpi_dm_dump_fadt(struct acpi_table_header *table);
205
206void acpi_dm_dump_srat(struct acpi_table_header *table);
207
208void acpi_dm_dump_mcfg(struct acpi_table_header *table);
209
210void acpi_dm_dump_madt(struct acpi_table_header *table);
211
212u32 acpi_dm_dump_rsdp(struct acpi_table_header *table);
213
214void acpi_dm_dump_rsdt(struct acpi_table_header *table);
215
216void acpi_dm_dump_slit(struct acpi_table_header *table);
217
218void acpi_dm_dump_xsdt(struct acpi_table_header *table);
219
220/*
221 * dmwalk
222 */
223void
224acpi_dm_disassemble(struct acpi_walk_state *walk_state,
225 union acpi_parse_object *origin, u32 num_opcodes);
226
227void
228acpi_dm_walk_parse_tree(union acpi_parse_object *op,
229 asl_walk_callback descending_callback,
230 asl_walk_callback ascending_callback, void *context);
231
232/*
233 * dmopcode
234 */
235void
236acpi_dm_disassemble_one_op(struct acpi_walk_state *walk_state,
237 struct acpi_op_walk_info *info,
238 union acpi_parse_object *op);
239
240void acpi_dm_decode_internal_object(union acpi_operand_object *obj_desc);
241
242u32 acpi_dm_list_type(union acpi_parse_object *op);
243
244void acpi_dm_method_flags(union acpi_parse_object *op);
245
246void acpi_dm_field_flags(union acpi_parse_object *op);
247
248void acpi_dm_address_space(u8 space_id);
249
250void acpi_dm_region_flags(union acpi_parse_object *op);
251
252void acpi_dm_match_op(union acpi_parse_object *op);
253
254u8 acpi_dm_comma_if_list_member(union acpi_parse_object *op);
255
256void acpi_dm_comma_if_field_member(union acpi_parse_object *op);
257
258/*
259 * dmnames
260 */
261u32 acpi_dm_dump_name(char *name);
262
263acpi_status
264acpi_ps_display_object_pathname(struct acpi_walk_state *walk_state,
265 union acpi_parse_object *op);
266
267void acpi_dm_namestring(char *name);
268
269/*
270 * dmobject
271 */
272void
273acpi_dm_display_internal_object(union acpi_operand_object *obj_desc,
274 struct acpi_walk_state *walk_state);
275
276void acpi_dm_display_arguments(struct acpi_walk_state *walk_state);
277
278void acpi_dm_display_locals(struct acpi_walk_state *walk_state);
279
280void
281acpi_dm_dump_method_info(acpi_status status,
282 struct acpi_walk_state *walk_state,
283 union acpi_parse_object *op);
284
285/*
286 * dmbuffer
287 */
288void acpi_dm_disasm_byte_list(u32 level, u8 * byte_data, u32 byte_count);
289
290void
291acpi_dm_byte_list(struct acpi_op_walk_info *info, union acpi_parse_object *op);
292
293void acpi_dm_is_eisa_id(union acpi_parse_object *op);
294
295void acpi_dm_eisa_id(u32 encoded_id);
296
297u8 acpi_dm_is_unicode_buffer(union acpi_parse_object *op);
298
299u8 acpi_dm_is_string_buffer(union acpi_parse_object *op);
300
301/*
302 * dmresrc
303 */
304void acpi_dm_dump_integer8(u8 value, char *name);
305
306void acpi_dm_dump_integer16(u16 value, char *name);
307
308void acpi_dm_dump_integer32(u32 value, char *name);
309
310void acpi_dm_dump_integer64(u64 value, char *name);
311
312void
313acpi_dm_resource_template(struct acpi_op_walk_info *info,
314 union acpi_parse_object *op,
315 u8 * byte_data, u32 byte_count);
316
317u8 acpi_dm_is_resource_template(union acpi_parse_object *op);
318
319void acpi_dm_indent(u32 level);
320
321void acpi_dm_bit_list(u16 mask);
322
323void acpi_dm_decode_attribute(u8 attribute);
324
325void acpi_dm_descriptor_name(void);
326
327/*
328 * dmresrcl
329 */
330void
331acpi_dm_word_descriptor(union aml_resource *resource, u32 length, u32 level);
332
333void
334acpi_dm_dword_descriptor(union aml_resource *resource, u32 length, u32 level);
335
336void
337acpi_dm_extended_descriptor(union aml_resource *resource,
338 u32 length, u32 level);
339
340void
341acpi_dm_qword_descriptor(union aml_resource *resource, u32 length, u32 level);
342
343void
344acpi_dm_memory24_descriptor(union aml_resource *resource,
345 u32 length, u32 level);
346
347void
348acpi_dm_memory32_descriptor(union aml_resource *resource,
349 u32 length, u32 level);
350
351void
352acpi_dm_fixed_memory32_descriptor(union aml_resource *resource,
353 u32 length, u32 level);
354
355void
356acpi_dm_generic_register_descriptor(union aml_resource *resource,
357 u32 length, u32 level);
358
359void
360acpi_dm_interrupt_descriptor(union aml_resource *resource,
361 u32 length, u32 level);
362
363void
364acpi_dm_vendor_large_descriptor(union aml_resource *resource,
365 u32 length, u32 level);
366
367void acpi_dm_vendor_common(char *name, u8 * byte_data, u32 length, u32 level);
368
369/*
370 * dmresrcs
371 */
372void
373acpi_dm_irq_descriptor(union aml_resource *resource, u32 length, u32 level);
374
375void
376acpi_dm_dma_descriptor(union aml_resource *resource, u32 length, u32 level);
377
378void acpi_dm_io_descriptor(union aml_resource *resource, u32 length, u32 level);
379
380void
381acpi_dm_fixed_io_descriptor(union aml_resource *resource,
382 u32 length, u32 level);
383
384void
385acpi_dm_start_dependent_descriptor(union aml_resource *resource,
386 u32 length, u32 level);
387
388void
389acpi_dm_end_dependent_descriptor(union aml_resource *resource,
390 u32 length, u32 level);
391
392void
393acpi_dm_vendor_small_descriptor(union aml_resource *resource,
394 u32 length, u32 level);
395
396/*
397 * dmutils
398 */
399void acpi_dm_add_to_external_list(char *path, u8 type, u32 value);
400
401/*
402 * dmrestag
403 */
404void acpi_dm_find_resources(union acpi_parse_object *root);
405
406void
407acpi_dm_check_resource_reference(union acpi_parse_object *op,
408 struct acpi_walk_state *walk_state);
409
410#endif /* __ACDISASM_H__ */