控制调用者-被调用者列表的命令

以下命令控制显示调用者和被调用者信息的方式。

callers-callees

按函数排序度量 (sort) 指定的顺序，列显每个函数的调用者-被调用者面板。

在每个调用者-被调用者报告中，调用者和被调用者按调用者-被调用者排序度量 (csort) 进行排序。可以使用 limit 命令限制写入的面板数（请参见控制输出的命令）。选定的（中央）函数以星号标记，如以下示例所示。

Attr.     Excl.     Incl.      Name
User CPU  User CPU  User CPU
 sec.      sec.       sec.
4.440     0.        42.910     commandline
0.        0.         4.440    *gpf
4.080     0.         4.080     gpf_b
0.360     0.         0.360     gpf_a

在此示例中，gpf 是选定的函数；它由 commandline 调用，而它调用 gpf_a 和 gpf_b。

cmetrics metric_spec

指定调用者-被调用者度量的选项。缺省情况下，只要更改了函数列表度量，就会将调用者-被调用者度量设置为与函数列表度量匹配。如果省略 metric_spec，则显示当前的调用者-被调用者度量设置。

字符串 metric_spec 为度量列表中所述的度量关键字之一，如以下示例所示。

% cmetrics i.%user:a.%user

此命令指示 er_print 显示以下度量。

• 用秒表示的包含用户 CPU 时间

• 包含用户 CPU 时间百分比

• 用秒表示的归属用户 CPU 时间

• 归属用户 CPU 时间百分比

完成 cmetrics 命令时，将列显一条消息，指明当前的度量选项。对于前面的示例，消息如下。

current: i.%user:a.%user:name

缺省情况下，只要更改了函数列表度量，就会将调用者-被调用者度量设置为与函数列表度量匹配。

调用者-被调用者归属度量被插入到对应的独占度量和包含度量前面，visibility 对应于这两个度量的 visibility 设置的逻辑“或”。将静态度量设置复制到调用者-被调用者度量。如果 metric-name 不在列表中，则将它附加到列表中。

可以使用 cmetric_list 命令获取已装入实验的所有可用 metric-name 值的列表。

如果 cmetrics 命令中包含错误，则忽略它并显示一条警告，但先前的设置仍然有效。

csingle function_name [N]

为指定的函数写入调用者-被调用者面板。当有多个函数具有相同的名称时，需要使用可选参数 N。为具有给定函数名称的第 N 个函数写入调用者-被调用者面板。在命令行上提供命令时，N 是必需的；如果不需要它，则将其忽略。当以交互方式提供不带 N 的命令但又需要 N 时，则会列显具有对应 N 值的函数列表。

csort metric_spec

按指定的度量对调用者-被调用者显示进行排序。字符串 metric_spec 为度量列表中所述的度量关键字之一，如以下示例所示。

% csort a.user

如果省略 metric-spec，则显示当前的调用者-被调用者排序度量。

csort 度量必须是归属度量或静态度量。如果指定了多个度量，则按匹配的第一个可见度量进行排序。

只要设置了度量（显式设置或缺省设置），就会基于函数度量设置调用者-被调用者排序度量，如下所示：

• 如果排序依据是动态度量（包含或独占），则按对应的归属度量进行排序。

• 如果排序依据是静态度量，则按它进行排序。

此命令指示 er_print 实用程序按归属用户 CPU 时间对调用者-被调用者显示进行排序。命令完成时，将列显排序度量。