195857638SErik Schmauss // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
295b482a8SLen Brown /*******************************************************************************
395b482a8SLen Brown *
495b482a8SLen Brown * Module Name: dsmthdat - control method arguments and local variables
595b482a8SLen Brown *
695b482a8SLen Brown ******************************************************************************/
795b482a8SLen Brown
895b482a8SLen Brown #include <acpi/acpi.h>
9e2f7a777SLen Brown #include "accommon.h"
10e2f7a777SLen Brown #include "acdispat.h"
11e2f7a777SLen Brown #include "acnamesp.h"
12e2f7a777SLen Brown #include "acinterp.h"
1395b482a8SLen Brown
1495b482a8SLen Brown #define _COMPONENT ACPI_DISPATCHER
1595b482a8SLen Brown ACPI_MODULE_NAME("dsmthdat")
1695b482a8SLen Brown
1795b482a8SLen Brown /* Local prototypes */
1895b482a8SLen Brown static void
1995b482a8SLen Brown acpi_ds_method_data_delete_value(u8 type,
2095b482a8SLen Brown u32 index, struct acpi_walk_state *walk_state);
2195b482a8SLen Brown
2295b482a8SLen Brown static acpi_status
2395b482a8SLen Brown acpi_ds_method_data_set_value(u8 type,
2495b482a8SLen Brown u32 index,
2595b482a8SLen Brown union acpi_operand_object *object,
2695b482a8SLen Brown struct acpi_walk_state *walk_state);
2795b482a8SLen Brown
2895b482a8SLen Brown #ifdef ACPI_OBSOLETE_FUNCTIONS
2995b482a8SLen Brown acpi_object_type
3095b482a8SLen Brown acpi_ds_method_data_get_type(u16 opcode,
3195b482a8SLen Brown u32 index, struct acpi_walk_state *walk_state);
3295b482a8SLen Brown #endif
3395b482a8SLen Brown
3495b482a8SLen Brown /*******************************************************************************
3595b482a8SLen Brown *
3695b482a8SLen Brown * FUNCTION: acpi_ds_method_data_init
3795b482a8SLen Brown *
3895b482a8SLen Brown * PARAMETERS: walk_state - Current walk state object
3995b482a8SLen Brown *
4095b482a8SLen Brown * RETURN: Status
4195b482a8SLen Brown *
4295b482a8SLen Brown * DESCRIPTION: Initialize the data structures that hold the method's arguments
4395b482a8SLen Brown * and locals. The data struct is an array of namespace nodes for
4495b482a8SLen Brown * each - this allows ref_of and de_ref_of to work properly for these
4595b482a8SLen Brown * special data types.
4695b482a8SLen Brown *
4795b482a8SLen Brown * NOTES: walk_state fields are initialized to zero by the
4895b482a8SLen Brown * ACPI_ALLOCATE_ZEROED().
4995b482a8SLen Brown *
5095b482a8SLen Brown * A pseudo-Namespace Node is assigned to each argument and local
5195b482a8SLen Brown * so that ref_of() can return a pointer to the Node.
5295b482a8SLen Brown *
5395b482a8SLen Brown ******************************************************************************/
5495b482a8SLen Brown
acpi_ds_method_data_init(struct acpi_walk_state * walk_state)5595b482a8SLen Brown void acpi_ds_method_data_init(struct acpi_walk_state *walk_state)
5695b482a8SLen Brown {
5795b482a8SLen Brown u32 i;
5895b482a8SLen Brown
5995b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_init);
6095b482a8SLen Brown
6195b482a8SLen Brown /* Init the method arguments */
6295b482a8SLen Brown
6395b482a8SLen Brown for (i = 0; i < ACPI_METHOD_NUM_ARGS; i++) {
6495b482a8SLen Brown ACPI_MOVE_32_TO_32(&walk_state->arguments[i].name,
6595b482a8SLen Brown NAMEOF_ARG_NTE);
661fad8738SBob Moore
6795b482a8SLen Brown walk_state->arguments[i].name.integer |= (i << 24);
6895b482a8SLen Brown walk_state->arguments[i].descriptor_type = ACPI_DESC_TYPE_NAMED;
6995b482a8SLen Brown walk_state->arguments[i].type = ACPI_TYPE_ANY;
70c45b5c09SAlexey Starikovskiy walk_state->arguments[i].flags = ANOBJ_METHOD_ARG;
7195b482a8SLen Brown }
7295b482a8SLen Brown
7395b482a8SLen Brown /* Init the method locals */
7495b482a8SLen Brown
7595b482a8SLen Brown for (i = 0; i < ACPI_METHOD_NUM_LOCALS; i++) {
7695b482a8SLen Brown ACPI_MOVE_32_TO_32(&walk_state->local_variables[i].name,
7795b482a8SLen Brown NAMEOF_LOCAL_NTE);
7895b482a8SLen Brown
7995b482a8SLen Brown walk_state->local_variables[i].name.integer |= (i << 24);
8095b482a8SLen Brown walk_state->local_variables[i].descriptor_type =
8195b482a8SLen Brown ACPI_DESC_TYPE_NAMED;
8295b482a8SLen Brown walk_state->local_variables[i].type = ACPI_TYPE_ANY;
83c45b5c09SAlexey Starikovskiy walk_state->local_variables[i].flags = ANOBJ_METHOD_LOCAL;
8495b482a8SLen Brown }
8595b482a8SLen Brown
8695b482a8SLen Brown return_VOID;
8795b482a8SLen Brown }
8895b482a8SLen Brown
8995b482a8SLen Brown /*******************************************************************************
9095b482a8SLen Brown *
9195b482a8SLen Brown * FUNCTION: acpi_ds_method_data_delete_all
9295b482a8SLen Brown *
9395b482a8SLen Brown * PARAMETERS: walk_state - Current walk state object
9495b482a8SLen Brown *
9595b482a8SLen Brown * RETURN: None
9695b482a8SLen Brown *
9795b482a8SLen Brown * DESCRIPTION: Delete method locals and arguments. Arguments are only
9895b482a8SLen Brown * deleted if this method was called from another method.
9995b482a8SLen Brown *
10095b482a8SLen Brown ******************************************************************************/
10195b482a8SLen Brown
acpi_ds_method_data_delete_all(struct acpi_walk_state * walk_state)10295b482a8SLen Brown void acpi_ds_method_data_delete_all(struct acpi_walk_state *walk_state)
10395b482a8SLen Brown {
10495b482a8SLen Brown u32 index;
10595b482a8SLen Brown
10695b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_delete_all);
10795b482a8SLen Brown
10895b482a8SLen Brown /* Detach the locals */
10995b482a8SLen Brown
11095b482a8SLen Brown for (index = 0; index < ACPI_METHOD_NUM_LOCALS; index++) {
11195b482a8SLen Brown if (walk_state->local_variables[index].object) {
112b27d6597SBob Moore ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Deleting Local%u=%p\n",
11395b482a8SLen Brown index,
11495b482a8SLen Brown walk_state->local_variables[index].
11595b482a8SLen Brown object));
11695b482a8SLen Brown
11795b482a8SLen Brown /* Detach object (if present) and remove a reference */
11895b482a8SLen Brown
11995b482a8SLen Brown acpi_ns_detach_object(&walk_state->
12095b482a8SLen Brown local_variables[index]);
12195b482a8SLen Brown }
12295b482a8SLen Brown }
12395b482a8SLen Brown
12495b482a8SLen Brown /* Detach the arguments */
12595b482a8SLen Brown
12695b482a8SLen Brown for (index = 0; index < ACPI_METHOD_NUM_ARGS; index++) {
12795b482a8SLen Brown if (walk_state->arguments[index].object) {
128b27d6597SBob Moore ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Deleting Arg%u=%p\n",
12995b482a8SLen Brown index,
13095b482a8SLen Brown walk_state->arguments[index].object));
13195b482a8SLen Brown
13295b482a8SLen Brown /* Detach object (if present) and remove a reference */
13395b482a8SLen Brown
13495b482a8SLen Brown acpi_ns_detach_object(&walk_state->arguments[index]);
13595b482a8SLen Brown }
13695b482a8SLen Brown }
13795b482a8SLen Brown
13895b482a8SLen Brown return_VOID;
13995b482a8SLen Brown }
14095b482a8SLen Brown
14195b482a8SLen Brown /*******************************************************************************
14295b482a8SLen Brown *
14395b482a8SLen Brown * FUNCTION: acpi_ds_method_data_init_args
14495b482a8SLen Brown *
145ba494beeSBob Moore * PARAMETERS: *params - Pointer to a parameter list for the method
14695b482a8SLen Brown * max_param_count - The arg count for this method
14795b482a8SLen Brown * walk_state - Current walk state object
14895b482a8SLen Brown *
14995b482a8SLen Brown * RETURN: Status
15095b482a8SLen Brown *
15195b482a8SLen Brown * DESCRIPTION: Initialize arguments for a method. The parameter list is a list
15295b482a8SLen Brown * of ACPI operand objects, either null terminated or whose length
15395b482a8SLen Brown * is defined by max_param_count.
15495b482a8SLen Brown *
15595b482a8SLen Brown ******************************************************************************/
15695b482a8SLen Brown
15795b482a8SLen Brown acpi_status
acpi_ds_method_data_init_args(union acpi_operand_object ** params,u32 max_param_count,struct acpi_walk_state * walk_state)15895b482a8SLen Brown acpi_ds_method_data_init_args(union acpi_operand_object **params,
15995b482a8SLen Brown u32 max_param_count,
16095b482a8SLen Brown struct acpi_walk_state *walk_state)
16195b482a8SLen Brown {
16295b482a8SLen Brown acpi_status status;
16395b482a8SLen Brown u32 index = 0;
16495b482a8SLen Brown
16595b482a8SLen Brown ACPI_FUNCTION_TRACE_PTR(ds_method_data_init_args, params);
16695b482a8SLen Brown
16795b482a8SLen Brown if (!params) {
16895b482a8SLen Brown ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
1691fad8738SBob Moore "No parameter list passed to method\n"));
17095b482a8SLen Brown return_ACPI_STATUS(AE_OK);
17195b482a8SLen Brown }
17295b482a8SLen Brown
17395b482a8SLen Brown /* Copy passed parameters into the new method stack frame */
17495b482a8SLen Brown
17595b482a8SLen Brown while ((index < ACPI_METHOD_NUM_ARGS) &&
17695b482a8SLen Brown (index < max_param_count) && params[index]) {
17795b482a8SLen Brown /*
17895b482a8SLen Brown * A valid parameter.
17995b482a8SLen Brown * Store the argument in the method/walk descriptor.
18095b482a8SLen Brown * Do not copy the arg in order to implement call by reference
18195b482a8SLen Brown */
1821fad8738SBob Moore status =
1831fad8738SBob Moore acpi_ds_method_data_set_value(ACPI_REFCLASS_ARG, index,
1841fad8738SBob Moore params[index], walk_state);
18595b482a8SLen Brown if (ACPI_FAILURE(status)) {
18695b482a8SLen Brown return_ACPI_STATUS(status);
18795b482a8SLen Brown }
18895b482a8SLen Brown
18995b482a8SLen Brown index++;
19095b482a8SLen Brown }
19195b482a8SLen Brown
192b27d6597SBob Moore ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%u args passed to method\n", index));
19395b482a8SLen Brown return_ACPI_STATUS(AE_OK);
19495b482a8SLen Brown }
19595b482a8SLen Brown
19695b482a8SLen Brown /*******************************************************************************
19795b482a8SLen Brown *
19895b482a8SLen Brown * FUNCTION: acpi_ds_method_data_get_node
19995b482a8SLen Brown *
200ba494beeSBob Moore * PARAMETERS: type - Either ACPI_REFCLASS_LOCAL or
20195b482a8SLen Brown * ACPI_REFCLASS_ARG
202ba494beeSBob Moore * index - Which Local or Arg whose type to get
20395b482a8SLen Brown * walk_state - Current walk state object
204ba494beeSBob Moore * node - Where the node is returned.
20595b482a8SLen Brown *
20695b482a8SLen Brown * RETURN: Status and node
20795b482a8SLen Brown *
20895b482a8SLen Brown * DESCRIPTION: Get the Node associated with a local or arg.
20995b482a8SLen Brown *
21095b482a8SLen Brown ******************************************************************************/
21195b482a8SLen Brown
21295b482a8SLen Brown acpi_status
acpi_ds_method_data_get_node(u8 type,u32 index,struct acpi_walk_state * walk_state,struct acpi_namespace_node ** node)21395b482a8SLen Brown acpi_ds_method_data_get_node(u8 type,
21495b482a8SLen Brown u32 index,
21595b482a8SLen Brown struct acpi_walk_state *walk_state,
21695b482a8SLen Brown struct acpi_namespace_node **node)
21795b482a8SLen Brown {
21895b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_get_node);
21995b482a8SLen Brown
22095b482a8SLen Brown /*
22195b482a8SLen Brown * Method Locals and Arguments are supported
22295b482a8SLen Brown */
22395b482a8SLen Brown switch (type) {
22495b482a8SLen Brown case ACPI_REFCLASS_LOCAL:
22595b482a8SLen Brown
22695b482a8SLen Brown if (index > ACPI_METHOD_MAX_LOCAL) {
22795b482a8SLen Brown ACPI_ERROR((AE_INFO,
228f6a22b0bSBob Moore "Local index %u is invalid (max %u)",
22995b482a8SLen Brown index, ACPI_METHOD_MAX_LOCAL));
23095b482a8SLen Brown return_ACPI_STATUS(AE_AML_INVALID_INDEX);
23195b482a8SLen Brown }
23295b482a8SLen Brown
23395b482a8SLen Brown /* Return a pointer to the pseudo-node */
23495b482a8SLen Brown
23595b482a8SLen Brown *node = &walk_state->local_variables[index];
23695b482a8SLen Brown break;
23795b482a8SLen Brown
23895b482a8SLen Brown case ACPI_REFCLASS_ARG:
23995b482a8SLen Brown
24095b482a8SLen Brown if (index > ACPI_METHOD_MAX_ARG) {
24195b482a8SLen Brown ACPI_ERROR((AE_INFO,
242f6a22b0bSBob Moore "Arg index %u is invalid (max %u)",
24395b482a8SLen Brown index, ACPI_METHOD_MAX_ARG));
24495b482a8SLen Brown return_ACPI_STATUS(AE_AML_INVALID_INDEX);
24595b482a8SLen Brown }
24695b482a8SLen Brown
24795b482a8SLen Brown /* Return a pointer to the pseudo-node */
24895b482a8SLen Brown
24995b482a8SLen Brown *node = &walk_state->arguments[index];
25095b482a8SLen Brown break;
25195b482a8SLen Brown
25295b482a8SLen Brown default:
2531d1ea1b7SChao Guan
254f6a22b0bSBob Moore ACPI_ERROR((AE_INFO, "Type %u is invalid", type));
25595b482a8SLen Brown return_ACPI_STATUS(AE_TYPE);
25695b482a8SLen Brown }
25795b482a8SLen Brown
25895b482a8SLen Brown return_ACPI_STATUS(AE_OK);
25995b482a8SLen Brown }
26095b482a8SLen Brown
26195b482a8SLen Brown /*******************************************************************************
26295b482a8SLen Brown *
26395b482a8SLen Brown * FUNCTION: acpi_ds_method_data_set_value
26495b482a8SLen Brown *
265ba494beeSBob Moore * PARAMETERS: type - Either ACPI_REFCLASS_LOCAL or
26695b482a8SLen Brown * ACPI_REFCLASS_ARG
267ba494beeSBob Moore * index - Which Local or Arg to get
268ba494beeSBob Moore * object - Object to be inserted into the stack entry
26995b482a8SLen Brown * walk_state - Current walk state object
27095b482a8SLen Brown *
27195b482a8SLen Brown * RETURN: Status
27295b482a8SLen Brown *
27395b482a8SLen Brown * DESCRIPTION: Insert an object onto the method stack at entry Opcode:Index.
27495b482a8SLen Brown * Note: There is no "implicit conversion" for locals.
27595b482a8SLen Brown *
27695b482a8SLen Brown ******************************************************************************/
27795b482a8SLen Brown
27895b482a8SLen Brown static acpi_status
acpi_ds_method_data_set_value(u8 type,u32 index,union acpi_operand_object * object,struct acpi_walk_state * walk_state)27995b482a8SLen Brown acpi_ds_method_data_set_value(u8 type,
28095b482a8SLen Brown u32 index,
28195b482a8SLen Brown union acpi_operand_object *object,
28295b482a8SLen Brown struct acpi_walk_state *walk_state)
28395b482a8SLen Brown {
28495b482a8SLen Brown acpi_status status;
28595b482a8SLen Brown struct acpi_namespace_node *node;
28695b482a8SLen Brown
28795b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_set_value);
28895b482a8SLen Brown
28995b482a8SLen Brown ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
290b27d6597SBob Moore "NewObj %p Type %2.2X, Refs=%u [%s]\n", object,
29195b482a8SLen Brown type, object->common.reference_count,
29295b482a8SLen Brown acpi_ut_get_type_name(object->common.type)));
29395b482a8SLen Brown
29495b482a8SLen Brown /* Get the namespace node for the arg/local */
29595b482a8SLen Brown
29695b482a8SLen Brown status = acpi_ds_method_data_get_node(type, index, walk_state, &node);
29795b482a8SLen Brown if (ACPI_FAILURE(status)) {
29895b482a8SLen Brown return_ACPI_STATUS(status);
29995b482a8SLen Brown }
30095b482a8SLen Brown
30195b482a8SLen Brown /*
30295b482a8SLen Brown * Increment ref count so object can't be deleted while installed.
30395b482a8SLen Brown * NOTE: We do not copy the object in order to preserve the call by
30495b482a8SLen Brown * reference semantics of ACPI Control Method invocation.
305ba494beeSBob Moore * (See ACPI Specification 2.0C)
30695b482a8SLen Brown */
30795b482a8SLen Brown acpi_ut_add_reference(object);
30895b482a8SLen Brown
30995b482a8SLen Brown /* Install the object */
31095b482a8SLen Brown
31195b482a8SLen Brown node->object = object;
31295b482a8SLen Brown return_ACPI_STATUS(status);
31395b482a8SLen Brown }
31495b482a8SLen Brown
31595b482a8SLen Brown /*******************************************************************************
31695b482a8SLen Brown *
31795b482a8SLen Brown * FUNCTION: acpi_ds_method_data_get_value
31895b482a8SLen Brown *
319ba494beeSBob Moore * PARAMETERS: type - Either ACPI_REFCLASS_LOCAL or
32095b482a8SLen Brown * ACPI_REFCLASS_ARG
321ba494beeSBob Moore * index - Which localVar or argument to get
32295b482a8SLen Brown * walk_state - Current walk state object
32395b482a8SLen Brown * dest_desc - Where Arg or Local value is returned
32495b482a8SLen Brown *
32595b482a8SLen Brown * RETURN: Status
32695b482a8SLen Brown *
32795b482a8SLen Brown * DESCRIPTION: Retrieve value of selected Arg or Local for this method
32895b482a8SLen Brown * Used only in acpi_ex_resolve_to_value().
32995b482a8SLen Brown *
33095b482a8SLen Brown ******************************************************************************/
33195b482a8SLen Brown
33295b482a8SLen Brown acpi_status
acpi_ds_method_data_get_value(u8 type,u32 index,struct acpi_walk_state * walk_state,union acpi_operand_object ** dest_desc)33395b482a8SLen Brown acpi_ds_method_data_get_value(u8 type,
33495b482a8SLen Brown u32 index,
33595b482a8SLen Brown struct acpi_walk_state *walk_state,
33695b482a8SLen Brown union acpi_operand_object **dest_desc)
33795b482a8SLen Brown {
33895b482a8SLen Brown acpi_status status;
33995b482a8SLen Brown struct acpi_namespace_node *node;
34095b482a8SLen Brown union acpi_operand_object *object;
34195b482a8SLen Brown
34295b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_get_value);
34395b482a8SLen Brown
34495b482a8SLen Brown /* Validate the object descriptor */
34595b482a8SLen Brown
34695b482a8SLen Brown if (!dest_desc) {
34795b482a8SLen Brown ACPI_ERROR((AE_INFO, "Null object descriptor pointer"));
34895b482a8SLen Brown return_ACPI_STATUS(AE_BAD_PARAMETER);
34995b482a8SLen Brown }
35095b482a8SLen Brown
35195b482a8SLen Brown /* Get the namespace node for the arg/local */
35295b482a8SLen Brown
35395b482a8SLen Brown status = acpi_ds_method_data_get_node(type, index, walk_state, &node);
35495b482a8SLen Brown if (ACPI_FAILURE(status)) {
35595b482a8SLen Brown return_ACPI_STATUS(status);
35695b482a8SLen Brown }
35795b482a8SLen Brown
35895b482a8SLen Brown /* Get the object from the node */
35995b482a8SLen Brown
36095b482a8SLen Brown object = node->object;
36195b482a8SLen Brown
36295b482a8SLen Brown /* Examine the returned object, it must be valid. */
36395b482a8SLen Brown
36495b482a8SLen Brown if (!object) {
36595b482a8SLen Brown /*
36695b482a8SLen Brown * Index points to uninitialized object.
36795b482a8SLen Brown * This means that either 1) The expected argument was
36895b482a8SLen Brown * not passed to the method, or 2) A local variable
36995b482a8SLen Brown * was referenced by the method (via the ASL)
37095b482a8SLen Brown * before it was initialized. Either case is an error.
37195b482a8SLen Brown */
37295b482a8SLen Brown
37395b482a8SLen Brown /* If slack enabled, init the local_x/arg_x to an Integer of value zero */
37495b482a8SLen Brown
37595b482a8SLen Brown if (acpi_gbl_enable_interpreter_slack) {
376dc95a270SBob Moore object = acpi_ut_create_integer_object((u64) 0);
37795b482a8SLen Brown if (!object) {
37895b482a8SLen Brown return_ACPI_STATUS(AE_NO_MEMORY);
37995b482a8SLen Brown }
38095b482a8SLen Brown
38195b482a8SLen Brown node->object = object;
38295b482a8SLen Brown }
38395b482a8SLen Brown
38495b482a8SLen Brown /* Otherwise, return the error */
38595b482a8SLen Brown
38695b482a8SLen Brown else
38795b482a8SLen Brown switch (type) {
38895b482a8SLen Brown case ACPI_REFCLASS_ARG:
38995b482a8SLen Brown
39095b482a8SLen Brown ACPI_ERROR((AE_INFO,
391f6a22b0bSBob Moore "Uninitialized Arg[%u] at node %p",
39295b482a8SLen Brown index, node));
39395b482a8SLen Brown
39495b482a8SLen Brown return_ACPI_STATUS(AE_AML_UNINITIALIZED_ARG);
39595b482a8SLen Brown
39695b482a8SLen Brown case ACPI_REFCLASS_LOCAL:
397e678902eSBob Moore /*
398e678902eSBob Moore * No error message for this case, will be trapped again later to
399e678902eSBob Moore * detect and ignore cases of Store(local_x,local_x)
400e678902eSBob Moore */
40195b482a8SLen Brown return_ACPI_STATUS(AE_AML_UNINITIALIZED_LOCAL);
40295b482a8SLen Brown
40395b482a8SLen Brown default:
40495b482a8SLen Brown
40595b482a8SLen Brown ACPI_ERROR((AE_INFO,
406f6a22b0bSBob Moore "Not a Arg/Local opcode: 0x%X",
40795b482a8SLen Brown type));
40895b482a8SLen Brown return_ACPI_STATUS(AE_AML_INTERNAL);
40995b482a8SLen Brown }
41095b482a8SLen Brown }
41195b482a8SLen Brown
41295b482a8SLen Brown /*
41395b482a8SLen Brown * The Index points to an initialized and valid object.
41495b482a8SLen Brown * Return an additional reference to the object
41595b482a8SLen Brown */
41695b482a8SLen Brown *dest_desc = object;
41795b482a8SLen Brown acpi_ut_add_reference(object);
41895b482a8SLen Brown
41995b482a8SLen Brown return_ACPI_STATUS(AE_OK);
42095b482a8SLen Brown }
42195b482a8SLen Brown
42295b482a8SLen Brown /*******************************************************************************
42395b482a8SLen Brown *
42495b482a8SLen Brown * FUNCTION: acpi_ds_method_data_delete_value
42595b482a8SLen Brown *
426ba494beeSBob Moore * PARAMETERS: type - Either ACPI_REFCLASS_LOCAL or
42795b482a8SLen Brown * ACPI_REFCLASS_ARG
428ba494beeSBob Moore * index - Which localVar or argument to delete
42995b482a8SLen Brown * walk_state - Current walk state object
43095b482a8SLen Brown *
43195b482a8SLen Brown * RETURN: None
43295b482a8SLen Brown *
43395b482a8SLen Brown * DESCRIPTION: Delete the entry at Opcode:Index. Inserts
43495b482a8SLen Brown * a null into the stack slot after the object is deleted.
43595b482a8SLen Brown *
43695b482a8SLen Brown ******************************************************************************/
43795b482a8SLen Brown
43895b482a8SLen Brown static void
acpi_ds_method_data_delete_value(u8 type,u32 index,struct acpi_walk_state * walk_state)43995b482a8SLen Brown acpi_ds_method_data_delete_value(u8 type,
44095b482a8SLen Brown u32 index, struct acpi_walk_state *walk_state)
44195b482a8SLen Brown {
44295b482a8SLen Brown acpi_status status;
44395b482a8SLen Brown struct acpi_namespace_node *node;
44495b482a8SLen Brown union acpi_operand_object *object;
44595b482a8SLen Brown
44695b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_delete_value);
44795b482a8SLen Brown
44895b482a8SLen Brown /* Get the namespace node for the arg/local */
44995b482a8SLen Brown
45095b482a8SLen Brown status = acpi_ds_method_data_get_node(type, index, walk_state, &node);
45195b482a8SLen Brown if (ACPI_FAILURE(status)) {
45295b482a8SLen Brown return_VOID;
45395b482a8SLen Brown }
45495b482a8SLen Brown
45595b482a8SLen Brown /* Get the associated object */
45695b482a8SLen Brown
45795b482a8SLen Brown object = acpi_ns_get_attached_object(node);
45895b482a8SLen Brown
45995b482a8SLen Brown /*
46095b482a8SLen Brown * Undefine the Arg or Local by setting its descriptor
46195b482a8SLen Brown * pointer to NULL. Locals/Args can contain both
46295b482a8SLen Brown * ACPI_OPERAND_OBJECTS and ACPI_NAMESPACE_NODEs
46395b482a8SLen Brown */
46495b482a8SLen Brown node->object = NULL;
46595b482a8SLen Brown
46695b482a8SLen Brown if ((object) &&
46795b482a8SLen Brown (ACPI_GET_DESCRIPTOR_TYPE(object) == ACPI_DESC_TYPE_OPERAND)) {
46895b482a8SLen Brown /*
46995b482a8SLen Brown * There is a valid object.
47095b482a8SLen Brown * Decrement the reference count by one to balance the
47195b482a8SLen Brown * increment when the object was stored.
47295b482a8SLen Brown */
47395b482a8SLen Brown acpi_ut_remove_reference(object);
47495b482a8SLen Brown }
47595b482a8SLen Brown
47695b482a8SLen Brown return_VOID;
47795b482a8SLen Brown }
47895b482a8SLen Brown
47995b482a8SLen Brown /*******************************************************************************
48095b482a8SLen Brown *
48195b482a8SLen Brown * FUNCTION: acpi_ds_store_object_to_local
48295b482a8SLen Brown *
483ba494beeSBob Moore * PARAMETERS: type - Either ACPI_REFCLASS_LOCAL or
48495b482a8SLen Brown * ACPI_REFCLASS_ARG
485ba494beeSBob Moore * index - Which Local or Arg to set
48695b482a8SLen Brown * obj_desc - Value to be stored
48795b482a8SLen Brown * walk_state - Current walk state
48895b482a8SLen Brown *
48995b482a8SLen Brown * RETURN: Status
49095b482a8SLen Brown *
49195b482a8SLen Brown * DESCRIPTION: Store a value in an Arg or Local. The obj_desc is installed
49295b482a8SLen Brown * as the new value for the Arg or Local and the reference count
49395b482a8SLen Brown * for obj_desc is incremented.
49495b482a8SLen Brown *
49595b482a8SLen Brown ******************************************************************************/
49695b482a8SLen Brown
49795b482a8SLen Brown acpi_status
acpi_ds_store_object_to_local(u8 type,u32 index,union acpi_operand_object * obj_desc,struct acpi_walk_state * walk_state)49895b482a8SLen Brown acpi_ds_store_object_to_local(u8 type,
49995b482a8SLen Brown u32 index,
50095b482a8SLen Brown union acpi_operand_object *obj_desc,
50195b482a8SLen Brown struct acpi_walk_state *walk_state)
50295b482a8SLen Brown {
50395b482a8SLen Brown acpi_status status;
50495b482a8SLen Brown struct acpi_namespace_node *node;
50595b482a8SLen Brown union acpi_operand_object *current_obj_desc;
50695b482a8SLen Brown union acpi_operand_object *new_obj_desc;
50795b482a8SLen Brown
50895b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_store_object_to_local);
509b27d6597SBob Moore ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Type=%2.2X Index=%u Obj=%p\n",
51095b482a8SLen Brown type, index, obj_desc));
51195b482a8SLen Brown
51295b482a8SLen Brown /* Parameter validation */
51395b482a8SLen Brown
51495b482a8SLen Brown if (!obj_desc) {
51595b482a8SLen Brown return_ACPI_STATUS(AE_BAD_PARAMETER);
51695b482a8SLen Brown }
51795b482a8SLen Brown
51895b482a8SLen Brown /* Get the namespace node for the arg/local */
51995b482a8SLen Brown
52095b482a8SLen Brown status = acpi_ds_method_data_get_node(type, index, walk_state, &node);
52195b482a8SLen Brown if (ACPI_FAILURE(status)) {
52295b482a8SLen Brown return_ACPI_STATUS(status);
52395b482a8SLen Brown }
52495b482a8SLen Brown
52595b482a8SLen Brown current_obj_desc = acpi_ns_get_attached_object(node);
52695b482a8SLen Brown if (current_obj_desc == obj_desc) {
52795b482a8SLen Brown ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Obj=%p already installed!\n",
52895b482a8SLen Brown obj_desc));
52995b482a8SLen Brown return_ACPI_STATUS(status);
53095b482a8SLen Brown }
53195b482a8SLen Brown
53295b482a8SLen Brown /*
53395b482a8SLen Brown * If the reference count on the object is more than one, we must
53495b482a8SLen Brown * take a copy of the object before we store. A reference count
53595b482a8SLen Brown * of exactly 1 means that the object was just created during the
53695b482a8SLen Brown * evaluation of an expression, and we can safely use it since it
53795b482a8SLen Brown * is not used anywhere else.
53895b482a8SLen Brown */
53995b482a8SLen Brown new_obj_desc = obj_desc;
54095b482a8SLen Brown if (obj_desc->common.reference_count > 1) {
54195b482a8SLen Brown status =
54295b482a8SLen Brown acpi_ut_copy_iobject_to_iobject(obj_desc, &new_obj_desc,
54395b482a8SLen Brown walk_state);
54495b482a8SLen Brown if (ACPI_FAILURE(status)) {
54595b482a8SLen Brown return_ACPI_STATUS(status);
54695b482a8SLen Brown }
54795b482a8SLen Brown }
54895b482a8SLen Brown
54995b482a8SLen Brown /*
55095b482a8SLen Brown * If there is an object already in this slot, we either
55195b482a8SLen Brown * have to delete it, or if this is an argument and there
55295b482a8SLen Brown * is an object reference stored there, we have to do
55395b482a8SLen Brown * an indirect store!
55495b482a8SLen Brown */
55595b482a8SLen Brown if (current_obj_desc) {
55695b482a8SLen Brown /*
55795b482a8SLen Brown * Check for an indirect store if an argument
55895b482a8SLen Brown * contains an object reference (stored as an Node).
55995b482a8SLen Brown * We don't allow this automatic dereferencing for
56095b482a8SLen Brown * locals, since a store to a local should overwrite
56195b482a8SLen Brown * anything there, including an object reference.
56295b482a8SLen Brown *
56395b482a8SLen Brown * If both Arg0 and Local0 contain ref_of (Local4):
56495b482a8SLen Brown *
56595b482a8SLen Brown * Store (1, Arg0) - Causes indirect store to local4
56695b482a8SLen Brown * Store (1, Local0) - Stores 1 in local0, overwriting
56795b482a8SLen Brown * the reference to local4
56895b482a8SLen Brown * Store (1, de_refof (Local0)) - Causes indirect store to local4
56995b482a8SLen Brown *
57095b482a8SLen Brown * Weird, but true.
57195b482a8SLen Brown */
57295b482a8SLen Brown if (type == ACPI_REFCLASS_ARG) {
57395b482a8SLen Brown /*
57495b482a8SLen Brown * If we have a valid reference object that came from ref_of(),
57595b482a8SLen Brown * do the indirect store
57695b482a8SLen Brown */
57795b482a8SLen Brown if ((ACPI_GET_DESCRIPTOR_TYPE(current_obj_desc) ==
5781fad8738SBob Moore ACPI_DESC_TYPE_OPERAND) &&
5791fad8738SBob Moore (current_obj_desc->common.type ==
5801fad8738SBob Moore ACPI_TYPE_LOCAL_REFERENCE) &&
5811fad8738SBob Moore (current_obj_desc->reference.class ==
58295b482a8SLen Brown ACPI_REFCLASS_REFOF)) {
58395b482a8SLen Brown ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
58495b482a8SLen Brown "Arg (%p) is an ObjRef(Node), storing in node %p\n",
58595b482a8SLen Brown new_obj_desc,
58695b482a8SLen Brown current_obj_desc));
58795b482a8SLen Brown
58895b482a8SLen Brown /*
58995b482a8SLen Brown * Store this object to the Node (perform the indirect store)
59095b482a8SLen Brown * NOTE: No implicit conversion is performed, as per the ACPI
59195b482a8SLen Brown * specification rules on storing to Locals/Args.
59295b482a8SLen Brown */
59395b482a8SLen Brown status =
59495b482a8SLen Brown acpi_ex_store_object_to_node(new_obj_desc,
59595b482a8SLen Brown current_obj_desc->
59695b482a8SLen Brown reference.
59795b482a8SLen Brown object,
59895b482a8SLen Brown walk_state,
59995b482a8SLen Brown ACPI_NO_IMPLICIT_CONVERSION);
60095b482a8SLen Brown
60195b482a8SLen Brown /* Remove local reference if we copied the object above */
60295b482a8SLen Brown
60395b482a8SLen Brown if (new_obj_desc != obj_desc) {
60495b482a8SLen Brown acpi_ut_remove_reference(new_obj_desc);
60595b482a8SLen Brown }
6061fad8738SBob Moore
60795b482a8SLen Brown return_ACPI_STATUS(status);
60895b482a8SLen Brown }
60995b482a8SLen Brown }
61095b482a8SLen Brown
61195b482a8SLen Brown /* Delete the existing object before storing the new one */
61295b482a8SLen Brown
61395b482a8SLen Brown acpi_ds_method_data_delete_value(type, index, walk_state);
61495b482a8SLen Brown }
61595b482a8SLen Brown
61695b482a8SLen Brown /*
61795b482a8SLen Brown * Install the Obj descriptor (*new_obj_desc) into
61895b482a8SLen Brown * the descriptor for the Arg or Local.
61995b482a8SLen Brown * (increments the object reference count by one)
62095b482a8SLen Brown */
62195b482a8SLen Brown status =
62295b482a8SLen Brown acpi_ds_method_data_set_value(type, index, new_obj_desc,
62395b482a8SLen Brown walk_state);
62495b482a8SLen Brown
62595b482a8SLen Brown /* Remove local reference if we copied the object above */
62695b482a8SLen Brown
62795b482a8SLen Brown if (new_obj_desc != obj_desc) {
62895b482a8SLen Brown acpi_ut_remove_reference(new_obj_desc);
62995b482a8SLen Brown }
63095b482a8SLen Brown
63195b482a8SLen Brown return_ACPI_STATUS(status);
63295b482a8SLen Brown }
63395b482a8SLen Brown
63495b482a8SLen Brown #ifdef ACPI_OBSOLETE_FUNCTIONS
63595b482a8SLen Brown /*******************************************************************************
63695b482a8SLen Brown *
63795b482a8SLen Brown * FUNCTION: acpi_ds_method_data_get_type
63895b482a8SLen Brown *
6399ff5a21aSBob Moore * PARAMETERS: opcode - Either AML_FIRST LOCAL_OP or
6409ff5a21aSBob Moore * AML_FIRST_ARG_OP
641ba494beeSBob Moore * index - Which Local or Arg whose type to get
64295b482a8SLen Brown * walk_state - Current walk state object
64395b482a8SLen Brown *
64495b482a8SLen Brown * RETURN: Data type of current value of the selected Arg or Local
64595b482a8SLen Brown *
64695b482a8SLen Brown * DESCRIPTION: Get the type of the object stored in the Local or Arg
64795b482a8SLen Brown *
64895b482a8SLen Brown ******************************************************************************/
64995b482a8SLen Brown
65095b482a8SLen Brown acpi_object_type
acpi_ds_method_data_get_type(u16 opcode,u32 index,struct acpi_walk_state * walk_state)65195b482a8SLen Brown acpi_ds_method_data_get_type(u16 opcode,
65295b482a8SLen Brown u32 index, struct acpi_walk_state *walk_state)
65395b482a8SLen Brown {
65495b482a8SLen Brown acpi_status status;
65595b482a8SLen Brown struct acpi_namespace_node *node;
65695b482a8SLen Brown union acpi_operand_object *object;
65795b482a8SLen Brown
65895b482a8SLen Brown ACPI_FUNCTION_TRACE(ds_method_data_get_type);
65995b482a8SLen Brown
66095b482a8SLen Brown /* Get the namespace node for the arg/local */
66195b482a8SLen Brown
66295b482a8SLen Brown status = acpi_ds_method_data_get_node(opcode, index, walk_state, &node);
66395b482a8SLen Brown if (ACPI_FAILURE(status)) {
66495b482a8SLen Brown return_VALUE((ACPI_TYPE_NOT_FOUND));
66595b482a8SLen Brown }
66695b482a8SLen Brown
66795b482a8SLen Brown /* Get the object */
66895b482a8SLen Brown
66995b482a8SLen Brown object = acpi_ns_get_attached_object(node);
67095b482a8SLen Brown if (!object) {
67195b482a8SLen Brown
67295b482a8SLen Brown /* Uninitialized local/arg, return TYPE_ANY */
67395b482a8SLen Brown
67495b482a8SLen Brown return_VALUE(ACPI_TYPE_ANY);
67595b482a8SLen Brown }
67695b482a8SLen Brown
67795b482a8SLen Brown /* Get the object type */
67895b482a8SLen Brown
6793371c19cSBob Moore return_VALUE(object->type);
68095b482a8SLen Brown }
68195b482a8SLen Brown #endif
682