PageRenderTime 42ms CodeModel.GetById 17ms app.highlight 21ms RepoModel.GetById 1ms app.codeStats 0ms

/drivers/acpi/acpica/acdispat.h

http://github.com/mirrors/linux
C Header | 344 lines | 212 code | 77 blank | 55 comment | 0 complexity | 1449b2d63e63ddc3e406d030cf0f9b1e MD5 | raw file
  1/* SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 */
  2/******************************************************************************
  3 *
  4 * Name: acdispat.h - dispatcher (parser to interpreter interface)
  5 *
  6 * Copyright (C) 2000 - 2020, Intel Corp.
  7 *
  8 *****************************************************************************/
  9
 10#ifndef _ACDISPAT_H_
 11#define _ACDISPAT_H_
 12
 13#define NAMEOF_LOCAL_NTE    "__L0"
 14#define NAMEOF_ARG_NTE      "__A0"
 15
 16/*
 17 * dsargs - execution of dynamic arguments for static objects
 18 */
 19acpi_status
 20acpi_ds_get_buffer_field_arguments(union acpi_operand_object *obj_desc);
 21
 22acpi_status
 23acpi_ds_get_bank_field_arguments(union acpi_operand_object *obj_desc);
 24
 25acpi_status acpi_ds_get_region_arguments(union acpi_operand_object *rgn_desc);
 26
 27acpi_status acpi_ds_get_buffer_arguments(union acpi_operand_object *obj_desc);
 28
 29acpi_status acpi_ds_get_package_arguments(union acpi_operand_object *obj_desc);
 30
 31/*
 32 * dscontrol - support for execution control opcodes
 33 */
 34acpi_status
 35acpi_ds_exec_begin_control_op(struct acpi_walk_state *walk_state,
 36			      union acpi_parse_object *op);
 37
 38acpi_status
 39acpi_ds_exec_end_control_op(struct acpi_walk_state *walk_state,
 40			    union acpi_parse_object *op);
 41
 42/*
 43 * dsopcode - support for late operand evaluation
 44 */
 45acpi_status
 46acpi_ds_eval_buffer_field_operands(struct acpi_walk_state *walk_state,
 47				   union acpi_parse_object *op);
 48
 49acpi_status
 50acpi_ds_eval_region_operands(struct acpi_walk_state *walk_state,
 51			     union acpi_parse_object *op);
 52
 53acpi_status
 54acpi_ds_eval_table_region_operands(struct acpi_walk_state *walk_state,
 55				   union acpi_parse_object *op);
 56
 57acpi_status
 58acpi_ds_eval_data_object_operands(struct acpi_walk_state *walk_state,
 59				  union acpi_parse_object *op,
 60				  union acpi_operand_object *obj_desc);
 61
 62acpi_status
 63acpi_ds_eval_bank_field_operands(struct acpi_walk_state *walk_state,
 64				 union acpi_parse_object *op);
 65
 66acpi_status acpi_ds_initialize_region(acpi_handle obj_handle);
 67
 68/*
 69 * dsexec - Parser/Interpreter interface, method execution callbacks
 70 */
 71acpi_status
 72acpi_ds_get_predicate_value(struct acpi_walk_state *walk_state,
 73			    union acpi_operand_object *result_obj);
 74
 75acpi_status
 76acpi_ds_exec_begin_op(struct acpi_walk_state *walk_state,
 77		      union acpi_parse_object **out_op);
 78
 79acpi_status acpi_ds_exec_end_op(struct acpi_walk_state *state);
 80
 81/*
 82 * dsfield - Parser/Interpreter interface for AML fields
 83 */
 84acpi_status
 85acpi_ds_create_field(union acpi_parse_object *op,
 86		     struct acpi_namespace_node *region_node,
 87		     struct acpi_walk_state *walk_state);
 88
 89acpi_status
 90acpi_ds_create_bank_field(union acpi_parse_object *op,
 91			  struct acpi_namespace_node *region_node,
 92			  struct acpi_walk_state *walk_state);
 93
 94acpi_status
 95acpi_ds_create_index_field(union acpi_parse_object *op,
 96			   struct acpi_namespace_node *region_node,
 97			   struct acpi_walk_state *walk_state);
 98
 99acpi_status
