Print this page
update to acpica-unix2-20131218
acpica-unix2-20130823
PANKOVs restructure
   1 /******************************************************************************
   2  *
   3  * Module Name: utcache - local cache allocation routines
   4  *
   5  *****************************************************************************/
   6 
   7 /*
   8  * Copyright (C) 2000 - 2011, Intel Corp.
   9  * All rights reserved.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions, and the following disclaimer,
  16  *    without modification.
  17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  18  *    substantially similar to the "NO WARRANTY" disclaimer below
  19  *    ("Disclaimer") and any redistribution must be conditioned upon
  20  *    including a substantially similar Disclaimer requirement for further
  21  *    binary redistribution.
  22  * 3. Neither the names of the above-listed copyright holders nor the names
  23  *    of any contributors may be used to endorse or promote products derived
  24  *    from this software without specific prior written permission.
  25  *
  26  * Alternatively, this software may be distributed under the terms of the
  27  * GNU General Public License ("GPL") version 2 as published by the Free
  28  * Software Foundation.


  78 
  79     ACPI_FUNCTION_ENTRY ();
  80 
  81 
  82     if (!CacheName || !ReturnCache || (ObjectSize < 16))
  83     {
  84         return (AE_BAD_PARAMETER);
  85     }
  86 
  87     /* Create the cache object */
  88 
  89     Cache = AcpiOsAllocate (sizeof (ACPI_MEMORY_LIST));
  90     if (!Cache)
  91     {
  92         return (AE_NO_MEMORY);
  93     }
  94 
  95     /* Populate the cache object and return it */
  96 
  97     ACPI_MEMSET (Cache, 0, sizeof (ACPI_MEMORY_LIST));
  98     Cache->LinkOffset = 8;
  99     Cache->ListName   = CacheName;
 100     Cache->ObjectSize = ObjectSize;
 101     Cache->MaxDepth   = MaxDepth;
 102 
 103     *ReturnCache = Cache;
 104     return (AE_OK);
 105 }
 106 
 107 
 108 /*******************************************************************************
 109  *
 110  * FUNCTION:    AcpiOsPurgeCache
 111  *
 112  * PARAMETERS:  Cache           - Handle to cache object
 113  *
 114  * RETURN:      Status
 115  *
 116  * DESCRIPTION: Free all objects within the requested cache.
 117  *
 118  ******************************************************************************/
 119 
 120 ACPI_STATUS
 121 AcpiOsPurgeCache (
 122     ACPI_MEMORY_LIST        *Cache)
 123 {
 124     char                    *Next;
 125     ACPI_STATUS             Status;
 126 
 127 
 128     ACPI_FUNCTION_ENTRY ();
 129 
 130 
 131     if (!Cache)
 132     {
 133         return (AE_BAD_PARAMETER);
 134     }
 135 
 136     Status = AcpiUtAcquireMutex (ACPI_MTX_CACHES);
 137     if (ACPI_FAILURE (Status))
 138     {
 139         return (Status);
 140     }
 141 
 142     /* Walk the list of objects in this cache */
 143 
 144     while (Cache->ListHead)
 145     {
 146         /* Delete and unlink one cached state object */
 147 
 148         Next = *(ACPI_CAST_INDIRECT_PTR (char,
 149                     &(((char *) Cache->ListHead)[Cache->LinkOffset])));
 150         ACPI_FREE (Cache->ListHead);
 151 
 152         Cache->ListHead = Next;
 153         Cache->CurrentDepth--;
 154     }
 155 
 156     (void) AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 157     return (AE_OK);
 158 }
 159 
 160 
 161 /*******************************************************************************
 162  *
 163  * FUNCTION:    AcpiOsDeleteCache
 164  *
 165  * PARAMETERS:  Cache           - Handle to cache object
 166  *
 167  * RETURN:      Status
 168  *
 169  * DESCRIPTION: Free all objects within the requested cache and delete the


 234         ACPI_MEM_TRACKING (Cache->TotalFreed++);
 235     }
 236 
 237     /* Otherwise put this object back into the cache */
 238 
 239     else
 240     {
 241         Status = AcpiUtAcquireMutex (ACPI_MTX_CACHES);
 242         if (ACPI_FAILURE (Status))
 243         {
 244             return (Status);
 245         }
 246 
 247         /* Mark the object as cached */
 248 
 249         ACPI_MEMSET (Object, 0xCA, Cache->ObjectSize);
 250         ACPI_SET_DESCRIPTOR_TYPE (Object, ACPI_DESC_TYPE_CACHED);
 251 
 252         /* Put the object at the head of the cache list */
 253 
 254         * (ACPI_CAST_INDIRECT_PTR (char,
 255             &(((char *) Object)[Cache->LinkOffset]))) = Cache->ListHead;
 256         Cache->ListHead = Object;
 257         Cache->CurrentDepth++;
 258 
 259         (void) AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 260     }
 261 
 262     return (AE_OK);
 263 }
 264 
 265 
 266 /*******************************************************************************
 267  *
 268  * FUNCTION:    AcpiOsAcquireObject
 269  *
 270  * PARAMETERS:  Cache           - Handle to cache object
 271  *
 272  * RETURN:      the acquired object.  NULL on error
 273  *
 274  * DESCRIPTION: Get an object from the specified cache.  If cache is empty,
 275  *              the object is allocated.
 276  *
 277  ******************************************************************************/
 278 
 279 void *
 280 AcpiOsAcquireObject (
 281     ACPI_MEMORY_LIST        *Cache)
 282 {
 283     ACPI_STATUS             Status;
 284     void                    *Object;
 285 
 286 
 287     ACPI_FUNCTION_NAME (OsAcquireObject);
 288 
 289 
 290     if (!Cache)
 291     {
 292         return (NULL);
 293     }
 294 
 295     Status = AcpiUtAcquireMutex (ACPI_MTX_CACHES);
 296     if (ACPI_FAILURE (Status))
 297     {
 298         return (NULL);
 299     }
 300 
 301     ACPI_MEM_TRACKING (Cache->Requests++);
 302 
 303     /* Check the cache first */
 304 
 305     if (Cache->ListHead)
 306     {
 307         /* There is an object available, use it */
 308 
 309         Object = Cache->ListHead;
 310         Cache->ListHead = *(ACPI_CAST_INDIRECT_PTR (char,
 311                                 &(((char *) Object)[Cache->LinkOffset])));
 312 
 313         Cache->CurrentDepth--;
 314 
 315         ACPI_MEM_TRACKING (Cache->Hits++);
 316         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
 317             "Object %p from %s cache\n", Object, Cache->ListName));
 318 
 319         Status = AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 320         if (ACPI_FAILURE (Status))
 321         {
 322             return (NULL);
 323         }
 324 
 325         /* Clear (zero) the previously used Object */
 326 
 327         ACPI_MEMSET (Object, 0, Cache->ObjectSize);
 328     }
 329     else
 330     {
 331         /* The cache is empty, create a new object */
 332 
 333         ACPI_MEM_TRACKING (Cache->TotalAllocated++);
 334 
 335 #ifdef ACPI_DBG_TRACK_ALLOCATIONS
 336         if ((Cache->TotalAllocated - Cache->TotalFreed) > Cache->MaxOccupied)
 337         {
 338             Cache->MaxOccupied = Cache->TotalAllocated - Cache->TotalFreed;
 339         }
 340 #endif
 341 
 342         /* Avoid deadlock with ACPI_ALLOCATE_ZEROED */
 343 
 344         Status = AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 345         if (ACPI_FAILURE (Status))
 346         {
 347             return (NULL);
 348         }
 349 
 350         Object = ACPI_ALLOCATE_ZEROED (Cache->ObjectSize);
 351         if (!Object)
 352         {
 353             return (NULL);
 354         }
 355     }
 356 
 357     return (Object);
 358 }
 359 #endif /* ACPI_USE_LOCAL_CACHE */
 360 
 361 
   1 /******************************************************************************
   2  *
   3  * Module Name: utcache - local cache allocation routines
   4  *
   5  *****************************************************************************/
   6 
   7 /*
   8  * Copyright (C) 2000 - 2013, Intel Corp.
   9  * All rights reserved.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions, and the following disclaimer,
  16  *    without modification.
  17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  18  *    substantially similar to the "NO WARRANTY" disclaimer below
  19  *    ("Disclaimer") and any redistribution must be conditioned upon
  20  *    including a substantially similar Disclaimer requirement for further
  21  *    binary redistribution.
  22  * 3. Neither the names of the above-listed copyright holders nor the names
  23  *    of any contributors may be used to endorse or promote products derived
  24  *    from this software without specific prior written permission.
  25  *
  26  * Alternatively, this software may be distributed under the terms of the
  27  * GNU General Public License ("GPL") version 2 as published by the Free
  28  * Software Foundation.


  78 
  79     ACPI_FUNCTION_ENTRY ();
  80 
  81 
  82     if (!CacheName || !ReturnCache || (ObjectSize < 16))
  83     {
  84         return (AE_BAD_PARAMETER);
  85     }
  86 
  87     /* Create the cache object */
  88 
  89     Cache = AcpiOsAllocate (sizeof (ACPI_MEMORY_LIST));
  90     if (!Cache)
  91     {
  92         return (AE_NO_MEMORY);
  93     }
  94 
  95     /* Populate the cache object and return it */
  96 
  97     ACPI_MEMSET (Cache, 0, sizeof (ACPI_MEMORY_LIST));

  98     Cache->ListName   = CacheName;
  99     Cache->ObjectSize = ObjectSize;
 100     Cache->MaxDepth   = MaxDepth;
 101 
 102     *ReturnCache = Cache;
 103     return (AE_OK);
 104 }
 105 
 106 
 107 /*******************************************************************************
 108  *
 109  * FUNCTION:    AcpiOsPurgeCache
 110  *
 111  * PARAMETERS:  Cache           - Handle to cache object
 112  *
 113  * RETURN:      Status
 114  *
 115  * DESCRIPTION: Free all objects within the requested cache.
 116  *
 117  ******************************************************************************/
 118 
 119 ACPI_STATUS
 120 AcpiOsPurgeCache (
 121     ACPI_MEMORY_LIST        *Cache)
 122 {
 123     void                    *Next;
 124     ACPI_STATUS             Status;
 125 
 126 
 127     ACPI_FUNCTION_ENTRY ();
 128 
 129 
 130     if (!Cache)
 131     {
 132         return (AE_BAD_PARAMETER);
 133     }
 134 
 135     Status = AcpiUtAcquireMutex (ACPI_MTX_CACHES);
 136     if (ACPI_FAILURE (Status))
 137     {
 138         return (Status);
 139     }
 140 
 141     /* Walk the list of objects in this cache */
 142 
 143     while (Cache->ListHead)
 144     {
 145         /* Delete and unlink one cached state object */
 146 
 147         Next = ACPI_GET_DESCRIPTOR_PTR (Cache->ListHead);

 148         ACPI_FREE (Cache->ListHead);
 149 
 150         Cache->ListHead = Next;
 151         Cache->CurrentDepth--;
 152     }
 153 
 154     (void) AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 155     return (AE_OK);
 156 }
 157 
 158 
 159 /*******************************************************************************
 160  *
 161  * FUNCTION:    AcpiOsDeleteCache
 162  *
 163  * PARAMETERS:  Cache           - Handle to cache object
 164  *
 165  * RETURN:      Status
 166  *
 167  * DESCRIPTION: Free all objects within the requested cache and delete the


 232         ACPI_MEM_TRACKING (Cache->TotalFreed++);
 233     }
 234 
 235     /* Otherwise put this object back into the cache */
 236 
 237     else
 238     {
 239         Status = AcpiUtAcquireMutex (ACPI_MTX_CACHES);
 240         if (ACPI_FAILURE (Status))
 241         {
 242             return (Status);
 243         }
 244 
 245         /* Mark the object as cached */
 246 
 247         ACPI_MEMSET (Object, 0xCA, Cache->ObjectSize);
 248         ACPI_SET_DESCRIPTOR_TYPE (Object, ACPI_DESC_TYPE_CACHED);
 249 
 250         /* Put the object at the head of the cache list */
 251 
 252         ACPI_SET_DESCRIPTOR_PTR (Object, Cache->ListHead);

 253         Cache->ListHead = Object;
 254         Cache->CurrentDepth++;
 255 
 256         (void) AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 257     }
 258 
 259     return (AE_OK);
 260 }
 261 
 262 
 263 /*******************************************************************************
 264  *
 265  * FUNCTION:    AcpiOsAcquireObject
 266  *
 267  * PARAMETERS:  Cache           - Handle to cache object
 268  *
 269  * RETURN:      the acquired object. NULL on error
 270  *
 271  * DESCRIPTION: Get an object from the specified cache. If cache is empty,
 272  *              the object is allocated.
 273  *
 274  ******************************************************************************/
 275 
 276 void *
 277 AcpiOsAcquireObject (
 278     ACPI_MEMORY_LIST        *Cache)
 279 {
 280     ACPI_STATUS             Status;
 281     void                    *Object;
 282 
 283 
 284     ACPI_FUNCTION_NAME (OsAcquireObject);
 285 
 286 
 287     if (!Cache)
 288     {
 289         return_PTR (NULL);
 290     }
 291 
 292     Status = AcpiUtAcquireMutex (ACPI_MTX_CACHES);
 293     if (ACPI_FAILURE (Status))
 294     {
 295         return_PTR (NULL);
 296     }
 297 
 298     ACPI_MEM_TRACKING (Cache->Requests++);
 299 
 300     /* Check the cache first */
 301 
 302     if (Cache->ListHead)
 303     {
 304         /* There is an object available, use it */
 305 
 306         Object = Cache->ListHead;
 307         Cache->ListHead = ACPI_GET_DESCRIPTOR_PTR (Object);

 308 
 309         Cache->CurrentDepth--;
 310 
 311         ACPI_MEM_TRACKING (Cache->Hits++);
 312         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
 313             "Object %p from %s cache\n", Object, Cache->ListName));
 314 
 315         Status = AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 316         if (ACPI_FAILURE (Status))
 317         {
 318             return_PTR (NULL);
 319         }
 320 
 321         /* Clear (zero) the previously used Object */
 322 
 323         ACPI_MEMSET (Object, 0, Cache->ObjectSize);
 324     }
 325     else
 326     {
 327         /* The cache is empty, create a new object */
 328 
 329         ACPI_MEM_TRACKING (Cache->TotalAllocated++);
 330 
 331 #ifdef ACPI_DBG_TRACK_ALLOCATIONS
 332         if ((Cache->TotalAllocated - Cache->TotalFreed) > Cache->MaxOccupied)
 333         {
 334             Cache->MaxOccupied = Cache->TotalAllocated - Cache->TotalFreed;
 335         }
 336 #endif
 337 
 338         /* Avoid deadlock with ACPI_ALLOCATE_ZEROED */
 339 
 340         Status = AcpiUtReleaseMutex (ACPI_MTX_CACHES);
 341         if (ACPI_FAILURE (Status))
 342         {
 343             return_PTR (NULL);
 344         }
 345 
 346         Object = ACPI_ALLOCATE_ZEROED (Cache->ObjectSize);
 347         if (!Object)
 348         {
 349             return_PTR (NULL);
 350         }
 351     }
 352 
 353     return_PTR (Object);
 354 }
 355 #endif /* ACPI_USE_LOCAL_CACHE */