Home | History | Annotate | Line # | Download | only in utilities
utdelete.c revision 1.1.1.2.4.2
      1  1.1.1.2.4.2  rmind /*******************************************************************************
      2  1.1.1.2.4.2  rmind  *
      3  1.1.1.2.4.2  rmind  * Module Name: utdelete - object deletion and reference count utilities
      4  1.1.1.2.4.2  rmind  *
      5  1.1.1.2.4.2  rmind  ******************************************************************************/
      6  1.1.1.2.4.2  rmind 
      7  1.1.1.2.4.2  rmind /*
      8  1.1.1.2.4.2  rmind  * Copyright (C) 2000 - 2011, Intel Corp.
      9  1.1.1.2.4.2  rmind  * All rights reserved.
     10  1.1.1.2.4.2  rmind  *
     11  1.1.1.2.4.2  rmind  * Redistribution and use in source and binary forms, with or without
     12  1.1.1.2.4.2  rmind  * modification, are permitted provided that the following conditions
     13  1.1.1.2.4.2  rmind  * are met:
     14  1.1.1.2.4.2  rmind  * 1. Redistributions of source code must retain the above copyright
     15  1.1.1.2.4.2  rmind  *    notice, this list of conditions, and the following disclaimer,
     16  1.1.1.2.4.2  rmind  *    without modification.
     17  1.1.1.2.4.2  rmind  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1.1.2.4.2  rmind  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1.1.2.4.2  rmind  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1.1.2.4.2  rmind  *    including a substantially similar Disclaimer requirement for further
     21  1.1.1.2.4.2  rmind  *    binary redistribution.
     22  1.1.1.2.4.2  rmind  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1.1.2.4.2  rmind  *    of any contributors may be used to endorse or promote products derived
     24  1.1.1.2.4.2  rmind  *    from this software without specific prior written permission.
     25  1.1.1.2.4.2  rmind  *
     26  1.1.1.2.4.2  rmind  * Alternatively, this software may be distributed under the terms of the
     27  1.1.1.2.4.2  rmind  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1.1.2.4.2  rmind  * Software Foundation.
     29  1.1.1.2.4.2  rmind  *
     30  1.1.1.2.4.2  rmind  * NO WARRANTY
     31  1.1.1.2.4.2  rmind  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1.1.2.4.2  rmind  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1.1.2.4.2  rmind  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1.1.2.4.2  rmind  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1.1.2.4.2  rmind  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1.1.2.4.2  rmind  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1.1.2.4.2  rmind  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1.1.2.4.2  rmind  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1.1.2.4.2  rmind  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1.1.2.4.2  rmind  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1.1.2.4.2  rmind  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1.1.2.4.2  rmind  */
     43  1.1.1.2.4.2  rmind 
     44  1.1.1.2.4.2  rmind #define __UTDELETE_C__
     45  1.1.1.2.4.2  rmind 
     46  1.1.1.2.4.2  rmind #include "acpi.h"
     47  1.1.1.2.4.2  rmind #include "accommon.h"
     48  1.1.1.2.4.2  rmind #include "acinterp.h"
     49  1.1.1.2.4.2  rmind #include "acnamesp.h"
     50  1.1.1.2.4.2  rmind #include "acevents.h"
     51  1.1.1.2.4.2  rmind 
     52  1.1.1.2.4.2  rmind 
     53  1.1.1.2.4.2  rmind #define _COMPONENT          ACPI_UTILITIES
     54  1.1.1.2.4.2  rmind         ACPI_MODULE_NAME    ("utdelete")
     55  1.1.1.2.4.2  rmind 
     56  1.1.1.2.4.2  rmind /* Local prototypes */
     57  1.1.1.2.4.2  rmind 
     58  1.1.1.2.4.2  rmind static void
     59  1.1.1.2.4.2  rmind AcpiUtDeleteInternalObj (
     60  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object);
     61  1.1.1.2.4.2  rmind 
     62  1.1.1.2.4.2  rmind static void
     63  1.1.1.2.4.2  rmind AcpiUtUpdateRefCount (
     64  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object,
     65  1.1.1.2.4.2  rmind     UINT32                  Action);
     66  1.1.1.2.4.2  rmind 
     67  1.1.1.2.4.2  rmind 
     68  1.1.1.2.4.2  rmind /*******************************************************************************
     69  1.1.1.2.4.2  rmind  *
     70  1.1.1.2.4.2  rmind  * FUNCTION:    AcpiUtDeleteInternalObj
     71  1.1.1.2.4.2  rmind  *
     72  1.1.1.2.4.2  rmind  * PARAMETERS:  Object         - Object to be deleted
     73  1.1.1.2.4.2  rmind  *
     74  1.1.1.2.4.2  rmind  * RETURN:      None
     75  1.1.1.2.4.2  rmind  *
     76  1.1.1.2.4.2  rmind  * DESCRIPTION: Low level object deletion, after reference counts have been
     77  1.1.1.2.4.2  rmind  *              updated (All reference counts, including sub-objects!)
     78  1.1.1.2.4.2  rmind  *
     79  1.1.1.2.4.2  rmind  ******************************************************************************/
     80  1.1.1.2.4.2  rmind 
     81  1.1.1.2.4.2  rmind static void
     82  1.1.1.2.4.2  rmind AcpiUtDeleteInternalObj (
     83  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object)
     84  1.1.1.2.4.2  rmind {
     85  1.1.1.2.4.2  rmind     void                    *ObjPointer = NULL;
     86  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *HandlerDesc;
     87  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *SecondDesc;
     88  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *NextDesc;
     89  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     **LastObjPtr;
     90  1.1.1.2.4.2  rmind 
     91  1.1.1.2.4.2  rmind 
     92  1.1.1.2.4.2  rmind     ACPI_FUNCTION_TRACE_PTR (UtDeleteInternalObj, Object);
     93  1.1.1.2.4.2  rmind 
     94  1.1.1.2.4.2  rmind 
     95  1.1.1.2.4.2  rmind     if (!Object)
     96  1.1.1.2.4.2  rmind     {
     97  1.1.1.2.4.2  rmind         return_VOID;
     98  1.1.1.2.4.2  rmind     }
     99  1.1.1.2.4.2  rmind 
    100  1.1.1.2.4.2  rmind     /*
    101  1.1.1.2.4.2  rmind      * Must delete or free any pointers within the object that are not
    102  1.1.1.2.4.2  rmind      * actual ACPI objects (for example, a raw buffer pointer).
    103  1.1.1.2.4.2  rmind      */
    104  1.1.1.2.4.2  rmind     switch (Object->Common.Type)
    105  1.1.1.2.4.2  rmind     {
    106  1.1.1.2.4.2  rmind     case ACPI_TYPE_STRING:
    107  1.1.1.2.4.2  rmind 
    108  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "**** String %p, ptr %p\n",
    109  1.1.1.2.4.2  rmind             Object, Object->String.Pointer));
    110  1.1.1.2.4.2  rmind 
    111  1.1.1.2.4.2  rmind         /* Free the actual string buffer */
    112  1.1.1.2.4.2  rmind 
    113  1.1.1.2.4.2  rmind         if (!(Object->Common.Flags & AOPOBJ_STATIC_POINTER))
    114  1.1.1.2.4.2  rmind         {
    115  1.1.1.2.4.2  rmind             /* But only if it is NOT a pointer into an ACPI table */
    116  1.1.1.2.4.2  rmind 
    117  1.1.1.2.4.2  rmind             ObjPointer = Object->String.Pointer;
    118  1.1.1.2.4.2  rmind         }
    119  1.1.1.2.4.2  rmind         break;
    120  1.1.1.2.4.2  rmind 
    121  1.1.1.2.4.2  rmind 
    122  1.1.1.2.4.2  rmind     case ACPI_TYPE_BUFFER:
    123  1.1.1.2.4.2  rmind 
    124  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "**** Buffer %p, ptr %p\n",
    125  1.1.1.2.4.2  rmind             Object, Object->Buffer.Pointer));
    126  1.1.1.2.4.2  rmind 
    127  1.1.1.2.4.2  rmind         /* Free the actual buffer */
    128  1.1.1.2.4.2  rmind 
    129  1.1.1.2.4.2  rmind         if (!(Object->Common.Flags & AOPOBJ_STATIC_POINTER))
    130  1.1.1.2.4.2  rmind         {
    131  1.1.1.2.4.2  rmind             /* But only if it is NOT a pointer into an ACPI table */
    132  1.1.1.2.4.2  rmind 
    133  1.1.1.2.4.2  rmind             ObjPointer = Object->Buffer.Pointer;
    134  1.1.1.2.4.2  rmind         }
    135  1.1.1.2.4.2  rmind         break;
    136  1.1.1.2.4.2  rmind 
    137  1.1.1.2.4.2  rmind 
    138  1.1.1.2.4.2  rmind     case ACPI_TYPE_PACKAGE:
    139  1.1.1.2.4.2  rmind 
    140  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, " **** Package of count %X\n",
    141  1.1.1.2.4.2  rmind             Object->Package.Count));
    142  1.1.1.2.4.2  rmind 
    143  1.1.1.2.4.2  rmind         /*
    144  1.1.1.2.4.2  rmind          * Elements of the package are not handled here, they are deleted
    145  1.1.1.2.4.2  rmind          * separately
    146  1.1.1.2.4.2  rmind          */
    147  1.1.1.2.4.2  rmind 
    148  1.1.1.2.4.2  rmind         /* Free the (variable length) element pointer array */
    149  1.1.1.2.4.2  rmind 
    150  1.1.1.2.4.2  rmind         ObjPointer = Object->Package.Elements;
    151  1.1.1.2.4.2  rmind         break;
    152  1.1.1.2.4.2  rmind 
    153  1.1.1.2.4.2  rmind 
    154  1.1.1.2.4.2  rmind     /*
    155  1.1.1.2.4.2  rmind      * These objects have a possible list of notify handlers.
    156  1.1.1.2.4.2  rmind      * Device object also may have a GPE block.
    157  1.1.1.2.4.2  rmind      */
    158  1.1.1.2.4.2  rmind     case ACPI_TYPE_DEVICE:
    159  1.1.1.2.4.2  rmind 
    160  1.1.1.2.4.2  rmind         if (Object->Device.GpeBlock)
    161  1.1.1.2.4.2  rmind         {
    162  1.1.1.2.4.2  rmind             (void) AcpiEvDeleteGpeBlock (Object->Device.GpeBlock);
    163  1.1.1.2.4.2  rmind         }
    164  1.1.1.2.4.2  rmind 
    165  1.1.1.2.4.2  rmind         /*lint -fallthrough */
    166  1.1.1.2.4.2  rmind 
    167  1.1.1.2.4.2  rmind     case ACPI_TYPE_PROCESSOR:
    168  1.1.1.2.4.2  rmind     case ACPI_TYPE_THERMAL:
    169  1.1.1.2.4.2  rmind 
    170  1.1.1.2.4.2  rmind         /* Walk the notify handler list for this object */
    171  1.1.1.2.4.2  rmind 
    172  1.1.1.2.4.2  rmind         HandlerDesc = Object->CommonNotify.Handler;
    173  1.1.1.2.4.2  rmind         while (HandlerDesc)
    174  1.1.1.2.4.2  rmind         {
    175  1.1.1.2.4.2  rmind             NextDesc = HandlerDesc->AddressSpace.Next;
    176  1.1.1.2.4.2  rmind             AcpiUtRemoveReference (HandlerDesc);
    177  1.1.1.2.4.2  rmind             HandlerDesc = NextDesc;
    178  1.1.1.2.4.2  rmind         }
    179  1.1.1.2.4.2  rmind         break;
    180  1.1.1.2.4.2  rmind 
    181  1.1.1.2.4.2  rmind 
    182  1.1.1.2.4.2  rmind     case ACPI_TYPE_MUTEX:
    183  1.1.1.2.4.2  rmind 
    184  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    185  1.1.1.2.4.2  rmind             "***** Mutex %p, OS Mutex %p\n",
    186  1.1.1.2.4.2  rmind             Object, Object->Mutex.OsMutex));
    187  1.1.1.2.4.2  rmind 
    188  1.1.1.2.4.2  rmind         if (Object == AcpiGbl_GlobalLockMutex)
    189  1.1.1.2.4.2  rmind         {
    190  1.1.1.2.4.2  rmind             /* Global Lock has extra semaphore */
    191  1.1.1.2.4.2  rmind 
    192  1.1.1.2.4.2  rmind             (void) AcpiOsDeleteSemaphore (AcpiGbl_GlobalLockSemaphore);
    193  1.1.1.2.4.2  rmind             AcpiGbl_GlobalLockSemaphore = NULL;
    194  1.1.1.2.4.2  rmind 
    195  1.1.1.2.4.2  rmind             AcpiOsDeleteMutex (Object->Mutex.OsMutex);
    196  1.1.1.2.4.2  rmind             AcpiGbl_GlobalLockMutex = NULL;
    197  1.1.1.2.4.2  rmind         }
    198  1.1.1.2.4.2  rmind         else
    199  1.1.1.2.4.2  rmind         {
    200  1.1.1.2.4.2  rmind             AcpiExUnlinkMutex (Object);
    201  1.1.1.2.4.2  rmind             AcpiOsDeleteMutex (Object->Mutex.OsMutex);
    202  1.1.1.2.4.2  rmind         }
    203  1.1.1.2.4.2  rmind         break;
    204  1.1.1.2.4.2  rmind 
    205  1.1.1.2.4.2  rmind 
    206  1.1.1.2.4.2  rmind     case ACPI_TYPE_EVENT:
    207  1.1.1.2.4.2  rmind 
    208  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    209  1.1.1.2.4.2  rmind             "***** Event %p, OS Semaphore %p\n",
    210  1.1.1.2.4.2  rmind             Object, Object->Event.OsSemaphore));
    211  1.1.1.2.4.2  rmind 
    212  1.1.1.2.4.2  rmind         (void) AcpiOsDeleteSemaphore (Object->Event.OsSemaphore);
    213  1.1.1.2.4.2  rmind         Object->Event.OsSemaphore = NULL;
    214  1.1.1.2.4.2  rmind         break;
    215  1.1.1.2.4.2  rmind 
    216  1.1.1.2.4.2  rmind 
    217  1.1.1.2.4.2  rmind     case ACPI_TYPE_METHOD:
    218  1.1.1.2.4.2  rmind 
    219  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    220  1.1.1.2.4.2  rmind             "***** Method %p\n", Object));
    221  1.1.1.2.4.2  rmind 
    222  1.1.1.2.4.2  rmind         /* Delete the method mutex if it exists */
    223  1.1.1.2.4.2  rmind 
    224  1.1.1.2.4.2  rmind         if (Object->Method.Mutex)
    225  1.1.1.2.4.2  rmind         {
    226  1.1.1.2.4.2  rmind             AcpiOsDeleteMutex (Object->Method.Mutex->Mutex.OsMutex);
    227  1.1.1.2.4.2  rmind             AcpiUtDeleteObjectDesc (Object->Method.Mutex);
    228  1.1.1.2.4.2  rmind             Object->Method.Mutex = NULL;
    229  1.1.1.2.4.2  rmind         }
    230  1.1.1.2.4.2  rmind         break;
    231  1.1.1.2.4.2  rmind 
    232  1.1.1.2.4.2  rmind 
    233  1.1.1.2.4.2  rmind     case ACPI_TYPE_REGION:
    234  1.1.1.2.4.2  rmind 
    235  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    236  1.1.1.2.4.2  rmind             "***** Region %p\n", Object));
    237  1.1.1.2.4.2  rmind 
    238  1.1.1.2.4.2  rmind         SecondDesc = AcpiNsGetSecondaryObject (Object);
    239  1.1.1.2.4.2  rmind         if (SecondDesc)
    240  1.1.1.2.4.2  rmind         {
    241  1.1.1.2.4.2  rmind             /*
    242  1.1.1.2.4.2  rmind              * Free the RegionContext if and only if the handler is one of the
    243  1.1.1.2.4.2  rmind              * default handlers -- and therefore, we created the context object
    244  1.1.1.2.4.2  rmind              * locally, it was not created by an external caller.
    245  1.1.1.2.4.2  rmind              */
    246  1.1.1.2.4.2  rmind             HandlerDesc = Object->Region.Handler;
    247  1.1.1.2.4.2  rmind             if (HandlerDesc)
    248  1.1.1.2.4.2  rmind             {
    249  1.1.1.2.4.2  rmind                 NextDesc = HandlerDesc->AddressSpace.RegionList;
    250  1.1.1.2.4.2  rmind                 LastObjPtr = &HandlerDesc->AddressSpace.RegionList;
    251  1.1.1.2.4.2  rmind 
    252  1.1.1.2.4.2  rmind                 /* Remove the region object from the handler's list */
    253  1.1.1.2.4.2  rmind 
    254  1.1.1.2.4.2  rmind                 while (NextDesc)
    255  1.1.1.2.4.2  rmind                 {
    256  1.1.1.2.4.2  rmind                     if (NextDesc == Object)
    257  1.1.1.2.4.2  rmind                     {
    258  1.1.1.2.4.2  rmind                         *LastObjPtr = NextDesc->Region.Next;
    259  1.1.1.2.4.2  rmind                         break;
    260  1.1.1.2.4.2  rmind                     }
    261  1.1.1.2.4.2  rmind 
    262  1.1.1.2.4.2  rmind                     /* Walk the linked list of handler */
    263  1.1.1.2.4.2  rmind 
    264  1.1.1.2.4.2  rmind                     LastObjPtr = &NextDesc->Region.Next;
    265  1.1.1.2.4.2  rmind                     NextDesc = NextDesc->Region.Next;
    266  1.1.1.2.4.2  rmind                 }
    267  1.1.1.2.4.2  rmind 
    268  1.1.1.2.4.2  rmind                 if (HandlerDesc->AddressSpace.HandlerFlags &
    269  1.1.1.2.4.2  rmind                     ACPI_ADDR_HANDLER_DEFAULT_INSTALLED)
    270  1.1.1.2.4.2  rmind                 {
    271  1.1.1.2.4.2  rmind                     /* Deactivate region and free region context */
    272  1.1.1.2.4.2  rmind 
    273  1.1.1.2.4.2  rmind                     if (HandlerDesc->AddressSpace.Setup)
    274  1.1.1.2.4.2  rmind                     {
    275  1.1.1.2.4.2  rmind                         (void) HandlerDesc->AddressSpace.Setup (Object,
    276  1.1.1.2.4.2  rmind                             ACPI_REGION_DEACTIVATE,
    277  1.1.1.2.4.2  rmind                             HandlerDesc->AddressSpace.Context,
    278  1.1.1.2.4.2  rmind                             &SecondDesc->Extra.RegionContext);
    279  1.1.1.2.4.2  rmind                     }
    280  1.1.1.2.4.2  rmind                 }
    281  1.1.1.2.4.2  rmind 
    282  1.1.1.2.4.2  rmind                 AcpiUtRemoveReference (HandlerDesc);
    283  1.1.1.2.4.2  rmind             }
    284  1.1.1.2.4.2  rmind 
    285  1.1.1.2.4.2  rmind             /* Now we can free the Extra object */
    286  1.1.1.2.4.2  rmind 
    287  1.1.1.2.4.2  rmind             AcpiUtDeleteObjectDesc (SecondDesc);
    288  1.1.1.2.4.2  rmind         }
    289  1.1.1.2.4.2  rmind         break;
    290  1.1.1.2.4.2  rmind 
    291  1.1.1.2.4.2  rmind 
    292  1.1.1.2.4.2  rmind     case ACPI_TYPE_BUFFER_FIELD:
    293  1.1.1.2.4.2  rmind 
    294  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    295  1.1.1.2.4.2  rmind             "***** Buffer Field %p\n", Object));
    296  1.1.1.2.4.2  rmind 
    297  1.1.1.2.4.2  rmind         SecondDesc = AcpiNsGetSecondaryObject (Object);
    298  1.1.1.2.4.2  rmind         if (SecondDesc)
    299  1.1.1.2.4.2  rmind         {
    300  1.1.1.2.4.2  rmind             AcpiUtDeleteObjectDesc (SecondDesc);
    301  1.1.1.2.4.2  rmind         }
    302  1.1.1.2.4.2  rmind         break;
    303  1.1.1.2.4.2  rmind 
    304  1.1.1.2.4.2  rmind 
    305  1.1.1.2.4.2  rmind     case ACPI_TYPE_LOCAL_BANK_FIELD:
    306  1.1.1.2.4.2  rmind 
    307  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    308  1.1.1.2.4.2  rmind             "***** Bank Field %p\n", Object));
    309  1.1.1.2.4.2  rmind 
    310  1.1.1.2.4.2  rmind         SecondDesc = AcpiNsGetSecondaryObject (Object);
    311  1.1.1.2.4.2  rmind         if (SecondDesc)
    312  1.1.1.2.4.2  rmind         {
    313  1.1.1.2.4.2  rmind             AcpiUtDeleteObjectDesc (SecondDesc);
    314  1.1.1.2.4.2  rmind         }
    315  1.1.1.2.4.2  rmind         break;
    316  1.1.1.2.4.2  rmind 
    317  1.1.1.2.4.2  rmind 
    318  1.1.1.2.4.2  rmind     default:
    319  1.1.1.2.4.2  rmind         break;
    320  1.1.1.2.4.2  rmind     }
    321  1.1.1.2.4.2  rmind 
    322  1.1.1.2.4.2  rmind     /* Free any allocated memory (pointer within the object) found above */
    323  1.1.1.2.4.2  rmind 
    324  1.1.1.2.4.2  rmind     if (ObjPointer)
    325  1.1.1.2.4.2  rmind     {
    326  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "Deleting Object Subptr %p\n",
    327  1.1.1.2.4.2  rmind             ObjPointer));
    328  1.1.1.2.4.2  rmind         ACPI_FREE (ObjPointer);
    329  1.1.1.2.4.2  rmind     }
    330  1.1.1.2.4.2  rmind 
    331  1.1.1.2.4.2  rmind     /* Now the object can be safely deleted */
    332  1.1.1.2.4.2  rmind 
    333  1.1.1.2.4.2  rmind     ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "Deleting Object %p [%s]\n",
    334  1.1.1.2.4.2  rmind         Object, AcpiUtGetObjectTypeName (Object)));
    335  1.1.1.2.4.2  rmind 
    336  1.1.1.2.4.2  rmind     AcpiUtDeleteObjectDesc (Object);
    337  1.1.1.2.4.2  rmind     return_VOID;
    338  1.1.1.2.4.2  rmind }
    339  1.1.1.2.4.2  rmind 
    340  1.1.1.2.4.2  rmind 
    341  1.1.1.2.4.2  rmind /*******************************************************************************
    342  1.1.1.2.4.2  rmind  *
    343  1.1.1.2.4.2  rmind  * FUNCTION:    AcpiUtDeleteInternalObjectList
    344  1.1.1.2.4.2  rmind  *
    345  1.1.1.2.4.2  rmind  * PARAMETERS:  ObjList         - Pointer to the list to be deleted
    346  1.1.1.2.4.2  rmind  *
    347  1.1.1.2.4.2  rmind  * RETURN:      None
    348  1.1.1.2.4.2  rmind  *
    349  1.1.1.2.4.2  rmind  * DESCRIPTION: This function deletes an internal object list, including both
    350  1.1.1.2.4.2  rmind  *              simple objects and package objects
    351  1.1.1.2.4.2  rmind  *
    352  1.1.1.2.4.2  rmind  ******************************************************************************/
    353  1.1.1.2.4.2  rmind 
    354  1.1.1.2.4.2  rmind void
    355  1.1.1.2.4.2  rmind AcpiUtDeleteInternalObjectList (
    356  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     **ObjList)
    357  1.1.1.2.4.2  rmind {
    358  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     **InternalObj;
    359  1.1.1.2.4.2  rmind 
    360  1.1.1.2.4.2  rmind 
    361  1.1.1.2.4.2  rmind     ACPI_FUNCTION_TRACE (UtDeleteInternalObjectList);
    362  1.1.1.2.4.2  rmind 
    363  1.1.1.2.4.2  rmind 
    364  1.1.1.2.4.2  rmind     /* Walk the null-terminated internal list */
    365  1.1.1.2.4.2  rmind 
    366  1.1.1.2.4.2  rmind     for (InternalObj = ObjList; *InternalObj; InternalObj++)
    367  1.1.1.2.4.2  rmind     {
    368  1.1.1.2.4.2  rmind         AcpiUtRemoveReference (*InternalObj);
    369  1.1.1.2.4.2  rmind     }
    370  1.1.1.2.4.2  rmind 
    371  1.1.1.2.4.2  rmind     /* Free the combined parameter pointer list and object array */
    372  1.1.1.2.4.2  rmind 
    373  1.1.1.2.4.2  rmind     ACPI_FREE (ObjList);
    374  1.1.1.2.4.2  rmind     return_VOID;
    375  1.1.1.2.4.2  rmind }
    376  1.1.1.2.4.2  rmind 
    377  1.1.1.2.4.2  rmind 
    378  1.1.1.2.4.2  rmind /*******************************************************************************
    379  1.1.1.2.4.2  rmind  *
    380  1.1.1.2.4.2  rmind  * FUNCTION:    AcpiUtUpdateRefCount
    381  1.1.1.2.4.2  rmind  *
    382  1.1.1.2.4.2  rmind  * PARAMETERS:  Object          - Object whose ref count is to be updated
    383  1.1.1.2.4.2  rmind  *              Action          - What to do
    384  1.1.1.2.4.2  rmind  *
    385  1.1.1.2.4.2  rmind  * RETURN:      New ref count
    386  1.1.1.2.4.2  rmind  *
    387  1.1.1.2.4.2  rmind  * DESCRIPTION: Modify the ref count and return it.
    388  1.1.1.2.4.2  rmind  *
    389  1.1.1.2.4.2  rmind  ******************************************************************************/
    390  1.1.1.2.4.2  rmind 
    391  1.1.1.2.4.2  rmind static void
    392  1.1.1.2.4.2  rmind AcpiUtUpdateRefCount (
    393  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object,
    394  1.1.1.2.4.2  rmind     UINT32                  Action)
    395  1.1.1.2.4.2  rmind {
    396  1.1.1.2.4.2  rmind     UINT16                  Count;
    397  1.1.1.2.4.2  rmind     UINT16                  NewCount;
    398  1.1.1.2.4.2  rmind 
    399  1.1.1.2.4.2  rmind 
    400  1.1.1.2.4.2  rmind     ACPI_FUNCTION_NAME (UtUpdateRefCount);
    401  1.1.1.2.4.2  rmind 
    402  1.1.1.2.4.2  rmind 
    403  1.1.1.2.4.2  rmind     if (!Object)
    404  1.1.1.2.4.2  rmind     {
    405  1.1.1.2.4.2  rmind         return;
    406  1.1.1.2.4.2  rmind     }
    407  1.1.1.2.4.2  rmind 
    408  1.1.1.2.4.2  rmind     Count = Object->Common.ReferenceCount;
    409  1.1.1.2.4.2  rmind     NewCount = Count;
    410  1.1.1.2.4.2  rmind 
    411  1.1.1.2.4.2  rmind     /*
    412  1.1.1.2.4.2  rmind      * Perform the reference count action (increment, decrement, force delete)
    413  1.1.1.2.4.2  rmind      */
    414  1.1.1.2.4.2  rmind     switch (Action)
    415  1.1.1.2.4.2  rmind     {
    416  1.1.1.2.4.2  rmind     case REF_INCREMENT:
    417  1.1.1.2.4.2  rmind 
    418  1.1.1.2.4.2  rmind         NewCount++;
    419  1.1.1.2.4.2  rmind         Object->Common.ReferenceCount = NewCount;
    420  1.1.1.2.4.2  rmind 
    421  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    422  1.1.1.2.4.2  rmind             "Obj %p Refs=%X, [Incremented]\n",
    423  1.1.1.2.4.2  rmind             Object, NewCount));
    424  1.1.1.2.4.2  rmind         break;
    425  1.1.1.2.4.2  rmind 
    426  1.1.1.2.4.2  rmind     case REF_DECREMENT:
    427  1.1.1.2.4.2  rmind 
    428  1.1.1.2.4.2  rmind         if (Count < 1)
    429  1.1.1.2.4.2  rmind         {
    430  1.1.1.2.4.2  rmind             ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    431  1.1.1.2.4.2  rmind                 "Obj %p Refs=%X, can't decrement! (Set to 0)\n",
    432  1.1.1.2.4.2  rmind                 Object, NewCount));
    433  1.1.1.2.4.2  rmind 
    434  1.1.1.2.4.2  rmind             NewCount = 0;
    435  1.1.1.2.4.2  rmind         }
    436  1.1.1.2.4.2  rmind         else
    437  1.1.1.2.4.2  rmind         {
    438  1.1.1.2.4.2  rmind             NewCount--;
    439  1.1.1.2.4.2  rmind 
    440  1.1.1.2.4.2  rmind             ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    441  1.1.1.2.4.2  rmind                 "Obj %p Refs=%X, [Decremented]\n",
    442  1.1.1.2.4.2  rmind                 Object, NewCount));
    443  1.1.1.2.4.2  rmind         }
    444  1.1.1.2.4.2  rmind 
    445  1.1.1.2.4.2  rmind         if (Object->Common.Type == ACPI_TYPE_METHOD)
    446  1.1.1.2.4.2  rmind         {
    447  1.1.1.2.4.2  rmind             ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    448  1.1.1.2.4.2  rmind                 "Method Obj %p Refs=%X, [Decremented]\n", Object, NewCount));
    449  1.1.1.2.4.2  rmind         }
    450  1.1.1.2.4.2  rmind 
    451  1.1.1.2.4.2  rmind         Object->Common.ReferenceCount = NewCount;
    452  1.1.1.2.4.2  rmind         if (NewCount == 0)
    453  1.1.1.2.4.2  rmind         {
    454  1.1.1.2.4.2  rmind             AcpiUtDeleteInternalObj (Object);
    455  1.1.1.2.4.2  rmind         }
    456  1.1.1.2.4.2  rmind         break;
    457  1.1.1.2.4.2  rmind 
    458  1.1.1.2.4.2  rmind     case REF_FORCE_DELETE:
    459  1.1.1.2.4.2  rmind 
    460  1.1.1.2.4.2  rmind         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    461  1.1.1.2.4.2  rmind             "Obj %p Refs=%X, Force delete! (Set to 0)\n", Object, Count));
    462  1.1.1.2.4.2  rmind 
    463  1.1.1.2.4.2  rmind         NewCount = 0;
    464  1.1.1.2.4.2  rmind         Object->Common.ReferenceCount = NewCount;
    465  1.1.1.2.4.2  rmind         AcpiUtDeleteInternalObj (Object);
    466  1.1.1.2.4.2  rmind         break;
    467  1.1.1.2.4.2  rmind 
    468  1.1.1.2.4.2  rmind     default:
    469  1.1.1.2.4.2  rmind 
    470  1.1.1.2.4.2  rmind         ACPI_ERROR ((AE_INFO, "Unknown action (0x%X)", Action));
    471  1.1.1.2.4.2  rmind         break;
    472  1.1.1.2.4.2  rmind     }
    473  1.1.1.2.4.2  rmind 
    474  1.1.1.2.4.2  rmind     /*
    475  1.1.1.2.4.2  rmind      * Sanity check the reference count, for debug purposes only.
    476  1.1.1.2.4.2  rmind      * (A deleted object will have a huge reference count)
    477  1.1.1.2.4.2  rmind      */
    478  1.1.1.2.4.2  rmind     if (Count > ACPI_MAX_REFERENCE_COUNT)
    479  1.1.1.2.4.2  rmind     {
    480  1.1.1.2.4.2  rmind         ACPI_WARNING ((AE_INFO,
    481  1.1.1.2.4.2  rmind             "Large Reference Count (0x%X) in object %p", Count, Object));
    482  1.1.1.2.4.2  rmind     }
    483  1.1.1.2.4.2  rmind }
    484  1.1.1.2.4.2  rmind 
    485  1.1.1.2.4.2  rmind 
    486  1.1.1.2.4.2  rmind /*******************************************************************************
    487  1.1.1.2.4.2  rmind  *
    488  1.1.1.2.4.2  rmind  * FUNCTION:    AcpiUtUpdateObjectReference
    489  1.1.1.2.4.2  rmind  *
    490  1.1.1.2.4.2  rmind  * PARAMETERS:  Object              - Increment ref count for this object
    491  1.1.1.2.4.2  rmind  *                                    and all sub-objects
    492  1.1.1.2.4.2  rmind  *              Action              - Either REF_INCREMENT or REF_DECREMENT or
    493  1.1.1.2.4.2  rmind  *                                    REF_FORCE_DELETE
    494  1.1.1.2.4.2  rmind  *
    495  1.1.1.2.4.2  rmind  * RETURN:      Status
    496  1.1.1.2.4.2  rmind  *
    497  1.1.1.2.4.2  rmind  * DESCRIPTION: Increment the object reference count
    498  1.1.1.2.4.2  rmind  *
    499  1.1.1.2.4.2  rmind  * Object references are incremented when:
    500  1.1.1.2.4.2  rmind  * 1) An object is attached to a Node (namespace object)
    501  1.1.1.2.4.2  rmind  * 2) An object is copied (all subobjects must be incremented)
    502  1.1.1.2.4.2  rmind  *
    503  1.1.1.2.4.2  rmind  * Object references are decremented when:
    504  1.1.1.2.4.2  rmind  * 1) An object is detached from an Node
    505  1.1.1.2.4.2  rmind  *
    506  1.1.1.2.4.2  rmind  ******************************************************************************/
    507  1.1.1.2.4.2  rmind 
    508  1.1.1.2.4.2  rmind ACPI_STATUS
    509  1.1.1.2.4.2  rmind AcpiUtUpdateObjectReference (
    510  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object,
    511  1.1.1.2.4.2  rmind     UINT16                  Action)
    512  1.1.1.2.4.2  rmind {
    513  1.1.1.2.4.2  rmind     ACPI_STATUS             Status = AE_OK;
    514  1.1.1.2.4.2  rmind     ACPI_GENERIC_STATE      *StateList = NULL;
    515  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *NextObject = NULL;
    516  1.1.1.2.4.2  rmind     ACPI_GENERIC_STATE      *State;
    517  1.1.1.2.4.2  rmind     UINT32                  i;
    518  1.1.1.2.4.2  rmind 
    519  1.1.1.2.4.2  rmind 
    520  1.1.1.2.4.2  rmind     ACPI_FUNCTION_TRACE_PTR (UtUpdateObjectReference, Object);
    521  1.1.1.2.4.2  rmind 
    522  1.1.1.2.4.2  rmind 
    523  1.1.1.2.4.2  rmind     while (Object)
    524  1.1.1.2.4.2  rmind     {
    525  1.1.1.2.4.2  rmind         /* Make sure that this isn't a namespace handle */
    526  1.1.1.2.4.2  rmind 
    527  1.1.1.2.4.2  rmind         if (ACPI_GET_DESCRIPTOR_TYPE (Object) == ACPI_DESC_TYPE_NAMED)
    528  1.1.1.2.4.2  rmind         {
    529  1.1.1.2.4.2  rmind             ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    530  1.1.1.2.4.2  rmind                 "Object %p is NS handle\n", Object));
    531  1.1.1.2.4.2  rmind             return_ACPI_STATUS (AE_OK);
    532  1.1.1.2.4.2  rmind         }
    533  1.1.1.2.4.2  rmind 
    534  1.1.1.2.4.2  rmind         /*
    535  1.1.1.2.4.2  rmind          * All sub-objects must have their reference count incremented also.
    536  1.1.1.2.4.2  rmind          * Different object types have different subobjects.
    537  1.1.1.2.4.2  rmind          */
    538  1.1.1.2.4.2  rmind         switch (Object->Common.Type)
    539  1.1.1.2.4.2  rmind         {
    540  1.1.1.2.4.2  rmind         case ACPI_TYPE_DEVICE:
    541  1.1.1.2.4.2  rmind         case ACPI_TYPE_PROCESSOR:
    542  1.1.1.2.4.2  rmind         case ACPI_TYPE_POWER:
    543  1.1.1.2.4.2  rmind         case ACPI_TYPE_THERMAL:
    544  1.1.1.2.4.2  rmind 
    545  1.1.1.2.4.2  rmind             /* Update the notify objects for these types (if present) */
    546  1.1.1.2.4.2  rmind 
    547  1.1.1.2.4.2  rmind             AcpiUtUpdateRefCount (Object->CommonNotify.SystemNotify, Action);
    548  1.1.1.2.4.2  rmind             AcpiUtUpdateRefCount (Object->CommonNotify.DeviceNotify, Action);
    549  1.1.1.2.4.2  rmind             break;
    550  1.1.1.2.4.2  rmind 
    551  1.1.1.2.4.2  rmind         case ACPI_TYPE_PACKAGE:
    552  1.1.1.2.4.2  rmind             /*
    553  1.1.1.2.4.2  rmind              * We must update all the sub-objects of the package,
    554  1.1.1.2.4.2  rmind              * each of whom may have their own sub-objects.
    555  1.1.1.2.4.2  rmind              */
    556  1.1.1.2.4.2  rmind             for (i = 0; i < Object->Package.Count; i++)
    557  1.1.1.2.4.2  rmind             {
    558  1.1.1.2.4.2  rmind                 /*
    559  1.1.1.2.4.2  rmind                  * Push each element onto the stack for later processing.
    560  1.1.1.2.4.2  rmind                  * Note: There can be null elements within the package,
    561  1.1.1.2.4.2  rmind                  * these are simply ignored
    562  1.1.1.2.4.2  rmind                  */
    563  1.1.1.2.4.2  rmind                 Status = AcpiUtCreateUpdateStateAndPush (
    564  1.1.1.2.4.2  rmind                             Object->Package.Elements[i], Action, &StateList);
    565  1.1.1.2.4.2  rmind                 if (ACPI_FAILURE (Status))
    566  1.1.1.2.4.2  rmind                 {
    567  1.1.1.2.4.2  rmind                     goto ErrorExit;
    568  1.1.1.2.4.2  rmind                 }
    569  1.1.1.2.4.2  rmind             }
    570  1.1.1.2.4.2  rmind             break;
    571  1.1.1.2.4.2  rmind 
    572  1.1.1.2.4.2  rmind         case ACPI_TYPE_BUFFER_FIELD:
    573  1.1.1.2.4.2  rmind 
    574  1.1.1.2.4.2  rmind             NextObject = Object->BufferField.BufferObj;
    575  1.1.1.2.4.2  rmind             break;
    576  1.1.1.2.4.2  rmind 
    577  1.1.1.2.4.2  rmind         case ACPI_TYPE_LOCAL_REGION_FIELD:
    578  1.1.1.2.4.2  rmind 
    579  1.1.1.2.4.2  rmind             NextObject = Object->Field.RegionObj;
    580  1.1.1.2.4.2  rmind             break;
    581  1.1.1.2.4.2  rmind 
    582  1.1.1.2.4.2  rmind         case ACPI_TYPE_LOCAL_BANK_FIELD:
    583  1.1.1.2.4.2  rmind 
    584  1.1.1.2.4.2  rmind             NextObject = Object->BankField.BankObj;
    585  1.1.1.2.4.2  rmind             Status = AcpiUtCreateUpdateStateAndPush (
    586  1.1.1.2.4.2  rmind                         Object->BankField.RegionObj, Action, &StateList);
    587  1.1.1.2.4.2  rmind             if (ACPI_FAILURE (Status))
    588  1.1.1.2.4.2  rmind             {
    589  1.1.1.2.4.2  rmind                 goto ErrorExit;
    590  1.1.1.2.4.2  rmind             }
    591  1.1.1.2.4.2  rmind             break;
    592  1.1.1.2.4.2  rmind 
    593  1.1.1.2.4.2  rmind         case ACPI_TYPE_LOCAL_INDEX_FIELD:
    594  1.1.1.2.4.2  rmind 
    595  1.1.1.2.4.2  rmind             NextObject = Object->IndexField.IndexObj;
    596  1.1.1.2.4.2  rmind             Status = AcpiUtCreateUpdateStateAndPush (
    597  1.1.1.2.4.2  rmind                         Object->IndexField.DataObj, Action, &StateList);
    598  1.1.1.2.4.2  rmind             if (ACPI_FAILURE (Status))
    599  1.1.1.2.4.2  rmind             {
    600  1.1.1.2.4.2  rmind                 goto ErrorExit;
    601  1.1.1.2.4.2  rmind             }
    602  1.1.1.2.4.2  rmind             break;
    603  1.1.1.2.4.2  rmind 
    604  1.1.1.2.4.2  rmind         case ACPI_TYPE_LOCAL_REFERENCE:
    605  1.1.1.2.4.2  rmind             /*
    606  1.1.1.2.4.2  rmind              * The target of an Index (a package, string, or buffer) or a named
    607  1.1.1.2.4.2  rmind              * reference must track changes to the ref count of the index or
    608  1.1.1.2.4.2  rmind              * target object.
    609  1.1.1.2.4.2  rmind              */
    610  1.1.1.2.4.2  rmind             if ((Object->Reference.Class == ACPI_REFCLASS_INDEX) ||
    611  1.1.1.2.4.2  rmind                 (Object->Reference.Class== ACPI_REFCLASS_NAME))
    612  1.1.1.2.4.2  rmind             {
    613  1.1.1.2.4.2  rmind                 NextObject = Object->Reference.Object;
    614  1.1.1.2.4.2  rmind             }
    615  1.1.1.2.4.2  rmind             break;
    616  1.1.1.2.4.2  rmind 
    617  1.1.1.2.4.2  rmind         case ACPI_TYPE_REGION:
    618  1.1.1.2.4.2  rmind         default:
    619  1.1.1.2.4.2  rmind             break; /* No subobjects for all other types */
    620  1.1.1.2.4.2  rmind         }
    621  1.1.1.2.4.2  rmind 
    622  1.1.1.2.4.2  rmind         /*
    623  1.1.1.2.4.2  rmind          * Now we can update the count in the main object. This can only
    624  1.1.1.2.4.2  rmind          * happen after we update the sub-objects in case this causes the
    625  1.1.1.2.4.2  rmind          * main object to be deleted.
    626  1.1.1.2.4.2  rmind          */
    627  1.1.1.2.4.2  rmind         AcpiUtUpdateRefCount (Object, Action);
    628  1.1.1.2.4.2  rmind         Object = NULL;
    629  1.1.1.2.4.2  rmind 
    630  1.1.1.2.4.2  rmind         /* Move on to the next object to be updated */
    631  1.1.1.2.4.2  rmind 
    632  1.1.1.2.4.2  rmind         if (NextObject)
    633  1.1.1.2.4.2  rmind         {
    634  1.1.1.2.4.2  rmind             Object = NextObject;
    635  1.1.1.2.4.2  rmind             NextObject = NULL;
    636  1.1.1.2.4.2  rmind         }
    637  1.1.1.2.4.2  rmind         else if (StateList)
    638  1.1.1.2.4.2  rmind         {
    639  1.1.1.2.4.2  rmind             State = AcpiUtPopGenericState (&StateList);
    640  1.1.1.2.4.2  rmind             Object = State->Update.Object;
    641  1.1.1.2.4.2  rmind             AcpiUtDeleteGenericState (State);
    642  1.1.1.2.4.2  rmind         }
    643  1.1.1.2.4.2  rmind     }
    644  1.1.1.2.4.2  rmind 
    645  1.1.1.2.4.2  rmind     return_ACPI_STATUS (AE_OK);
    646  1.1.1.2.4.2  rmind 
    647  1.1.1.2.4.2  rmind 
    648  1.1.1.2.4.2  rmind ErrorExit:
    649  1.1.1.2.4.2  rmind 
    650  1.1.1.2.4.2  rmind     ACPI_EXCEPTION ((AE_INFO, Status,
    651  1.1.1.2.4.2  rmind         "Could not update object reference count"));
    652  1.1.1.2.4.2  rmind 
    653  1.1.1.2.4.2  rmind     /* Free any stacked Update State objects */
    654  1.1.1.2.4.2  rmind 
    655  1.1.1.2.4.2  rmind     while (StateList)
    656  1.1.1.2.4.2  rmind     {
    657  1.1.1.2.4.2  rmind         State = AcpiUtPopGenericState (&StateList);
    658  1.1.1.2.4.2  rmind         AcpiUtDeleteGenericState (State);
    659  1.1.1.2.4.2  rmind     }
    660  1.1.1.2.4.2  rmind 
    661  1.1.1.2.4.2  rmind     return_ACPI_STATUS (Status);
    662  1.1.1.2.4.2  rmind }
    663  1.1.1.2.4.2  rmind 
    664  1.1.1.2.4.2  rmind 
    665  1.1.1.2.4.2  rmind /*******************************************************************************
    666  1.1.1.2.4.2  rmind  *
    667  1.1.1.2.4.2  rmind  * FUNCTION:    AcpiUtAddReference
    668  1.1.1.2.4.2  rmind  *
    669  1.1.1.2.4.2  rmind  * PARAMETERS:  Object          - Object whose reference count is to be
    670  1.1.1.2.4.2  rmind  *                                incremented
    671  1.1.1.2.4.2  rmind  *
    672  1.1.1.2.4.2  rmind  * RETURN:      None
    673  1.1.1.2.4.2  rmind  *
    674  1.1.1.2.4.2  rmind  * DESCRIPTION: Add one reference to an ACPI object
    675  1.1.1.2.4.2  rmind  *
    676  1.1.1.2.4.2  rmind  ******************************************************************************/
    677  1.1.1.2.4.2  rmind 
    678  1.1.1.2.4.2  rmind void
    679  1.1.1.2.4.2  rmind AcpiUtAddReference (
    680  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object)
    681  1.1.1.2.4.2  rmind {
    682  1.1.1.2.4.2  rmind 
    683  1.1.1.2.4.2  rmind     ACPI_FUNCTION_TRACE_PTR (UtAddReference, Object);
    684  1.1.1.2.4.2  rmind 
    685  1.1.1.2.4.2  rmind 
    686  1.1.1.2.4.2  rmind     /* Ensure that we have a valid object */
    687  1.1.1.2.4.2  rmind 
    688  1.1.1.2.4.2  rmind     if (!AcpiUtValidInternalObject (Object))
    689  1.1.1.2.4.2  rmind     {
    690  1.1.1.2.4.2  rmind         return_VOID;
    691  1.1.1.2.4.2  rmind     }
    692  1.1.1.2.4.2  rmind 
    693  1.1.1.2.4.2  rmind     ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    694  1.1.1.2.4.2  rmind         "Obj %p Current Refs=%X [To Be Incremented]\n",
    695  1.1.1.2.4.2  rmind         Object, Object->Common.ReferenceCount));
    696  1.1.1.2.4.2  rmind 
    697  1.1.1.2.4.2  rmind     /* Increment the reference count */
    698  1.1.1.2.4.2  rmind 
    699  1.1.1.2.4.2  rmind     (void) AcpiUtUpdateObjectReference (Object, REF_INCREMENT);
    700  1.1.1.2.4.2  rmind     return_VOID;
    701  1.1.1.2.4.2  rmind }
    702  1.1.1.2.4.2  rmind 
    703  1.1.1.2.4.2  rmind 
    704  1.1.1.2.4.2  rmind /*******************************************************************************
    705  1.1.1.2.4.2  rmind  *
    706  1.1.1.2.4.2  rmind  * FUNCTION:    AcpiUtRemoveReference
    707  1.1.1.2.4.2  rmind  *
    708  1.1.1.2.4.2  rmind  * PARAMETERS:  Object         - Object whose ref count will be decremented
    709  1.1.1.2.4.2  rmind  *
    710  1.1.1.2.4.2  rmind  * RETURN:      None
    711  1.1.1.2.4.2  rmind  *
    712  1.1.1.2.4.2  rmind  * DESCRIPTION: Decrement the reference count of an ACPI internal object
    713  1.1.1.2.4.2  rmind  *
    714  1.1.1.2.4.2  rmind  ******************************************************************************/
    715  1.1.1.2.4.2  rmind 
    716  1.1.1.2.4.2  rmind void
    717  1.1.1.2.4.2  rmind AcpiUtRemoveReference (
    718  1.1.1.2.4.2  rmind     ACPI_OPERAND_OBJECT     *Object)
    719  1.1.1.2.4.2  rmind {
    720  1.1.1.2.4.2  rmind 
    721  1.1.1.2.4.2  rmind     ACPI_FUNCTION_TRACE_PTR (UtRemoveReference, Object);
    722  1.1.1.2.4.2  rmind 
    723  1.1.1.2.4.2  rmind 
    724  1.1.1.2.4.2  rmind     /*
    725  1.1.1.2.4.2  rmind      * Allow a NULL pointer to be passed in, just ignore it. This saves
    726  1.1.1.2.4.2  rmind      * each caller from having to check. Also, ignore NS nodes.
    727  1.1.1.2.4.2  rmind      *
    728  1.1.1.2.4.2  rmind      */
    729  1.1.1.2.4.2  rmind     if (!Object ||
    730  1.1.1.2.4.2  rmind         (ACPI_GET_DESCRIPTOR_TYPE (Object) == ACPI_DESC_TYPE_NAMED))
    731  1.1.1.2.4.2  rmind 
    732  1.1.1.2.4.2  rmind     {
    733  1.1.1.2.4.2  rmind         return_VOID;
    734  1.1.1.2.4.2  rmind     }
    735  1.1.1.2.4.2  rmind 
    736  1.1.1.2.4.2  rmind     /* Ensure that we have a valid object */
    737  1.1.1.2.4.2  rmind 
    738  1.1.1.2.4.2  rmind     if (!AcpiUtValidInternalObject (Object))
    739  1.1.1.2.4.2  rmind     {
    740  1.1.1.2.4.2  rmind         return_VOID;
    741  1.1.1.2.4.2  rmind     }
    742  1.1.1.2.4.2  rmind 
    743  1.1.1.2.4.2  rmind     ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS,
    744  1.1.1.2.4.2  rmind         "Obj %p Current Refs=%X [To Be Decremented]\n",
    745  1.1.1.2.4.2  rmind         Object, Object->Common.ReferenceCount));
    746  1.1.1.2.4.2  rmind 
    747  1.1.1.2.4.2  rmind     /*
    748  1.1.1.2.4.2  rmind      * Decrement the reference count, and only actually delete the object
    749  1.1.1.2.4.2  rmind      * if the reference count becomes 0. (Must also decrement the ref count
    750  1.1.1.2.4.2  rmind      * of all subobjects!)
    751  1.1.1.2.4.2  rmind      */
    752  1.1.1.2.4.2  rmind     (void) AcpiUtUpdateObjectReference (Object, REF_DECREMENT);
    753  1.1.1.2.4.2  rmind     return_VOID;
    754  1.1.1.2.4.2  rmind }
    755  1.1.1.2.4.2  rmind 
    756  1.1.1.2.4.2  rmind 
    757