Linux Audio

Check our new training course

Linux BSP upgrade and security maintenance

Need help to get security updates for your Linux BSP?
Loading...
v3.1
 
  1/******************************************************************************
  2 *
  3 * Module Name: dsfield - Dispatcher field routines
  4 *
 
 
  5 *****************************************************************************/
  6
  7/*
  8 * Copyright (C) 2000 - 2011, 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 "amlcode.h"
 47#include "acdispat.h"
 48#include "acinterp.h"
 49#include "acnamesp.h"
 50#include "acparser.h"
 51
 
 
 
 
 52#define _COMPONENT          ACPI_DISPATCHER
 53ACPI_MODULE_NAME("dsfield")
 54
 55/* Local prototypes */
 
 
 
 
 
 
 
 
 
 
 56static acpi_status
 57acpi_ds_get_field_names(struct acpi_create_field_info *info,
 58			struct acpi_walk_state *walk_state,
 59			union acpi_parse_object *arg);
 60
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 61/*******************************************************************************
 62 *
 63 * FUNCTION:    acpi_ds_create_buffer_field
 64 *
 65 * PARAMETERS:  Op                  - Current parse op (create_xXField)
 66 *              walk_state          - Current state
 67 *
 68 * RETURN:      Status
 69 *
 70 * DESCRIPTION: Execute the create_field operators:
 71 *              create_bit_field_op,
 72 *              create_byte_field_op,
 73 *              create_word_field_op,
 74 *              create_dword_field_op,
 75 *              create_qword_field_op,
 76 *              create_field_op     (all of which define a field in a buffer)
 77 *
 78 ******************************************************************************/
 79
 80acpi_status
 81acpi_ds_create_buffer_field(union acpi_parse_object *op,
 82			    struct acpi_walk_state *walk_state)
 83{
 84	union acpi_parse_object *arg;
 85	struct acpi_namespace_node *node;
 86	acpi_status status;
 87	union acpi_operand_object *obj_desc;
 88	union acpi_operand_object *second_desc = NULL;
 89	u32 flags;
 90
 91	ACPI_FUNCTION_TRACE(ds_create_buffer_field);
 92
 93	/*
 94	 * Get the name_string argument (name of the new buffer_field)
 95	 */
 96	if (op->common.aml_opcode == AML_CREATE_FIELD_OP) {
 97
 98		/* For create_field, name is the 4th argument */
 99
100		arg = acpi_ps_get_arg(op, 3);
101	} else {
102		/* For all other create_xXXField operators, name is the 3rd argument */
103
104		arg = acpi_ps_get_arg(op, 2);
105	}
106
107	if (!arg) {
108		return_ACPI_STATUS(AE_AML_NO_OPERAND);
109	}
110
111	if (walk_state->deferred_node) {
112		node = walk_state->deferred_node;
113		status = AE_OK;
114	} else {
115		/* Execute flag should always be set when this function is entered */
116
117		if (!(walk_state->parse_flags & ACPI_PARSE_EXECUTE)) {
 
118			return_ACPI_STATUS(AE_AML_INTERNAL);
119		}
120
121		/* Creating new namespace node, should not already exist */
122
123		flags = ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
124		    ACPI_NS_ERROR_IF_FOUND;
125
126		/*
127		 * Mark node temporary if we are executing a normal control
128		 * method. (Don't mark if this is a module-level code method)
129		 */
130		if (walk_state->method_node &&
131		    !(walk_state->parse_flags & ACPI_PARSE_MODULE_LEVEL)) {
132			flags |= ACPI_NS_TEMPORARY;
133		}
134
135		/* Enter the name_string into the namespace */
136
137		status =
138		    acpi_ns_lookup(walk_state->scope_info,
139				   arg->common.value.string, ACPI_TYPE_ANY,
140				   ACPI_IMODE_LOAD_PASS1, flags, walk_state,
141				   &node);
142		if (ACPI_FAILURE(status)) {
143			ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 
 
 
144			return_ACPI_STATUS(status);
145		}
146	}
147
148	/*
149	 * We could put the returned object (Node) on the object stack for later,
150	 * but for now, we will put it in the "op" object that the parser uses,
151	 * so we can get it again at the end of this scope.
152	 */
153	op->common.node = node;
154
155	/*
156	 * If there is no object attached to the node, this node was just created
157	 * and we need to create the field object. Otherwise, this was a lookup
158	 * of an existing node and we don't want to create the field object again.
159	 */
160	obj_desc = acpi_ns_get_attached_object(node);
161	if (obj_desc) {
162		return_ACPI_STATUS(AE_OK);
163	}
164
165	/*
166	 * The Field definition is not fully parsed at this time.
167	 * (We must save the address of the AML for the buffer and index operands)
168	 */
169
170	/* Create the buffer field object */
171
172	obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_BUFFER_FIELD);
173	if (!obj_desc) {
174		status = AE_NO_MEMORY;
175		goto cleanup;
176	}
177
178	/*
179	 * Remember location in AML stream of the field unit opcode and operands --
180	 * since the buffer and index operands must be evaluated.
181	 */
182	second_desc = obj_desc->common.next_object;
183	second_desc->extra.aml_start = op->named.data;
184	second_desc->extra.aml_length = op->named.length;
185	obj_desc->buffer_field.node = node;
186
187	/* Attach constructed field descriptors to parent node */
188
189	status = acpi_ns_attach_object(node, obj_desc, ACPI_TYPE_BUFFER_FIELD);
190	if (ACPI_FAILURE(status)) {
191		goto cleanup;
192	}
193
194      cleanup:
195
196	/* Remove local reference to the object */
197
198	acpi_ut_remove_reference(obj_desc);
199	return_ACPI_STATUS(status);
200}
201
202/*******************************************************************************
203 *
204 * FUNCTION:    acpi_ds_get_field_names
205 *
206 * PARAMETERS:  Info            - create_field info structure
207 *  `           walk_state      - Current method state
208 *              Arg             - First parser arg for the field name list
209 *
210 * RETURN:      Status
211 *
212 * DESCRIPTION: Process all named fields in a field declaration.  Names are
213 *              entered into the namespace.
214 *
215 ******************************************************************************/
216
217static acpi_status
218acpi_ds_get_field_names(struct acpi_create_field_info *info,
219			struct acpi_walk_state *walk_state,
220			union acpi_parse_object *arg)
221{
222	acpi_status status;
223	u64 position;
 
 
 
 
 
 
 
224
225	ACPI_FUNCTION_TRACE_PTR(ds_get_field_names, info);
226
227	/* First field starts at bit zero */
228
229	info->field_bit_position = 0;
230
231	/* Process all elements in the field list (of parse nodes) */
232
233	while (arg) {
234		/*
235		 * Three types of field elements are handled:
236		 * 1) Offset - specifies a bit offset
237		 * 2) access_as - changes the access mode
238		 * 3) Name - Enters a new named field into the namespace
 
239		 */
240		switch (arg->common.aml_opcode) {
241		case AML_INT_RESERVEDFIELD_OP:
242
243			position = (u64) info->field_bit_position
244			    + (u64) arg->common.value.size;
245
246			if (position > ACPI_UINT32_MAX) {
247				ACPI_ERROR((AE_INFO,
248					    "Bit offset within field too large (> 0xFFFFFFFF)"));
249				return_ACPI_STATUS(AE_SUPPORT);
250			}
251
252			info->field_bit_position = (u32) position;
253			break;
254
255		case AML_INT_ACCESSFIELD_OP:
256
257			/*
258			 * Get a new access_type and access_attribute -- to be used for all
259			 * field units that follow, until field end or another access_as
260			 * keyword.
 
 
261			 *
262			 * In field_flags, preserve the flag bits other than the
263			 * ACCESS_TYPE bits
264			 */
 
 
 
265			info->field_flags = (u8)
266			    ((info->
267			      field_flags & ~(AML_FIELD_ACCESS_TYPE_MASK)) |
268			     ((u8) ((u32) arg->common.value.integer >> 8)));
 
 
 
 
 
269
270			info->attribute = (u8) (arg->common.value.integer);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
271			break;
272
273		case AML_INT_NAMEDFIELD_OP:
274
275			/* Lookup the name, it should already exist */
276
277			status = acpi_ns_lookup(walk_state->scope_info,
278						(char *)&arg->named.name,
279						info->field_type,
280						ACPI_IMODE_EXECUTE,
281						ACPI_NS_DONT_OPEN_SCOPE,
282						walk_state, &info->field_node);
283			if (ACPI_FAILURE(status)) {
284				ACPI_ERROR_NAMESPACE((char *)&arg->named.name,
 
285						     status);
286				return_ACPI_STATUS(status);
287			} else {
288				arg->common.node = info->field_node;
289				info->field_bit_length = arg->common.value.size;
290
291				/*
292				 * If there is no object attached to the node, this node was
293				 * just created and we need to create the field object.
294				 * Otherwise, this was a lookup of an existing node and we
295				 * don't want to create the field object again.
296				 */
297				if (!acpi_ns_get_attached_object
298				    (info->field_node)) {
299					status = acpi_ex_prep_field_value(info);
300					if (ACPI_FAILURE(status)) {
301						return_ACPI_STATUS(status);
302					}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
303				}
304			}
305
306			/* Keep track of bit position for the next field */
307
308			position = (u64) info->field_bit_position
309			    + (u64) arg->common.value.size;
310
311			if (position > ACPI_UINT32_MAX) {
312				ACPI_ERROR((AE_INFO,
313					    "Field [%4.4s] bit offset too large (> 0xFFFFFFFF)",
314					    ACPI_CAST_PTR(char,
315							  &info->field_node->
316							  name)));
317				return_ACPI_STATUS(AE_SUPPORT);
318			}
319
320			info->field_bit_position += info->field_bit_length;
 
321			break;
322
323		default:
324
325			ACPI_ERROR((AE_INFO,
326				    "Invalid opcode in field list: 0x%X",
327				    arg->common.aml_opcode));
328			return_ACPI_STATUS(AE_AML_BAD_OPCODE);
329		}
330
331		arg = arg->common.next;
332	}
333
334	return_ACPI_STATUS(AE_OK);
335}
336
337/*******************************************************************************
338 *
339 * FUNCTION:    acpi_ds_create_field
340 *
341 * PARAMETERS:  Op              - Op containing the Field definition and args
342 *              region_node     - Object for the containing Operation Region
343 *  `           walk_state      - Current method state
344 *
345 * RETURN:      Status
346 *
347 * DESCRIPTION: Create a new field in the specified operation region
348 *
349 ******************************************************************************/
350
351acpi_status
352acpi_ds_create_field(union acpi_parse_object *op,
353		     struct acpi_namespace_node *region_node,
354		     struct acpi_walk_state *walk_state)
355{
356	acpi_status status;
357	union acpi_parse_object *arg;
358	struct acpi_create_field_info info;
359
360	ACPI_FUNCTION_TRACE_PTR(ds_create_field, op);
361
362	/* First arg is the name of the parent op_region (must already exist) */
363
364	arg = op->common.value.arg;
 
365	if (!region_node) {
366		status =
367		    acpi_ns_lookup(walk_state->scope_info,
368				   arg->common.value.name, ACPI_TYPE_REGION,
369				   ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
370				   walk_state, &region_node);
 
 
 
 
 
 
371		if (ACPI_FAILURE(status)) {
372			ACPI_ERROR_NAMESPACE(arg->common.value.name, status);
 
373			return_ACPI_STATUS(status);
374		}
375	}
376
 
 
377	/* Second arg is the field flags */
378
379	arg = arg->common.next;
380	info.field_flags = (u8) arg->common.value.integer;
381	info.attribute = 0;
382
383	/* Each remaining arg is a Named Field */
384
385	info.field_type = ACPI_TYPE_LOCAL_REGION_FIELD;
386	info.region_node = region_node;
387
388	status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
 
 
 
 
 
 
 
 
 
 
 
 
 
389
390	return_ACPI_STATUS(status);
391}
392
393/*******************************************************************************
394 *
395 * FUNCTION:    acpi_ds_init_field_objects
396 *
397 * PARAMETERS:  Op              - Op containing the Field definition and args
398 *  `           walk_state      - Current method state
399 *
400 * RETURN:      Status
401 *
402 * DESCRIPTION: For each "Field Unit" name in the argument list that is
403 *              part of the field declaration, enter the name into the
404 *              namespace.
405 *
406 ******************************************************************************/
407
408acpi_status
409acpi_ds_init_field_objects(union acpi_parse_object *op,
410			   struct acpi_walk_state *walk_state)
411{
412	acpi_status status;
413	union acpi_parse_object *arg = NULL;
414	struct acpi_namespace_node *node;
415	u8 type = 0;
416	u32 flags;
417
418	ACPI_FUNCTION_TRACE_PTR(ds_init_field_objects, op);
419
420	/* Execute flag should always be set when this function is entered */
421
422	if (!(walk_state->parse_flags & ACPI_PARSE_EXECUTE)) {
423		if (walk_state->parse_flags & ACPI_PARSE_DEFERRED_OP) {
424
425			/* bank_field Op is deferred, just return OK */
426
427			return_ACPI_STATUS(AE_OK);
428		}
429
 
430		return_ACPI_STATUS(AE_AML_INTERNAL);
431	}
432
433	/*
434	 * Get the field_list argument for this opcode. This is the start of the
435	 * list of field elements.
436	 */
437	switch (walk_state->opcode) {
438	case AML_FIELD_OP:
 
439		arg = acpi_ps_get_arg(op, 2);
440		type = ACPI_TYPE_LOCAL_REGION_FIELD;
441		break;
442
443	case AML_BANK_FIELD_OP:
 
444		arg = acpi_ps_get_arg(op, 4);
445		type = ACPI_TYPE_LOCAL_BANK_FIELD;
446		break;
447
448	case AML_INDEX_FIELD_OP:
 
449		arg = acpi_ps_get_arg(op, 3);
450		type = ACPI_TYPE_LOCAL_INDEX_FIELD;
451		break;
452
453	default:
 
454		return_ACPI_STATUS(AE_BAD_PARAMETER);
455	}
456
457	/* Creating new namespace node(s), should not already exist */
458
459	flags = ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
460	    ACPI_NS_ERROR_IF_FOUND;
461
462	/*
463	 * Mark node(s) temporary if we are executing a normal control
464	 * method. (Don't mark if this is a module-level code method)
465	 */
466	if (walk_state->method_node &&
467	    !(walk_state->parse_flags & ACPI_PARSE_MODULE_LEVEL)) {
468		flags |= ACPI_NS_TEMPORARY;
469	}
470
 
 
471	/*
472	 * Walk the list of entries in the field_list
473	 * Note: field_list can be of zero length. In this case, Arg will be NULL.
474	 */
475	while (arg) {
476		/*
477		 * Ignore OFFSET and ACCESSAS terms here; we are only interested in the
478		 * field names in order to enter them into the namespace.
479		 */
480		if (arg->common.aml_opcode == AML_INT_NAMEDFIELD_OP) {
481			status = acpi_ns_lookup(walk_state->scope_info,
482						(char *)&arg->named.name, type,
483						ACPI_IMODE_LOAD_PASS1, flags,
484						walk_state, &node);
485			if (ACPI_FAILURE(status)) {
486				ACPI_ERROR_NAMESPACE((char *)&arg->named.name,
 
487						     status);
488				if (status != AE_ALREADY_EXISTS) {
489					return_ACPI_STATUS(status);
490				}
491
492				/* Name already exists, just ignore this error */
493
494				status = AE_OK;
495			}
496
497			arg->common.node = node;
498		}
499
500		/* Get the next field element in the list */
501
502		arg = arg->common.next;
503	}
504
505	return_ACPI_STATUS(AE_OK);
506}
507
508/*******************************************************************************
509 *
510 * FUNCTION:    acpi_ds_create_bank_field
511 *
512 * PARAMETERS:  Op              - Op containing the Field definition and args
513 *              region_node     - Object for the containing Operation Region
514 *              walk_state      - Current method state
515 *
516 * RETURN:      Status
517 *
518 * DESCRIPTION: Create a new bank field in the specified operation region
519 *
520 ******************************************************************************/
521
522acpi_status
523acpi_ds_create_bank_field(union acpi_parse_object *op,
524			  struct acpi_namespace_node *region_node,
525			  struct acpi_walk_state *walk_state)
526{
527	acpi_status status;
528	union acpi_parse_object *arg;
529	struct acpi_create_field_info info;
530
531	ACPI_FUNCTION_TRACE_PTR(ds_create_bank_field, op);
532
533	/* First arg is the name of the parent op_region (must already exist) */
534
535	arg = op->common.value.arg;
536	if (!region_node) {
537		status =
538		    acpi_ns_lookup(walk_state->scope_info,
539				   arg->common.value.name, ACPI_TYPE_REGION,
540				   ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
541				   walk_state, &region_node);
 
 
 
 
 
 
542		if (ACPI_FAILURE(status)) {
543			ACPI_ERROR_NAMESPACE(arg->common.value.name, status);
 
544			return_ACPI_STATUS(status);
545		}
546	}
547
548	/* Second arg is the Bank Register (Field) (must already exist) */
549
550	arg = arg->common.next;
551	status =
552	    acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
553			   ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
554			   ACPI_NS_SEARCH_PARENT, walk_state,
555			   &info.register_node);
556	if (ACPI_FAILURE(status)) {
557		ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 
558		return_ACPI_STATUS(status);
559	}
560
561	/*
562	 * Third arg is the bank_value
563	 * This arg is a term_arg, not a constant
564	 * It will be evaluated later, by acpi_ds_eval_bank_field_operands
565	 */
566	arg = arg->common.next;
567
568	/* Fourth arg is the field flags */
569
570	arg = arg->common.next;
571	info.field_flags = (u8) arg->common.value.integer;
572
573	/* Each remaining arg is a Named Field */
574
575	info.field_type = ACPI_TYPE_LOCAL_BANK_FIELD;
576	info.region_node = region_node;
577
578	/*
579	 * Use Info.data_register_node to store bank_field Op
580	 * It's safe because data_register_node will never be used when create bank field
581	 * We store aml_start and aml_length in the bank_field Op for late evaluation
582	 * Used in acpi_ex_prep_field_value(Info)
583	 *
584	 * TBD: Or, should we add a field in struct acpi_create_field_info, like "void *ParentOp"?
 
585	 */
586	info.data_register_node = (struct acpi_namespace_node *)op;
587
588	status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
589	return_ACPI_STATUS(status);
590}
591
592/*******************************************************************************
593 *
594 * FUNCTION:    acpi_ds_create_index_field
595 *
596 * PARAMETERS:  Op              - Op containing the Field definition and args
597 *              region_node     - Object for the containing Operation Region
598 *  `           walk_state      - Current method state
599 *
600 * RETURN:      Status
601 *
602 * DESCRIPTION: Create a new index field in the specified operation region
603 *
604 ******************************************************************************/
605
606acpi_status
607acpi_ds_create_index_field(union acpi_parse_object *op,
608			   struct acpi_namespace_node *region_node,
609			   struct acpi_walk_state *walk_state)
610{
611	acpi_status status;
612	union acpi_parse_object *arg;
613	struct acpi_create_field_info info;
614
615	ACPI_FUNCTION_TRACE_PTR(ds_create_index_field, op);
616
617	/* First arg is the name of the Index register (must already exist) */
618
619	arg = op->common.value.arg;
620	status =
621	    acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
622			   ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
623			   ACPI_NS_SEARCH_PARENT, walk_state,
624			   &info.register_node);
625	if (ACPI_FAILURE(status)) {
626		ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 
627		return_ACPI_STATUS(status);
628	}
629
630	/* Second arg is the data register (must already exist) */
631
632	arg = arg->common.next;
633	status =
634	    acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
635			   ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
636			   ACPI_NS_SEARCH_PARENT, walk_state,
637			   &info.data_register_node);
638	if (ACPI_FAILURE(status)) {
639		ACPI_ERROR_NAMESPACE(arg->common.value.string, status);
 
640		return_ACPI_STATUS(status);
641	}
642
643	/* Next arg is the field flags */
644
645	arg = arg->common.next;
646	info.field_flags = (u8) arg->common.value.integer;
647
648	/* Each remaining arg is a Named Field */
649
650	info.field_type = ACPI_TYPE_LOCAL_INDEX_FIELD;
651	info.region_node = region_node;
652
653	status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
654
655	return_ACPI_STATUS(status);
656}
v6.8
  1// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
  2/******************************************************************************
  3 *
  4 * Module Name: dsfield - Dispatcher field routines
  5 *
  6 * Copyright (C) 2000 - 2023, Intel Corp.
  7 *
  8 *****************************************************************************/
  9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 10#include <acpi/acpi.h>
 11#include "accommon.h"
 12#include "amlcode.h"
 13#include "acdispat.h"
 14#include "acinterp.h"
 15#include "acnamesp.h"
 16#include "acparser.h"
 17
 18#ifdef ACPI_EXEC_APP
 19#include "aecommon.h"
 20#endif
 21
 22#define _COMPONENT          ACPI_DISPATCHER
 23ACPI_MODULE_NAME("dsfield")
 24
 25/* Local prototypes */
 26#ifdef ACPI_ASL_COMPILER
 27#include "acdisasm.h"
 28static acpi_status
 29acpi_ds_create_external_region(acpi_status lookup_status,
 30			       union acpi_parse_object *op,
 31			       char *path,
 32			       struct acpi_walk_state *walk_state,
 33			       struct acpi_namespace_node **node);
 34#endif
 35
 36static acpi_status
 37acpi_ds_get_field_names(struct acpi_create_field_info *info,
 38			struct acpi_walk_state *walk_state,
 39			union acpi_parse_object *arg);
 40
 41#ifdef ACPI_ASL_COMPILER
 42/*******************************************************************************
 43 *
 44 * FUNCTION:    acpi_ds_create_external_region (iASL Disassembler only)
 45 *
 46 * PARAMETERS:  lookup_status   - Status from ns_lookup operation
 47 *              op              - Op containing the Field definition and args
 48 *              path            - Pathname of the region
 49 *  `           walk_state      - Current method state
 50 *              node            - Where the new region node is returned
 51 *
 52 * RETURN:      Status
 53 *
 54 * DESCRIPTION: Add region to the external list if NOT_FOUND. Create a new
 55 *              region node/object.
 56 *
 57 ******************************************************************************/
 58
 59static acpi_status
 60acpi_ds_create_external_region(acpi_status lookup_status,
 61			       union acpi_parse_object *op,
 62			       char *path,
 63			       struct acpi_walk_state *walk_state,
 64			       struct acpi_namespace_node **node)
 65{
 66	acpi_status status;
 67	union acpi_operand_object *obj_desc;
 68
 69	if (lookup_status != AE_NOT_FOUND) {
 70		return (lookup_status);
 71	}
 72
 73	/*
 74	 * Table disassembly:
 75	 * operation_region not found. Generate an External for it, and
 76	 * insert the name into the namespace.
 77	 */
 78	acpi_dm_add_op_to_external_list(op, path, ACPI_TYPE_REGION, 0, 0);
 79
 80	status = acpi_ns_lookup(walk_state->scope_info, path, ACPI_TYPE_REGION,
 81				ACPI_IMODE_LOAD_PASS1, ACPI_NS_SEARCH_PARENT,
 82				walk_state, node);
 83	if (ACPI_FAILURE(status)) {
 84		return (status);
 85	}
 86
 87	/* Must create and install a region object for the new node */
 88
 89	obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_REGION);
 90	if (!obj_desc) {
 91		return (AE_NO_MEMORY);
 92	}
 93
 94	obj_desc->region.node = *node;
 95	status = acpi_ns_attach_object(*node, obj_desc, ACPI_TYPE_REGION);
 96	return (status);
 97}
 98#endif
 99
