[deliverable/linux.git] / drivers / acpi / parser / psxface.c

/******************************************************************************
 *
 * Module Name: psxface - Parser external interfaces
 *
 *****************************************************************************/

/*
 * Copyright (C) 2000 - 2006, R. Byron Moore
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions, and the following disclaimer,
 *    without modification.
 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
 *    substantially similar to the "NO WARRANTY" disclaimer below
 *    ("Disclaimer") and any redistribution must be conditioned upon
 *    including a substantially similar Disclaimer requirement for further
 *    binary redistribution.
 * 3. Neither the names of the above-listed copyright holders nor the names
 *    of any contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * Alternatively, this software may be distributed under the terms of the
 * GNU General Public License ("GPL") version 2 as published by the Free
 * Software Foundation.
 *
 * NO WARRANTY
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGES.
 */

#include <acpi/acpi.h>
#include <acpi/acparser.h>
#include <acpi/acdispat.h>
#include <acpi/acinterp.h>

#define _COMPONENT          ACPI_PARSER
ACPI_MODULE_NAME("psxface")

/* Local Prototypes */
static void acpi_ps_start_trace(struct acpi_evaluate_info *info);

static void acpi_ps_stop_trace(struct acpi_evaluate_info *info);

static acpi_status acpi_ps_execute_pass(struct acpi_evaluate_info *info);

static void
acpi_ps_update_parameter_list(struct acpi_evaluate_info *info, u16 action);

/*******************************************************************************
 *
 * FUNCTION:    acpi_debug_trace
 *
 * PARAMETERS:  method_name     - Valid ACPI name string
 *              debug_level     - Optional level mask. 0 to use default
 *              debug_layer     - Optional layer mask. 0 to use default
 *              Flags           - bit 1: one shot(1) or persistent(0)
 *
 * RETURN:      Status
 *
 * DESCRIPTION: External interface to enable debug tracing during control
 *              method execution
 *
 ******************************************************************************/

