<div dir="ltr">Hi folks,<div><br></div><div>This is the plain text version of the previous email in case that was considered as spam.</div><div><br></div><div>--- Background ---</div><div>On the downstream Android, vendors used to report GPU private memory allocations with debugfs nodes in their own formats. However, debugfs nodes are getting deprecated in the next Android release.</div><div><br></div><div>--- Proposal ---</div><div>We are taking the chance to unify all the vendors to migrate their existing debugfs nodes into a standardized sysfs node structure. Then the platform is able to do a bunch of useful things: memory profiling, system health coverage, field metrics, local shell dump, in-app api, etc. This proposal is better served upstream as all GPU vendors can standardize a gpu memory structure and reduce fragmentation across Android and Linux that clients can rely on.</div><div><br></div><div>--- Detailed design ---</div><div>The sysfs node structure looks like below:</div><div>/sys/devices/<ro.gfx.sysfs.0>/<pid>/<type_name></div><div>e.g. "/sys/devices/mali0/gpu_mem/606/gl_buffer" and the gl_buffer is a node having the comma separated size values: "4096,81920,...,4096".</div><div><br></div><div>For the top level root, vendors can choose their own names based on the value of ro.gfx.sysfs.0 the vendors set. (1) For the multiple gpu driver cases, we can use ro.gfx.sysfs.1, ro.gfx.sysfs.2 for the 2nd and 3rd KMDs. (2) It's also allowed to put some sub-dir for example "kgsl/gpu_mem" or "mali0/gpu_mem" in the ro.gfx.sysfs.<channel> property if the root name under /sys/devices/ is already created and used for other purposes.<br></div><div><br></div><div>For the 2nd level "pid", there are usually just a couple of them per snapshot, since we only takes snapshot for the active ones.<br></div><div><br></div><div>For the 3rd level "type_name", the type name will be one of the GPU memory object types in lower case, and the value will be a comma separated sequence of size values for all the allocations under that specific type.<br></div><div><br></div><div>We especially would like some comments on this part. For the GPU memory object types, we defined 9 different types for Android:</div><div>(1) UNKNOWN // not accounted for in any other category<br></div><div>(2) SHADER // shader binaries</div><div>(3) COMMAND // allocations which have a lifetime similar to a VkCommandBuffer</div><div>(4) VULKAN // backing for VkDeviceMemory</div><div>(5) GL_TEXTURE // GL Texture and RenderBuffer</div><div>(6) GL_BUFFER // GL Buffer</div><div>(7) QUERY // backing for query</div><div>(8) DESCRIPTOR // allocations which have a lifetime similar to a VkDescriptorSet</div><div>(9) TRANSIENT // random transient things that the driver needs</div><div><br></div><div>We are wondering if those type enumerations make sense to the upstream side as well, or maybe we just deal with our own different type sets. Cuz on the Android side, we'll just read those nodes named after the types we defined in the sysfs node structure.<br></div><div><br></div><div>Looking forward to any concerns/comments/suggestions!<br></div><div><br></div><div>Best regards,</div><div>Yiwei</div><div><br></div></div>