memstats
摘要
显示描述仿真对象正在使用的内存资源的统计量列表。列表仅包含达到或超过指定千字节阈值的资源使用情况。
语法
memstats [long | delta | diff | kernel | model | catmem | poolmem | general | private] [<kbyte_threshold> | <pattern>]
| 参数 | 类型 | 说明 |
|---|---|---|
| long | n/a | 显示详细信息。 |
| delta | n/a | 以与先前报告的差值形式显示内存信息。 |
| diff | n/a | 与 “delta” 相同。 |
| kernel | n/a | 仅显示由仿真内核定义的内存分配器。 |
| model | n/a | 仅显示由模型定义的内存分配器。 |
| catmem | n/a | 仅显示分类内存分配器。 |
| poolmem | n/a | 仅显示池化内存分配器。 |
| general | n/a | 仅显示汇总信息。 |
| private | n/a | 除其他条目外,还显示内核内部条目。 |
<kbyte_threshold> |
integer | 纳入列表的最小使用阈值(默认值为 1 KB)。 当某类仿真对象的内存资源使用量累计超过指定阈值(以千字节 KB 为单位)时,将被纳入显示列表。5 KB 的阈值通常可过滤掉“不重要”的内存分配。 |
<pattern> |
string | 仅显示名称包含 <pattern> 的分配器。 |
说明
此命令显示关于静态和动态仿真对象的统计量列表。(在此语境中,仿真对象 一词所指的范围比模型对象更广,还包括仿真内核的内部数据结构。)
表格的每一行给出单个仿真对象(内存类别)的统计量:
- 分类内存类型按名称单独成行显示。
- 标记为 “general” 的行包含未分类内存的内部块。这部分内存不与特定对象关联。
- 标记为 “other” 的行包含所有小于给定报告阈值(
<kbyte_threshold>)的内存块的大小合计。它还包含仿真内核内部的所有内存块(除非请求kernel内存,在这种情况下将分别报告由内核分配的内存类别)。
注: 如果 mem_optimize 偏好设置为 FALSE,则只报告内存总用量。详情参见“mem_optimize”第 47 页。
该表有两个版本:默认的精简格式,以及由 “long” 参数指定的、包含附加信息的长格式。每种格式的列数因所显示的内存类型而异。根据内存类别的不同,可能显示以下统计量:
表 29:memstats 内存类别
- Bytes — 内存池中对象的大小(字节)(用于池化内存)。
- #Alloc * — 自程序启动以来,调用
prg_pmo_alloc()(池化)为单个对象分配内存,或调用prg_cmo_alloc()(分类)为一组对象分配内存的次数。 - #Dealloc * — 自程序启动以来,调用
op_prg_cmo_dealloc()释放一组对象的内存,或调用prg_mem_free()释放一组或单个对象内存的次数。 - #Use — 该类别中当前正在使用的已分配对象数量。
- Use(KB) — 该类别中已分配对象当前使用的内存量(千字节,向上取整)。
- #Free * — 该类别中已分配但未被使用的对象数量。(用于池化内存)
- #Resrv * — 该类别中作为预留持有、尚未被程序使用的对象数量。(用于池化内存)
- #Total * — 当前系统中的对象总数。(对于池化内存,#Total = #Resv + #Use + #Free,且始终是
prg_pmo_define()的 “increment” 参数的整数倍。) - Overhead * — 用于内存头的内存量(千字节,向上取整)。
- Total(KB) * — 该类别当前使用的内存量(千字节,向上取整)。(对于池化内存,Total(KB) = Bytes × #Total / 1024。)
Total(KB) 是调试期间最值得关注的统计量。如果在整个仿真过程中采集内存统计量,并发现某一特定类别意外上升,则该类别是排查内存泄漏的重点调查对象。
示例
(本示例列出所有使用量达到或超过 100 KB 的对象;由于这是相当大的内存量,所列对象数目被大幅精简。)
ODB> memstats 100
--------------------------------------------------------------
Object Allocation Statistics
--------------------------------------------------------------
--------------------------------------------------------------
Memory Pool Model Bytes #Use Use(KB)
--------------------------------------------------------------
Vos linked list cell N 12 21,591 254
--------------------------------------------------------------
Total Pooled Memory 254
--------------------------------------------------------------
--------------------------------------------------------------
Memory Category Model #Use Use(KB)
--------------------------------------------------------------
Const Strings Hash N 488,640 478
prg log store N 1 1,025
string data N 257,298 252
--------------------------------------------------------------
Total Categorized Memory 1,755
--------------------------------------------------------------
--------------------------------------------------------------
Memory Type Use(KB)
--------------------------------------------------------------
general 2,749
other 5,024
Total Pooled Memory 422
Total Categorized Memory 1,965
--------------------------------------------------------------
Total 10,160