Merge "Memtrack HAL: Update documentation" am: 620ad1ca3f

Original change: https://android-review.googlesource.com/c/platform/hardware/interfaces/+/1611823

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: I5234b508cae8d55b22852e53063d8f53b49580ec
This commit is contained in:
Treehugger Robot 2021-03-03 18:30:12 +00:00 committed by Automerger Merge Worker
commit 37961ff47c

View file

@ -30,6 +30,22 @@ import android.hardware.memtrack.MemtrackType;
* GL, graphics, etc. All memory sizes must be in real memory usage,
* accounting for stride, bit depth, rounding up to page size, etc.
*
* The following getMemory() categories are important for memory accounting in
* `dumpsys meminfo` and should be reported as described below:
*
* - MemtrackType::GRAPHICS and MemtrackRecord::FLAG_SMAPS_UNACCOUNTED
* This should report the PSS of all DMA buffers mapped by the process
* with the specified PID. This PSS can be calculated using ReadDmaBufPss()
* form libdmabufinfo.
*
* - MemtrackType::GL and MemtrackRecord::FLAG_SMAPS_UNACCOUNTED
* This category should report all GPU private allocations for the specified
* PID that are not accounted in /proc/<pid>/smaps.
*
* - MemtrackType::OTHER and MemtrackRecord::FLAG_SMAPS_UNACCOUNTED
* Any other memory not accounted for in /proc/<pid>/smaps if any, otherwise
* this should return 0.
*
* Constructor for the interface should be used to perform memtrack management
* setup actions and must be called once before any calls to getMemory().
*/
@ -76,7 +92,10 @@ interface IMemtrack {
* This information is used to identify GPU devices for GPU specific
* memory accounting (e.g. DMA buffer usage).
*
* The device name(s) provided in getGpuDeviceInfo() must match the
* device name in the corresponding device(s) sysfs entry.
*
* @return vector of DeviceInfo populated for all GPU devices.
*/
DeviceInfo[] getGpuDeviceInfo();
DeviceInfo[] getGpuDeviceInfo();
}