vm/AllocTracker.h

   1 /*
   2  * Copyright (C) 2008 The Android Open Source Project
   3  *
   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
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  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.
  15  */
  16 /*
  17  * Allocation tracking and reporting.
  18  */
  19 #ifndef _DALVIK_ALLOCTRACKER
  20 #define _DALVIK_ALLOCTRACKER
  21
  22 /* initialization */
  23 bool dvmAllocTrackerStartup(void);
  24 void dvmAllocTrackerShutdown(void);
  25
  26 struct AllocRecord;
  27 typedef struct AllocRecord AllocRecord;
  28
  29 /*
  30  * Enable allocation tracking.  Does nothing if tracking is already enabled.
  31  */
  32 bool dvmEnableAllocTracker(void);
  33
  34 /*
  35  * Disable allocation tracking.  Does nothing if tracking is not enabled.
  36  */
  37 void dvmDisableAllocTracker(void);
  38
  39 /*
  40  * If allocation tracking is enabled, add a new entry to the set.
  41  */
  42 #define dvmTrackAllocation(_clazz, _size)                                   \
  43     {                                                                       \
  44         if (gDvm.allocRecords != NULL)                                      \
  45             dvmDoTrackAllocation(_clazz, _size);                            \
  46     }
  47 void dvmDoTrackAllocation(ClassObject* clazz, int size);
  48
  49 /*
  50  * Generate a DDM packet with all of the tracked allocation data.
  51  *
  52  * On success, returns "true" with "*pData" and "*pDataLen" set.  "*pData"
  53  * refers to newly-allocated storage that must be freed by the caller.
  54  */
  55 bool dvmGenerateTrackedAllocationReport(u1** pData, size_t* pDataLen);
  56
  57 /*
  58  * Dump the tracked allocations to the log file.  If "enable" is set, this
  59  * will enable tracking if it's not already on.
  60  */
  61 void dvmDumpTrackedAllocations(bool enable);
  62
  63 #endif /*_DALVIK_ALLOCTRACKER*/