include/acpi/acdebug.h

   1 /******************************************************************************
   2  *
   3  * Name: acdebug.h - ACPI/AML debugger
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2005, 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 __ACDEBUG_H__
  45 #define __ACDEBUG_H__
  46
  47
  48 #define ACPI_DEBUG_BUFFER_SIZE  4196
  49
  50 struct command_info
  51 {
  52         char                            *name;          /* Command Name */
  53         u8                              min_args;       /* Minimum arguments required */
  54 };
  55
  56
  57 struct argument_info
  58 {
  59         char                            *name;          /* Argument Name */
  60 };
  61
  62
  63 #define PARAM_LIST(pl)                  pl
  64 #define DBTEST_OUTPUT_LEVEL(lvl)        if (acpi_gbl_db_opt_verbose)
  65 #define VERBOSE_PRINT(fp)               DBTEST_OUTPUT_LEVEL(lvl) {\
  66                           acpi_os_printf PARAM_LIST(fp);}
  67
  68 #define EX_NO_SINGLE_STEP               1
  69 #define EX_SINGLE_STEP                  2
  70
  71
  72 /*
  73  * dbxface - external debugger interfaces
  74  */
  75 acpi_status
  76 acpi_db_initialize (
  77         void);
  78
  79 void
  80 acpi_db_terminate (
  81         void);
  82
  83 acpi_status
  84 acpi_db_single_step (
  85         struct acpi_walk_state          *walk_state,
  86         union acpi_parse_object         *op,
  87         u32                             op_type);
  88
  89
  90 /*
  91  * dbcmds - debug commands and output routines
  92  */
  93 acpi_status
  94 acpi_db_disassemble_method (
  95         char                            *name);
  96
  97 void
  98 acpi_db_display_table_info (
  99         char                            *table_arg);
 100
 101 void
 102 acpi_db_unload_acpi_table (
 103         char                            *table_arg,
 104         char                            *instance_arg);
 105
 106 void
 107 acpi_db_set_method_breakpoint (
 108         char                            *location,
 109         struct acpi_walk_state          *walk_state,
 110         union acpi_parse_object         *op);
 111
 112 void
 113 acpi_db_set_method_call_breakpoint (
 114         union acpi_parse_object         *op);
 115
 116 void
 117 acpi_db_get_bus_info (
 118         void);
 119
 120 void
 121 acpi_db_disassemble_aml (
 122         char                            *statements,
 123         union acpi_parse_object         *op);
 124
 125 void
 126 acpi_db_dump_namespace (
 127         char                            *start_arg,
 128         char                            *depth_arg);
 129
 130 void
 131 acpi_db_dump_namespace_by_owner (
 132         char                            *owner_arg,
 133         char                            *depth_arg);
 134
 135 void
 136 acpi_db_send_notify (
 137         char                            *name,
 138         u32                             value);
 139
 140 void
 141 acpi_db_set_method_data (
 142         char                            *type_arg,
 143         char                            *index_arg,
 144         char                            *value_arg);
 145
 146 acpi_status
 147 acpi_db_display_objects (
 148         char                            *obj_type_arg,
 149         char                            *display_count_arg);
 150
 151 acpi_status
 152 acpi_db_find_name_in_namespace (
 153         char                            *name_arg);
 154
 155 void
 156 acpi_db_set_scope (
 157         char                            *name);
 158
 159 acpi_status
 160 acpi_db_sleep (
 161         char                            *object_arg);
 162
 163 void
 164 acpi_db_find_references (
 165         char                            *object_arg);
 166
 167 void
 168 acpi_db_display_locks (
 169         void);
 170
 171 void
 172 acpi_db_display_resources (
 173         char                            *object_arg);
 174
 175 void
 176 acpi_db_display_gpes (
 177         void);
 178
 179 void
 180 acpi_db_check_integrity (
 181         void);
 182
 183 void
 184 acpi_db_generate_gpe (
 185         char                            *gpe_arg,
 186         char                            *block_arg);
 187
 188
 189 /*
 190  * dbdisply - debug display commands
 191  */
 192 void
 193 acpi_db_display_method_info (
 194         union acpi_parse_object         *op);
 195
 196 void
 197 acpi_db_decode_and_display_object (
 198         char                            *target,
 199         char                            *output_type);
 200
 201 void
 202 acpi_db_display_result_object (
 203         union acpi_operand_object       *obj_desc,
 204         struct acpi_walk_state          *walk_state);
 205
 206 acpi_status
 207 acpi_db_display_all_methods (
 208         char                            *display_count_arg);
 209
 210 void
 211 acpi_db_display_arguments (
 212         void);
 213
 214 void
 215 acpi_db_display_locals (
 216         void);
 217
 218 void
 219 acpi_db_display_results (
 220         void);
 221
 222 void
 223 acpi_db_display_calling_tree (
 224         void);
 225
 226 void
 227 acpi_db_display_object_type (
 228         char                            *object_arg);
 229
 230 void
 231 acpi_db_display_argument_object (
 232         union acpi_operand_object       *obj_desc,
 233         struct acpi_walk_state          *walk_state);
 234
 235
 236 /*
 237  * dbexec - debugger control method execution
 238  */
 239 void
 240 acpi_db_execute (
 241         char                            *name,
 242         char                            **args,
 243         u32                             flags);
 244
 245 void
 246 acpi_db_create_execution_threads (
 247         char                            *num_threads_arg,
 248         char                            *num_loops_arg,
 249         char                            *method_name_arg);
 250
 251
 252 /*
 253  * dbfileio - Debugger file I/O commands
 254  */
 255 acpi_object_type
 256 acpi_db_match_argument (
 257         char                            *user_argument,
 258         struct argument_info            *arguments);
 259
 260 void
 261 acpi_db_close_debug_file (
 262         void);
 263
 264 void
 265 acpi_db_open_debug_file (
 266         char                            *name);
 267
 268 acpi_status
 269 acpi_db_load_acpi_table (
 270         char                            *filename);
 271
 272 acpi_status
 273 acpi_db_get_table_from_file (
 274         char                            *filename,
 275         struct acpi_table_header        **table);
 276
 277 acpi_status
 278 acpi_db_read_table_from_file (
 279         char                            *filename,
 280         struct acpi_table_header        **table);
 281
 282
 283 /*
 284  * dbhistry - debugger HISTORY command
 285  */
 286 void
 287 acpi_db_add_to_history (
 288         char                            *command_line);
 289
 290 void
 291 acpi_db_display_history (
 292         void);
 293
 294 char *
 295 acpi_db_get_from_history (
 296         char                            *command_num_arg);
 297
 298
 299 /*
 300  * dbinput - user front-end to the AML debugger
 301  */
 302 acpi_status
 303 acpi_db_command_dispatch (
 304         char                            *input_buffer,
 305         struct acpi_walk_state          *walk_state,
 306         union acpi_parse_object         *op);
 307
 308 void ACPI_SYSTEM_XFACE
 309 acpi_db_execute_thread (
 310         void                            *context);
 311
 312
 313 /*
 314  * dbstats - Generation and display of ACPI table statistics
 315  */
 316 void
 317 acpi_db_generate_statistics (
 318         union acpi_parse_object         *root,
 319         u8                              is_method);
 320
 321 acpi_status
 322 acpi_db_display_statistics (
 323         char                            *type_arg);
 324
 325
 326 /*
 327  * dbutils - AML debugger utilities
 328  */
 329 void
 330 acpi_db_set_output_destination (
 331         u32                             where);
 332
 333 void
 334 acpi_db_dump_external_object (
 335         union acpi_object               *obj_desc,
 336         u32                             level);
 337
 338 void
 339 acpi_db_prep_namestring (
 340         char                            *name);
 341
 342 struct acpi_namespace_node *
 343 acpi_db_local_ns_lookup (
 344         char                            *name);
 345
 346 #endif  /* __ACDEBUG_H__ */