acpi_status
acpi_debug_trace(char *name, u32 debug_level, u32 debug_layer, u32 flags)
{
	acpi_status status;

	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
	if (ACPI_FAILURE(status)) {
		return (status);
	}

	/* TBDs: Validate name, allow full path or just nameseg */

	acpi_gbl_trace_method_name = *ACPI_CAST_PTR(u32, name);
	acpi_gbl_trace_flags = flags;

	if (debug_level) {
		acpi_gbl_trace_dbg_level = debug_level;
	}
	if (debug_layer) {
		acpi_gbl_trace_dbg_layer = debug_layer;
	}

	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
	return (AE_OK);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_ps_start_trace
 *
 * PARAMETERS:  Info        - Method info struct
 *
 * RETURN:      None
 *
 * DESCRIPTION: Start control method execution trace
 *
 ******************************************************************************/

static void acpi_ps_start_trace(struct acpi_evaluate_info *info)
{
	acpi_status status;

	ACPI_FUNCTION_ENTRY();

	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
	if (ACPI_FAILURE(status)) {
		return;
	}

	if ((!acpi_gbl_trace_method_name) ||
	    (acpi_gbl_trace_method_name != info->resolved_node->name.integer)) {
		goto exit;
	}

	acpi_gbl_original_dbg_level = acpi_dbg_level;
	acpi_gbl_original_dbg_layer = acpi_dbg_layer;

	acpi_dbg_level = 0x00FFFFFF;
	acpi_dbg_layer = ACPI_UINT32_MAX;

	if (acpi_gbl_trace_dbg_level) {
		acpi_dbg_level = acpi_gbl_trace_dbg_level;
	}
	if (acpi_gbl_trace_dbg_layer) {
		acpi_dbg_layer = acpi_gbl_trace_dbg_layer;
	}

      exit:
	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_ps_stop_trace
 *
 * PARAMETERS:  Info        - Method info struct
 *
 * RETURN:      None
 *
 * DESCRIPTION: Stop control method execution trace
 *
 ******************************************************************************/

static void acpi_ps_stop_trace(struct acpi_evaluate_info *info)
{
	acpi_status status;

	ACPI_FUNCTION_ENTRY();

	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
	if (ACPI_FAILURE(status)) {
		return;
	}

	if ((!acpi_gbl_trace_method_name) ||
	    (acpi_gbl_trace_method_name != info->resolved_node->name.integer)) {
		goto exit;
	}

	/* Disable further tracing if type is one-shot */

	if (acpi_gbl_trace_flags & 1) {
		acpi_gbl_trace_method_name = 0;
		acpi_gbl_trace_dbg_level = 0;
		acpi_gbl_trace_dbg_layer = 0;
	}

	acpi_dbg_level = acpi_gbl_original_dbg_level;
	acpi_dbg_layer = acpi_gbl_original_dbg_layer;

      exit:
	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_ps_execute_method
 *
 * PARAMETERS:  Info            - Method info block, contains:
 *                  Node            - Method Node to execute
 *                  obj_desc        - Method object
 *                  Parameters      - List of parameters to pass to the method,
 *                                    terminated by NULL. Params itself may be
 *                                    NULL if no parameters are being passed.
 *                  return_object   - Where to put method's return value (if
 *                                    any). If NULL, no value is returned.
 *                  parameter_type  - Type of Parameter list
 *                  return_object   - Where to put method's return value (if
 *                                    any). If NULL, no value is returned.
 *                  pass_number     - Parse or execute pass
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Execute a control method
 *
 ******************************************************************************/

acpi_status acpi_ps_execute_method(struct acpi_evaluate_info *info)
{
	acpi_status status;

	ACPI_FUNCTION_TRACE(ps_execute_method);

	/* Validate the Info and method Node */

	if (!info || !info->resolved_node) {
		return_ACPI_STATUS(AE_NULL_ENTRY);
	}

	/* Init for new method, wait on concurrency semaphore */

	status =
	    acpi_ds_begin_method_execution(info->resolved_node, info->obj_desc,
					   NULL);
	if (ACPI_FAILURE(status)) {
		return_ACPI_STATUS(status);
	}

	/*
	 * The caller "owns" the parameters, so give each one an extra
	 * reference
	 */
	acpi_ps_update_parameter_list(info, REF_INCREMENT);

	/* Begin tracing if requested */

	acpi_ps_start_trace(info);

	/*
	 * 1) Perform the first pass parse of the method to enter any
	 *    named objects that it creates into the namespace
	 */
	ACPI_DEBUG_PRINT((ACPI_DB_PARSE,
			  "**** Begin Method Parse **** Entry=%p obj=%p\n",
			  info->resolved_node, info->obj_desc));

	info->pass_number = 1;
	status = acpi_ps_execute_pass(info);
	if (ACPI_FAILURE(status)) {
		goto cleanup;
	}

	/*
	 * 2) Execute the method. Performs second pass parse simultaneously
	 */
	ACPI_DEBUG_PRINT((ACPI_DB_PARSE,
			  "**** Begin Method Execution **** Entry=%p obj=%p\n",
			  info->resolved_node, info->obj_desc));

	info->pass_number = 3;
	status = acpi_ps_execute_pass(info);

      cleanup:
	/* End optional tracing */

	acpi_ps_stop_trace(info);

	/* Take away the extra reference that we gave the parameters above */

	acpi_ps_update_parameter_list(info, REF_DECREMENT);

	/* Exit now if error above */

	if (ACPI_FAILURE(status)) {
		return_ACPI_STATUS(status);
	}

	/*
	 * If the method has returned an object, signal this to the caller with
	 * a control exception code
	 */
	if (info->return_object) {
		ACPI_DEBUG_PRINT((ACPI_DB_PARSE, "Method returned ObjDesc=%p\n",
				  info->return_object));
		ACPI_DUMP_STACK_ENTRY(info->return_object);

		status = AE_CTRL_RETURN_VALUE;
	}

	return_ACPI_STATUS(status);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_ps_update_parameter_list
 *
 * PARAMETERS:  Info            - See struct acpi_evaluate_info
 *                                (Used: parameter_type and Parameters)
 *              Action          - Add or Remove reference
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Update reference count on all method parameter objects
 *
 ******************************************************************************/

static void
acpi_ps_update_parameter_list(struct acpi_evaluate_info *info, u16 action)
{
	acpi_native_uint i;

	if ((info->parameter_type == ACPI_PARAM_ARGS) && (info->parameters)) {

		/* Update reference count for each parameter */

		for (i = 0; info->parameters[i]; i++) {

			/* Ignore errors, just do them all */

			(void)acpi_ut_update_object_reference(info->
							      parameters[i],
							      action);
		}
	}
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_ps_execute_pass
 *
 * PARAMETERS:  Info            - See struct acpi_evaluate_info
 *                                (Used: pass_number, Node, and obj_desc)
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Single AML pass: Parse or Execute a control method
 *
 ******************************************************************************/

static acpi_status acpi_ps_execute_pass(struct acpi_evaluate_info *info)
{
	acpi_status status;
	union acpi_parse_object *op;
	struct acpi_walk_state *walk_state;

	ACPI_FUNCTION_TRACE(ps_execute_pass);

	/* Create and init a Root Node */

	op = acpi_ps_create_scope_op();
	if (!op) {
		return_ACPI_STATUS(AE_NO_MEMORY);
	}

	/* Create and initialize a new walk state */

	walk_state =
	    acpi_ds_create_walk_state(info->obj_desc->method.owner_id, NULL,
				      NULL, NULL);
	if (!walk_state) {
		status = AE_NO_MEMORY;
		goto cleanup;
	}

	status = acpi_ds_init_aml_walk(walk_state, op, info->resolved_node,
				       info->obj_desc->method.aml_start,
				       info->obj_desc->method.aml_length,
				       info->pass_number == 1 ? NULL : info,
				       info->pass_number);
	if (ACPI_FAILURE(status)) {
		acpi_ds_delete_walk_state(walk_state);
		goto cleanup;
	}

	/* Parse the AML */

	status = acpi_ps_parse_aml(walk_state);

	/* Walk state was deleted by parse_aml */

      cleanup:
	acpi_ps_delete_parse_tree(op);
	return_ACPI_STATUS(status);
}
Commit	Line	Data
1da177e4 LT	1	/******************************************************************************
	2	*
	3	* Module Name: psxface - Parser external interfaces
	4	*
	5	*****************************************************************************/
	6
	7	/*
4a90c7e8	8	* Copyright (C) 2000 - 2006, R. Byron Moore
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
1da177e4 LT	44	#include <acpi/acpi.h>
	45	#include <acpi/acparser.h>
	46	#include <acpi/acdispat.h>
	47	#include <acpi/acinterp.h>
1da177e4	48
1da177e4	49	#define _COMPONENT ACPI_PARSER
4be44fcd	50	ACPI_MODULE_NAME("psxface")
1da177e4	51
0c9938cc	52	/* Local Prototypes */
4119532c	53	static void acpi_ps_start_trace(struct acpi_evaluate_info *info);
50eca3eb	54
4119532c	55	static void acpi_ps_stop_trace(struct acpi_evaluate_info *info);
50eca3eb	56
4119532c	57	static acpi_status acpi_ps_execute_pass(struct acpi_evaluate_info *info);
0c9938cc RM	58
0c9938cc RM	59	static void
4119532c	60	acpi_ps_update_parameter_list(struct acpi_evaluate_info *info, u16 action);
1da177e4	61
50eca3eb BM	62	/*******************************************************************************
	63	*
	64	* FUNCTION: acpi_debug_trace
	65	*
	66	* PARAMETERS: method_name - Valid ACPI name string
	67	* debug_level - Optional level mask. 0 to use default
	68	* debug_layer - Optional layer mask. 0 to use default
	69	* Flags - bit 1: one shot(1) or persistent(0)
	70	*
	71	* RETURN: Status
	72	*
	73	* DESCRIPTION: External interface to enable debug tracing during control
	74	* method execution
	75	*
	76	******************************************************************************/
	77
	78	acpi_status
	79	acpi_debug_trace(char *name, u32 debug_level, u32 debug_layer, u32 flags)
	80	{
	81	acpi_status status;
	82
	83	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
	84	if (ACPI_FAILURE(status)) {
	85	return (status);
	86	}
	87
	88	/* TBDs: Validate name, allow full path or just nameseg */
	89
c51a4de8	90	acpi_gbl_trace_method_name = *ACPI_CAST_PTR(u32, name);
50eca3eb BM	91	acpi_gbl_trace_flags = flags;
	92
	93	if (debug_level) {
	94	acpi_gbl_trace_dbg_level = debug_level;
	95	}
	96	if (debug_layer) {
	97	acpi_gbl_trace_dbg_layer = debug_layer;
	98	}
	99
	100	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
	101	return (AE_OK);
	102	}
	103
	104	/*******************************************************************************
	105	*
	106	* FUNCTION: acpi_ps_start_trace
	107	*
	108	* PARAMETERS: Info - Method info struct
	109	*
	110	* RETURN: None
	111	*
	112	* DESCRIPTION: Start control method execution trace
	113	*
	114	******************************************************************************/
	115
4119532c	116	static void acpi_ps_start_trace(struct acpi_evaluate_info *info)
50eca3eb BM	117	{
	118	acpi_status status;
	119
	120	ACPI_FUNCTION_ENTRY();
	121
	122	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
	123	if (ACPI_FAILURE(status)) {
	124	return;
	125	}
	126
	127	if ((!acpi_gbl_trace_method_name) \|\|
4119532c	128	(acpi_gbl_trace_method_name != info->resolved_node->name.integer)) {
50eca3eb BM	129	goto exit;
	130	}
	131
	132	acpi_gbl_original_dbg_level = acpi_dbg_level;
	133	acpi_gbl_original_dbg_layer = acpi_dbg_layer;
	134
	135	acpi_dbg_level = 0x00FFFFFF;
	136	acpi_dbg_layer = ACPI_UINT32_MAX;
	137
	138	if (acpi_gbl_trace_dbg_level) {
	139	acpi_dbg_level = acpi_gbl_trace_dbg_level;
	140	}
	141	if (acpi_gbl_trace_dbg_layer) {
	142	acpi_dbg_layer = acpi_gbl_trace_dbg_layer;
	143	}
	144
	145	exit:
	146	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
	147	}
	148
	149	/*******************************************************************************
	150	*
	151	* FUNCTION: acpi_ps_stop_trace
	152	*
	153	* PARAMETERS: Info - Method info struct
	154	*
	155	* RETURN: None
	156	*
	157	* DESCRIPTION: Stop control method execution trace
	158	*
	159	******************************************************************************/
	160
4119532c	161	static void acpi_ps_stop_trace(struct acpi_evaluate_info *info)
50eca3eb BM	162	{
	163	acpi_status status;
	164
	165	ACPI_FUNCTION_ENTRY();
	166
	167	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
	168	if (ACPI_FAILURE(status)) {
	169	return;
	170	}
	171
	172	if ((!acpi_gbl_trace_method_name) \|\|
4119532c	173	(acpi_gbl_trace_method_name != info->resolved_node->name.integer)) {
50eca3eb BM	174	goto exit;
	175	}
	176
	177	/* Disable further tracing if type is one-shot */
	178
	179	if (acpi_gbl_trace_flags & 1) {
	180	acpi_gbl_trace_method_name = 0;
	181	acpi_gbl_trace_dbg_level = 0;
	182	acpi_gbl_trace_dbg_layer = 0;
	183	}
	184
	185	acpi_dbg_level = acpi_gbl_original_dbg_level;
	186	acpi_dbg_layer = acpi_gbl_original_dbg_layer;
	187
	188	exit:
	189	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
	190	}
	191
1da177e4 LT	192	/*******************************************************************************
1da177e4 LT	193	*
0c9938cc	194	* FUNCTION: acpi_ps_execute_method
1da177e4	195	*
44f6c012 RM	196	* PARAMETERS: Info - Method info block, contains:
44f6c012 RM	197	* Node - Method Node to execute
0c9938cc	198	* obj_desc - Method object
44f6c012	199	* Parameters - List of parameters to pass to the method,
1da177e4 LT	200	* terminated by NULL. Params itself may be
1da177e4 LT	201	* NULL if no parameters are being passed.
44f6c012 RM	202	* return_object - Where to put method's return value (if
	203	* any). If NULL, no value is returned.
	204	* parameter_type - Type of Parameter list
	205	* return_object - Where to put method's return value (if
	206	* any). If NULL, no value is returned.
0c9938cc	207	* pass_number - Parse or execute pass
1da177e4 LT	208	*
	209	* RETURN: Status
	210	*
	211	* DESCRIPTION: Execute a control method
	212	*
	213	******************************************************************************/
	214
4119532c	215	acpi_status acpi_ps_execute_method(struct acpi_evaluate_info *info)
1da177e4	216	{
4be44fcd	217	acpi_status status;
1da177e4	218
b229cf92	219	ACPI_FUNCTION_TRACE(ps_execute_method);
1da177e4	220
0c9938cc	221	/* Validate the Info and method Node */
1da177e4	222
4119532c	223	if (!info \|\| !info->resolved_node) {
4be44fcd	224	return_ACPI_STATUS(AE_NULL_ENTRY);
1da177e4 LT	225	}
1da177e4 LT	226
1da177e4 LT	227	/* Init for new method, wait on concurrency semaphore */
1da177e4 LT	228
4be44fcd	229	status =
4119532c BM	230	acpi_ds_begin_method_execution(info->resolved_node, info->obj_desc,
4119532c BM	231	NULL);
4be44fcd LB	232	if (ACPI_FAILURE(status)) {
4be44fcd LB	233	return_ACPI_STATUS(status);
1da177e4 LT	234	}
1da177e4 LT	235
0c9938cc RM	236	/*
	237	* The caller "owns" the parameters, so give each one an extra
	238	* reference
	239	*/
4be44fcd	240	acpi_ps_update_parameter_list(info, REF_INCREMENT);
1da177e4	241
50eca3eb BM	242	/* Begin tracing if requested */
	243
	244	acpi_ps_start_trace(info);
	245
0c9938cc RM	246	/*
	247	* 1) Perform the first pass parse of the method to enter any
	248	* named objects that it creates into the namespace
	249	*/
4be44fcd LB	250	ACPI_DEBUG_PRINT((ACPI_DB_PARSE,
4be44fcd LB	251	"** Begin Method Parse ** Entry=%p obj=%p\n",
4119532c	252	info->resolved_node, info->obj_desc));
1da177e4	253
0c9938cc	254	info->pass_number = 1;
4be44fcd LB	255	status = acpi_ps_execute_pass(info);
4be44fcd LB	256	if (ACPI_FAILURE(status)) {
0c9938cc	257	goto cleanup;
1da177e4 LT	258	}
	259
	260	/*
0c9938cc	261	* 2) Execute the method. Performs second pass parse simultaneously
1da177e4	262	*/
4be44fcd LB	263	ACPI_DEBUG_PRINT((ACPI_DB_PARSE,
4be44fcd LB	264	"** Begin Method Execution ** Entry=%p obj=%p\n",
4119532c	265	info->resolved_node, info->obj_desc));
1da177e4	266
0c9938cc	267	info->pass_number = 3;
4be44fcd	268	status = acpi_ps_execute_pass(info);
0c9938cc	269
4be44fcd	270	cleanup:
50eca3eb BM	271	/* End optional tracing */
	272
	273	acpi_ps_stop_trace(info);
	274
0c9938cc	275	/* Take away the extra reference that we gave the parameters above */
1da177e4	276
4be44fcd	277	acpi_ps_update_parameter_list(info, REF_DECREMENT);
1da177e4	278
0c9938cc	279	/* Exit now if error above */
1da177e4	280
4be44fcd LB	281	if (ACPI_FAILURE(status)) {
4be44fcd LB	282	return_ACPI_STATUS(status);
1da177e4 LT	283	}
1da177e4 LT	284
0c9938cc RM	285	/*
	286	* If the method has returned an object, signal this to the caller with
	287	* a control exception code
	288	*/
	289	if (info->return_object) {
b229cf92	290	ACPI_DEBUG_PRINT((ACPI_DB_PARSE, "Method returned ObjDesc=%p\n",
4be44fcd LB	291	info->return_object));
4be44fcd LB	292	ACPI_DUMP_STACK_ENTRY(info->return_object);
0c9938cc RM	293
0c9938cc RM	294	status = AE_CTRL_RETURN_VALUE;
1da177e4 LT	295	}
1da177e4 LT	296
4be44fcd	297	return_ACPI_STATUS(status);
0c9938cc	298	}
44f6c012	299
0c9938cc RM	300	/*******************************************************************************
	301	*
	302	* FUNCTION: acpi_ps_update_parameter_list
	303	*
4119532c	304	* PARAMETERS: Info - See struct acpi_evaluate_info
0c9938cc RM	305	* (Used: parameter_type and Parameters)
	306	* Action - Add or Remove reference
	307	*
	308	* RETURN: Status
	309	*
	310	* DESCRIPTION: Update reference count on all method parameter objects
	311	*
	312	******************************************************************************/
1da177e4	313
0c9938cc	314	static void
4119532c	315	acpi_ps_update_parameter_list(struct acpi_evaluate_info *info, u16 action)
0c9938cc	316	{
4be44fcd	317	acpi_native_uint i;
1da177e4	318
4be44fcd	319	if ((info->parameter_type == ACPI_PARAM_ARGS) && (info->parameters)) {
52fc0b02	320
0c9938cc	321	/* Update reference count for each parameter */
1da177e4 LT	322
1da177e4 LT	323	for (i = 0; info->parameters[i]; i++) {
52fc0b02	324
1da177e4 LT	325	/* Ignore errors, just do them all */
1da177e4 LT	326
4be44fcd LB	327	(void)acpi_ut_update_object_reference(info->
	328	parameters[i],
	329	action);
1da177e4 LT	330	}
1da177e4 LT	331	}
0c9938cc	332	}
1da177e4	333
0c9938cc RM	334	/*******************************************************************************
	335	*
	336	* FUNCTION: acpi_ps_execute_pass
	337	*
4119532c	338	* PARAMETERS: Info - See struct acpi_evaluate_info
0c9938cc RM	339	* (Used: pass_number, Node, and obj_desc)
	340	*
	341	* RETURN: Status
	342	*
	343	* DESCRIPTION: Single AML pass: Parse or Execute a control method
	344	*
	345	******************************************************************************/
	346
4119532c	347	static acpi_status acpi_ps_execute_pass(struct acpi_evaluate_info *info)
0c9938cc	348	{
4be44fcd LB	349	acpi_status status;
	350	union acpi_parse_object *op;
	351	struct acpi_walk_state *walk_state;
0c9938cc	352
b229cf92	353	ACPI_FUNCTION_TRACE(ps_execute_pass);
0c9938cc RM	354
	355	/* Create and init a Root Node */
	356
4be44fcd	357	op = acpi_ps_create_scope_op();
0c9938cc	358	if (!op) {
4be44fcd	359	return_ACPI_STATUS(AE_NO_MEMORY);
1da177e4 LT	360	}
1da177e4 LT	361
0c9938cc	362	/* Create and initialize a new walk state */
1da177e4	363
4be44fcd LB	364	walk_state =
	365	acpi_ds_create_walk_state(info->obj_desc->method.owner_id, NULL,
	366	NULL, NULL);
0c9938cc RM	367	if (!walk_state) {
	368	status = AE_NO_MEMORY;
	369	goto cleanup;
	370	}
	371
4119532c	372	status = acpi_ds_init_aml_walk(walk_state, op, info->resolved_node,
4be44fcd LB	373	info->obj_desc->method.aml_start,
	374	info->obj_desc->method.aml_length,
	375	info->pass_number == 1 ? NULL : info,
	376	info->pass_number);
	377	if (ACPI_FAILURE(status)) {
	378	acpi_ds_delete_walk_state(walk_state);
0c9938cc	379	goto cleanup;
1da177e4 LT	380	}
1da177e4 LT	381
0c9938cc RM	382	/* Parse the AML */
0c9938cc RM	383
4be44fcd	384	status = acpi_ps_parse_aml(walk_state);
0c9938cc RM	385
	386	/* Walk state was deleted by parse_aml */
	387
4be44fcd LB	388	cleanup:
	389	acpi_ps_delete_parse_tree(op);
	390	return_ACPI_STATUS(status);
1da177e4	391	}