2 * Copyright (C) 2008 The Android Open Source Project
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
17 * Types and macros used internally by the heap.
19 #ifndef _DALVIK_ALLOC_HEAP_INTERNAL
20 #define _DALVIK_ALLOC_HEAP_INTERNAL
22 #include <time.h> // for struct timespec
24 #include "HeapTable.h"
25 #include "MarkSweep.h"
28 HeapSource *heapSource;
30 /* List of heap objects that the GC should never collect.
31 * These should be included in the root set of objects.
33 HeapRefTable nonCollectableRefs;
35 /* List of heap objects that will require finalization when
36 * collected. I.e., instance objects
38 * a) whose class definitions override java.lang.Object.finalize()
42 * b) that have never been finalized.
44 * Note that this does not exclude non-garbage objects; this
45 * is not the list of pending finalizations, but of objects that
46 * potentially have finalization in their futures.
48 LargeHeapRefTable *finalizableRefs;
50 /* The list of objects that need to have finalize() called
51 * on themselves. These references are part of the root set.
53 * This table is protected by gDvm.heapWorkerListLock, which must
54 * be acquired after the heap lock.
56 LargeHeapRefTable *pendingFinalizationRefs;
58 /* Linked lists of subclass instances of java/lang/ref/Reference
59 * that we find while recursing. The "next" pointers are hidden
60 * in the objects' <code>int Reference.vmData</code> fields.
61 * These lists are cleared and rebuilt each time the GC runs.
63 Object *softReferences;
64 Object *weakReferences;
65 Object *phantomReferences;
67 /* The list of Reference objects that need to be cleared and/or
68 * enqueued. The bottom two bits of the object pointers indicate
69 * whether they should be cleared and/or enqueued.
71 * This table is protected by gDvm.heapWorkerListLock, which must
72 * be acquired after the heap lock.
74 LargeHeapRefTable *referenceOperations;
76 /* If non-null, the method that the HeapWorker is currently
79 Object *heapWorkerCurrentObject;
80 Method *heapWorkerCurrentMethod;
82 /* If heapWorkerCurrentObject is non-null, this gives the time when
83 * HeapWorker started executing that method. The time value must come
84 * from dvmGetRelativeTimeUsec().
86 * The "Cpu" entry tracks the per-thread CPU timer (when available).
88 u8 heapWorkerInterpStartTime;
89 u8 heapWorkerInterpCpuStartTime;
91 /* If any fields are non-zero, indicates the next (absolute) time that
92 * the HeapWorker thread should call dvmHeapSourceTrim().
94 struct timespec heapWorkerNextTrim;
96 /* The current state of the mark step.
97 * Only valid during a GC.
99 GcMarkContext markContext;
101 /* Set to dvmGetRelativeTimeUsec() whenever a GC begins.
102 * The value is preserved between GCs, so it can be used
103 * to determine the time between successive GCs.
104 * Initialized to zero before the first GC.
108 /* Is the GC running? Used to avoid recursive calls to GC.
113 * Debug control values
124 const char* hprofFileName;
125 hprof_context_t *hprofContext;
127 bool hprofDirectToDdms;
131 bool dvmLockHeap(void);
132 void dvmUnlockHeap(void);
133 void dvmLogGcStats(size_t numFreed, size_t sizeFreed, size_t gcTimeMs);
134 void dvmLogMadviseStats(size_t madvisedSizes[], size_t arrayLen);
135 void dvmHeapSizeChanged(void);
141 #define HEAP_LOG_TAG LOG_TAG "-heap"
144 #define LOGV_HEAP(...) ((void)0)
145 #define LOGD_HEAP(...) ((void)0)
147 #define LOGV_HEAP(...) LOG(LOG_VERBOSE, HEAP_LOG_TAG, __VA_ARGS__)
148 #define LOGD_HEAP(...) LOG(LOG_DEBUG, HEAP_LOG_TAG, __VA_ARGS__)
150 #define LOGI_HEAP(...) LOG(LOG_INFO, HEAP_LOG_TAG, __VA_ARGS__)
151 #define LOGW_HEAP(...) LOG(LOG_WARN, HEAP_LOG_TAG, __VA_ARGS__)
152 #define LOGE_HEAP(...) LOG(LOG_ERROR, HEAP_LOG_TAG, __VA_ARGS__)
154 #define QUIET_ZYGOTE_GC 1
157 #define LOGI_HEAP(...) \
159 if (!gDvm.zygote) { \
160 LOG(LOG_INFO, HEAP_LOG_TAG, __VA_ARGS__); \
165 #define FRACTIONAL_MB(n) (n) / (1024 * 1024), \
166 ((((n) % (1024 * 1024)) / 1024) * 1000) / 1024
167 #define FRACTIONAL_PCT(n,max) ((n) * 100) / (max), \
168 (((n) * 1000) / (max)) % 10
170 #endif // _DALVIK_ALLOC_HEAP_INTERNAL