HeapSource.h revision e168ebd5a7cfc57936c16ff7d7f7063e967bdb9d
12ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 22ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 32ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * 42ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 52ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * you may not use this file except in compliance with the License. 62ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * You may obtain a copy of the License at 72ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * 82ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 92ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * 102ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 112ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 122ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 132ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * See the License for the specific language governing permissions and 142ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * limitations under the License. 152ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 162ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project#ifndef _DALVIK_HEAP_SOURCE 172ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project#define _DALVIK_HEAP_SOURCE 182ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 19d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro#include "alloc/Heap.h" 202ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project#include "alloc/HeapInternal.h" // for GcHeap 212ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 222ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* dlmalloc uses one size_t per allocated chunk. 232ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 242ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project#define HEAP_SOURCE_CHUNK_OVERHEAD (1 * sizeof (size_t)) 252ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project#define HEAP_SOURCE_WORST_CHUNK_OVERHEAD (32 * sizeof (size_t)) 262ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 272ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* The largest number of separate heaps we can handle. 282ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 29c8e06c8dba30f01d3cf6506c553041c340b312afCarl Shapiro#define HEAP_SOURCE_MAX_HEAP_COUNT 2 302ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 312ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 322ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Initializes the heap source; must be called before any other 332ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * dvmHeapSource*() functions. 342ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 352ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source ProjectGcHeap *dvmHeapSourceStartup(size_t startSize, size_t absoluteMaxSize); 362ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 372ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 382ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * If the HeapSource was created while in zygote mode, this 392ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * will create an additional zygote heap before the first fork(). 402ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Having a separate heap should reduce the number of shared 412ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * pages subsequently touched by the zygote process. 422ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 432ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectbool dvmHeapSourceStartupBeforeFork(void); 442ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 452ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 462ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Tears down the heap source and frees any resources associated with it. 472ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 48a199eb70871a8c142a723d76b1b08939286a3199Carl Shapirovoid dvmHeapSourceShutdown(GcHeap **gcHeap); 492ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 502ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 51f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapiro * Initializes a vector of object and mark bits to the object and mark 52e168ebd5a7cfc57936c16ff7d7f7063e967bdb9dBarry Hayes * bits of each heap. 532ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 54f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapirovoid dvmHeapSourceGetObjectBitmaps(HeapBitmap objBits[], HeapBitmap markBits[], 55f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapiro size_t numHeaps); 562ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 572ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 58962adba4e5db286a36bc8024f5c023bcf6f29312Barry Hayes * Get the bitmap representing all live objects. 59962adba4e5db286a36bc8024f5c023bcf6f29312Barry Hayes */ 60962adba4e5db286a36bc8024f5c023bcf6f29312Barry HayesHeapBitmap *dvmHeapSourceGetLiveBits(); 61962adba4e5db286a36bc8024f5c023bcf6f29312Barry Hayes 62962adba4e5db286a36bc8024f5c023bcf6f29312Barry Hayes/* 632ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Returns the requested value. If the per-heap stats are requested, fill 642ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * them as well. 652ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 662ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectenum HeapSourceValueSpec { 672ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_FOOTPRINT, 682ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_ALLOWED_FOOTPRINT, 692ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_BYTES_ALLOCATED, 702ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_OBJECTS_ALLOCATED, 712ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_EXTERNAL_BYTES_ALLOCATED, 722ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_EXTERNAL_LIMIT 732ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project}; 742ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectsize_t dvmHeapSourceGetValue(enum HeapSourceValueSpec spec, 752ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project size_t perHeapStats[], size_t arrayLen); 762ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 772ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 782ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Allocates <n> bytes of zeroed data. 792ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 802ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectvoid *dvmHeapSourceAlloc(size_t n); 812ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 822ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 832ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Allocates <n> bytes of zeroed data, growing up to absoluteMaxSize 842ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * if necessary. 852ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 862ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectvoid *dvmHeapSourceAllocAndGrow(size_t n); 872ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 882ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 892ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Frees the memory pointed to by <ptr>, which may be NULL. 902ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 912ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectvoid dvmHeapSourceFree(void *ptr); 922ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 932ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 94dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes * Frees the first numPtrs objects in the ptrs list. The list must 95dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes * contain addresses all in the same mspace, and must be in increasing 96dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes * order. This implies that there are no duplicates, and no entries 97dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes * are NULL. 98dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes */ 99dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayesvoid dvmHeapSourceFreeList(size_t numPtrs, void **ptrs); 100dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes 101dde8ab037540aaec554a471d67613b959cc0e9f4Barry Hayes/* 1022ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Returns true iff <ptr> was allocated from the heap source. 1032ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1042ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectbool dvmHeapSourceContains(const void *ptr); 1052ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1062ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1072ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Returns the value of the requested flag. 1082ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1092ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectenum HeapSourcePtrFlag { 1102ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_CONTAINS, // identical to dvmHeapSourceContains() 1112ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project HS_ALLOCATED_IN_ZYGOTE 1122ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project}; 1132ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectbool dvmHeapSourceGetPtrFlag(const void *ptr, enum HeapSourcePtrFlag flag); 1142ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1152ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1162ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Returns the number of usable bytes in an allocated chunk; the size 1172ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * may be larger than the size passed to dvmHeapSourceAlloc(). 1182ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1192ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectsize_t dvmHeapSourceChunkSize(const void *ptr); 1202ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1212ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1222ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Returns the number of bytes that the heap source has allocated 1232ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * from the system using sbrk/mmap, etc. 1242ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1252ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectsize_t dvmHeapSourceFootprint(void); 1262ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1272ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1282ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Gets the maximum number of bytes that the heap source is allowed 1292ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * to allocate from the system. 1302ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1312ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectsize_t dvmHeapSourceGetIdealFootprint(void); 1322ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1332ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1342ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Given the current contents of the heap, increase the allowed 1352ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * heap footprint to match the target utilization ratio. This 1362ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * should only be called immediately after a full mark/sweep. 1372ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1382ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectvoid dvmHeapSourceGrowForUtilization(void); 1392ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1402ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1412ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Return unused memory to the system if possible. If <bytesTrimmed> 1422ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * is non-NULL, the number of bytes returned to the system is written to it. 1432ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1442ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectvoid dvmHeapSourceTrim(size_t bytesTrimmed[], size_t arrayLen); 1452ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 1462ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1472ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Walks over the heap source and passes every allocated and 1482ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * free chunk to the callback. 1492ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1502ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectvoid dvmHeapSourceWalk(void(*callback)(const void *chunkptr, size_t chunklen, 1512ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project const void *userptr, size_t userlen, 1522ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project void *arg), 1532ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project void *arg); 1542ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project/* 1552ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project * Gets the number of heaps available in the heap source. 1562ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project */ 1572ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Projectsize_t dvmHeapSourceGetNumHeaps(void); 1582ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project 159f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapiro/* 160f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapiro * Exchanges the mark and object bitmaps and zeros the mark bitmap. 161f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapiro */ 162f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapirovoid dvmHeapSourceSwapBitmaps(void); 163f373efd3321307f54c102e02b3ee7eb922c4765cCarl Shapiro 164d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro/* 165425848f6b64603f79c336c08b6e1cbca1a9f6048Barry Hayes * Marks all objects inside the immune region of the heap. Addresses 166425848f6b64603f79c336c08b6e1cbca1a9f6048Barry Hayes * at or above this pointer are threatened, addresses below this 167425848f6b64603f79c336c08b6e1cbca1a9f6048Barry Hayes * pointer are immune. 168d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro */ 169425848f6b64603f79c336c08b6e1cbca1a9f6048Barry Hayesvoid dvmMarkImmuneObjects(const char *immuneLimit); 170d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro 171d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro/* 172d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro * Returns a pointer that demarcates the threatened region of the 173d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro * heap. Addresses at or above this pointer are threatened, addresses 174425848f6b64603f79c336c08b6e1cbca1a9f6048Barry Hayes * below this pointer are immune. 175d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro */ 176d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapirovoid *dvmHeapSourceGetImmuneLimit(GcMode mode); 177d25566d9278e6424e521f4b7148ac31480e60c5cCarl Shapiro 1782ad60cfc28e14ee8f0bb038720836a4696c478aThe Android Open Source Project#endif // _DALVIK_HEAP_SOURCE 179