跳转到内容

std.valgrind.callgrind

标准库Zig 0.17.0官方原文
源码std/valgrind/callgrind.zig

第 1 行

std.valgrind.callgrind.ClientRequest

容器

第 4 行

字段

DumpStats = valgrind.ToolBase("CT".*)
ZeroStats
ToggleCollect
DumpStatsAt
StartInstrumentation
StopInstrumentation

std.valgrind.callgrind.doClientRequestExpr

函数

第 13 行

fn doClientRequestExpr(default: usize, request: ClientRequest, a1: usize, a2: usize, a3: usize, a4: usize, a5: usize) usize

参数

default: usize
request: ClientRequest
a1: usize
a2: usize
a3: usize
a4: usize
a5: usize

std.valgrind.callgrind.doClientRequestStmt

函数

第 17 行

fn doClientRequestStmt(request: ClientRequest, a1: usize, a2: usize, a3: usize, a4: usize, a5: usize) void

参数

request: ClientRequest
a1: usize
a2: usize
a3: usize
a4: usize
a5: usize

std.valgrind.callgrind.dumpStats

函数

第 22 行

转储各成本中心的当前状态,然后将其清零

pub fn dumpStats() void

std.valgrind.callgrind.dumpStatsAt

函数

第 30 行

转储当前成本中心状态,然后将其清零。 参数会附加到说明转储触发原因的字符串之后。此字符串会作为 描述字段写入性能分析数据转储。

pub fn dumpStatsAt(pos_str: [*:0]const u8) void

参数

pos_str: [*:0]const u8

std.valgrind.callgrind.startInstrumentation

函数

第 51 行

如果尚未启用,则启动完整 callgrind 插桩。 进行缓存模拟时,会清空模拟缓存; 这会导致之后出现人为的缓存预热阶段, 产生现实中不会发生的缓存未命中。

pub fn startInstrumentation() void

std.valgrind.callgrind.std

别名

第 1 行

别名目标 std

std.valgrind.callgrind.stopInstrumentation

函数

第 62 行

若尚未关闭,则停止全部 Callgrind 插桩。 这会刷新 Valgrind 的翻译缓存,之后不再执行额外 插桩,实际运行速度与 "none" 工具 相同,即开销最小。 可用于让无关代码绕过 Callgrind 的统计汇总。 若希望启动 Callgrind 时即采用此模式,以忽略准备阶段, 使用选项 "--instr-atstart=no"。

pub fn stopInstrumentation() void

std.valgrind.callgrind.toggleCollect

函数

第 43 行

切换收集状态。 收集状态指定是否记录 事件的发生,或忽略事件。通过递增 成本中心的计数器记录事件。

pub fn toggleCollect() void

std.valgrind.callgrind.valgrind

别名

第 2 行

别名目标 std.valgrind

std.valgrind.callgrind.zeroStats

函数

第 35 行

零代价中心

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);
}