]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /****************************************************************************** |
2 | * | |
3 | * Name: acdebug.h - ACPI/AML debugger | |
4 | * | |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
75a44ce0 | 8 | * Copyright (C) 2000 - 2008, Intel Corp. |
1da177e4 LT |
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 __ACDEBUG_H__ | |
45 | #define __ACDEBUG_H__ | |
46 | ||
1da177e4 LT |
47 | #define ACPI_DEBUG_BUFFER_SIZE 4196 |
48 | ||
4be44fcd LB |
49 | struct command_info { |
50 | char *name; /* Command Name */ | |
51 | u8 min_args; /* Minimum arguments required */ | |
1da177e4 LT |
52 | }; |
53 | ||
4be44fcd LB |
54 | struct argument_info { |
55 | char *name; /* Argument Name */ | |
1da177e4 LT |
56 | }; |
57 | ||
1da177e4 | 58 | #define PARAM_LIST(pl) pl |
1da177e4 | 59 | #define DBTEST_OUTPUT_LEVEL(lvl) if (acpi_gbl_db_opt_verbose) |
1da177e4 LT |
60 | #define VERBOSE_PRINT(fp) DBTEST_OUTPUT_LEVEL(lvl) {\ |
61 | acpi_os_printf PARAM_LIST(fp);} | |
62 | ||
63 | #define EX_NO_SINGLE_STEP 1 | |
64 | #define EX_SINGLE_STEP 2 | |
65 | ||
1da177e4 LT |
66 | /* |
67 | * dbxface - external debugger interfaces | |
68 | */ | |
4be44fcd | 69 | acpi_status acpi_db_initialize(void); |
1da177e4 | 70 | |
4be44fcd | 71 | void acpi_db_terminate(void); |
1da177e4 LT |
72 | |
73 | acpi_status | |
4be44fcd LB |
74 | acpi_db_single_step(struct acpi_walk_state *walk_state, |
75 | union acpi_parse_object *op, u32 op_type); | |
1da177e4 LT |
76 | |
77 | /* | |
78 | * dbcmds - debug commands and output routines | |
79 | */ | |
4be44fcd | 80 | acpi_status acpi_db_disassemble_method(char *name); |
1da177e4 | 81 | |
4be44fcd | 82 | void acpi_db_display_table_info(char *table_arg); |
1da177e4 | 83 | |
4be44fcd | 84 | void acpi_db_unload_acpi_table(char *table_arg, char *instance_arg); |
1da177e4 LT |
85 | |
86 | void | |
4be44fcd LB |
87 | acpi_db_set_method_breakpoint(char *location, |
88 | struct acpi_walk_state *walk_state, | |
89 | union acpi_parse_object *op); | |
1da177e4 | 90 | |
4be44fcd | 91 | void acpi_db_set_method_call_breakpoint(union acpi_parse_object *op); |
73459f73 | 92 | |
4be44fcd | 93 | void acpi_db_get_bus_info(void); |
1da177e4 | 94 | |
4be44fcd | 95 | void acpi_db_disassemble_aml(char *statements, union acpi_parse_object *op); |
1da177e4 | 96 | |
4be44fcd | 97 | void acpi_db_dump_namespace(char *start_arg, char *depth_arg); |
1da177e4 | 98 | |
4be44fcd | 99 | void acpi_db_dump_namespace_by_owner(char *owner_arg, char *depth_arg); |
1da177e4 | 100 | |
4be44fcd | 101 | void acpi_db_send_notify(char *name, u32 value); |
1da177e4 | 102 | |
4be44fcd | 103 | void acpi_db_set_method_data(char *type_arg, char *index_arg, char *value_arg); |
1da177e4 LT |
104 | |
105 | acpi_status | |
4be44fcd | 106 | acpi_db_display_objects(char *obj_type_arg, char *display_count_arg); |
1da177e4 | 107 | |
4be44fcd | 108 | acpi_status acpi_db_find_name_in_namespace(char *name_arg); |
1da177e4 | 109 | |
4be44fcd | 110 | void acpi_db_set_scope(char *name); |
1da177e4 | 111 | |
4be44fcd | 112 | acpi_status acpi_db_sleep(char *object_arg); |
1da177e4 | 113 | |
4be44fcd | 114 | void acpi_db_find_references(char *object_arg); |
1da177e4 | 115 | |
4be44fcd | 116 | void acpi_db_display_locks(void); |
1da177e4 | 117 | |
4be44fcd | 118 | void acpi_db_display_resources(char *object_arg); |
1da177e4 | 119 | |
4be44fcd | 120 | void acpi_db_display_gpes(void); |
1da177e4 | 121 | |
4be44fcd | 122 | void acpi_db_check_integrity(void); |
1da177e4 | 123 | |
4be44fcd | 124 | void acpi_db_generate_gpe(char *gpe_arg, char *block_arg); |
44f6c012 | 125 | |
1044f1f6 BM |
126 | void acpi_db_check_predefined_names(void); |
127 | ||
128 | void acpi_db_batch_execute(void); | |
129 | ||
1da177e4 LT |
130 | /* |
131 | * dbdisply - debug display commands | |
132 | */ | |
4be44fcd | 133 | void acpi_db_display_method_info(union acpi_parse_object *op); |
1da177e4 | 134 | |
4be44fcd | 135 | void acpi_db_decode_and_display_object(char *target, char *output_type); |
1da177e4 LT |
136 | |
137 | void | |
4be44fcd LB |
138 | acpi_db_display_result_object(union acpi_operand_object *obj_desc, |
139 | struct acpi_walk_state *walk_state); | |
1da177e4 | 140 | |
4be44fcd | 141 | acpi_status acpi_db_display_all_methods(char *display_count_arg); |
1da177e4 | 142 | |
4be44fcd | 143 | void acpi_db_display_arguments(void); |
1da177e4 | 144 | |
4be44fcd | 145 | void acpi_db_display_locals(void); |
1da177e4 | 146 | |
4be44fcd | 147 | void acpi_db_display_results(void); |
1da177e4 | 148 | |
4be44fcd | 149 | void acpi_db_display_calling_tree(void); |
1da177e4 | 150 | |
4be44fcd | 151 | void acpi_db_display_object_type(char *object_arg); |
1da177e4 LT |
152 | |
153 | void | |
4be44fcd LB |
154 | acpi_db_display_argument_object(union acpi_operand_object *obj_desc, |
155 | struct acpi_walk_state *walk_state); | |
1da177e4 LT |
156 | |
157 | /* | |
158 | * dbexec - debugger control method execution | |
159 | */ | |
4be44fcd | 160 | void acpi_db_execute(char *name, char **args, u32 flags); |
1da177e4 LT |
161 | |
162 | void | |
4be44fcd LB |
163 | acpi_db_create_execution_threads(char *num_threads_arg, |
164 | char *num_loops_arg, char *method_name_arg); | |
1da177e4 | 165 | |
afbb9e65 VP |
166 | #ifdef ACPI_DBG_TRACK_ALLOCATIONS |
167 | u32 acpi_db_get_cache_info(struct acpi_memory_list *cache); | |
168 | #endif | |
169 | ||
1da177e4 LT |
170 | /* |
171 | * dbfileio - Debugger file I/O commands | |
172 | */ | |
1da177e4 | 173 | acpi_object_type |
4be44fcd | 174 | acpi_db_match_argument(char *user_argument, struct argument_info *arguments); |
1da177e4 | 175 | |
4be44fcd | 176 | void acpi_db_close_debug_file(void); |
1da177e4 | 177 | |
4be44fcd | 178 | void acpi_db_open_debug_file(char *name); |
1da177e4 | 179 | |
4be44fcd | 180 | acpi_status acpi_db_load_acpi_table(char *filename); |
1da177e4 LT |
181 | |
182 | acpi_status | |
4be44fcd | 183 | acpi_db_get_table_from_file(char *filename, struct acpi_table_header **table); |
1da177e4 LT |
184 | |
185 | acpi_status | |
4be44fcd | 186 | acpi_db_read_table_from_file(char *filename, struct acpi_table_header **table); |
44f6c012 | 187 | |
1da177e4 LT |
188 | /* |
189 | * dbhistry - debugger HISTORY command | |
190 | */ | |
4be44fcd | 191 | void acpi_db_add_to_history(char *command_line); |
1da177e4 | 192 | |
4be44fcd | 193 | void acpi_db_display_history(void); |
1da177e4 | 194 | |
4be44fcd | 195 | char *acpi_db_get_from_history(char *command_num_arg); |
1da177e4 LT |
196 | |
197 | /* | |
198 | * dbinput - user front-end to the AML debugger | |
199 | */ | |
1da177e4 | 200 | acpi_status |
4be44fcd LB |
201 | acpi_db_command_dispatch(char *input_buffer, |
202 | struct acpi_walk_state *walk_state, | |
203 | union acpi_parse_object *op); | |
1da177e4 | 204 | |
4be44fcd | 205 | void ACPI_SYSTEM_XFACE acpi_db_execute_thread(void *context); |
1da177e4 LT |
206 | |
207 | /* | |
208 | * dbstats - Generation and display of ACPI table statistics | |
209 | */ | |
4be44fcd | 210 | void acpi_db_generate_statistics(union acpi_parse_object *root, u8 is_method); |
1da177e4 | 211 | |
4be44fcd | 212 | acpi_status acpi_db_display_statistics(char *type_arg); |
1da177e4 LT |
213 | |
214 | /* | |
215 | * dbutils - AML debugger utilities | |
216 | */ | |
4be44fcd | 217 | void acpi_db_set_output_destination(u32 where); |
1da177e4 | 218 | |
4be44fcd | 219 | void acpi_db_dump_external_object(union acpi_object *obj_desc, u32 level); |
1da177e4 | 220 | |
4be44fcd | 221 | void acpi_db_prep_namestring(char *name); |
1da177e4 | 222 | |
4be44fcd | 223 | struct acpi_namespace_node *acpi_db_local_ns_lookup(char *name); |
1da177e4 | 224 | |
2e23f851 BM |
225 | void acpi_db_uint32_to_hex_string(u32 value, char *buffer); |
226 | ||
4be44fcd | 227 | #endif /* __ACDEBUG_H__ */ |