123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534 |
- /******************************************************************************
- *
- * Module Name: exmisc - ACPI AML (p-code) execution - specific opcodes
- *
- *****************************************************************************/
- /*
- * Copyright (C) 2000 - 2019, Intel Corp.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions, and the following disclaimer,
- * without modification.
- * 2. Redistributions in binary form must reproduce at minimum a disclaimer
- * substantially similar to the "NO WARRANTY" disclaimer below
- * ("Disclaimer") and any redistribution must be conditioned upon
- * including a substantially similar Disclaimer requirement for further
- * binary redistribution.
- * 3. Neither the names of the above-listed copyright holders nor the names
- * of any contributors may be used to endorse or promote products derived
- * from this software without specific prior written permission.
- *
- * Alternatively, this software may be distributed under the terms of the
- * GNU General Public License ("GPL") version 2 as published by the Free
- * Software Foundation.
- *
- * NO WARRANTY
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
- * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
- * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
- * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
- * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
- * POSSIBILITY OF SUCH DAMAGES.
- */
- #include "acpi.h"
- #include "accommon.h"
- #include "acinterp.h"
- #include "amlcode.h"
- #define _COMPONENT ACPI_EXECUTER
- ACPI_MODULE_NAME ("exmisc")
- /*******************************************************************************
- *
- * FUNCTION: AcpiExGetObjectReference
- *
- * PARAMETERS: ObjDesc - Create a reference to this object
- * ReturnDesc - Where to store the reference
- * WalkState - Current state
- *
- * RETURN: Status
- *
- * DESCRIPTION: Obtain and return a "reference" to the target object
- * Common code for the RefOfOp and the CondRefOfOp.
- *
- ******************************************************************************/
- ACPI_STATUS
- AcpiExGetObjectReference (
- ACPI_OPERAND_OBJECT *ObjDesc,
- ACPI_OPERAND_OBJECT **ReturnDesc,
- ACPI_WALK_STATE *WalkState)
- {
- ACPI_OPERAND_OBJECT *ReferenceObj;
- ACPI_OPERAND_OBJECT *ReferencedObj;
- ACPI_FUNCTION_TRACE_PTR (ExGetObjectReference, ObjDesc);
- *ReturnDesc = NULL;
- switch (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc))
- {
- case ACPI_DESC_TYPE_OPERAND:
- if (ObjDesc->Common.Type != ACPI_TYPE_LOCAL_REFERENCE)
- {
- return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
- }
- /*
- * Must be a reference to a Local or Arg
- */
- switch (ObjDesc->Reference.Class)
- {
- case ACPI_REFCLASS_LOCAL:
- case ACPI_REFCLASS_ARG:
- case ACPI_REFCLASS_DEBUG:
- /* The referenced object is the pseudo-node for the local/arg */
- ReferencedObj = ObjDesc->Reference.Object;
- break;
- default:
- ACPI_ERROR ((AE_INFO, "Invalid Reference Class 0x%2.2X",
- ObjDesc->Reference.Class));
- return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
- }
- break;
- case ACPI_DESC_TYPE_NAMED:
- /*
- * A named reference that has already been resolved to a Node
- */
- ReferencedObj = ObjDesc;
- break;
- default:
- ACPI_ERROR ((AE_INFO, "Invalid descriptor type 0x%X",
- ACPI_GET_DESCRIPTOR_TYPE (ObjDesc)));
- return_ACPI_STATUS (AE_TYPE);
- }
- /* Create a new reference object */
- ReferenceObj = AcpiUtCreateInternalObject (ACPI_TYPE_LOCAL_REFERENCE);
- if (!ReferenceObj)
- {
- return_ACPI_STATUS (AE_NO_MEMORY);
- }
- ReferenceObj->Reference.Class = ACPI_REFCLASS_REFOF;
- ReferenceObj->Reference.Object = ReferencedObj;
- *ReturnDesc = ReferenceObj;
- ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
- "Object %p Type [%s], returning Reference %p\n",
- ObjDesc, AcpiUtGetObjectTypeName (ObjDesc), *ReturnDesc));
- return_ACPI_STATUS (AE_OK);
- }
- /*******************************************************************************
- *
- * FUNCTION: AcpiExDoMathOp
- *
- * PARAMETERS: Opcode - AML opcode
- * Integer0 - Integer operand #0
- * Integer1 - Integer operand #1
- *
- * RETURN: Integer result of the operation
- *
- * DESCRIPTION: Execute a math AML opcode. The purpose of having all of the
- * math functions here is to prevent a lot of pointer dereferencing
- * to obtain the operands.
- *
- ******************************************************************************/
- UINT64
- AcpiExDoMathOp (
- UINT16 Opcode,
- UINT64 Integer0,
- UINT64 Integer1)
- {
- ACPI_FUNCTION_ENTRY ();
- switch (Opcode)
- {
- case AML_ADD_OP: /* Add (Integer0, Integer1, Result) */
- return (Integer0 + Integer1);
- case AML_BIT_AND_OP: /* And (Integer0, Integer1, Result) */
- return (Integer0 & Integer1);
- case AML_BIT_NAND_OP: /* NAnd (Integer0, Integer1, Result) */
- return (~(Integer0 & Integer1));
- case AML_BIT_OR_OP: /* Or (Integer0, Integer1, Result) */
- return (Integer0 | Integer1);
- case AML_BIT_NOR_OP: /* NOr (Integer0, Integer1, Result) */
- return (~(Integer0 | Integer1));
- case AML_BIT_XOR_OP: /* XOr (Integer0, Integer1, Result) */
- return (Integer0 ^ Integer1);
- case AML_MULTIPLY_OP: /* Multiply (Integer0, Integer1, Result) */
- return (Integer0 * Integer1);
- case AML_SHIFT_LEFT_OP: /* ShiftLeft (Operand, ShiftCount, Result)*/
- /*
- * We need to check if the shiftcount is larger than the integer bit
- * width since the behavior of this is not well-defined in the C language.
- */
- if (Integer1 >= AcpiGbl_IntegerBitWidth)
- {
- return (0);
- }
- return (Integer0 << Integer1);
- case AML_SHIFT_RIGHT_OP: /* ShiftRight (Operand, ShiftCount, Result) */
- /*
- * We need to check if the shiftcount is larger than the integer bit
- * width since the behavior of this is not well-defined in the C language.
- */
- if (Integer1 >= AcpiGbl_IntegerBitWidth)
- {
- return (0);
- }
- return (Integer0 >> Integer1);
- case AML_SUBTRACT_OP: /* Subtract (Integer0, Integer1, Result) */
- return (Integer0 - Integer1);
- default:
- return (0);
- }
- }
- /*******************************************************************************
- *
- * FUNCTION: AcpiExDoLogicalNumericOp
- *
- * PARAMETERS: Opcode - AML opcode
- * Integer0 - Integer operand #0
- * Integer1 - Integer operand #1
- * LogicalResult - TRUE/FALSE result of the operation
- *
- * RETURN: Status
- *
- * DESCRIPTION: Execute a logical "Numeric" AML opcode. For these Numeric
- * operators (LAnd and LOr), both operands must be integers.
- *
- * Note: cleanest machine code seems to be produced by the code
- * below, rather than using statements of the form:
- * Result = (Integer0 && Integer1);
- *
- ******************************************************************************/
- ACPI_STATUS
- AcpiExDoLogicalNumericOp (
- UINT16 Opcode,
- UINT64 Integer0,
- UINT64 Integer1,
- BOOLEAN *LogicalResult)
- {
- ACPI_STATUS Status = AE_OK;
- BOOLEAN LocalResult = FALSE;
- ACPI_FUNCTION_TRACE (ExDoLogicalNumericOp);
- switch (Opcode)
- {
- case AML_LOGICAL_AND_OP: /* LAnd (Integer0, Integer1) */
- if (Integer0 && Integer1)
- {
- LocalResult = TRUE;
- }
- break;
- case AML_LOGICAL_OR_OP: /* LOr (Integer0, Integer1) */
- if (Integer0 || Integer1)
- {
- LocalResult = TRUE;
- }
- break;
- default:
- ACPI_ERROR ((AE_INFO,
- "Invalid numeric logical opcode: %X", Opcode));
- Status = AE_AML_INTERNAL;
- break;
- }
- /* Return the logical result and status */
- *LogicalResult = LocalResult;
- return_ACPI_STATUS (Status);
- }
- /*******************************************************************************
- *
- * FUNCTION: AcpiExDoLogicalOp
- *
- * PARAMETERS: Opcode - AML opcode
- * Operand0 - operand #0
- * Operand1 - operand #1
- * LogicalResult - TRUE/FALSE result of the operation
- *
- * RETURN: Status
- *
- * DESCRIPTION: Execute a logical AML opcode. The purpose of having all of the
- * functions here is to prevent a lot of pointer dereferencing
- * to obtain the operands and to simplify the generation of the
- * logical value. For the Numeric operators (LAnd and LOr), both
- * operands must be integers. For the other logical operators,
- * operands can be any combination of Integer/String/Buffer. The
- * first operand determines the type to which the second operand
- * will be converted.
- *
- * Note: cleanest machine code seems to be produced by the code
- * below, rather than using statements of the form:
- * Result = (Operand0 == Operand1);
- *
- ******************************************************************************/
- ACPI_STATUS
- AcpiExDoLogicalOp (
- UINT16 Opcode,
- ACPI_OPERAND_OBJECT *Operand0,
- ACPI_OPERAND_OBJECT *Operand1,
- BOOLEAN *LogicalResult)
- {
- ACPI_OPERAND_OBJECT *LocalOperand1 = Operand1;
- UINT64 Integer0;
- UINT64 Integer1;
- UINT32 Length0;
- UINT32 Length1;
- ACPI_STATUS Status = AE_OK;
- BOOLEAN LocalResult = FALSE;
- int Compare;
- ACPI_FUNCTION_TRACE (ExDoLogicalOp);
- /*
- * Convert the second operand if necessary. The first operand
- * determines the type of the second operand, (See the Data Types
- * section of the ACPI 3.0+ specification.) Both object types are
- * guaranteed to be either Integer/String/Buffer by the operand
- * resolution mechanism.
- */
- switch (Operand0->Common.Type)
- {
- case ACPI_TYPE_INTEGER:
- Status = AcpiExConvertToInteger (Operand1, &LocalOperand1,
- ACPI_IMPLICIT_CONVERSION);
- break;
- case ACPI_TYPE_STRING:
- Status = AcpiExConvertToString (
- Operand1, &LocalOperand1, ACPI_IMPLICIT_CONVERT_HEX);
- break;
- case ACPI_TYPE_BUFFER:
- Status = AcpiExConvertToBuffer (Operand1, &LocalOperand1);
- break;
- default:
- ACPI_ERROR ((AE_INFO,
- "Invalid object type for logical operator: %X",
- Operand0->Common.Type));
- Status = AE_AML_INTERNAL;
- break;
- }
- if (ACPI_FAILURE (Status))
- {
- goto Cleanup;
- }
- /*
- * Two cases: 1) Both Integers, 2) Both Strings or Buffers
- */
- if (Operand0->Common.Type == ACPI_TYPE_INTEGER)
- {
- /*
- * 1) Both operands are of type integer
- * Note: LocalOperand1 may have changed above
- */
- Integer0 = Operand0->Integer.Value;
- Integer1 = LocalOperand1->Integer.Value;
- switch (Opcode)
- {
- case AML_LOGICAL_EQUAL_OP: /* LEqual (Operand0, Operand1) */
- if (Integer0 == Integer1)
- {
- LocalResult = TRUE;
- }
- break;
- case AML_LOGICAL_GREATER_OP: /* LGreater (Operand0, Operand1) */
- if (Integer0 > Integer1)
- {
- LocalResult = TRUE;
- }
- break;
- case AML_LOGICAL_LESS_OP: /* LLess (Operand0, Operand1) */
- if (Integer0 < Integer1)
- {
- LocalResult = TRUE;
- }
- break;
- default:
- ACPI_ERROR ((AE_INFO,
- "Invalid comparison opcode: %X", Opcode));
- Status = AE_AML_INTERNAL;
- break;
- }
- }
- else
- {
- /*
- * 2) Both operands are Strings or both are Buffers
- * Note: Code below takes advantage of common Buffer/String
- * object fields. LocalOperand1 may have changed above. Use
- * memcmp to handle nulls in buffers.
- */
- Length0 = Operand0->Buffer.Length;
- Length1 = LocalOperand1->Buffer.Length;
- /* Lexicographic compare: compare the data bytes */
- Compare = memcmp (Operand0->Buffer.Pointer,
- LocalOperand1->Buffer.Pointer,
- (Length0 > Length1) ? Length1 : Length0);
- switch (Opcode)
- {
- case AML_LOGICAL_EQUAL_OP: /* LEqual (Operand0, Operand1) */
- /* Length and all bytes must be equal */
- if ((Length0 == Length1) &&
- (Compare == 0))
- {
- /* Length and all bytes match ==> TRUE */
- LocalResult = TRUE;
- }
- break;
- case AML_LOGICAL_GREATER_OP: /* LGreater (Operand0, Operand1) */
- if (Compare > 0)
- {
- LocalResult = TRUE;
- goto Cleanup; /* TRUE */
- }
- if (Compare < 0)
- {
- goto Cleanup; /* FALSE */
- }
- /* Bytes match (to shortest length), compare lengths */
- if (Length0 > Length1)
- {
- LocalResult = TRUE;
- }
- break;
- case AML_LOGICAL_LESS_OP: /* LLess (Operand0, Operand1) */
- if (Compare > 0)
- {
- goto Cleanup; /* FALSE */
- }
- if (Compare < 0)
- {
- LocalResult = TRUE;
- goto Cleanup; /* TRUE */
- }
- /* Bytes match (to shortest length), compare lengths */
- if (Length0 < Length1)
- {
- LocalResult = TRUE;
- }
- break;
- default:
- ACPI_ERROR ((AE_INFO,
- "Invalid comparison opcode: %X", Opcode));
- Status = AE_AML_INTERNAL;
- break;
- }
- }
- Cleanup:
- /* New object was created if implicit conversion performed - delete */
- if (LocalOperand1 != Operand1)
- {
- AcpiUtRemoveReference (LocalOperand1);
- }
- /* Return the logical result and status */
- *LogicalResult = LocalResult;
- return_ACPI_STATUS (Status);
- }
|