std.valgrind.callgrind.ClientRequest
容器
字段
std.valgrind.callgrind.doClientRequestExpr
函数
fn doClientRequestExpr(default: usize, request: ClientRequest, a1: usize, a2: usize, a3: usize, a4: usize, a5: usize) usize
参数
std.valgrind.callgrind.doClientRequestStmt
函数
fn doClientRequestStmt(request: ClientRequest, a1: usize, a2: usize, a3: usize, a4: usize, a5: usize) void
参数
std.valgrind.callgrind.dumpStats
函数
转储各成本中心的当前状态,然后将其清零
pub fn dumpStats() void
std.valgrind.callgrind.dumpStatsAt
函数
转储当前成本中心状态,然后将其清零。 参数会附加到说明转储触发原因的字符串之后。此字符串会作为 描述字段写入性能分析数据转储。
pub fn dumpStatsAt(pos_str: [*:0]const u8) void
参数
pos_str: [*:0]const u8
std.valgrind.callgrind.startInstrumentation
函数
如果尚未启用,则启动完整 callgrind 插桩。 进行缓存模拟时,会清空模拟缓存; 这会导致之后出现人为的缓存预热阶段, 产生现实中不会发生的缓存未命中。
pub fn startInstrumentation() void
std.valgrind.callgrind.std
别名
别名目标 std
std.valgrind.callgrind.stopInstrumentation
函数
若尚未关闭,则停止全部 Callgrind 插桩。 这会刷新 Valgrind 的翻译缓存,之后不再执行额外 插桩,实际运行速度与 "none" 工具 相同,即开销最小。 可用于让无关代码绕过 Callgrind 的统计汇总。 若希望启动 Callgrind 时即采用此模式,以忽略准备阶段, 使用选项 "--instr-atstart=no"。
pub fn stopInstrumentation() void
std.valgrind.callgrind.toggleCollect
函数
切换收集状态。 收集状态指定是否记录 事件的发生,或忽略事件。通过递增 成本中心的计数器记录事件。
pub fn toggleCollect() void
std.valgrind.callgrind.valgrind
别名
别名目标 std.valgrind
std.valgrind.callgrind.zeroStats
函数
零代价中心
pub fn zeroStats() void
源码
std/valgrind/callgrind.zig
const std = @import("../std.zig");
const valgrind = std.valgrind;
pub const ClientRequest = enum(usize) {
DumpStats = valgrind.ToolBase("CT".*),
ZeroStats,
ToggleCollect,
DumpStatsAt,
StartInstrumentation,
StopInstrumentation,
};
fn doClientRequestExpr(default: usize, request: ClientRequest, a1: usize, a2: usize, a3: usize, a4: usize, a5: usize) usize {
return valgrind.doClientRequest(default, @as(usize, @intCast(@backingInt(request))), a1, a2, a3, a4, a5);
}
fn doClientRequestStmt(request: ClientRequest, a1: usize, a2: usize, a3: usize, a4: usize, a5: usize) void {
_ = doClientRequestExpr(0, request, a1, a2, a3, a4, a5);
}
/// 转储各成本中心的当前状态,然后将其清零
pub fn dumpStats() void {
doClientRequestStmt(.DumpStats, 0, 0, 0, 0, 0);
}
/// 转储当前成本中心状态,然后将其清零。
/// 参数会附加到说明转储触发原因的字符串之后。此字符串会作为
/// 描述字段写入性能分析数据转储。
///
pub fn dumpStatsAt(pos_str: [*:0]const u8) void {
doClientRequestStmt(.DumpStatsAt, @intFromPtr(pos_str), 0, 0, 0, 0);
}
/// 零代价中心
pub fn zeroStats() void {
doClientRequestStmt(.ZeroStats, 0, 0, 0, 0, 0);
}
/// 切换收集状态。
/// 收集状态指定是否记录
/// 事件的发生,或忽略事件。通过递增
/// 成本中心的计数器记录事件。
pub fn toggleCollect() void {
doClientRequestStmt(.ToggleCollect, 0, 0, 0, 0, 0);
}
/// 如果尚未启用,则启动完整 callgrind 插桩。
/// 进行缓存模拟时,会清空模拟缓存;
/// 这会导致之后出现人为的缓存预热阶段,
/// 产生现实中不会发生的缓存未命中。
pub fn startInstrumentation() void {
doClientRequestStmt(.StartInstrumentation, 0, 0, 0, 0, 0);
}
/// 若尚未关闭,则停止全部 Callgrind 插桩。
/// 这会刷新 Valgrind 的翻译缓存,之后不再执行额外
/// 插桩,实际运行速度与 "none" 工具
/// 相同,即开销最小。
/// 可用于让无关代码绕过 Callgrind 的统计汇总。
/// 若希望启动 Callgrind 时即采用此模式,以忽略准备阶段,
/// 使用选项 "--instr-atstart=no"。
pub fn stopInstrumentation() void {
doClientRequestStmt(.StopInstrumentation, 0, 0, 0, 0, 0);
}