100/*******************************************************************************
101 *
102 * FUNCTION:    acpi_ds_create_buffer_field
103 *
104 * PARAMETERS:  op                  - Current parse op (create_XXField)
105 *              walk_state          - Current state
106 *
107 * RETURN:      Status
108 *
109 * DESCRIPTION: Execute the create_field operators:
110 *              create_bit_field_op,
111 *              create_byte_field_op,
112 *              create_word_field_op,
113 *              create_dword_field_op,
114 *              create_qword_field_op,
115 *              create_field_op     (all of which define a field in a buffer)
116 *
117 ******************************************************************************/
118
119acpi_status
120acpi_ds_create_buffer_field(union acpi_parse_object *op,
121			    struct acpi_walk_state *walk_state)
122{
123	union acpi_parse_object *arg;
124	struct acpi_namespace_node *node;
125	acpi_status status;
126	union acpi_operand_object *obj_desc;
127	union acpi_operand_object *second_desc = NULL;
128	u32 flags;
129
130	ACPI_FUNCTION_TRACE(ds_create_buffer_field);
131
132	/*
133	 * Get the name_string argument (name of the new buffer_field)
134	 */
135	if (op->common.aml_opcode == AML_CREATE_FIELD_OP) {
136
137		/* For create_field, name is the 4th argument */
138
139		arg = acpi_ps_get_arg(op, 3);
140	} else {
141		/* For all other create_XXXField operators, name is the 3rd argument */
142
143		arg = acpi_ps_get_arg(op, 2);
144	}
145
146	if (!arg) {
147		return_ACPI_STATUS(AE_AML_NO_OPERAND);
148	}
149
150	if (walk_state->deferred_node) {
151		node = walk_state->deferred_node;
 
152	} else {
153		/* Execute flag should always be set when this function is entered */
154
155		if (!(walk_state->parse_flags & ACPI_PARSE_EXECUTE)) {
156			ACPI_ERROR((AE_INFO, "Parse execute mode is not set"));
157			return_ACPI_STATUS(AE_AML_INTERNAL);
158		}
159
160		/* Creating new namespace node, should not already exist */
161
162		flags = ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
163		    ACPI_NS_ERROR_IF_FOUND;
164
165		/*
166		 * Mark node temporary if we are executing a normal control
167		 * method. (Don't mark if this is a module-level code method)
168		 */
169		if (walk_state->method_node &&
170		    !(walk_state->parse_flags & ACPI_PARSE_MODULE_LEVEL)) {
171			flags |= ACPI_NS_TEMPORARY;
172		}
173
174		/* Enter the name_string into the namespace */
175
176		status = acpi_ns_lookup(walk_state->scope_info,
177					arg->common.value.string, ACPI_TYPE_ANY,
178					ACPI_IMODE_LOAD_PASS1, flags,
179					walk_state, &node);
180		if ((walk_state->parse_flags & ACPI_PARSE_DISASSEMBLE)
181		    && status == AE_ALREADY_EXISTS) {
182			status = AE_OK;
183		} else if (ACPI_FAILURE(status)) {
184			ACPI_ERROR_NAMESPACE(walk_state->scope_info,
185					     arg->common.value.string, status);
186			return_ACPI_STATUS(status);
187		}
188	}
189
190	/*
191	 * We could put the returned object (Node) on the object stack for later,
192	 * but for now, we will put it in the "op" object that the parser uses,
193	 * so we can get it again at the end of this scope.
194	 */
195	op->common.node = node;
196
197	/*
198	 * If there is no object attached to the node, this node was just created
199	 * and we need to create the field object. Otherwise, this was a lookup
200	 * of an existing node and we don't want to create the field object again.
201	 */
202	obj_desc = acpi_ns_get_attached_object(node);
203	if (obj_desc) {
204		return_ACPI_STATUS(AE_OK);
205	}
206
207	/*
208	 * The Field definition is not fully parsed at this time.
209	 * (We must save the address of the AML for the buffer and index operands)
210	 */
211
212	/* Create the buffer field object */
213
214	obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_BUFFER_FIELD);
215	if (!obj_desc) {
216		status = AE_NO_MEMORY;
217		goto cleanup;
218	}
219
220	/*
221	 * Remember location in AML stream of the field unit opcode and operands
222	 * -- since the buffer and index operands must be evaluated.
223	 */
224	second_desc = obj_desc->common.next_object;
225	second_desc->extra.aml_start = op->named.data;
226	second_desc->extra.aml_length = op->named.length;
227	obj_desc->buffer_field.node = node;
228
229	/* Attach constructed field descriptors to parent node */
230
231	status = acpi_ns_attach_object(node, obj_desc, ACPI_TYPE_BUFFER_FIELD);
232	if (ACPI_FAILURE(status)) {
233		goto cleanup;
234	}
235
236cleanup:
237
238	/* Remove local reference to the object */
239
240	acpi_ut_remove_reference(obj_desc);
241	return_ACPI_STATUS(status);
242}
243
244/*******************************************************************************
245 *
246 * FUNCTION:    acpi_ds_get_field_names
247 *
248 * PARAMETERS:  info            - create_field info structure
249 *              walk_state      - Current method state
250 *              arg             - First parser arg for the field name list
251 *
252 * RETURN:      Status
253 *
254 * DESCRIPTION: Process all named fields in a field declaration. Names are
255 *              entered into the namespace.
256 *
257 ******************************************************************************/
258
259static acpi_status
260acpi_ds_get_field_names(struct acpi_create_field_info *info,
261			struct acpi_walk_state *walk_state,
262			union acpi_parse_object *arg)
263{
264	acpi_status status;
265	u64 position;
266	union acpi_parse_object *child;
267
268#ifdef ACPI_EXEC_APP
269	union acpi_operand_object *result_desc;
270	union acpi_operand_object *obj_desc;
271	char *name_path;
272#endif
273
274	ACPI_FUNCTION_TRACE_PTR(ds_get_field_names, info);
275
276	/* First field starts at bit zero */
277
278	info->field_bit_position = 0;
279
280	/* Process all elements in the field list (of parse nodes) */
281
282	while (arg) {
283		/*
284		 * Four types of field elements are handled:
285		 * 1) name - Enters a new named field into the namespace
286		 * 2) offset - specifies a bit offset
287		 * 3) access_as - changes the access mode/attributes
288		 * 4) connection - Associate a resource template with the field
289		 */
290		switch (arg->common.aml_opcode) {
291		case AML_INT_RESERVEDFIELD_OP:
292
293			position = (u64)info->field_bit_position +
294			    (u64)arg->common.value.size;
295
296			if (position > ACPI_UINT32_MAX) {
297				ACPI_ERROR((AE_INFO,
298					    "Bit offset within field too large (> 0xFFFFFFFF)"));
299				return_ACPI_STATUS(AE_SUPPORT);
300			}
301
302			info->field_bit_position = (u32) position;
303			break;
304
305		case AML_INT_ACCESSFIELD_OP:
306		case AML_INT_EXTACCESSFIELD_OP:
307			/*
308			 * Get new access_type, access_attribute, and access_length fields
309			 * -- to be used for all field units that follow, until the
310			 * end-of-field or another access_as keyword is encountered.
311			 * NOTE. These three bytes are encoded in the integer value
312			 * of the parseop for convenience.
313			 *
314			 * In field_flags, preserve the flag bits other than the
315			 * ACCESS_TYPE bits.
316			 */
317
318			/* access_type (byte_acc, word_acc, etc.) */
319
320			info->field_flags = (u8)
321			    ((info->
322			      field_flags & ~(AML_FIELD_ACCESS_TYPE_MASK)) |
323			     ((u8)((u32)(arg->common.value.integer & 0x07))));
324
325			/* access_attribute (attrib_quick, attrib_byte, etc.) */
326
327			info->attribute = (u8)
328			    ((arg->common.value.integer >> 8) & 0xFF);
329
330			/* access_length (for serial/buffer protocols) */
331
332			info->access_length = (u8)
333			    ((arg->common.value.integer >> 16) & 0xFF);
334			break;
335
336		case AML_INT_CONNECTION_OP:
337			/*
338			 * Clear any previous connection. New connection is used for all
339			 * fields that follow, similar to access_as
340			 */
341			info->resource_buffer = NULL;
342			info->connection_node = NULL;
343			info->pin_number_index = 0;
344
345			/*
346			 * A Connection() is either an actual resource descriptor (buffer)
347			 * or a named reference to a resource template
348			 */
349			child = arg->common.value.arg;
350			if (child->common.aml_opcode == AML_INT_BYTELIST_OP) {
351				info->resource_buffer = child->named.data;
352				info->resource_length =
353				    (u16)child->named.value.integer;
354			} else {
355				/* Lookup the Connection() namepath, it should already exist */
356
357				status = acpi_ns_lookup(walk_state->scope_info,
358							child->common.value.
359							name, ACPI_TYPE_ANY,
360							ACPI_IMODE_EXECUTE,
361							ACPI_NS_DONT_OPEN_SCOPE,
362							walk_state,
363							&info->connection_node);
364				if (ACPI_FAILURE(status)) {
365					ACPI_ERROR_NAMESPACE(walk_state->
366							     scope_info,
367							     child->common.
368							     value.name,
369							     status);
370					return_ACPI_STATUS(status);
371				}
372			}
373			break;
374
375		case AML_INT_NAMEDFIELD_OP:
376
377			/* Lookup the name, it should already exist */
378
379			status = acpi_ns_lookup(walk_state->scope_info,
380						(char *)&arg->named.name,
381						info->field_type,
382						ACPI_IMODE_EXECUTE,
383						ACPI_NS_DONT_OPEN_SCOPE,
384						walk_state, &info->field_node);
385			if (ACPI_FAILURE(status)) {
386				ACPI_ERROR_NAMESPACE(walk_state->scope_info,
387						     (char *)&arg->named.name,
388						     status);
389				return_ACPI_STATUS(status);
390			} else {
391				arg->common.node = info->field_node;
392				info->field_bit_length = arg->common.value.size;
393
394				/*
395				 * If there is no object attached to the node, this node was
396				 * just created and we need to create the field object.
397				 * Otherwise, this was a lookup of an existing node and we
398				 * don't want to create the field object again.
399				 */
400				if (!acpi_ns_get_attached_object
401				    (info->field_node)) {
402					status = acpi_ex_prep_field_value(info);
403					if (ACPI_FAILURE(status)) {
404						return_ACPI_STATUS(status);
405					}
406#ifdef ACPI_EXEC_APP
407					name_path =
408					    acpi_ns_get_external_pathname(info->
409									  field_node);
410					if (ACPI_SUCCESS
411					    (ae_lookup_init_file_entry
412					     (name_path, &obj_desc))) {
413						acpi_ex_write_data_to_field
414						    (obj_desc,
415						     acpi_ns_get_attached_object
416						     (info->field_node),
417						     &result_desc);
418						acpi_ut_remove_reference
419						    (obj_desc);
420					}
421					ACPI_FREE(name_path);
422#endif
423				}
424			}
425
426			/* Keep track of bit position for the next field */
427
428			position = (u64)info->field_bit_position +
429			    (u64)arg->common.value.size;
430
431			if (position > ACPI_UINT32_MAX) {
432				ACPI_ERROR((AE_INFO,
433					    "Field [%4.4s] bit offset too large (> 0xFFFFFFFF)",
434					    ACPI_CAST_PTR(char,
435							  &info->field_node->
436							  name)));
437				return_ACPI_STATUS(AE_SUPPORT);
438			}
439
440			info->field_bit_position += info->field_bit_length;
441			info->pin_number_index++;	/* Index relative to previous Connection() */
442			break;
443
444		default:
445
446			ACPI_ERROR((AE_INFO,
447				    "Invalid opcode in field list: 0x%X",
448				    arg->common.aml_opcode));
449			return_ACPI_STATUS(AE_AML_BAD_OPCODE);
450		}
451
452		arg = arg->common.next;
453	}
454
455	return_ACPI_STATUS(AE_OK);
456}
457
458/*******************************************************************************
459 *
460 * FUNCTION:    acpi_ds_create_field
461 *
462 * PARAMETERS:  op              - Op containing the Field definition and args
463 *              region_node     - Object for the containing Operation Region
464 *  `           walk_state      - Current method state
465 *
466 * RETURN:      Status
467 *
468 * DESCRIPTION: Create a new field in the specified operation region
469 *
470 ******************************************************************************/
471
472acpi_status
473acpi_ds_create_field(union acpi_parse_object *op,
474		     struct acpi_namespace_node *region_node,
475		     struct acpi_walk_state *walk_state)
476{
477	acpi_status status;
478	union acpi_parse_object *arg;
479	struct acpi_create_field_info info;
480
481	ACPI_FUNCTION_TRACE_PTR(ds_create_field, op);
482
483	/* First arg is the name of the parent op_region (must already exist) */
484
485	arg = op->common.value.arg;
486
487	if (!region_node) {
488		status =
489		    acpi_ns_lookup(walk_state->scope_info,
490				   arg->common.value.name, ACPI_TYPE_REGION,
491				   ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
492				   walk_state, &region_node);
493#ifdef ACPI_ASL_COMPILER
494		status = acpi_ds_create_external_region(status, arg,
495							arg->common.value.name,
496							walk_state,
497							&region_node);
498#endif
499		if (ACPI_FAILURE(status)) {
500			ACPI_ERROR_NAMESPACE(walk_state->scope_info,
501					     arg->common.value.name, status);
502			return_ACPI_STATUS(status);
503		}
504	}
505
506	memset(&info, 0, sizeof(struct acpi_create_field_info));
507
508	/* Second arg is the field flags */
509
510	arg = arg->common.next;
511	info.field_flags = (u8) arg->common.value.integer;
512	info.attribute = 0;
513
514	/* Each remaining arg is a Named Field */
515
516	info.field_type = ACPI_TYPE_LOCAL_REGION_FIELD;
517	info.region_node = region_node;
518
519	status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
520	if (ACPI_FAILURE(status)) {
521		return_ACPI_STATUS(status);
522	}
523
524	if (info.region_node->object->region.space_id ==
525	    ACPI_ADR_SPACE_PLATFORM_COMM) {
526		region_node->object->field.internal_pcc_buffer =
527		    ACPI_ALLOCATE_ZEROED(info.region_node->object->region.
528					 length);
529		if (!region_node->object->field.internal_pcc_buffer) {
530			return_ACPI_STATUS(AE_NO_MEMORY);
531		}
532	}
533
534	return_ACPI_STATUS(status);
535}
536
537/*******************************************************************************
538 *
539 * FUNCTION:    acpi_ds_init_field_objects
540 *
541 * PARAMETERS:  op              - Op containing the Field definition and args
542 *  `           walk_state      - Current method state
543 *
544 * RETURN:      Status
545 *
546 * DESCRIPTION: For each "Field Unit" name in the argument list that is
547 *              part of the field declaration, enter the name into the
548 *              namespace.
549 *
550 ******************************************************************************/
551
552acpi_status
553acpi_ds_init_field_objects(union acpi_parse_object *op,
554			   struct acpi_walk_state *walk_state)
555{
556	acpi_status status;
557	union acpi_parse_object *arg = NULL;
558	struct acpi_namespace_node *node;
559	u8 type = 0;
560	u32 flags;
561
562	ACPI_FUNCTION_TRACE_PTR(ds_init_field_objects, op);
563
564	/* Execute flag should always be set when this function is entered */
565
566	if (!(walk_state->parse_flags & ACPI_PARSE_EXECUTE)) {
567		if (walk_state->parse_flags & ACPI_PARSE_DEFERRED_OP) {
568
569			/* bank_field Op is deferred, just return OK */
570
571			return_ACPI_STATUS(AE_OK);
572		}
573
574		ACPI_ERROR((AE_INFO, "Parse deferred mode is not set"));
575		return_ACPI_STATUS(AE_AML_INTERNAL);
576	}
577
578	/*
579	 * Get the field_list argument for this opcode. This is the start of the
580	 * list of field elements.
581	 */
582	switch (walk_state->opcode) {
583	case AML_FIELD_OP:
584
585		arg = acpi_ps_get_arg(op, 2);
586		type = ACPI_TYPE_LOCAL_REGION_FIELD;
587		break;
588
589	case AML_BANK_FIELD_OP:
590
591		arg = acpi_ps_get_arg(op, 4);
592		type = ACPI_TYPE_LOCAL_BANK_FIELD;
593		break;
594
595	case AML_INDEX_FIELD_OP:
596
597		arg = acpi_ps_get_arg(op, 3);
598		type = ACPI_TYPE_LOCAL_INDEX_FIELD;
599		break;
600
601	default:
602
603		return_ACPI_STATUS(AE_BAD_PARAMETER);
604	}
605
606	/* Creating new namespace node(s), should not already exist */
607
608	flags = ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
609	    ACPI_NS_ERROR_IF_FOUND;
610
611	/*
612	 * Mark node(s) temporary if we are executing a normal control
613	 * method. (Don't mark if this is a module-level code method)
614	 */
615	if (walk_state->method_node &&
616	    !(walk_state->parse_flags & ACPI_PARSE_MODULE_LEVEL)) {
617		flags |= ACPI_NS_TEMPORARY;
618	}
619#ifdef ACPI_EXEC_APP
620	flags |= ACPI_NS_OVERRIDE_IF_FOUND;
621#endif
622	/*
623	 * Walk the list of entries in the field_list
624	 * Note: field_list can be of zero length. In this case, Arg will be NULL.
625	 */
626	while (arg) {
627		/*
628		 * Ignore OFFSET/ACCESSAS/CONNECTION terms here; we are only interested
629		 * in the field names in order to enter them into the namespace.
630		 */
631		if (arg->common.aml_opcode == AML_INT_NAMEDFIELD_OP) {
632			status = acpi_ns_lookup(walk_state->scope_info,
633						(char *)&arg->named.name, type,
634						ACPI_IMODE_LOAD_PASS1, flags,
635						walk_state, &node);
636			if (ACPI_FAILURE(status)) {
637				ACPI_ERROR_NAMESPACE(walk_state->scope_info,
638						     (char *)&arg->named.name,
639						     status);
640				if (status != AE_ALREADY_EXISTS) {
641					return_ACPI_STATUS(status);
642				}
643
644				/* Name already exists, just ignore this error */
 
 
645			}
646
647			arg->common.node = node;
648		}
649
650		/* Get the next field element in the list */
651
652		arg = arg->common.next;
653	}
654
655	return_ACPI_STATUS(AE_OK);
656}
657
658/*******************************************************************************
659 *
660 * FUNCTION:    acpi_ds_create_bank_field
661 *
662 * PARAMETERS:  op              - Op containing the Field definition and args
663 *              region_node     - Object for the containing Operation Region
664 *              walk_state      - Current method state
665 *
666 * RETURN:      Status
667 *
668 * DESCRIPTION: Create a new bank field in the specified operation region
669 *
670 ******************************************************************************/
671
672acpi_status
673acpi_ds_create_bank_field(union acpi_parse_object *op,
674			  struct acpi_namespace_node *region_node,
675			  struct acpi_walk_state *walk_state)
676{
677	acpi_status status;
678	union acpi_parse_object *arg;
679	struct acpi_create_field_info info;
680
681	ACPI_FUNCTION_TRACE_PTR(ds_create_bank_field, op);
682
683	/* First arg is the name of the parent op_region (must already exist) */
684
685	arg = op->common.value.arg;
686	if (!region_node) {
687		status =
688		    acpi_ns_lookup(walk_state->scope_info,
689				   arg->common.value.name, ACPI_TYPE_REGION,
690				   ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
691				   walk_state, &region_node);
692#ifdef ACPI_ASL_COMPILER
693		status = acpi_ds_create_external_region(status, arg,
694							arg->common.value.name,
695							walk_state,
696							&region_node);
697#endif
698		if (ACPI_FAILURE(status)) {
699			ACPI_ERROR_NAMESPACE(walk_state->scope_info,
700					     arg->common.value.name, status);
701			return_ACPI_STATUS(status);
702		}
703	}
704
705	/* Second arg is the Bank Register (Field) (must already exist) */
706
707	arg = arg->common.next;
708	status =
709	    acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
710			   ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
711			   ACPI_NS_SEARCH_PARENT, walk_state,
712			   &info.register_node);
713	if (ACPI_FAILURE(status)) {
714		ACPI_ERROR_NAMESPACE(walk_state->scope_info,
715				     arg->common.value.string, status);
716		return_ACPI_STATUS(status);
717	}
718
719	/*
720	 * Third arg is the bank_value
721	 * This arg is a term_arg, not a constant
722	 * It will be evaluated later, by acpi_ds_eval_bank_field_operands
723	 */
724	arg = arg->common.next;
725
726	/* Fourth arg is the field flags */
727
728	arg = arg->common.next;
729	info.field_flags = (u8) arg->common.value.integer;
730
731	/* Each remaining arg is a Named Field */
732
733	info.field_type = ACPI_TYPE_LOCAL_BANK_FIELD;
734	info.region_node = region_node;
735
736	/*
737	 * Use Info.data_register_node to store bank_field Op
738	 * It's safe because data_register_node will never be used when create
739	 * bank field \we store aml_start and aml_length in the bank_field Op for
740	 * late evaluation. Used in acpi_ex_prep_field_value(Info)
741	 *
742	 * TBD: Or, should we add a field in struct acpi_create_field_info, like
743	 * "void *ParentOp"?
744	 */
745	info.data_register_node = (struct acpi_namespace_node *)op;
746
747	status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
748	return_ACPI_STATUS(status);
749}
750
751/*******************************************************************************
752 *
753 * FUNCTION:    acpi_ds_create_index_field
754 *
755 * PARAMETERS:  op              - Op containing the Field definition and args
756 *              region_node     - Object for the containing Operation Region
757 *  `           walk_state      - Current method state
758 *
759 * RETURN:      Status
760 *
761 * DESCRIPTION: Create a new index field in the specified operation region
762 *
763 ******************************************************************************/
764
765acpi_status
766acpi_ds_create_index_field(union acpi_parse_object *op,
767			   struct acpi_namespace_node *region_node,
768			   struct acpi_walk_state *walk_state)
769{
770	acpi_status status;
771	union acpi_parse_object *arg;
772	struct acpi_create_field_info info;
773
774	ACPI_FUNCTION_TRACE_PTR(ds_create_index_field, op);
775
776	/* First arg is the name of the Index register (must already exist) */
777
778	arg = op->common.value.arg;
779	status =
780	    acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
781			   ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
782			   ACPI_NS_SEARCH_PARENT, walk_state,
783			   &info.register_node);
784	if (ACPI_FAILURE(status)) {
785		ACPI_ERROR_NAMESPACE(walk_state->scope_info,
786				     arg->common.value.string, status);
787		return_ACPI_STATUS(status);
788	}
789
790	/* Second arg is the data register (must already exist) */
791
792	arg = arg->common.next;
793	status =
794	    acpi_ns_lookup(walk_state->scope_info, arg->common.value.string,
795			   ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
796			   ACPI_NS_SEARCH_PARENT, walk_state,
797			   &info.data_register_node);
798	if (ACPI_FAILURE(status)) {
799		ACPI_ERROR_NAMESPACE(walk_state->scope_info,
800				     arg->common.value.string, status);
801		return_ACPI_STATUS(status);
802	}
803
804	/* Next arg is the field flags */
805
806	arg = arg->common.next;
807	info.field_flags = (u8) arg->common.value.integer;
808
809	/* Each remaining arg is a Named Field */
810
811	info.field_type = ACPI_TYPE_LOCAL_INDEX_FIELD;
812	info.region_node = region_node;
813
814	status = acpi_ds_get_field_names(&info, walk_state, arg->common.next);
 
815	return_ACPI_STATUS(status);
816}