Home | History | Annotate | Line # | Download | only in debugger
dbexec.c revision 1.1.1.2
      1      1.1  jruoho /*******************************************************************************
      2      1.1  jruoho  *
      3      1.1  jruoho  * Module Name: dbexec - debugger control method execution
      4      1.1  jruoho  *
      5      1.1  jruoho  ******************************************************************************/
      6      1.1  jruoho 
      7  1.1.1.2  jruoho /*
      8  1.1.1.2  jruoho  * Copyright (C) 2000 - 2011, Intel Corp.
      9      1.1  jruoho  * All rights reserved.
     10      1.1  jruoho  *
     11  1.1.1.2  jruoho  * Redistribution and use in source and binary forms, with or without
     12  1.1.1.2  jruoho  * modification, are permitted provided that the following conditions
     13  1.1.1.2  jruoho  * are met:
     14  1.1.1.2  jruoho  * 1. Redistributions of source code must retain the above copyright
     15  1.1.1.2  jruoho  *    notice, this list of conditions, and the following disclaimer,
     16  1.1.1.2  jruoho  *    without modification.
     17  1.1.1.2  jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1.1.2  jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1.1.2  jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1.1.2  jruoho  *    including a substantially similar Disclaimer requirement for further
     21  1.1.1.2  jruoho  *    binary redistribution.
     22  1.1.1.2  jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1.1.2  jruoho  *    of any contributors may be used to endorse or promote products derived
     24  1.1.1.2  jruoho  *    from this software without specific prior written permission.
     25  1.1.1.2  jruoho  *
     26  1.1.1.2  jruoho  * Alternatively, this software may be distributed under the terms of the
     27  1.1.1.2  jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1.1.2  jruoho  * Software Foundation.
     29  1.1.1.2  jruoho  *
     30  1.1.1.2  jruoho  * NO WARRANTY
     31  1.1.1.2  jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1.1.2  jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1.1.2  jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1.1.2  jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1.1.2  jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1.1.2  jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1.1.2  jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1.1.2  jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1.1.2  jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1.1.2  jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1.1.2  jruoho  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1.1.2  jruoho  */
     43      1.1  jruoho 
     44      1.1  jruoho 
     45      1.1  jruoho #include "acpi.h"
     46      1.1  jruoho #include "accommon.h"
     47      1.1  jruoho #include "acdebug.h"
     48      1.1  jruoho #include "acnamesp.h"
     49      1.1  jruoho 
     50      1.1  jruoho #ifdef ACPI_DEBUGGER
     51      1.1  jruoho 
     52      1.1  jruoho #define _COMPONENT          ACPI_CA_DEBUGGER
     53      1.1  jruoho         ACPI_MODULE_NAME    ("dbexec")
     54      1.1  jruoho 
     55      1.1  jruoho 
     56      1.1  jruoho static ACPI_DB_METHOD_INFO  AcpiGbl_DbMethodInfo;
     57      1.1  jruoho 
     58      1.1  jruoho /* Local prototypes */
     59      1.1  jruoho 
     60      1.1  jruoho static ACPI_STATUS
     61      1.1  jruoho AcpiDbExecuteMethod (
     62      1.1  jruoho     ACPI_DB_METHOD_INFO     *Info,
     63      1.1  jruoho     ACPI_BUFFER             *ReturnObj);
     64      1.1  jruoho 
     65      1.1  jruoho static void
     66      1.1  jruoho AcpiDbExecuteSetup (
     67      1.1  jruoho     ACPI_DB_METHOD_INFO     *Info);
     68      1.1  jruoho 
     69      1.1  jruoho static UINT32
     70      1.1  jruoho AcpiDbGetOutstandingAllocations (
     71      1.1  jruoho     void);
     72      1.1  jruoho 
     73      1.1  jruoho static void ACPI_SYSTEM_XFACE
     74      1.1  jruoho AcpiDbMethodThread (
     75      1.1  jruoho     void                    *Context);
     76      1.1  jruoho 
     77      1.1  jruoho static ACPI_STATUS
     78      1.1  jruoho AcpiDbExecutionWalk (
     79      1.1  jruoho     ACPI_HANDLE             ObjHandle,
     80      1.1  jruoho     UINT32                  NestingLevel,
     81      1.1  jruoho     void                    *Context,
     82      1.1  jruoho     void                    **ReturnValue);
     83      1.1  jruoho 
     84      1.1  jruoho 
     85      1.1  jruoho /*******************************************************************************
     86      1.1  jruoho  *
     87      1.1  jruoho  * FUNCTION:    AcpiDbExecuteMethod
     88      1.1  jruoho  *
     89      1.1  jruoho  * PARAMETERS:  Info            - Valid info segment
     90      1.1  jruoho  *              ReturnObj       - Where to put return object
     91      1.1  jruoho  *
     92      1.1  jruoho  * RETURN:      Status
     93      1.1  jruoho  *
     94      1.1  jruoho  * DESCRIPTION: Execute a control method.
     95      1.1  jruoho  *
     96      1.1  jruoho  ******************************************************************************/
     97      1.1  jruoho 
     98      1.1  jruoho static ACPI_STATUS
     99      1.1  jruoho AcpiDbExecuteMethod (
    100      1.1  jruoho     ACPI_DB_METHOD_INFO     *Info,
    101      1.1  jruoho     ACPI_BUFFER             *ReturnObj)
    102      1.1  jruoho {
    103      1.1  jruoho     ACPI_STATUS             Status;
    104      1.1  jruoho     ACPI_OBJECT_LIST        ParamObjects;
    105      1.1  jruoho     ACPI_OBJECT             Params[ACPI_METHOD_NUM_ARGS];
    106      1.1  jruoho     ACPI_HANDLE             Handle;
    107      1.1  jruoho     UINT32                  i;
    108      1.1  jruoho     ACPI_DEVICE_INFO        *ObjInfo;
    109      1.1  jruoho 
    110      1.1  jruoho 
    111  1.1.1.2  jruoho     ACPI_FUNCTION_TRACE (DbExecuteMethod);
    112  1.1.1.2  jruoho 
    113  1.1.1.2  jruoho 
    114      1.1  jruoho     if (AcpiGbl_DbOutputToFile && !AcpiDbgLevel)
    115      1.1  jruoho     {
    116      1.1  jruoho         AcpiOsPrintf ("Warning: debug output is not enabled!\n");
    117      1.1  jruoho     }
    118      1.1  jruoho 
    119      1.1  jruoho     /* Get the NS node, determines existence also */
    120      1.1  jruoho 
    121      1.1  jruoho     Status = AcpiGetHandle (NULL, Info->Pathname, &Handle);
    122      1.1  jruoho     if (ACPI_FAILURE (Status))
    123      1.1  jruoho     {
    124  1.1.1.2  jruoho         return_ACPI_STATUS (Status);
    125      1.1  jruoho     }
    126      1.1  jruoho 
    127      1.1  jruoho     /* Get the object info for number of method parameters */
    128      1.1  jruoho 
    129      1.1  jruoho     Status = AcpiGetObjectInfo (Handle, &ObjInfo);
    130      1.1  jruoho     if (ACPI_FAILURE (Status))
    131      1.1  jruoho     {
    132  1.1.1.2  jruoho         return_ACPI_STATUS (Status);
    133      1.1  jruoho     }
    134      1.1  jruoho 
    135      1.1  jruoho     ParamObjects.Pointer = NULL;
    136      1.1  jruoho     ParamObjects.Count   = 0;
    137      1.1  jruoho 
    138      1.1  jruoho     if (ObjInfo->Type == ACPI_TYPE_METHOD)
    139      1.1  jruoho     {
    140      1.1  jruoho         /* Are there arguments to the method? */
    141      1.1  jruoho 
    142      1.1  jruoho         if (Info->Args && Info->Args[0])
    143      1.1  jruoho         {
    144  1.1.1.2  jruoho             for (i = 0; Info->Args[i] &&
    145  1.1.1.2  jruoho                 (i < ACPI_METHOD_NUM_ARGS) &&
    146  1.1.1.2  jruoho                 (i < ObjInfo->ParamCount);
    147  1.1.1.2  jruoho                 i++)
    148      1.1  jruoho             {
    149      1.1  jruoho                 Params[i].Type          = ACPI_TYPE_INTEGER;
    150      1.1  jruoho                 Params[i].Integer.Value = ACPI_STRTOUL (Info->Args[i], NULL, 16);
    151      1.1  jruoho             }
    152      1.1  jruoho 
    153      1.1  jruoho             ParamObjects.Pointer = Params;
    154      1.1  jruoho             ParamObjects.Count   = i;
    155      1.1  jruoho         }
    156      1.1  jruoho         else
    157      1.1  jruoho         {
    158      1.1  jruoho             /* Setup default parameters */
    159      1.1  jruoho 
    160      1.1  jruoho             for (i = 0; i < ObjInfo->ParamCount; i++)
    161      1.1  jruoho             {
    162      1.1  jruoho                 switch (i)
    163      1.1  jruoho                 {
    164      1.1  jruoho                 case 0:
    165      1.1  jruoho 
    166      1.1  jruoho                     Params[0].Type           = ACPI_TYPE_INTEGER;
    167      1.1  jruoho                     Params[0].Integer.Value  = 0x01020304;
    168      1.1  jruoho                     break;
    169      1.1  jruoho 
    170      1.1  jruoho                 case 1:
    171      1.1  jruoho 
    172      1.1  jruoho                     Params[1].Type           = ACPI_TYPE_STRING;
    173      1.1  jruoho                     Params[1].String.Length  = 12;
    174      1.1  jruoho                     Params[1].String.Pointer = "AML Debugger";
    175      1.1  jruoho                     break;
    176      1.1  jruoho 
    177      1.1  jruoho                 default:
    178      1.1  jruoho 
    179      1.1  jruoho                     Params[i].Type           = ACPI_TYPE_INTEGER;
    180      1.1  jruoho                     Params[i].Integer.Value  = i * (UINT64) 0x1000;
    181      1.1  jruoho                     break;
    182      1.1  jruoho                 }
    183      1.1  jruoho             }
    184      1.1  jruoho 
    185      1.1  jruoho             ParamObjects.Pointer     = Params;
    186      1.1  jruoho             ParamObjects.Count       = ObjInfo->ParamCount;
    187      1.1  jruoho         }
    188      1.1  jruoho     }
    189      1.1  jruoho 
    190      1.1  jruoho     ACPI_FREE (ObjInfo);
    191      1.1  jruoho 
    192      1.1  jruoho     /* Prepare for a return object of arbitrary size */
    193      1.1  jruoho 
    194      1.1  jruoho     ReturnObj->Pointer = AcpiGbl_DbBuffer;
    195      1.1  jruoho     ReturnObj->Length  = ACPI_DEBUG_BUFFER_SIZE;
    196      1.1  jruoho 
    197      1.1  jruoho     /* Do the actual method execution */
    198      1.1  jruoho 
    199      1.1  jruoho     AcpiGbl_MethodExecuting = TRUE;
    200      1.1  jruoho     Status = AcpiEvaluateObject (NULL,
    201      1.1  jruoho                 Info->Pathname, &ParamObjects, ReturnObj);
    202      1.1  jruoho 
    203      1.1  jruoho     AcpiGbl_CmSingleStep = FALSE;
    204      1.1  jruoho     AcpiGbl_MethodExecuting = FALSE;
    205      1.1  jruoho 
    206  1.1.1.2  jruoho     if (ACPI_FAILURE (Status))
    207  1.1.1.2  jruoho     {
    208  1.1.1.2  jruoho         ACPI_EXCEPTION ((AE_INFO, Status,
    209  1.1.1.2  jruoho         "while executing %s from debugger", Info->Pathname));
    210  1.1.1.2  jruoho 
    211  1.1.1.2  jruoho         if (Status == AE_BUFFER_OVERFLOW)
    212  1.1.1.2  jruoho         {
    213  1.1.1.2  jruoho             ACPI_ERROR ((AE_INFO,
    214  1.1.1.2  jruoho             "Possible overflow of internal debugger buffer (size 0x%X needed 0x%X)",
    215  1.1.1.2  jruoho                 ACPI_DEBUG_BUFFER_SIZE, (UINT32) ReturnObj->Length));
    216  1.1.1.2  jruoho         }
    217  1.1.1.2  jruoho     }
    218  1.1.1.2  jruoho 
    219  1.1.1.2  jruoho     return_ACPI_STATUS (Status);
    220      1.1  jruoho }
    221      1.1  jruoho 
    222      1.1  jruoho 
    223      1.1  jruoho /*******************************************************************************
    224      1.1  jruoho  *
    225      1.1  jruoho  * FUNCTION:    AcpiDbExecuteSetup
    226      1.1  jruoho  *
    227      1.1  jruoho  * PARAMETERS:  Info            - Valid method info
    228      1.1  jruoho  *
    229      1.1  jruoho  * RETURN:      None
    230      1.1  jruoho  *
    231      1.1  jruoho  * DESCRIPTION: Setup info segment prior to method execution
    232      1.1  jruoho  *
    233      1.1  jruoho  ******************************************************************************/
    234      1.1  jruoho 
    235      1.1  jruoho static void
    236      1.1  jruoho AcpiDbExecuteSetup (
    237      1.1  jruoho     ACPI_DB_METHOD_INFO     *Info)
    238      1.1  jruoho {
    239      1.1  jruoho 
    240      1.1  jruoho     /* Catenate the current scope to the supplied name */
    241      1.1  jruoho 
    242      1.1  jruoho     Info->Pathname[0] = 0;
    243      1.1  jruoho     if ((Info->Name[0] != '\\') &&
    244      1.1  jruoho         (Info->Name[0] != '/'))
    245      1.1  jruoho     {
    246      1.1  jruoho         ACPI_STRCAT (Info->Pathname, AcpiGbl_DbScopeBuf);
    247      1.1  jruoho     }
    248      1.1  jruoho 
    249      1.1  jruoho     ACPI_STRCAT (Info->Pathname, Info->Name);
    250      1.1  jruoho     AcpiDbPrepNamestring (Info->Pathname);
    251      1.1  jruoho 
    252      1.1  jruoho     AcpiDbSetOutputDestination (ACPI_DB_DUPLICATE_OUTPUT);
    253      1.1  jruoho     AcpiOsPrintf ("Executing %s\n", Info->Pathname);
    254      1.1  jruoho 
    255      1.1  jruoho     if (Info->Flags & EX_SINGLE_STEP)
    256      1.1  jruoho     {
    257      1.1  jruoho         AcpiGbl_CmSingleStep = TRUE;
    258      1.1  jruoho         AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);
    259      1.1  jruoho     }
    260      1.1  jruoho 
    261      1.1  jruoho     else
    262      1.1  jruoho     {
    263      1.1  jruoho         /* No single step, allow redirection to a file */
    264      1.1  jruoho 
    265      1.1  jruoho         AcpiDbSetOutputDestination (ACPI_DB_REDIRECTABLE_OUTPUT);
    266      1.1  jruoho     }
    267      1.1  jruoho }
    268      1.1  jruoho 
    269      1.1  jruoho 
    270      1.1  jruoho #ifdef ACPI_DBG_TRACK_ALLOCATIONS
    271      1.1  jruoho UINT32
    272      1.1  jruoho AcpiDbGetCacheInfo (
    273      1.1  jruoho     ACPI_MEMORY_LIST        *Cache)
    274      1.1  jruoho {
    275      1.1  jruoho 
    276      1.1  jruoho     return (Cache->TotalAllocated - Cache->TotalFreed - Cache->CurrentDepth);
    277      1.1  jruoho }
    278      1.1  jruoho #endif
    279      1.1  jruoho 
    280      1.1  jruoho /*******************************************************************************
    281      1.1  jruoho  *
    282      1.1  jruoho  * FUNCTION:    AcpiDbGetOutstandingAllocations
    283      1.1  jruoho  *
    284      1.1  jruoho  * PARAMETERS:  None
    285      1.1  jruoho  *
    286      1.1  jruoho  * RETURN:      Current global allocation count minus cache entries
    287      1.1  jruoho  *
    288      1.1  jruoho  * DESCRIPTION: Determine the current number of "outstanding" allocations --
    289      1.1  jruoho  *              those allocations that have not been freed and also are not
    290      1.1  jruoho  *              in one of the various object caches.
    291      1.1  jruoho  *
    292      1.1  jruoho  ******************************************************************************/
    293      1.1  jruoho 
    294      1.1  jruoho static UINT32
    295      1.1  jruoho AcpiDbGetOutstandingAllocations (
    296      1.1  jruoho     void)
    297      1.1  jruoho {
    298      1.1  jruoho     UINT32                  Outstanding = 0;
    299      1.1  jruoho 
    300      1.1  jruoho #ifdef ACPI_DBG_TRACK_ALLOCATIONS
    301      1.1  jruoho 
    302      1.1  jruoho     Outstanding += AcpiDbGetCacheInfo (AcpiGbl_StateCache);
    303      1.1  jruoho     Outstanding += AcpiDbGetCacheInfo (AcpiGbl_PsNodeCache);
    304      1.1  jruoho     Outstanding += AcpiDbGetCacheInfo (AcpiGbl_PsNodeExtCache);
    305      1.1  jruoho     Outstanding += AcpiDbGetCacheInfo (AcpiGbl_OperandCache);
    306      1.1  jruoho #endif
    307      1.1  jruoho 
    308      1.1  jruoho     return (Outstanding);
    309      1.1  jruoho }
    310      1.1  jruoho 
    311      1.1  jruoho 
    312      1.1  jruoho /*******************************************************************************
    313      1.1  jruoho  *
    314      1.1  jruoho  * FUNCTION:    AcpiDbExecutionWalk
    315      1.1  jruoho  *
    316      1.1  jruoho  * PARAMETERS:  WALK_CALLBACK
    317      1.1  jruoho  *
    318      1.1  jruoho  * RETURN:      Status
    319      1.1  jruoho  *
    320      1.1  jruoho  * DESCRIPTION: Execute a control method.  Name is relative to the current
    321      1.1  jruoho  *              scope.
    322      1.1  jruoho  *
    323      1.1  jruoho  ******************************************************************************/
    324      1.1  jruoho 
    325      1.1  jruoho static ACPI_STATUS
    326      1.1  jruoho AcpiDbExecutionWalk (
    327      1.1  jruoho     ACPI_HANDLE             ObjHandle,
    328      1.1  jruoho     UINT32                  NestingLevel,
    329      1.1  jruoho     void                    *Context,
    330      1.1  jruoho     void                    **ReturnValue)
    331      1.1  jruoho {
    332      1.1  jruoho     ACPI_OPERAND_OBJECT     *ObjDesc;
    333      1.1  jruoho     ACPI_NAMESPACE_NODE     *Node = (ACPI_NAMESPACE_NODE *) ObjHandle;
    334      1.1  jruoho     ACPI_BUFFER             ReturnObj;
    335      1.1  jruoho     ACPI_STATUS             Status;
    336      1.1  jruoho 
    337      1.1  jruoho 
    338      1.1  jruoho     ObjDesc = AcpiNsGetAttachedObject (Node);
    339      1.1  jruoho     if (ObjDesc->Method.ParamCount)
    340      1.1  jruoho     {
    341      1.1  jruoho         return (AE_OK);
    342      1.1  jruoho     }
    343      1.1  jruoho 
    344      1.1  jruoho     ReturnObj.Pointer = NULL;
    345      1.1  jruoho     ReturnObj.Length = ACPI_ALLOCATE_BUFFER;
    346      1.1  jruoho 
    347      1.1  jruoho     AcpiNsPrintNodePathname (Node, "Execute");
    348      1.1  jruoho 
    349      1.1  jruoho     /* Do the actual method execution */
    350      1.1  jruoho 
    351      1.1  jruoho     AcpiOsPrintf ("\n");
    352      1.1  jruoho     AcpiGbl_MethodExecuting = TRUE;
    353      1.1  jruoho 
    354      1.1  jruoho     Status = AcpiEvaluateObject (Node, NULL, NULL, &ReturnObj);
    355      1.1  jruoho 
    356      1.1  jruoho     AcpiOsPrintf ("[%4.4s] returned %s\n", AcpiUtGetNodeName (Node),
    357      1.1  jruoho             AcpiFormatException (Status));
    358      1.1  jruoho     AcpiGbl_MethodExecuting = FALSE;
    359      1.1  jruoho 
    360      1.1  jruoho     return (AE_OK);
    361      1.1  jruoho }
    362      1.1  jruoho 
    363      1.1  jruoho 
    364      1.1  jruoho /*******************************************************************************
    365      1.1  jruoho  *
    366      1.1  jruoho  * FUNCTION:    AcpiDbExecute
    367      1.1  jruoho  *
    368      1.1  jruoho  * PARAMETERS:  Name                - Name of method to execute
    369      1.1  jruoho  *              Args                - Parameters to the method
    370      1.1  jruoho  *              Flags               - single step/no single step
    371      1.1  jruoho  *
    372      1.1  jruoho  * RETURN:      None
    373      1.1  jruoho  *
    374      1.1  jruoho  * DESCRIPTION: Execute a control method.  Name is relative to the current
    375      1.1  jruoho  *              scope.
    376      1.1  jruoho  *
    377      1.1  jruoho  ******************************************************************************/
    378      1.1  jruoho 
    379      1.1  jruoho void
    380      1.1  jruoho AcpiDbExecute (
    381      1.1  jruoho     char                    *Name,
    382      1.1  jruoho     char                    **Args,
    383      1.1  jruoho     UINT32                  Flags)
    384      1.1  jruoho {
    385      1.1  jruoho     ACPI_STATUS             Status;
    386      1.1  jruoho     ACPI_BUFFER             ReturnObj;
    387      1.1  jruoho     char                    *NameString;
    388      1.1  jruoho 
    389      1.1  jruoho 
    390      1.1  jruoho #ifdef ACPI_DEBUG_OUTPUT
    391      1.1  jruoho     UINT32                  PreviousAllocations;
    392      1.1  jruoho     UINT32                  Allocations;
    393      1.1  jruoho 
    394      1.1  jruoho 
    395      1.1  jruoho     /* Memory allocation tracking */
    396      1.1  jruoho 
    397      1.1  jruoho     PreviousAllocations = AcpiDbGetOutstandingAllocations ();
    398      1.1  jruoho #endif
    399      1.1  jruoho 
    400      1.1  jruoho     if (*Name == '*')
    401      1.1  jruoho     {
    402      1.1  jruoho         (void) AcpiWalkNamespace (ACPI_TYPE_METHOD, ACPI_ROOT_OBJECT,
    403      1.1  jruoho                     ACPI_UINT32_MAX, AcpiDbExecutionWalk, NULL, NULL, NULL);
    404      1.1  jruoho         return;
    405      1.1  jruoho     }
    406      1.1  jruoho     else
    407      1.1  jruoho     {
    408      1.1  jruoho         NameString = ACPI_ALLOCATE (ACPI_STRLEN (Name) + 1);
    409      1.1  jruoho         if (!NameString)
    410      1.1  jruoho         {
    411      1.1  jruoho             return;
    412      1.1  jruoho         }
    413      1.1  jruoho 
    414      1.1  jruoho         ACPI_MEMSET (&AcpiGbl_DbMethodInfo, 0, sizeof (ACPI_DB_METHOD_INFO));
    415      1.1  jruoho 
    416      1.1  jruoho         ACPI_STRCPY (NameString, Name);
    417      1.1  jruoho         AcpiUtStrupr (NameString);
    418      1.1  jruoho         AcpiGbl_DbMethodInfo.Name = NameString;
    419      1.1  jruoho         AcpiGbl_DbMethodInfo.Args = Args;
    420      1.1  jruoho         AcpiGbl_DbMethodInfo.Flags = Flags;
    421      1.1  jruoho 
    422      1.1  jruoho         ReturnObj.Pointer = NULL;
    423      1.1  jruoho         ReturnObj.Length = ACPI_ALLOCATE_BUFFER;
    424      1.1  jruoho 
    425      1.1  jruoho         AcpiDbExecuteSetup (&AcpiGbl_DbMethodInfo);
    426      1.1  jruoho         Status = AcpiDbExecuteMethod (&AcpiGbl_DbMethodInfo, &ReturnObj);
    427      1.1  jruoho         ACPI_FREE (NameString);
    428      1.1  jruoho     }
    429      1.1  jruoho 
    430      1.1  jruoho     /*
    431      1.1  jruoho      * Allow any handlers in separate threads to complete.
    432      1.1  jruoho      * (Such as Notify handlers invoked from AML executed above).
    433      1.1  jruoho      */
    434      1.1  jruoho     AcpiOsSleep ((UINT64) 10);
    435      1.1  jruoho 
    436      1.1  jruoho 
    437      1.1  jruoho #ifdef ACPI_DEBUG_OUTPUT
    438      1.1  jruoho 
    439      1.1  jruoho     /* Memory allocation tracking */
    440      1.1  jruoho 
    441      1.1  jruoho     Allocations = AcpiDbGetOutstandingAllocations () - PreviousAllocations;
    442      1.1  jruoho 
    443      1.1  jruoho     AcpiDbSetOutputDestination (ACPI_DB_DUPLICATE_OUTPUT);
    444      1.1  jruoho 
    445      1.1  jruoho     if (Allocations > 0)
    446      1.1  jruoho     {
    447      1.1  jruoho         AcpiOsPrintf ("Outstanding: 0x%X allocations after execution\n",
    448      1.1  jruoho                         Allocations);
    449      1.1  jruoho     }
    450      1.1  jruoho #endif
    451      1.1  jruoho 
    452      1.1  jruoho     if (ACPI_FAILURE (Status))
    453      1.1  jruoho     {
    454      1.1  jruoho         AcpiOsPrintf ("Execution of %s failed with status %s\n",
    455      1.1  jruoho             AcpiGbl_DbMethodInfo.Pathname, AcpiFormatException (Status));
    456      1.1  jruoho     }
    457      1.1  jruoho     else
    458      1.1  jruoho     {
    459      1.1  jruoho         /* Display a return object, if any */
    460      1.1  jruoho 
    461      1.1  jruoho         if (ReturnObj.Length)
    462      1.1  jruoho         {
    463      1.1  jruoho             AcpiOsPrintf ("Execution of %s returned object %p Buflen %X\n",
    464      1.1  jruoho                 AcpiGbl_DbMethodInfo.Pathname, ReturnObj.Pointer,
    465      1.1  jruoho                 (UINT32) ReturnObj.Length);
    466      1.1  jruoho             AcpiDbDumpExternalObject (ReturnObj.Pointer, 1);
    467      1.1  jruoho         }
    468      1.1  jruoho         else
    469      1.1  jruoho         {
    470      1.1  jruoho             AcpiOsPrintf ("No return object from execution of %s\n",
    471      1.1  jruoho                 AcpiGbl_DbMethodInfo.Pathname);
    472      1.1  jruoho         }
    473      1.1  jruoho     }
    474      1.1  jruoho 
    475      1.1  jruoho     AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);
    476      1.1  jruoho }
    477      1.1  jruoho 
    478      1.1  jruoho 
    479      1.1  jruoho /*******************************************************************************
    480      1.1  jruoho  *
    481      1.1  jruoho  * FUNCTION:    AcpiDbMethodThread
    482      1.1  jruoho  *
    483      1.1  jruoho  * PARAMETERS:  Context             - Execution info segment
    484      1.1  jruoho  *
    485      1.1  jruoho  * RETURN:      None
    486      1.1  jruoho  *
    487      1.1  jruoho  * DESCRIPTION: Debugger execute thread.  Waits for a command line, then
    488      1.1  jruoho  *              simply dispatches it.
    489      1.1  jruoho  *
    490      1.1  jruoho  ******************************************************************************/
    491      1.1  jruoho 
    492      1.1  jruoho static void ACPI_SYSTEM_XFACE
    493      1.1  jruoho AcpiDbMethodThread (
    494      1.1  jruoho     void                    *Context)
    495      1.1  jruoho {
    496      1.1  jruoho     ACPI_STATUS             Status;
    497      1.1  jruoho     ACPI_DB_METHOD_INFO     *Info = Context;
    498      1.1  jruoho     ACPI_DB_METHOD_INFO     LocalInfo;
    499      1.1  jruoho     UINT32                  i;
    500      1.1  jruoho     UINT8                   Allow;
    501      1.1  jruoho     ACPI_BUFFER             ReturnObj;
    502      1.1  jruoho 
    503      1.1  jruoho 
    504      1.1  jruoho     /*
    505      1.1  jruoho      * AcpiGbl_DbMethodInfo.Arguments will be passed as method arguments.
    506      1.1  jruoho      * Prevent AcpiGbl_DbMethodInfo from being modified by multiple threads
    507      1.1  jruoho      * concurrently.
    508      1.1  jruoho      *
    509      1.1  jruoho      * Note: The arguments we are passing are used by the ASL test suite
    510      1.1  jruoho      * (aslts). Do not change them without updating the tests.
    511      1.1  jruoho      */
    512      1.1  jruoho     (void) AcpiOsWaitSemaphore (Info->InfoGate, 1, ACPI_WAIT_FOREVER);
    513      1.1  jruoho 
    514      1.1  jruoho     if (Info->InitArgs)
    515      1.1  jruoho     {
    516      1.1  jruoho         AcpiDbUInt32ToHexString (Info->NumCreated, Info->IndexOfThreadStr);
    517  1.1.1.2  jruoho         AcpiDbUInt32ToHexString ((UINT32) AcpiOsGetThreadId (), Info->IdOfThreadStr);
    518      1.1  jruoho     }
    519      1.1  jruoho 
    520      1.1  jruoho     if (Info->Threads && (Info->NumCreated < Info->NumThreads))
    521      1.1  jruoho     {
    522  1.1.1.2  jruoho         Info->Threads[Info->NumCreated++] = AcpiOsGetThreadId();
    523      1.1  jruoho     }
    524      1.1  jruoho 
    525      1.1  jruoho     LocalInfo = *Info;
    526      1.1  jruoho     LocalInfo.Args = LocalInfo.Arguments;
    527      1.1  jruoho     LocalInfo.Arguments[0] = LocalInfo.NumThreadsStr;
    528      1.1  jruoho     LocalInfo.Arguments[1] = LocalInfo.IdOfThreadStr;
    529      1.1  jruoho     LocalInfo.Arguments[2] = LocalInfo.IndexOfThreadStr;
    530      1.1  jruoho     LocalInfo.Arguments[3] = NULL;
    531      1.1  jruoho 
    532      1.1  jruoho     (void) AcpiOsSignalSemaphore (Info->InfoGate, 1);
    533      1.1  jruoho 
    534      1.1  jruoho     for (i = 0; i < Info->NumLoops; i++)
    535      1.1  jruoho     {
    536      1.1  jruoho         Status = AcpiDbExecuteMethod (&LocalInfo, &ReturnObj);
    537      1.1  jruoho         if (ACPI_FAILURE (Status))
    538      1.1  jruoho         {
    539      1.1  jruoho             AcpiOsPrintf ("%s During execution of %s at iteration %X\n",
    540      1.1  jruoho                 AcpiFormatException (Status), Info->Pathname, i);
    541      1.1  jruoho             if (Status == AE_ABORT_METHOD)
    542      1.1  jruoho             {
    543      1.1  jruoho                 break;
    544      1.1  jruoho             }
    545      1.1  jruoho         }
    546      1.1  jruoho 
    547      1.1  jruoho #if 0
    548      1.1  jruoho         if ((i % 100) == 0)
    549      1.1  jruoho         {
    550      1.1  jruoho             AcpiOsPrintf ("%u executions, Thread 0x%x\n", i, AcpiOsGetThreadId ());
    551      1.1  jruoho         }
    552      1.1  jruoho 
    553      1.1  jruoho         if (ReturnObj.Length)
    554      1.1  jruoho         {
    555      1.1  jruoho             AcpiOsPrintf ("Execution of %s returned object %p Buflen %X\n",
    556      1.1  jruoho                 Info->Pathname, ReturnObj.Pointer, (UINT32) ReturnObj.Length);
    557      1.1  jruoho             AcpiDbDumpExternalObject (ReturnObj.Pointer, 1);
    558      1.1  jruoho         }
    559      1.1  jruoho #endif
    560      1.1  jruoho     }
    561      1.1  jruoho 
    562      1.1  jruoho     /* Signal our completion */
    563      1.1  jruoho 
    564      1.1  jruoho     Allow = 0;
    565      1.1  jruoho     (void) AcpiOsWaitSemaphore (Info->ThreadCompleteGate, 1, ACPI_WAIT_FOREVER);
    566      1.1  jruoho     Info->NumCompleted++;
    567      1.1  jruoho 
    568      1.1  jruoho     if (Info->NumCompleted == Info->NumThreads)
    569      1.1  jruoho     {
    570      1.1  jruoho         /* Do signal for main thread once only */
    571      1.1  jruoho         Allow = 1;
    572      1.1  jruoho     }
    573      1.1  jruoho 
    574      1.1  jruoho     (void) AcpiOsSignalSemaphore (Info->ThreadCompleteGate, 1);
    575      1.1  jruoho 
    576      1.1  jruoho     if (Allow)
    577      1.1  jruoho     {
    578      1.1  jruoho         Status = AcpiOsSignalSemaphore (Info->MainThreadGate, 1);
    579      1.1  jruoho         if (ACPI_FAILURE (Status))
    580      1.1  jruoho         {
    581      1.1  jruoho             AcpiOsPrintf ("Could not signal debugger thread sync semaphore, %s\n",
    582      1.1  jruoho                 AcpiFormatException (Status));
    583      1.1  jruoho         }
    584      1.1  jruoho     }
    585      1.1  jruoho }
    586      1.1  jruoho 
    587      1.1  jruoho 
    588      1.1  jruoho /*******************************************************************************
    589      1.1  jruoho  *
    590      1.1  jruoho  * FUNCTION:    AcpiDbCreateExecutionThreads
    591      1.1  jruoho  *
    592      1.1  jruoho  * PARAMETERS:  NumThreadsArg           - Number of threads to create
    593      1.1  jruoho  *              NumLoopsArg             - Loop count for the thread(s)
    594      1.1  jruoho  *              MethodNameArg           - Control method to execute
    595      1.1  jruoho  *
    596      1.1  jruoho  * RETURN:      None
    597      1.1  jruoho  *
    598      1.1  jruoho  * DESCRIPTION: Create threads to execute method(s)
    599      1.1  jruoho  *
    600      1.1  jruoho  ******************************************************************************/
    601      1.1  jruoho 
    602      1.1  jruoho void
    603      1.1  jruoho AcpiDbCreateExecutionThreads (
    604      1.1  jruoho     char                    *NumThreadsArg,
    605      1.1  jruoho     char                    *NumLoopsArg,
    606      1.1  jruoho     char                    *MethodNameArg)
    607      1.1  jruoho {
    608      1.1  jruoho     ACPI_STATUS             Status;
    609      1.1  jruoho     UINT32                  NumThreads;
    610      1.1  jruoho     UINT32                  NumLoops;
    611      1.1  jruoho     UINT32                  i;
    612      1.1  jruoho     UINT32                  Size;
    613      1.1  jruoho     ACPI_MUTEX              MainThreadGate;
    614      1.1  jruoho     ACPI_MUTEX              ThreadCompleteGate;
    615      1.1  jruoho     ACPI_MUTEX              InfoGate;
    616      1.1  jruoho 
    617      1.1  jruoho 
    618      1.1  jruoho     /* Get the arguments */
    619      1.1  jruoho 
    620      1.1  jruoho     NumThreads = ACPI_STRTOUL (NumThreadsArg, NULL, 0);
    621      1.1  jruoho     NumLoops   = ACPI_STRTOUL (NumLoopsArg, NULL, 0);
    622      1.1  jruoho 
    623      1.1  jruoho     if (!NumThreads || !NumLoops)
    624      1.1  jruoho     {
    625      1.1  jruoho         AcpiOsPrintf ("Bad argument: Threads %X, Loops %X\n",
    626      1.1  jruoho             NumThreads, NumLoops);
    627      1.1  jruoho         return;
    628      1.1  jruoho     }
    629      1.1  jruoho 
    630      1.1  jruoho     /*
    631      1.1  jruoho      * Create the semaphore for synchronization of
    632      1.1  jruoho      * the created threads with the main thread.
    633      1.1  jruoho      */
    634      1.1  jruoho     Status = AcpiOsCreateSemaphore (1, 0, &MainThreadGate);
    635      1.1  jruoho     if (ACPI_FAILURE (Status))
    636      1.1  jruoho     {
    637      1.1  jruoho         AcpiOsPrintf ("Could not create semaphore for synchronization with the main thread, %s\n",
    638      1.1  jruoho             AcpiFormatException (Status));
    639      1.1  jruoho         return;
    640      1.1  jruoho     }
    641      1.1  jruoho 
    642      1.1  jruoho     /*
    643      1.1  jruoho      * Create the semaphore for synchronization
    644      1.1  jruoho      * between the created threads.
    645      1.1  jruoho      */
    646      1.1  jruoho     Status = AcpiOsCreateSemaphore (1, 1, &ThreadCompleteGate);
    647      1.1  jruoho     if (ACPI_FAILURE (Status))
    648      1.1  jruoho     {
    649      1.1  jruoho         AcpiOsPrintf ("Could not create semaphore for synchronization between the created threads, %s\n",
    650      1.1  jruoho             AcpiFormatException (Status));
    651      1.1  jruoho         (void) AcpiOsDeleteSemaphore (MainThreadGate);
    652      1.1  jruoho         return;
    653      1.1  jruoho     }
    654      1.1  jruoho 
    655      1.1  jruoho     Status = AcpiOsCreateSemaphore (1, 1, &InfoGate);
    656      1.1  jruoho     if (ACPI_FAILURE (Status))
    657      1.1  jruoho     {
    658      1.1  jruoho         AcpiOsPrintf ("Could not create semaphore for synchronization of AcpiGbl_DbMethodInfo, %s\n",
    659      1.1  jruoho             AcpiFormatException (Status));
    660      1.1  jruoho         (void) AcpiOsDeleteSemaphore (ThreadCompleteGate);
    661      1.1  jruoho         (void) AcpiOsDeleteSemaphore (MainThreadGate);
    662      1.1  jruoho         return;
    663      1.1  jruoho     }
    664      1.1  jruoho 
    665      1.1  jruoho     ACPI_MEMSET (&AcpiGbl_DbMethodInfo, 0, sizeof (ACPI_DB_METHOD_INFO));
    666      1.1  jruoho 
    667      1.1  jruoho     /* Array to store IDs of threads */
    668      1.1  jruoho 
    669      1.1  jruoho     AcpiGbl_DbMethodInfo.NumThreads = NumThreads;
    670  1.1.1.2  jruoho     Size = sizeof (ACPI_THREAD_ID) * AcpiGbl_DbMethodInfo.NumThreads;
    671  1.1.1.2  jruoho     AcpiGbl_DbMethodInfo.Threads = AcpiOsAllocate (Size);
    672      1.1  jruoho     if (AcpiGbl_DbMethodInfo.Threads == NULL)
    673      1.1  jruoho     {
    674      1.1  jruoho         AcpiOsPrintf ("No memory for thread IDs array\n");
    675      1.1  jruoho         (void) AcpiOsDeleteSemaphore (MainThreadGate);
    676      1.1  jruoho         (void) AcpiOsDeleteSemaphore (ThreadCompleteGate);
    677      1.1  jruoho         (void) AcpiOsDeleteSemaphore (InfoGate);
    678      1.1  jruoho         return;
    679      1.1  jruoho     }
    680      1.1  jruoho     ACPI_MEMSET (AcpiGbl_DbMethodInfo.Threads, 0, Size);
    681      1.1  jruoho 
    682      1.1  jruoho     /* Setup the context to be passed to each thread */
    683      1.1  jruoho 
    684      1.1  jruoho     AcpiGbl_DbMethodInfo.Name = MethodNameArg;
    685      1.1  jruoho     AcpiGbl_DbMethodInfo.Flags = 0;
    686      1.1  jruoho     AcpiGbl_DbMethodInfo.NumLoops = NumLoops;
    687      1.1  jruoho     AcpiGbl_DbMethodInfo.MainThreadGate = MainThreadGate;
    688      1.1  jruoho     AcpiGbl_DbMethodInfo.ThreadCompleteGate = ThreadCompleteGate;
    689      1.1  jruoho     AcpiGbl_DbMethodInfo.InfoGate = InfoGate;
    690      1.1  jruoho 
    691      1.1  jruoho     /* Init arguments to be passed to method */
    692      1.1  jruoho 
    693      1.1  jruoho     AcpiGbl_DbMethodInfo.InitArgs = 1;
    694      1.1  jruoho     AcpiGbl_DbMethodInfo.Args = AcpiGbl_DbMethodInfo.Arguments;
    695      1.1  jruoho     AcpiGbl_DbMethodInfo.Arguments[0] = AcpiGbl_DbMethodInfo.NumThreadsStr;
    696      1.1  jruoho     AcpiGbl_DbMethodInfo.Arguments[1] = AcpiGbl_DbMethodInfo.IdOfThreadStr;
    697      1.1  jruoho     AcpiGbl_DbMethodInfo.Arguments[2] = AcpiGbl_DbMethodInfo.IndexOfThreadStr;
    698      1.1  jruoho     AcpiGbl_DbMethodInfo.Arguments[3] = NULL;
    699      1.1  jruoho     AcpiDbUInt32ToHexString (NumThreads, AcpiGbl_DbMethodInfo.NumThreadsStr);
    700      1.1  jruoho 
    701      1.1  jruoho     AcpiDbExecuteSetup (&AcpiGbl_DbMethodInfo);
    702      1.1  jruoho 
    703      1.1  jruoho     /* Create the threads */
    704      1.1  jruoho 
    705      1.1  jruoho     AcpiOsPrintf ("Creating %X threads to execute %X times each\n",
    706      1.1  jruoho         NumThreads, NumLoops);
    707      1.1  jruoho 
    708      1.1  jruoho     for (i = 0; i < (NumThreads); i++)
    709      1.1  jruoho     {
    710      1.1  jruoho         Status = AcpiOsExecute (OSL_DEBUGGER_THREAD, AcpiDbMethodThread,
    711      1.1  jruoho             &AcpiGbl_DbMethodInfo);
    712      1.1  jruoho         if (ACPI_FAILURE (Status))
    713      1.1  jruoho         {
    714      1.1  jruoho             break;
    715      1.1  jruoho         }
    716      1.1  jruoho     }
    717      1.1  jruoho 
    718      1.1  jruoho     /* Wait for all threads to complete */
    719      1.1  jruoho 
    720      1.1  jruoho     (void) AcpiOsWaitSemaphore (MainThreadGate, 1, ACPI_WAIT_FOREVER);
    721      1.1  jruoho 
    722      1.1  jruoho     AcpiDbSetOutputDestination (ACPI_DB_DUPLICATE_OUTPUT);
    723      1.1  jruoho     AcpiOsPrintf ("All threads (%X) have completed\n", NumThreads);
    724      1.1  jruoho     AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);
    725      1.1  jruoho 
    726      1.1  jruoho     /* Cleanup and exit */
    727      1.1  jruoho 
    728      1.1  jruoho     (void) AcpiOsDeleteSemaphore (MainThreadGate);
    729      1.1  jruoho     (void) AcpiOsDeleteSemaphore (ThreadCompleteGate);
    730      1.1  jruoho     (void) AcpiOsDeleteSemaphore (InfoGate);
    731      1.1  jruoho 
    732      1.1  jruoho     AcpiOsFree (AcpiGbl_DbMethodInfo.Threads);
    733      1.1  jruoho     AcpiGbl_DbMethodInfo.Threads = NULL;
    734      1.1  jruoho }
    735      1.1  jruoho 
    736      1.1  jruoho #endif /* ACPI_DEBUGGER */
    737      1.1  jruoho 
    738      1.1  jruoho 
    739