1 /******************************************************************************
3 * Name: acdisasm.h - AML disassembler
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2006, R. Byron Moore
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
44 #ifndef __ACDISASM_H__
45 #define __ACDISASM_H__
52 #define BLOCK_COMMA_LIST 4
53 #define ACPI_DEFAULT_RESNAME *(u32 *) "__RD"
55 struct acpi_external_list
{
57 struct acpi_external_list
*next
;
60 extern struct acpi_external_list
*acpi_gbl_external_list
;
62 /* Strings used for decoding flags to ASL keywords */
64 extern const char *acpi_gbl_word_decode
[4];
65 extern const char *acpi_gbl_irq_decode
[2];
66 extern const char *acpi_gbl_lock_rule
[ACPI_NUM_LOCK_RULES
];
67 extern const char *acpi_gbl_access_types
[ACPI_NUM_ACCESS_TYPES
];
68 extern const char *acpi_gbl_update_rules
[ACPI_NUM_UPDATE_RULES
];
69 extern const char *acpi_gbl_match_ops
[ACPI_NUM_MATCH_OPS
];
71 struct acpi_op_walk_info
{
75 struct acpi_walk_state
*walk_state
;
79 acpi_status(*asl_walk_callback
) (union acpi_parse_object
* op
,
80 u32 level
, void *context
);
82 struct acpi_resource_tag
{
91 acpi_dm_disassemble(struct acpi_walk_state
*walk_state
,
92 union acpi_parse_object
*origin
, u32 num_opcodes
);
95 acpi_dm_walk_parse_tree(union acpi_parse_object
*op
,
96 asl_walk_callback descending_callback
,
97 asl_walk_callback ascending_callback
, void *context
);
103 acpi_dm_disassemble_one_op(struct acpi_walk_state
*walk_state
,
104 struct acpi_op_walk_info
*info
,
105 union acpi_parse_object
*op
);
107 void acpi_dm_decode_internal_object(union acpi_operand_object
*obj_desc
);
109 u32
acpi_dm_list_type(union acpi_parse_object
*op
);
111 void acpi_dm_method_flags(union acpi_parse_object
*op
);
113 void acpi_dm_field_flags(union acpi_parse_object
*op
);
115 void acpi_dm_address_space(u8 space_id
);
117 void acpi_dm_region_flags(union acpi_parse_object
*op
);
119 void acpi_dm_match_op(union acpi_parse_object
*op
);
121 u8
acpi_dm_comma_if_list_member(union acpi_parse_object
*op
);
123 void acpi_dm_comma_if_field_member(union acpi_parse_object
*op
);
128 u32
acpi_dm_dump_name(char *name
);
131 acpi_ps_display_object_pathname(struct acpi_walk_state
*walk_state
,
132 union acpi_parse_object
*op
);
134 void acpi_dm_namestring(char *name
);
140 acpi_dm_display_internal_object(union acpi_operand_object
*obj_desc
,
141 struct acpi_walk_state
*walk_state
);
143 void acpi_dm_display_arguments(struct acpi_walk_state
*walk_state
);
145 void acpi_dm_display_locals(struct acpi_walk_state
*walk_state
);
148 acpi_dm_dump_method_info(acpi_status status
,
149 struct acpi_walk_state
*walk_state
,
150 union acpi_parse_object
*op
);
155 void acpi_dm_disasm_byte_list(u32 level
, u8
* byte_data
, u32 byte_count
);
158 acpi_dm_byte_list(struct acpi_op_walk_info
*info
, union acpi_parse_object
*op
);
160 void acpi_dm_is_eisa_id(union acpi_parse_object
*op
);
162 void acpi_dm_eisa_id(u32 encoded_id
);
164 u8
acpi_dm_is_unicode_buffer(union acpi_parse_object
*op
);
166 u8
acpi_dm_is_string_buffer(union acpi_parse_object
*op
);
171 void acpi_dm_dump_integer8(u8 value
, char *name
);
173 void acpi_dm_dump_integer16(u16 value
, char *name
);
175 void acpi_dm_dump_integer32(u32 value
, char *name
);
177 void acpi_dm_dump_integer64(u64 value
, char *name
);
180 acpi_dm_resource_template(struct acpi_op_walk_info
*info
,
181 union acpi_parse_object
*op
,
182 u8
* byte_data
, u32 byte_count
);
184 u8
acpi_dm_is_resource_template(union acpi_parse_object
*op
);
186 void acpi_dm_indent(u32 level
);
188 void acpi_dm_bit_list(u16 mask
);
190 void acpi_dm_decode_attribute(u8 attribute
);
192 void acpi_dm_descriptor_name(void);
198 acpi_dm_word_descriptor(union aml_resource
*resource
, u32 length
, u32 level
);
201 acpi_dm_dword_descriptor(union aml_resource
*resource
, u32 length
, u32 level
);
204 acpi_dm_extended_descriptor(union aml_resource
*resource
,
205 u32 length
, u32 level
);
208 acpi_dm_qword_descriptor(union aml_resource
*resource
, u32 length
, u32 level
);
211 acpi_dm_memory24_descriptor(union aml_resource
*resource
,
212 u32 length
, u32 level
);
215 acpi_dm_memory32_descriptor(union aml_resource
*resource
,
216 u32 length
, u32 level
);
219 acpi_dm_fixed_memory32_descriptor(union aml_resource
*resource
,
220 u32 length
, u32 level
);
223 acpi_dm_generic_register_descriptor(union aml_resource
*resource
,
224 u32 length
, u32 level
);
227 acpi_dm_interrupt_descriptor(union aml_resource
*resource
,
228 u32 length
, u32 level
);
231 acpi_dm_vendor_large_descriptor(union aml_resource
*resource
,
232 u32 length
, u32 level
);
234 void acpi_dm_vendor_common(char *name
, u8
* byte_data
, u32 length
, u32 level
);
240 acpi_dm_irq_descriptor(union aml_resource
*resource
, u32 length
, u32 level
);
243 acpi_dm_dma_descriptor(union aml_resource
*resource
, u32 length
, u32 level
);
245 void acpi_dm_io_descriptor(union aml_resource
*resource
, u32 length
, u32 level
);
248 acpi_dm_fixed_io_descriptor(union aml_resource
*resource
,
249 u32 length
, u32 level
);
252 acpi_dm_start_dependent_descriptor(union aml_resource
*resource
,
253 u32 length
, u32 level
);
256 acpi_dm_end_dependent_descriptor(union aml_resource
*resource
,
257 u32 length
, u32 level
);
260 acpi_dm_vendor_small_descriptor(union aml_resource
*resource
,
261 u32 length
, u32 level
);
266 void acpi_dm_add_to_external_list(char *path
);
271 void acpi_dm_find_resources(union acpi_parse_object
*root
);
274 acpi_dm_check_resource_reference(union acpi_parse_object
*op
,
275 struct acpi_walk_state
*walk_state
);
277 #endif /* __ACDISASM_H__ */