跳转到内容

std.os.linux.bpf.btf

标准库Zig 0.17.1官方原文
源码std/os/linux/bpf/btf.zig

第 1 行

std.os.linux.bpf.btf.Array

容器

第 114 行

array 种类后面跟随此结构体

字段

typ: u32
index_type: u32
nelems: u32

std.os.linux.bpf.btf.DeclTag

容器

第 173 行

字段

component_idx: u32

std.os.linux.bpf.btf.Enum

容器

第 101 行

enum 种类后面跟随此结构体

字段

name_off: u32
val: i32

std.os.linux.bpf.btf.Enum64

容器

第 107 行

enum64 种类后面跟随此结构体

字段

name_off: u32
val_lo32: i32
val_hi32: i32

std.os.linux.bpf.btf.ext

别名

第 6 行

别名目标 std.os.linux.bpf.btf_ext

std.os.linux.bpf.btf.FuncLinkage

容器

第 147 行

字段

static
global
external

std.os.linux.bpf.btf.Header

容器

第 9 行

所有偏移均以字节为单位,相对于此头部末尾

字段

magic: u16
version: u8
flags: u8
hdr_len: u32
type_off: u32

类型节的偏移量

type_len: u32

类型节的长度

str_off: u32

字符串节的偏移量

str_len: u32

字符串节的长度

std.os.linux.bpf.btf.IntInfo

容器

第 84 行

int 种类后面跟随此结构体

字段

bits: u8
reserved_1: u8
offset: u8
encoding: enum(u4) {
    signed = 1 << 0,
    char = 1 << 1,
    boolean = 1 << 2,
}
reserved_2: u4

std.os.linux.bpf.btf.Kind

容器

第 60 行

某些类别中,Type 后紧跟额外数据。

字段

unknown
int
ptr
array
@"struct"
@"union"
@"enum"
fwd
typedef
@"volatile"
@"const"
restrict
func
func_proto
@"var"
datasec
float
decl_tag
type_tag
enum64

std.os.linux.bpf.btf.magic

常量

第 3 行

std.os.linux.bpf.btf.max_name_offset

常量

第 32 行

字符串节内的最大偏移量

std.os.linux.bpf.btf.max_type

常量

第 29 行

类型标识符的最大数量

std.os.linux.bpf.btf.max_vlen

常量

第 35 行

函数参数中结构体、联合体或枚举成员的最大数量。

std.os.linux.bpf.btf.Member

容器

第 122 行

struct 和 union 种类之后跟随多个 Member 结构体; 确切数量存储在 vlen 中。

字段

name_off: u32
typ: u32
offset: packed struct(u32) {
    bit: u24,
    bitfield_size: u8,
}

若设置 kind_flag,则 offset 同时包含成员位域大小及 位偏移;位域成员会设置位域大小。若类型信息中的 kind_flag 未设置,则 offset 仅包含位偏移。

std.os.linux.bpf.btf.Param

容器

第 136 行

func_proto 后跟多个 Param,确切数量存储于 vlen

字段

name_off: u32
typ: u32

std.os.linux.bpf.btf.std

别名

第 1 行

别名目标 std

std.os.linux.bpf.btf.Type

容器

第 37 行

字段

name_off: u32
info: packed struct(u32) {
    /// 结构体成员数量
    vlen: u16,

    unused_1: u8,
    kind: Kind,
    unused_2: u2,

    /// 由 Struct、Union 和 Fwd 使用
    kind_flag: bool,
}
size_type: extern union { size: u32, typ: u32 }

Int、Enum、Struct、Union 和 DataSec 使用 size 字段,它表示 所描述类型的大小。

Ptr、Typedef、Volatile、Const、Restrict、Func、 FuncProto 和 Var 使用 type 字段;它是引用另一类型的 type_id。

std.os.linux.bpf.btf.Var

容器

第 155 行

var 种类后跟单个 Var 结构体,描述与变量相关的 额外信息,例如链接属性。

字段

linkage: u32

std.os.linux.bpf.btf.VarLinkage

容器

第 141 行

字段

static
global_allocated
global_extern

std.os.linux.bpf.btf.VarSecInfo

容器

第 161 行

datasec 类型之后跟随多个 VarSecInfo,用于描述其包含的所有 Var 类型,以及各自的节内偏移和大小。

字段

typ: u32
offset: u32
size: u32

std.os.linux.bpf.btf.version

常量

第 4 行

源码

std/os/linux/bpf/btf.zig

