acdispat.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352
  1. /******************************************************************************
  2. *
  3. * Name: acdispat.h - dispatcher (parser to interpreter interface)
  4. *
  5. *****************************************************************************/
  6. /*
  7. * Copyright (C) 2000 - 2012, Intel Corp.
  8. * All rights reserved.
  9. *
  10. * Redistribution and use in source and binary forms, with or without
  11. * modification, are permitted provided that the following conditions
  12. * are met:
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions, and the following disclaimer,
  15. * without modification.
  16. * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  17. * substantially similar to the "NO WARRANTY" disclaimer below
  18. * ("Disclaimer") and any redistribution must be conditioned upon
  19. * including a substantially similar Disclaimer requirement for further
  20. * binary redistribution.
  21. * 3. Neither the names of the above-listed copyright holders nor the names
  22. * of any contributors may be used to endorse or promote products derived
  23. * from this software without specific prior written permission.
  24. *
  25. * Alternatively, this software may be distributed under the terms of the
  26. * GNU General Public License ("GPL") version 2 as published by the Free
  27. * Software Foundation.
  28. *
  29. * NO WARRANTY
  30. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  31. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  32. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  33. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  34. * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  35. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  36. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  37. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  38. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  39. * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  40. * POSSIBILITY OF SUCH DAMAGES.
  41. */
  42. #ifndef _ACDISPAT_H_
  43. #define _ACDISPAT_H_
  44. #define NAMEOF_LOCAL_NTE "__L0"
  45. #define NAMEOF_ARG_NTE "__A0"
  46. /*
  47. * dsargs - execution of dynamic arguments for static objects
  48. */
  49. acpi_status
  50. acpi_ds_get_buffer_field_arguments(union acpi_operand_object *obj_desc);
  51. acpi_status
  52. acpi_ds_get_bank_field_arguments(union acpi_operand_object *obj_desc);
  53. acpi_status acpi_ds_get_region_arguments(union acpi_operand_object *rgn_desc);
  54. acpi_status acpi_ds_get_buffer_arguments(union acpi_operand_object *obj_desc);
  55. acpi_status acpi_ds_get_package_arguments(union acpi_operand_object *obj_desc);
  56. /*
  57. * dscontrol - support for execution control opcodes
  58. */
  59. acpi_status
  60. acpi_ds_exec_begin_control_op(struct acpi_walk_state *walk_state,
  61. union acpi_parse_object *op);
  62. acpi_status
  63. acpi_ds_exec_end_control_op(struct acpi_walk_state *walk_state,
  64. union acpi_parse_object *op);
  65. /*
  66. * dsopcode - support for late operand evaluation
  67. */
  68. acpi_status
  69. acpi_ds_eval_buffer_field_operands(struct acpi_walk_state *walk_state,
  70. union acpi_parse_object *op);
  71. acpi_status
  72. acpi_ds_eval_region_operands(struct acpi_walk_state *walk_state,
  73. union acpi_parse_object *op);
  74. acpi_status
  75. acpi_ds_eval_table_region_operands(struct acpi_walk_state *walk_state,
  76. union acpi_parse_object *op);
  77. acpi_status
  78. acpi_ds_eval_data_object_operands(struct acpi_walk_state *walk_state,
  79. union acpi_parse_object *op,
  80. union acpi_operand_object *obj_desc);
  81. acpi_status
  82. acpi_ds_eval_bank_field_operands(struct acpi_walk_state *walk_state,
  83. union acpi_parse_object *op);
  84. acpi_status acpi_ds_initialize_region(acpi_handle obj_handle);
  85. /*
  86. * dsexec - Parser/Interpreter interface, method execution callbacks
  87. */
  88. acpi_status
  89. acpi_ds_get_predicate_value(struct acpi_walk_state *walk_state,
  90. union acpi_operand_object *result_obj);
  91. acpi_status
  92. acpi_ds_exec_begin_op(struct acpi_walk_state *walk_state,
  93. union acpi_parse_object **out_op);
  94. acpi_status acpi_ds_exec_end_op(struct acpi_walk_state *state);
  95. /*
  96. * dsfield - Parser/Interpreter interface for AML fields
  97. */
  98. acpi_status
  99. acpi_ds_create_field(union acpi_parse_object *op,
  100. struct acpi_namespace_node *region_node,
  101. struct acpi_walk_state *walk_state);
  102. acpi_status
  103. acpi_ds_create_bank_field(union acpi_parse_object *op,
  104. struct acpi_namespace_node *region_node,
  105. struct acpi_walk_state *walk_state);
  106. acpi_status
  107. acpi_ds_create_index_field(union acpi_parse_object *op,
  108. struct acpi_namespace_node *region_node,
  109. struct acpi_walk_state *walk_state);
  110. acpi_status
  111. acpi_ds_create_buffer_field(union acpi_parse_object *op,
  112. struct acpi_walk_state *walk_state);
  113. acpi_status
  114. acpi_ds_init_field_objects(union acpi_parse_object *op,
  115. struct acpi_walk_state *walk_state);
  116. /*
  117. * dsload - Parser/Interpreter interface, pass 1 namespace load callbacks
  118. */
  119. acpi_status
  120. acpi_ds_init_callbacks(struct acpi_walk_state *walk_state, u32 pass_number);
  121. acpi_status
  122. acpi_ds_load1_begin_op(struct acpi_walk_state *walk_state,
  123. union acpi_parse_object **out_op);
  124. acpi_status acpi_ds_load1_end_op(struct acpi_walk_state *walk_state);
  125. /*
  126. * dsload - Parser/Interpreter interface, pass 2 namespace load callbacks
  127. */
  128. acpi_status
  129. acpi_ds_load2_begin_op(struct acpi_walk_state *walk_state,
  130. union acpi_parse_object **out_op);
  131. acpi_status acpi_ds_load2_end_op(struct acpi_walk_state *walk_state);
  132. /*
  133. * dsmthdat - method data (locals/args)
  134. */
  135. acpi_status
  136. acpi_ds_store_object_to_local(u8 type,
  137. u32 index,
  138. union acpi_operand_object *src_desc,
  139. struct acpi_walk_state *walk_state);
  140. acpi_status
  141. acpi_ds_method_data_get_entry(u16 opcode,
  142. u32 index,
  143. struct acpi_walk_state *walk_state,
  144. union acpi_operand_object ***node);
  145. void acpi_ds_method_data_delete_all(struct acpi_walk_state *walk_state);
  146. u8 acpi_ds_is_method_value(union acpi_operand_object *obj_desc);
  147. acpi_status
  148. acpi_ds_method_data_get_value(u8 type,
  149. u32 index,
  150. struct acpi_walk_state *walk_state,
  151. union acpi_operand_object **dest_desc);
  152. acpi_status
  153. acpi_ds_method_data_init_args(union acpi_operand_object **params,
  154. u32 max_param_count,
  155. struct acpi_walk_state *walk_state);
  156. acpi_status
  157. acpi_ds_method_data_get_node(u8 type,
  158. u32 index,
  159. struct acpi_walk_state *walk_state,
  160. struct acpi_namespace_node **node);
  161. void acpi_ds_method_data_init(struct acpi_walk_state *walk_state);
  162. /*
  163. * dsmethod - Parser/Interpreter interface - control method parsing
  164. */
  165. acpi_status acpi_ds_parse_method(struct acpi_namespace_node *node);
  166. acpi_status
  167. acpi_ds_call_control_method(struct acpi_thread_state *thread,
  168. struct acpi_walk_state *walk_state,
  169. union acpi_parse_object *op);
  170. acpi_status
  171. acpi_ds_restart_control_method(struct acpi_walk_state *walk_state,
  172. union acpi_operand_object *return_desc);
  173. void
  174. acpi_ds_terminate_control_method(union acpi_operand_object *method_desc,
  175. struct acpi_walk_state *walk_state);
  176. acpi_status
  177. acpi_ds_begin_method_execution(struct acpi_namespace_node *method_node,
  178. union acpi_operand_object *obj_desc,
  179. struct acpi_walk_state *walk_state);
  180. acpi_status
  181. acpi_ds_method_error(acpi_status status, struct acpi_walk_state *walk_state);
  182. /*
  183. * dsinit
  184. */
  185. acpi_status
  186. acpi_ds_initialize_objects(u32 table_index,
  187. struct acpi_namespace_node *start_node);
  188. /*
  189. * dsobject - Parser/Interpreter interface - object initialization and conversion
  190. */
  191. acpi_status
  192. acpi_ds_build_internal_buffer_obj(struct acpi_walk_state *walk_state,
  193. union acpi_parse_object *op,
  194. u32 buffer_length,
  195. union acpi_operand_object **obj_desc_ptr);
  196. acpi_status
  197. acpi_ds_build_internal_package_obj(struct acpi_walk_state *walk_state,
  198. union acpi_parse_object *op,
  199. u32 package_length,
  200. union acpi_operand_object **obj_desc);
  201. acpi_status
  202. acpi_ds_init_object_from_op(struct acpi_walk_state *walk_state,
  203. union acpi_parse_object *op,
  204. u16 opcode, union acpi_operand_object **obj_desc);
  205. acpi_status
  206. acpi_ds_create_node(struct acpi_walk_state *walk_state,
  207. struct acpi_namespace_node *node,
  208. union acpi_parse_object *op);
  209. /*
  210. * dsutils - Parser/Interpreter interface utility routines
  211. */
  212. void acpi_ds_clear_implicit_return(struct acpi_walk_state *walk_state);
  213. u8
  214. acpi_ds_do_implicit_return(union acpi_operand_object *return_desc,
  215. struct acpi_walk_state *walk_state,
  216. u8 add_reference);
  217. u8
  218. acpi_ds_is_result_used(union acpi_parse_object *op,
  219. struct acpi_walk_state *walk_state);
  220. void
  221. acpi_ds_delete_result_if_not_used(union acpi_parse_object *op,
  222. union acpi_operand_object *result_obj,
  223. struct acpi_walk_state *walk_state);
  224. acpi_status
  225. acpi_ds_create_operand(struct acpi_walk_state *walk_state,
  226. union acpi_parse_object *arg, u32 args_remaining);
  227. acpi_status
  228. acpi_ds_create_operands(struct acpi_walk_state *walk_state,
  229. union acpi_parse_object *first_arg);
  230. acpi_status acpi_ds_resolve_operands(struct acpi_walk_state *walk_state);
  231. void acpi_ds_clear_operands(struct acpi_walk_state *walk_state);
  232. acpi_status acpi_ds_evaluate_name_path(struct acpi_walk_state *walk_state);
  233. /*
  234. * dswscope - Scope Stack manipulation
  235. */
  236. acpi_status
  237. acpi_ds_scope_stack_push(struct acpi_namespace_node *node,
  238. acpi_object_type type,
  239. struct acpi_walk_state *walk_state);
  240. acpi_status acpi_ds_scope_stack_pop(struct acpi_walk_state *walk_state);
  241. void acpi_ds_scope_stack_clear(struct acpi_walk_state *walk_state);
  242. /*
  243. * dswstate - parser WALK_STATE management routines
  244. */
  245. acpi_status
  246. acpi_ds_obj_stack_push(void *object, struct acpi_walk_state *walk_state);
  247. acpi_status
  248. acpi_ds_obj_stack_pop(u32 pop_count, struct acpi_walk_state *walk_state);
  249. struct acpi_walk_state *acpi_ds_create_walk_state(acpi_owner_id owner_id, union acpi_parse_object
  250. *origin, union acpi_operand_object
  251. *mth_desc, struct acpi_thread_state
  252. *thread);
  253. acpi_status
  254. acpi_ds_init_aml_walk(struct acpi_walk_state *walk_state,
  255. union acpi_parse_object *op,
  256. struct acpi_namespace_node *method_node,
  257. u8 * aml_start,
  258. u32 aml_length,
  259. struct acpi_evaluate_info *info, u8 pass_number);
  260. void
  261. acpi_ds_obj_stack_pop_and_delete(u32 pop_count,
  262. struct acpi_walk_state *walk_state);
  263. void acpi_ds_delete_walk_state(struct acpi_walk_state *walk_state);
  264. struct acpi_walk_state *acpi_ds_pop_walk_state(struct acpi_thread_state
  265. *thread);
  266. void
  267. acpi_ds_push_walk_state(struct acpi_walk_state *walk_state,
  268. struct acpi_thread_state *thread);
  269. acpi_status acpi_ds_result_stack_clear(struct acpi_walk_state *walk_state);
  270. struct acpi_walk_state *acpi_ds_get_current_walk_state(struct acpi_thread_state
  271. *thread);
  272. acpi_status
  273. acpi_ds_result_pop(union acpi_operand_object **object,
  274. struct acpi_walk_state *walk_state);
  275. acpi_status
  276. acpi_ds_result_push(union acpi_operand_object *object,
  277. struct acpi_walk_state *walk_state);
  278. #endif /* _ACDISPAT_H_ */