1 /****************************************************************************** 2 * 3 * Module Name: psxface - Parser external interfaces 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2015, Intel Corp. 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 #include <acpi/acpi.h> 45 #include "accommon.h" 46 #include "acparser.h" 47 #include "acdispat.h" 48 #include "acinterp.h" 49 #include "actables.h" 50 #include "acnamesp.h" 51 52 #define _COMPONENT ACPI_PARSER 53 ACPI_MODULE_NAME("psxface") 54 55 /* Local Prototypes */ 56 static void 57 acpi_ps_update_parameter_list(struct acpi_evaluate_info *info, u16 action); 58 59 /******************************************************************************* 60 * 61 * FUNCTION: acpi_debug_trace 62 * 63 * PARAMETERS: method_name - Valid ACPI name string 64 * debug_level - Optional level mask. 0 to use default 65 * debug_layer - Optional layer mask. 0 to use default 66 * flags - bit 1: one shot(1) or persistent(0) 67 * 68 * RETURN: Status 69 * 70 * DESCRIPTION: External interface to enable debug tracing during control 71 * method execution 72 * 73 ******************************************************************************/ 74 75 acpi_status 76 acpi_debug_trace(const char *name, u32 debug_level, u32 debug_layer, u32 flags) 77 { 78 acpi_status status; 79 80 status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); 81 if (ACPI_FAILURE(status)) { 82 return (status); 83 } 84 85 acpi_gbl_trace_method_name = name; 86 acpi_gbl_trace_flags = flags; 87 acpi_gbl_trace_dbg_level = debug_level; 88 acpi_gbl_trace_dbg_layer = debug_layer; 89 status = AE_OK; 90 91 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); 92 return (status); 93 } 94 95 /******************************************************************************* 96 * 97 * FUNCTION: acpi_ps_execute_method 98 * 99 * PARAMETERS: info - Method info block, contains: 100 * node - Method Node to execute 101 * obj_desc - Method object 102 * parameters - List of parameters to pass to the method, 103 * terminated by NULL. Params itself may be 104 * NULL if no parameters are being passed. 105 * return_object - Where to put method's return value (if 106 * any). If NULL, no value is returned. 107 * parameter_type - Type of Parameter list 108 * return_object - Where to put method's return value (if 109 * any). If NULL, no value is returned. 110 * pass_number - Parse or execute pass 111 * 112 * RETURN: Status 113 * 114 * DESCRIPTION: Execute a control method 115 * 116 ******************************************************************************/ 117 118 acpi_status acpi_ps_execute_method(struct acpi_evaluate_info * info) 119 { 120 acpi_status status; 121 union acpi_parse_object *op; 122 struct acpi_walk_state *walk_state; 123 124 ACPI_FUNCTION_TRACE(ps_execute_method); 125 126 /* Quick validation of DSDT header */ 127 128 acpi_tb_check_dsdt_header(); 129 130 /* Validate the Info and method Node */ 131 132 if (!info || !info->node) { 133 return_ACPI_STATUS(AE_NULL_ENTRY); 134 } 135 136 /* Init for new method, wait on concurrency semaphore */ 137 138 status = 139 acpi_ds_begin_method_execution(info->node, info->obj_desc, NULL); 140 if (ACPI_FAILURE(status)) { 141 return_ACPI_STATUS(status); 142 } 143 144 /* 145 * The caller "owns" the parameters, so give each one an extra reference 146 */ 147 acpi_ps_update_parameter_list(info, REF_INCREMENT); 148 149 /* 150 * Execute the method. Performs parse simultaneously 151 */ 152 ACPI_DEBUG_PRINT((ACPI_DB_PARSE, 153 "**** Begin Method Parse/Execute [%4.4s] **** Node=%p Obj=%p\n", 154 info->node->name.ascii, info->node, info->obj_desc)); 155 156 /* Create and init a Root Node */ 157 158 op = acpi_ps_create_scope_op(info->obj_desc->method.aml_start); 159 if (!op) { 160 status = AE_NO_MEMORY; 161 goto cleanup; 162 } 163 164 /* Create and initialize a new walk state */ 165 166 info->pass_number = ACPI_IMODE_EXECUTE; 167 walk_state = 168 acpi_ds_create_walk_state(info->obj_desc->method.owner_id, NULL, 169 NULL, NULL); 170 if (!walk_state) { 171 status = AE_NO_MEMORY; 172 goto cleanup; 173 } 174 175 status = acpi_ds_init_aml_walk(walk_state, op, info->node, 176 info->obj_desc->method.aml_start, 177 info->obj_desc->method.aml_length, info, 178 info->pass_number); 179 if (ACPI_FAILURE(status)) { 180 acpi_ds_delete_walk_state(walk_state); 181 goto cleanup; 182 } 183 184 if (info->obj_desc->method.info_flags & ACPI_METHOD_MODULE_LEVEL) { 185 walk_state->parse_flags |= ACPI_PARSE_MODULE_LEVEL; 186 } 187 188 /* Invoke an internal method if necessary */ 189 190 if (info->obj_desc->method.info_flags & ACPI_METHOD_INTERNAL_ONLY) { 191 status = 192 info->obj_desc->method.dispatch.implementation(walk_state); 193 info->return_object = walk_state->return_desc; 194 195 /* Cleanup states */ 196 197 acpi_ds_scope_stack_clear(walk_state); 198 acpi_ps_cleanup_scope(&walk_state->parser_state); 199 acpi_ds_terminate_control_method(walk_state->method_desc, 200 walk_state); 201 acpi_ds_delete_walk_state(walk_state); 202 goto cleanup; 203 } 204 205 /* 206 * Start method evaluation with an implicit return of zero. 207 * This is done for Windows compatibility. 208 */ 209 if (acpi_gbl_enable_interpreter_slack) { 210 walk_state->implicit_return_obj = 211 acpi_ut_create_integer_object((u64) 0); 212 if (!walk_state->implicit_return_obj) { 213 status = AE_NO_MEMORY; 214 acpi_ds_delete_walk_state(walk_state); 215 goto cleanup; 216 } 217 } 218 219 /* Parse the AML */ 220 221 status = acpi_ps_parse_aml(walk_state); 222 223 /* walk_state was deleted by parse_aml */ 224 225 cleanup: 226 acpi_ps_delete_parse_tree(op); 227 228 /* Take away the extra reference that we gave the parameters above */ 229 230 acpi_ps_update_parameter_list(info, REF_DECREMENT); 231 232 /* Exit now if error above */ 233 234 if (ACPI_FAILURE(status)) { 235 return_ACPI_STATUS(status); 236 } 237 238 /* 239 * If the method has returned an object, signal this to the caller with 240 * a control exception code 241 */ 242 if (info->return_object) { 243 ACPI_DEBUG_PRINT((ACPI_DB_PARSE, "Method returned ObjDesc=%p\n", 244 info->return_object)); 245 ACPI_DUMP_STACK_ENTRY(info->return_object); 246 247 status = AE_CTRL_RETURN_VALUE; 248 } 249 250 return_ACPI_STATUS(status); 251 } 252 253 /******************************************************************************* 254 * 255 * FUNCTION: acpi_ps_update_parameter_list 256 * 257 * PARAMETERS: info - See struct acpi_evaluate_info 258 * (Used: parameter_type and Parameters) 259 * action - Add or Remove reference 260 * 261 * RETURN: Status 262 * 263 * DESCRIPTION: Update reference count on all method parameter objects 264 * 265 ******************************************************************************/ 266 267 static void 268 acpi_ps_update_parameter_list(struct acpi_evaluate_info *info, u16 action) 269 { 270 u32 i; 271 272 if (info->parameters) { 273 274 /* Update reference count for each parameter */ 275 276 for (i = 0; info->parameters[i]; i++) { 277 278 /* Ignore errors, just do them all */ 279 280 (void)acpi_ut_update_object_reference(info-> 281 parameters[i], 282 action); 283 } 284 } 285 } 286