100acpi_ds_create_buffer_field(union acpi_parse_object *op,
101			    struct acpi_walk_state *walk_state);
102
103acpi_status
104acpi_ds_init_field_objects(union acpi_parse_object *op,
105			   struct acpi_walk_state *walk_state);
106
107/*
108 * dsload - Parser/Interpreter interface
109 */
110acpi_status
111acpi_ds_init_callbacks(struct acpi_walk_state *walk_state, u32 pass_number);
112
113/* dsload - pass 1 namespace load callbacks */
114
115acpi_status
116acpi_ds_load1_begin_op(struct acpi_walk_state *walk_state,
117		       union acpi_parse_object **out_op);
118
119acpi_status acpi_ds_load1_end_op(struct acpi_walk_state *walk_state);
120
121/* dsload - pass 2 namespace load callbacks */
122
123acpi_status
124acpi_ds_load2_begin_op(struct acpi_walk_state *walk_state,
125		       union acpi_parse_object **out_op);
126
127acpi_status acpi_ds_load2_end_op(struct acpi_walk_state *walk_state);
128
129/*
130 * dsmthdat - method data (locals/args)
131 */
132acpi_status
133acpi_ds_store_object_to_local(u8 type,
134			      u32 index,
135			      union acpi_operand_object *src_desc,
136			      struct acpi_walk_state *walk_state);
137
138acpi_status
139acpi_ds_method_data_get_entry(u16 opcode,
140			      u32 index,
141			      struct acpi_walk_state *walk_state,
142			      union acpi_operand_object ***node);
143
144void acpi_ds_method_data_delete_all(struct acpi_walk_state *walk_state);
145
146u8 acpi_ds_is_method_value(union acpi_operand_object *obj_desc);
147
148acpi_status
149acpi_ds_method_data_get_value(u8 type,
150			      u32 index,
151			      struct acpi_walk_state *walk_state,
152			      union acpi_operand_object **dest_desc);
153
154acpi_status
155acpi_ds_method_data_init_args(union acpi_operand_object **params,
156			      u32 max_param_count,
157			      struct acpi_walk_state *walk_state);
158
159acpi_status
160acpi_ds_method_data_get_node(u8 type,
161			     u32 index,
162			     struct acpi_walk_state *walk_state,
163			     struct acpi_namespace_node **node);
164
165void acpi_ds_method_data_init(struct acpi_walk_state *walk_state);
166
167/*
168 * dsmethod - Parser/Interpreter interface - control method parsing
169 */
170acpi_status
171acpi_ds_auto_serialize_method(struct acpi_namespace_node *node,
172			      union acpi_operand_object *obj_desc);
173
174acpi_status
175acpi_ds_call_control_method(struct acpi_thread_state *thread,
176			    struct acpi_walk_state *walk_state,
177			    union acpi_parse_object *op);
178
179acpi_status
180acpi_ds_restart_control_method(struct acpi_walk_state *walk_state,
181			       union acpi_operand_object *return_desc);
182
183void
184acpi_ds_terminate_control_method(union acpi_operand_object *method_desc,
185				 struct acpi_walk_state *walk_state);
186
187acpi_status
188acpi_ds_begin_method_execution(struct acpi_namespace_node *method_node,
189			       union acpi_operand_object *obj_desc,
190			       struct acpi_walk_state *walk_state);
191
192acpi_status
193acpi_ds_method_error(acpi_status status, struct acpi_walk_state *walk_state);
194
195/*
196 * dsinit
197 */
198acpi_status
199acpi_ds_initialize_objects(u32 table_index,
200			   struct acpi_namespace_node *start_node);
201
202/*
203 * dsobject - Parser/Interpreter interface - object initialization and conversion
204 */
205acpi_status
206acpi_ds_build_internal_object(struct acpi_walk_state *walk_state,
207			      union acpi_parse_object *op,
208			      union acpi_operand_object **obj_desc_ptr);
209
210acpi_status
211acpi_ds_build_internal_buffer_obj(struct acpi_walk_state *walk_state,
212				  union acpi_parse_object *op,
213				  u32 buffer_length,
214				  union acpi_operand_object **obj_desc_ptr);
215
216acpi_status
217acpi_ds_build_internal_package_obj(struct acpi_walk_state *walk_state,
218				   union acpi_parse_object *op,
219				   u32 package_length,
220				   union acpi_operand_object **obj_desc);
221
222acpi_status
223acpi_ds_init_object_from_op(struct acpi_walk_state *walk_state,
224			    union acpi_parse_object *op,
225			    u16 opcode, union acpi_operand_object **obj_desc);
226
227acpi_status
228acpi_ds_create_node(struct acpi_walk_state *walk_state,
229		    struct acpi_namespace_node *node,
230		    union acpi_parse_object *op);
231
232/*
233 * dspkginit - Package object initialization
234 */
235acpi_status
236acpi_ds_init_package_element(u8 object_type,
237			     union acpi_operand_object *source_object,
238			     union acpi_generic_state *state, void *context);
239
240/*
241 * dsutils - Parser/Interpreter interface utility routines
242 */
243void acpi_ds_clear_implicit_return(struct acpi_walk_state *walk_state);
244
245u8
246acpi_ds_do_implicit_return(union acpi_operand_object *return_desc,
247			   struct acpi_walk_state *walk_state,
248			   u8 add_reference);
249
250u8
251acpi_ds_is_result_used(union acpi_parse_object *op,
252		       struct acpi_walk_state *walk_state);
253
254void
255acpi_ds_delete_result_if_not_used(union acpi_parse_object *op,
256				  union acpi_operand_object *result_obj,
257				  struct acpi_walk_state *walk_state);
258
259acpi_status
260acpi_ds_create_operand(struct acpi_walk_state *walk_state,
261		       union acpi_parse_object *arg, u32 args_remaining);
262
263acpi_status
264acpi_ds_create_operands(struct acpi_walk_state *walk_state,
265			union acpi_parse_object *first_arg);
266
267acpi_status acpi_ds_resolve_operands(struct acpi_walk_state *walk_state);
268
269void acpi_ds_clear_operands(struct acpi_walk_state *walk_state);
270
271acpi_status acpi_ds_evaluate_name_path(struct acpi_walk_state *walk_state);
272
273/*
274 * dswscope - Scope Stack manipulation
275 */
276acpi_status
277acpi_ds_scope_stack_push(struct acpi_namespace_node *node,
278			 acpi_object_type type,
279			 struct acpi_walk_state *walk_state);
280
281acpi_status acpi_ds_scope_stack_pop(struct acpi_walk_state *walk_state);
282
283void acpi_ds_scope_stack_clear(struct acpi_walk_state *walk_state);
284
285/*
286 * dswstate - parser WALK_STATE management routines
287 */
288acpi_status
289acpi_ds_obj_stack_push(void *object, struct acpi_walk_state *walk_state);
290
291acpi_status
292acpi_ds_obj_stack_pop(u32 pop_count, struct acpi_walk_state *walk_state);
293
294struct acpi_walk_state * acpi_ds_create_walk_state(acpi_owner_id owner_id,
295						   union acpi_parse_object
296						   *origin,
297						   union acpi_operand_object
298						   *mth_desc,
299						   struct acpi_thread_state
300						   *thread);
301
302acpi_status
303acpi_ds_init_aml_walk(struct acpi_walk_state *walk_state,
304		      union acpi_parse_object *op,
305		      struct acpi_namespace_node *method_node,
306		      u8 * aml_start,
307		      u32 aml_length,
308		      struct acpi_evaluate_info *info, u8 pass_number);
309
310void
311acpi_ds_obj_stack_pop_and_delete(u32 pop_count,
312				 struct acpi_walk_state *walk_state);
313
314void acpi_ds_delete_walk_state(struct acpi_walk_state *walk_state);
315
316struct acpi_walk_state *acpi_ds_pop_walk_state(struct acpi_thread_state
317					       *thread);
318
319void
320acpi_ds_push_walk_state(struct acpi_walk_state *walk_state,
321			struct acpi_thread_state *thread);
322
323acpi_status acpi_ds_result_stack_clear(struct acpi_walk_state *walk_state);
324
325struct acpi_walk_state *acpi_ds_get_current_walk_state(struct acpi_thread_state
326						       *thread);
327
328acpi_status
329acpi_ds_result_pop(union acpi_operand_object **object,
330		   struct acpi_walk_state *walk_state);
331
332acpi_status
333acpi_ds_result_push(union acpi_operand_object *object,
334		    struct acpi_walk_state *walk_state);
335
336/*
337 * dsdebug - parser debugging routines
338 */
339void
340acpi_ds_dump_method_stack(acpi_status status,
341			  struct acpi_walk_state *walk_state,
342			  union acpi_parse_object *op);
343
344#endif				/* _ACDISPAT_H_ */