const std = @import("../../../std.zig");

pub const magic = 0xeb9f;
pub const version = 1;

pub const ext = @import("btf_ext.zig");

/// 所有偏移均以字节为单位,相对于此头部末尾
pub const Header = extern struct {
    magic: u16,
    version: u8,
    flags: u8,
    hdr_len: u32,

    /// 类型节的偏移量
    type_off: u32,

    /// 类型节的长度
    type_len: u32,

    /// 字符串节的偏移量
    str_off: u32,

    /// 字符串节的长度
    str_len: u32,
};

/// 类型标识符的最大数量
pub const max_type = 0xfffff;

/// 字符串节内的最大偏移量
pub const max_name_offset = 0xffffff;

/// 函数参数中结构体、联合体或枚举成员的最大数量。
pub const max_vlen = 0xffff;

pub const Type = extern struct {
    name_off: u32,
    info: packed struct(u32) {
        /// 结构体成员数量
        vlen: u16,

        unused_1: u8,
        kind: Kind,
        unused_2: u2,

        /// 由 Struct、Union 和 Fwd 使用
        kind_flag: bool,
    },

    /// Int、Enum、Struct、Union 和 DataSec 使用 size 字段,它表示
    /// 所描述类型的大小。
    ///
    /// Ptr、Typedef、Volatile、Const、Restrict、Func、
    /// FuncProto 和 Var 使用 type 字段;它是引用另一类型的 type_id。
    size_type: extern union { size: u32, typ: u32 },
};

/// 某些类别中,Type 后紧跟额外数据。
pub const Kind = enum(u5) {
    unknown,
    int,
    ptr,
    array,
    @"struct",
    @"union",
    @"enum",
    fwd,
    typedef,
    @"volatile",
    @"const",
    restrict,
    func,
    func_proto,
    @"var",
    datasec,
    float,
    decl_tag,
    type_tag,
    enum64,
};

/// int 种类后面跟随此结构体
pub const IntInfo = packed struct(u32) {
    bits: u8,
    reserved_1: u8,
    offset: u8,
    encoding: enum(u4) {
        signed = 1 << 0,
        char = 1 << 1,
        boolean = 1 << 2,
    },
    reserved_2: u4,
};

test "IntInfo is 32 bits" {
    try std.testing.expectEqual(@bitSizeOf(IntInfo), 32);
}

/// enum 种类后面跟随此结构体
pub const Enum = extern struct {
    name_off: u32,
    val: i32,
};

/// enum64 种类后面跟随此结构体
pub const Enum64 = extern struct {
    name_off: u32,
    val_lo32: i32,
    val_hi32: i32,
};

/// array 种类后面跟随此结构体
pub const Array = extern struct {
    typ: u32,
    index_type: u32,
    nelems: u32,
};

/// struct 和 union 种类之后跟随多个 Member 结构体;
/// 确切数量存储在 vlen 中。
pub const Member = extern struct {
    name_off: u32,
    typ: u32,

    /// 若设置 kind_flag,则 offset 同时包含成员位域大小及
    /// 位偏移;位域成员会设置位域大小。若类型信息中的
    /// kind_flag 未设置,则 offset 仅包含位偏移。
    offset: packed struct(u32) {
        bit: u24,
        bitfield_size: u8,
    },
};

/// func_proto 后跟多个 Param,确切数量存储于 vlen
pub const Param = extern struct {
    name_off: u32,
    typ: u32,
};

pub const VarLinkage = enum {
    static,
    global_allocated,
    global_extern,
};

pub const FuncLinkage = enum {
    static,
    global,
    external,
};

/// var 种类后跟单个 Var 结构体,描述与变量相关的
/// 额外信息,例如链接属性。
pub const Var = extern struct {
    linkage: u32,
};

/// datasec 类型之后跟随多个 VarSecInfo,用于描述其包含的所有 Var 类型,以及各自的节内偏移和大小。
///
pub const VarSecInfo = extern struct {
    typ: u32,
    offset: u32,
    size: u32,
};

// decl_tag 种类后跟单个 DeclTag 结构体,用于描述
// 标签应用位置的附加信息。
// 如果 component_idx == -1,则标签应用于结构体、联合体、
// 变量或函数。否则,应用于结构体/联合体
// 成员或函数参数,component_idx 表示哪个成员
// 或参数,范围为 0 ... vlen-1。
pub const DeclTag = extern struct {
    component_idx: u32,
};