The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/contrib/dev/acpica/components/executer/exstore.c

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /******************************************************************************
    2  *
    3  * Module Name: exstore - AML Interpreter object store support
    4  *
    5  *****************************************************************************/
    6 
    7 /******************************************************************************
    8  *
    9  * 1. Copyright Notice
   10  *
   11  * Some or all of this work - Copyright (c) 1999 - 2022, Intel Corp.
   12  * All rights reserved.
   13  *
   14  * 2. License
   15  *
   16  * 2.1. This is your license from Intel Corp. under its intellectual property
   17  * rights. You may have additional license terms from the party that provided
   18  * you this software, covering your right to use that party's intellectual
   19  * property rights.
   20  *
   21  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
   22  * copy of the source code appearing in this file ("Covered Code") an
   23  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
   24  * base code distributed originally by Intel ("Original Intel Code") to copy,
   25  * make derivatives, distribute, use and display any portion of the Covered
   26  * Code in any form, with the right to sublicense such rights; and
   27  *
   28  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
   29  * license (with the right to sublicense), under only those claims of Intel
   30  * patents that are infringed by the Original Intel Code, to make, use, sell,
   31  * offer to sell, and import the Covered Code and derivative works thereof
   32  * solely to the minimum extent necessary to exercise the above copyright
   33  * license, and in no event shall the patent license extend to any additions
   34  * to or modifications of the Original Intel Code. No other license or right
   35  * is granted directly or by implication, estoppel or otherwise;
   36  *
   37  * The above copyright and patent license is granted only if the following
   38  * conditions are met:
   39  *
   40  * 3. Conditions
   41  *
   42  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
   43  * Redistribution of source code of any substantial portion of the Covered
   44  * Code or modification with rights to further distribute source must include
   45  * the above Copyright Notice, the above License, this list of Conditions,
   46  * and the following Disclaimer and Export Compliance provision. In addition,
   47  * Licensee must cause all Covered Code to which Licensee contributes to
   48  * contain a file documenting the changes Licensee made to create that Covered
   49  * Code and the date of any change. Licensee must include in that file the
   50  * documentation of any changes made by any predecessor Licensee. Licensee
   51  * must include a prominent statement that the modification is derived,
   52  * directly or indirectly, from Original Intel Code.
   53  *
   54  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
   55  * Redistribution of source code of any substantial portion of the Covered
   56  * Code or modification without rights to further distribute source must
   57  * include the following Disclaimer and Export Compliance provision in the
   58  * documentation and/or other materials provided with distribution. In
   59  * addition, Licensee may not authorize further sublicense of source of any
   60  * portion of the Covered Code, and must include terms to the effect that the
   61  * license from Licensee to its licensee is limited to the intellectual
   62  * property embodied in the software Licensee provides to its licensee, and
   63  * not to intellectual property embodied in modifications its licensee may
   64  * make.
   65  *
   66  * 3.3. Redistribution of Executable. Redistribution in executable form of any
   67  * substantial portion of the Covered Code or modification must reproduce the
   68  * above Copyright Notice, and the following Disclaimer and Export Compliance
   69  * provision in the documentation and/or other materials provided with the
   70  * distribution.
   71  *
   72  * 3.4. Intel retains all right, title, and interest in and to the Original
   73  * Intel Code.
   74  *
   75  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
   76  * Intel shall be used in advertising or otherwise to promote the sale, use or
   77  * other dealings in products derived from or relating to the Covered Code
   78  * without prior written authorization from Intel.
   79  *
   80  * 4. Disclaimer and Export Compliance
   81  *
   82  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
   83  * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
   84  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
   85  * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
   86  * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
   87  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
   88  * PARTICULAR PURPOSE.
   89  *
   90  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
   91  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
   92  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
   93  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
   94  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
   95  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
   96  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
   97  * LIMITED REMEDY.
   98  *
   99  * 4.3. Licensee shall not export, either directly or indirectly, any of this
  100  * software or system incorporating such software without first obtaining any
  101  * required license or other approval from the U. S. Department of Commerce or
  102  * any other agency or department of the United States Government. In the
  103  * event Licensee exports any such software from the United States or
  104  * re-exports any such software from a foreign destination, Licensee shall
  105  * ensure that the distribution and export/re-export of the software is in
  106  * compliance with all laws, regulations, orders, or other restrictions of the
  107  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
  108  * any of its subsidiaries will export/re-export any technical data, process,
  109  * software, or service, directly or indirectly, to any country for which the
  110  * United States government or any agency thereof requires an export license,
  111  * other governmental approval, or letter of assurance, without first obtaining
  112  * such license, approval or letter.
  113  *
  114  *****************************************************************************
  115  *
  116  * Alternatively, you may choose to be licensed under the terms of the
  117  * following license:
  118  *
  119  * Redistribution and use in source and binary forms, with or without
  120  * modification, are permitted provided that the following conditions
  121  * are met:
  122  * 1. Redistributions of source code must retain the above copyright
  123  *    notice, this list of conditions, and the following disclaimer,
  124  *    without modification.
  125  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  126  *    substantially similar to the "NO WARRANTY" disclaimer below
  127  *    ("Disclaimer") and any redistribution must be conditioned upon
  128  *    including a substantially similar Disclaimer requirement for further
  129  *    binary redistribution.
  130  * 3. Neither the names of the above-listed copyright holders nor the names
  131  *    of any contributors may be used to endorse or promote products derived
  132  *    from this software without specific prior written permission.
  133  *
  134  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  135  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  136  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  137  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  138  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  139  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  140  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  141  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  142  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  143  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  144  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  145  *
  146  * Alternatively, you may choose to be licensed under the terms of the
  147  * GNU General Public License ("GPL") version 2 as published by the Free
  148  * Software Foundation.
  149  *
  150  *****************************************************************************/
  151 
  152 #include <contrib/dev/acpica/include/acpi.h>
  153 #include <contrib/dev/acpica/include/accommon.h>
  154 #include <contrib/dev/acpica/include/acdispat.h>
  155 #include <contrib/dev/acpica/include/acinterp.h>
  156 #include <contrib/dev/acpica/include/amlcode.h>
  157 #include <contrib/dev/acpica/include/acnamesp.h>
  158 
  159 
  160 #define _COMPONENT          ACPI_EXECUTER
  161         ACPI_MODULE_NAME    ("exstore")
  162 
  163 /* Local prototypes */
  164 
  165 static ACPI_STATUS
  166 AcpiExStoreObjectToIndex (
  167     ACPI_OPERAND_OBJECT     *ValDesc,
  168     ACPI_OPERAND_OBJECT     *DestDesc,
  169     ACPI_WALK_STATE         *WalkState);
  170 
  171 static ACPI_STATUS
  172 AcpiExStoreDirectToNode (
  173     ACPI_OPERAND_OBJECT     *SourceDesc,
  174     ACPI_NAMESPACE_NODE     *Node,
  175     ACPI_WALK_STATE         *WalkState);
  176 
  177 
  178 /*******************************************************************************
  179  *
  180  * FUNCTION:    AcpiExStore
  181  *
  182  * PARAMETERS:  *SourceDesc         - Value to be stored
  183  *              *DestDesc           - Where to store it. Must be an NS node
  184  *                                    or ACPI_OPERAND_OBJECT of type
  185  *                                    Reference;
  186  *              WalkState           - Current walk state
  187  *
  188  * RETURN:      Status
  189  *
  190  * DESCRIPTION: Store the value described by SourceDesc into the location
  191  *              described by DestDesc. Called by various interpreter
  192  *              functions to store the result of an operation into
  193  *              the destination operand -- not just simply the actual "Store"
  194  *              ASL operator.
  195  *
  196  ******************************************************************************/
  197 
  198 ACPI_STATUS
  199 AcpiExStore (
  200     ACPI_OPERAND_OBJECT     *SourceDesc,
  201     ACPI_OPERAND_OBJECT     *DestDesc,
  202     ACPI_WALK_STATE         *WalkState)
  203 {
  204     ACPI_STATUS             Status = AE_OK;
  205     ACPI_OPERAND_OBJECT     *RefDesc = DestDesc;
  206 
  207 
  208     ACPI_FUNCTION_TRACE_PTR (ExStore, DestDesc);
  209 
  210 
  211     /* Validate parameters */
  212 
  213     if (!SourceDesc || !DestDesc)
  214     {
  215         ACPI_ERROR ((AE_INFO, "Null parameter"));
  216         return_ACPI_STATUS (AE_AML_NO_OPERAND);
  217     }
  218 
  219     /* DestDesc can be either a namespace node or an ACPI object */
  220 
  221     if (ACPI_GET_DESCRIPTOR_TYPE (DestDesc) == ACPI_DESC_TYPE_NAMED)
  222     {
  223         /*
  224          * Dest is a namespace node,
  225          * Storing an object into a Named node.
  226          */
  227         Status = AcpiExStoreObjectToNode (SourceDesc,
  228             (ACPI_NAMESPACE_NODE *) DestDesc, WalkState,
  229             ACPI_IMPLICIT_CONVERSION);
  230 
  231         return_ACPI_STATUS (Status);
  232     }
  233 
  234     /* Destination object must be a Reference or a Constant object */
  235 
  236     switch (DestDesc->Common.Type)
  237     {
  238     case ACPI_TYPE_LOCAL_REFERENCE:
  239 
  240         break;
  241 
  242     case ACPI_TYPE_INTEGER:
  243 
  244         /* Allow stores to Constants -- a Noop as per ACPI spec */
  245 
  246         if (DestDesc->Common.Flags & AOPOBJ_AML_CONSTANT)
  247         {
  248             return_ACPI_STATUS (AE_OK);
  249         }
  250 
  251         ACPI_FALLTHROUGH;
  252 
  253     default:
  254 
  255         /* Destination is not a Reference object */
  256 
  257         ACPI_ERROR ((AE_INFO,
  258             "Target is not a Reference or Constant object - [%s] %p",
  259             AcpiUtGetObjectTypeName (DestDesc), DestDesc));
  260 
  261         return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
  262     }
  263 
  264     /*
  265      * Examine the Reference class. These cases are handled:
  266      *
  267      * 1) Store to Name (Change the object associated with a name)
  268      * 2) Store to an indexed area of a Buffer or Package
  269      * 3) Store to a Method Local or Arg
  270      * 4) Store to the debug object
  271      */
  272     switch (RefDesc->Reference.Class)
  273     {
  274     case ACPI_REFCLASS_REFOF:
  275 
  276         /* Storing an object into a Name "container" */
  277 
  278         Status = AcpiExStoreObjectToNode (SourceDesc,
  279             RefDesc->Reference.Object,
  280             WalkState, ACPI_IMPLICIT_CONVERSION);
  281         break;
  282 
  283     case ACPI_REFCLASS_INDEX:
  284 
  285         /* Storing to an Index (pointer into a packager or buffer) */
  286 
  287         Status = AcpiExStoreObjectToIndex (SourceDesc, RefDesc, WalkState);
  288         break;
  289 
  290     case ACPI_REFCLASS_LOCAL:
  291     case ACPI_REFCLASS_ARG:
  292 
  293         /* Store to a method local/arg  */
  294 
  295         Status = AcpiDsStoreObjectToLocal (RefDesc->Reference.Class,
  296             RefDesc->Reference.Value, SourceDesc, WalkState);
  297         break;
  298 
  299     case ACPI_REFCLASS_DEBUG:
  300         /*
  301          * Storing to the Debug object causes the value stored to be
  302          * displayed and otherwise has no effect -- see ACPI Specification
  303          */
  304         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
  305             "**** Write to Debug Object: Object %p [%s] ****:\n\n",
  306             SourceDesc, AcpiUtGetObjectTypeName (SourceDesc)));
  307 
  308         ACPI_DEBUG_OBJECT (SourceDesc, 0, 0);
  309         break;
  310 
  311     default:
  312 
  313         ACPI_ERROR ((AE_INFO, "Unknown Reference Class 0x%2.2X",
  314             RefDesc->Reference.Class));
  315         ACPI_DUMP_ENTRY (RefDesc, ACPI_LV_INFO);
  316 
  317         Status = AE_AML_INTERNAL;
  318         break;
  319     }
  320 
  321     return_ACPI_STATUS (Status);
  322 }
  323 
  324 
  325 /*******************************************************************************
  326  *
  327  * FUNCTION:    AcpiExStoreObjectToIndex
  328  *
  329  * PARAMETERS:  *SourceDesc             - Value to be stored
  330  *              *DestDesc               - Named object to receive the value
  331  *              WalkState               - Current walk state
  332  *
  333  * RETURN:      Status
  334  *
  335  * DESCRIPTION: Store the object to indexed Buffer or Package element
  336  *
  337  ******************************************************************************/
  338 
  339 static ACPI_STATUS
  340 AcpiExStoreObjectToIndex (
  341     ACPI_OPERAND_OBJECT     *SourceDesc,
  342     ACPI_OPERAND_OBJECT     *IndexDesc,
  343     ACPI_WALK_STATE         *WalkState)
  344 {
  345     ACPI_STATUS             Status = AE_OK;
  346     ACPI_OPERAND_OBJECT     *ObjDesc;
  347     ACPI_OPERAND_OBJECT     *NewDesc;
  348     UINT8                   Value = 0;
  349     UINT32                  i;
  350 
  351 
  352     ACPI_FUNCTION_TRACE (ExStoreObjectToIndex);
  353 
  354 
  355     /*
  356      * Destination must be a reference pointer, and
  357      * must point to either a buffer or a package
  358      */
  359     switch (IndexDesc->Reference.TargetType)
  360     {
  361     case ACPI_TYPE_PACKAGE:
  362         /*
  363          * Storing to a package element. Copy the object and replace
  364          * any existing object with the new object. No implicit
  365          * conversion is performed.
  366          *
  367          * The object at *(IndexDesc->Reference.Where) is the
  368          * element within the package that is to be modified.
  369          * The parent package object is at IndexDesc->Reference.Object
  370          */
  371         ObjDesc = *(IndexDesc->Reference.Where);
  372 
  373         if (SourceDesc->Common.Type == ACPI_TYPE_LOCAL_REFERENCE &&
  374             SourceDesc->Reference.Class == ACPI_REFCLASS_TABLE)
  375         {
  376             /* This is a DDBHandle, just add a reference to it */
  377 
  378             AcpiUtAddReference (SourceDesc);
  379             NewDesc = SourceDesc;
  380         }
  381         else
  382         {
  383             /* Normal object, copy it */
  384 
  385             Status = AcpiUtCopyIobjectToIobject (
  386                 SourceDesc, &NewDesc, WalkState);
  387             if (ACPI_FAILURE (Status))
  388             {
  389                 return_ACPI_STATUS (Status);
  390             }
  391         }
  392 
  393         if (ObjDesc)
  394         {
  395             /* Decrement reference count by the ref count of the parent package */
  396 
  397             for (i = 0;
  398                  i < ((ACPI_OPERAND_OBJECT *)
  399                         IndexDesc->Reference.Object)->Common.ReferenceCount;
  400                  i++)
  401             {
  402                 AcpiUtRemoveReference (ObjDesc);
  403             }
  404         }
  405 
  406         *(IndexDesc->Reference.Where) = NewDesc;
  407 
  408         /* Increment ref count by the ref count of the parent package-1 */
  409 
  410         for (i = 1;
  411              i < ((ACPI_OPERAND_OBJECT *)
  412                     IndexDesc->Reference.Object)->Common.ReferenceCount;
  413              i++)
  414         {
  415             AcpiUtAddReference (NewDesc);
  416         }
  417 
  418         break;
  419 
  420     case ACPI_TYPE_BUFFER_FIELD:
  421         /*
  422          * Store into a Buffer or String (not actually a real BufferField)
  423          * at a location defined by an Index.
  424          *
  425          * The first 8-bit element of the source object is written to the
  426          * 8-bit Buffer location defined by the Index destination object,
  427          * according to the ACPI 2.0 specification.
  428          */
  429 
  430         /*
  431          * Make sure the target is a Buffer or String. An error should
  432          * not happen here, since the ReferenceObject was constructed
  433          * by the INDEX_OP code.
  434          */
  435         ObjDesc = IndexDesc->Reference.Object;
  436         if ((ObjDesc->Common.Type != ACPI_TYPE_BUFFER) &&
  437             (ObjDesc->Common.Type != ACPI_TYPE_STRING))
  438         {
  439             return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
  440         }
  441 
  442         /*
  443          * The assignment of the individual elements will be slightly
  444          * different for each source type.
  445          */
  446         switch (SourceDesc->Common.Type)
  447         {
  448         case ACPI_TYPE_INTEGER:
  449 
  450             /* Use the least-significant byte of the integer */
  451 
  452             Value = (UINT8) (SourceDesc->Integer.Value);
  453             break;
  454 
  455         case ACPI_TYPE_BUFFER:
  456         case ACPI_TYPE_STRING:
  457 
  458             /* Note: Takes advantage of common string/buffer fields */
  459 
  460             Value = SourceDesc->Buffer.Pointer[0];
  461             break;
  462 
  463         default:
  464 
  465             /* All other types are invalid */
  466 
  467             ACPI_ERROR ((AE_INFO,
  468                 "Source must be type [Integer/Buffer/String], found [%s]",
  469                 AcpiUtGetObjectTypeName (SourceDesc)));
  470             return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
  471         }
  472 
  473         /* Store the source value into the target buffer byte */
  474 
  475         ObjDesc->Buffer.Pointer[IndexDesc->Reference.Value] = Value;
  476         break;
  477 
  478     default:
  479         ACPI_ERROR ((AE_INFO,
  480             "Target is not of type [Package/BufferField]"));
  481         Status = AE_AML_TARGET_TYPE;
  482         break;
  483     }
  484 
  485     return_ACPI_STATUS (Status);
  486 }
  487 
  488 
  489 /*******************************************************************************
  490  *
  491  * FUNCTION:    AcpiExStoreObjectToNode
  492  *
  493  * PARAMETERS:  SourceDesc              - Value to be stored
  494  *              Node                    - Named object to receive the value
  495  *              WalkState               - Current walk state
  496  *              ImplicitConversion      - Perform implicit conversion (yes/no)
  497  *
  498  * RETURN:      Status
  499  *
  500  * DESCRIPTION: Store the object to the named object.
  501  *
  502  * The assignment of an object to a named object is handled here.
  503  * The value passed in will replace the current value (if any)
  504  * with the input value.
  505  *
  506  * When storing into an object the data is converted to the
  507  * target object type then stored in the object. This means
  508  * that the target object type (for an initialized target) will
  509  * not be changed by a store operation. A CopyObject can change
  510  * the target type, however.
  511  *
  512  * The ImplicitConversion flag is set to NO/FALSE only when
  513  * storing to an ArgX -- as per the rules of the ACPI spec.
  514  *
  515  * Assumes parameters are already validated.
  516  *
  517  ******************************************************************************/
  518 
  519 ACPI_STATUS
  520 AcpiExStoreObjectToNode (
  521     ACPI_OPERAND_OBJECT     *SourceDesc,
  522     ACPI_NAMESPACE_NODE     *Node,
  523     ACPI_WALK_STATE         *WalkState,
  524     UINT8                   ImplicitConversion)
  525 {
  526     ACPI_STATUS             Status = AE_OK;
  527     ACPI_OPERAND_OBJECT     *TargetDesc;
  528     ACPI_OPERAND_OBJECT     *NewDesc;
  529     ACPI_OBJECT_TYPE        TargetType;
  530 
  531 
  532     ACPI_FUNCTION_TRACE_PTR (ExStoreObjectToNode, SourceDesc);
  533 
  534 
  535     /* Get current type of the node, and object attached to Node */
  536 
  537     TargetType = AcpiNsGetType (Node);
  538     TargetDesc = AcpiNsGetAttachedObject (Node);
  539 
  540     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Storing %p [%s] to node %p [%s]\n",
  541         SourceDesc, AcpiUtGetObjectTypeName (SourceDesc),
  542         Node, AcpiUtGetTypeName (TargetType)));
  543 
  544     /* Only limited target types possible for everything except CopyObject */
  545 
  546     if (WalkState->Opcode != AML_COPY_OBJECT_OP)
  547     {
  548         /*
  549          * Only CopyObject allows all object types to be overwritten. For
  550          * TargetRef(s), there are restrictions on the object types that
  551          * are allowed.
  552          *
  553          * Allowable operations/typing for Store:
  554          *
  555          * 1) Simple Store
  556          *      Integer     --> Integer (Named/Local/Arg)
  557          *      String      --> String  (Named/Local/Arg)
  558          *      Buffer      --> Buffer  (Named/Local/Arg)
  559          *      Package     --> Package (Named/Local/Arg)
  560          *
  561          * 2) Store with implicit conversion
  562          *      Integer     --> String or Buffer  (Named)
  563          *      String      --> Integer or Buffer (Named)
  564          *      Buffer      --> Integer or String (Named)
  565          */
  566         switch (TargetType)
  567         {
  568         case ACPI_TYPE_PACKAGE:
  569             /*
  570              * Here, can only store a package to an existing package.
  571              * Storing a package to a Local/Arg is OK, and handled
  572              * elsewhere.
  573              */
  574             if (WalkState->Opcode == AML_STORE_OP)
  575             {
  576                 if (SourceDesc->Common.Type != ACPI_TYPE_PACKAGE)
  577                 {
  578                     ACPI_ERROR ((AE_INFO,
  579                         "Cannot assign type [%s] to [Package] "
  580                         "(source must be type Pkg)",
  581                         AcpiUtGetObjectTypeName (SourceDesc)));
  582 
  583                     return_ACPI_STATUS (AE_AML_TARGET_TYPE);
  584                 }
  585                 break;
  586             }
  587 
  588             ACPI_FALLTHROUGH;
  589 
  590         case ACPI_TYPE_DEVICE:
  591         case ACPI_TYPE_EVENT:
  592         case ACPI_TYPE_MUTEX:
  593         case ACPI_TYPE_REGION:
  594         case ACPI_TYPE_POWER:
  595         case ACPI_TYPE_PROCESSOR:
  596         case ACPI_TYPE_THERMAL:
  597 
  598             ACPI_ERROR ((AE_INFO,
  599                 "Target must be [Buffer/Integer/String/Reference]"
  600                 ", found [%s] (%4.4s)",
  601                 AcpiUtGetTypeName (Node->Type), Node->Name.Ascii));
  602 
  603             return_ACPI_STATUS (AE_AML_TARGET_TYPE);
  604 
  605         default:
  606             break;
  607         }
  608     }
  609 
  610     /*
  611      * Resolve the source object to an actual value
  612      * (If it is a reference object)
  613      */
  614     Status = AcpiExResolveObject (&SourceDesc, TargetType, WalkState);
  615     if (ACPI_FAILURE (Status))
  616     {
  617         return_ACPI_STATUS (Status);
  618     }
  619 
  620     /* Do the actual store operation */
  621 
  622     switch (TargetType)
  623     {
  624         /*
  625          * The simple data types all support implicit source operand
  626          * conversion before the store.
  627          */
  628     case ACPI_TYPE_INTEGER:
  629     case ACPI_TYPE_STRING:
  630     case ACPI_TYPE_BUFFER:
  631 
  632         if ((WalkState->Opcode == AML_COPY_OBJECT_OP) ||
  633             !ImplicitConversion)
  634         {
  635             /*
  636              * However, CopyObject and Stores to ArgX do not perform
  637              * an implicit conversion, as per the ACPI specification.
  638              * A direct store is performed instead.
  639              */
  640             Status = AcpiExStoreDirectToNode (SourceDesc, Node, WalkState);
  641             break;
  642         }
  643 
  644         /* Store with implicit source operand conversion support */
  645 
  646         Status = AcpiExStoreObjectToObject (SourceDesc, TargetDesc,
  647             &NewDesc, WalkState);
  648         if (ACPI_FAILURE (Status))
  649         {
  650             return_ACPI_STATUS (Status);
  651         }
  652 
  653         if (NewDesc != TargetDesc)
  654         {
  655             /*
  656              * Store the new NewDesc as the new value of the Name, and set
  657              * the Name's type to that of the value being stored in it.
  658              * SourceDesc reference count is incremented by AttachObject.
  659              *
  660              * Note: This may change the type of the node if an explicit
  661              * store has been performed such that the node/object type
  662              * has been changed.
  663              */
  664             Status = AcpiNsAttachObject (
  665                 Node, NewDesc, NewDesc->Common.Type);
  666 
  667             ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
  668                 "Store type [%s] into [%s] via Convert/Attach\n",
  669                 AcpiUtGetObjectTypeName (SourceDesc),
  670                 AcpiUtGetObjectTypeName (NewDesc)));
  671         }
  672         break;
  673 
  674     case ACPI_TYPE_BUFFER_FIELD:
  675     case ACPI_TYPE_LOCAL_REGION_FIELD:
  676     case ACPI_TYPE_LOCAL_BANK_FIELD:
  677     case ACPI_TYPE_LOCAL_INDEX_FIELD:
  678         /*
  679          * For all fields, always write the source data to the target
  680          * field. Any required implicit source operand conversion is
  681          * performed in the function below as necessary. Note, field
  682          * objects must retain their original type permanently.
  683          */
  684         Status = AcpiExWriteDataToField (SourceDesc, TargetDesc,
  685             &WalkState->ResultObj);
  686         break;
  687 
  688     default:
  689         /*
  690          * CopyObject operator: No conversions for all other types.
  691          * Instead, directly store a copy of the source object.
  692          *
  693          * This is the ACPI spec-defined behavior for the CopyObject
  694          * operator. (Note, for this default case, all normal
  695          * Store/Target operations exited above with an error).
  696          */
  697         Status = AcpiExStoreDirectToNode (SourceDesc, Node, WalkState);
  698         break;
  699     }
  700 
  701     return_ACPI_STATUS (Status);
  702 }
  703 
  704 
  705 /*******************************************************************************
  706  *
  707  * FUNCTION:    AcpiExStoreDirectToNode
  708  *
  709  * PARAMETERS:  SourceDesc              - Value to be stored
  710  *              Node                    - Named object to receive the value
  711  *              WalkState               - Current walk state
  712  *
  713  * RETURN:      Status
  714  *
  715  * DESCRIPTION: "Store" an object directly to a node. This involves a copy
  716  *              and an attach.
  717  *
  718  ******************************************************************************/
  719 
  720 static ACPI_STATUS
  721 AcpiExStoreDirectToNode (
  722     ACPI_OPERAND_OBJECT     *SourceDesc,
  723     ACPI_NAMESPACE_NODE     *Node,
  724     ACPI_WALK_STATE         *WalkState)
  725 {
  726     ACPI_STATUS             Status;
  727     ACPI_OPERAND_OBJECT     *NewDesc;
  728 
  729 
  730     ACPI_FUNCTION_TRACE (ExStoreDirectToNode);
  731 
  732 
  733     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
  734         "Storing [%s] (%p) directly into node [%s] (%p)"
  735         " with no implicit conversion\n",
  736         AcpiUtGetObjectTypeName (SourceDesc), SourceDesc,
  737         AcpiUtGetTypeName (Node->Type), Node));
  738 
  739     /* Copy the source object to a new object */
  740 
  741     Status = AcpiUtCopyIobjectToIobject (SourceDesc, &NewDesc, WalkState);
  742     if (ACPI_FAILURE (Status))
  743     {
  744         return_ACPI_STATUS (Status);
  745     }
  746 
  747     /* Attach the new object to the node */
  748 
  749     Status = AcpiNsAttachObject (Node, NewDesc, NewDesc->Common.Type);
  750     AcpiUtRemoveReference (NewDesc);
  751     return_ACPI_STATUS (Status);
  752 }

Cache object: 9390c79a1fc30ff818b33f971b8b6749


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.