meta

type BpfSkelDoc struct {
	// Version 版本信息
	Version string `json:"version,omitempty"`

	// Brief 简短描述
	Brief string `json:"brief,omitempty"`

	// Details 详细信息
	Details string `json:"details,omitempty"`

	// Description 描述信息
	Description string `json:"description,omitempty"`
}

type BpfSkeletonMeta struct {
	// DataSections 描述 .rodata 和 .bss 段及其中的变量
	DataSections []DataSectionMeta `json:"data_sections"`

	// Maps 描述 eBPF 对象中使用的 map 声明
	Maps map[string]*MapMeta `json:"maps"`

	// Progs 描述 eBPF 对象中的程序（函数）
	Progs map[string]*ProgMeta `json:"progs"`

	// ObjName eBPF 对象名称
	ObjName string `json:"obj_name"`

	// Doc 文档信息，用于生成命令行解析器
	Doc *BpfSkelDoc `json:"doc,omitempty"`
}

type BufferValueInterpreter struct {
	// Type 解释器类型：default_struct 或 stack_trace
	Type string `json:"type"`

	// StackTrace 堆栈跟踪配置
	// 仅当 Type 为 stack_trace 时使用
	StackTrace *StackTraceConfig `json:"stack_trace,omitempty"`
}

type ComposedObject struct {
	// BpfObject 对象二进制数据
	BpfObject []byte

	// Meta 元数据信息
	Meta EunomiaObjectMeta
}

type ComposedObjectInner struct {
	// BpfObject base64编码的、zlib压缩的对象文件
	BpfObject string `json:"bpf_object"`

	// BpfObjectSize 未压缩对象文件的大小（字节）
	BpfObjectSize uint `json:"bpf_object_size"`

	// Meta 元数据对象
	Meta EunomiaObjectMeta `json:"meta"`
}

type DataSectionMeta struct {
	// Name 段名称
	Name string `json:"name"`

	// Variables 段中的变量列表
	Variables []DataSectionVariableMeta `json:"variables"`
}

type DataSectionVariableMeta struct {
	// Name 变量名称
	Name string `json:"name"`

	// Type 变量的 C 类型
	Type string `json:"type"`

	// Value 变量的默认值
	// 如果未提供且未通过命令行解析器填充，将使用零值
	Value *json.RawMessage `json:"value,omitempty"`

	// Description 变量描述，用于生成命令行参数说明
	Description string `json:"description,omitempty"`

	// CmdArg 命令行参数配置
	CmdArg VariableCommandArgument `json:"cmdarg"`

	// Others 其他字段
	Others map[string]interface{} `json:"others,omitempty"`
}

type DataType int

type EunomiaObjectMeta struct {
	// ExportTypes 描述程序导出到用户空间的数据类型
	// 这些类型将通过 BTF 进行验证，并用于格式化输出
	ExportTypes []ExportedTypesStructMeta `json:"export_types"`

	// BpfSkel eBPF 程序的骨架元数据
	BpfSkel BpfSkeletonMeta `json:"bpf_skel"`

	// PerfBufferPages perf 缓冲区的页数，默认为 64
	PerfBufferPages uint `json:"perf_buffer_pages,omitempty"`

	// PerfBufferTimeMs perf 缓冲区的超时时间（毫秒），默认为 10
	PerfBufferTimeMs uint `json:"perf_buffer_time_ms,omitempty"`

	// PollTimeoutMs 轮询超时时间（毫秒），默认为 100
	PollTimeoutMs int `json:"poll_timeout_ms,omitempty"`

	// DebugVerbose 是否启用 libbpf 调试信息输出
	DebugVerbose bool `json:"debug_verbose,omitempty"`

	// PrintHeader 是否打印导出类型的类型和名称信息
	PrintHeader bool `json:"print_header,omitempty"`

	// EnableMultiExportTypes 是否启用多导出类型支持
	// 如果为 true，将使用每个 map 的 export_config 字段
	// 如果为 false，将保持与旧版本的兼容性
	EnableMultiExportTypes bool `json:"enable_multiple_export_types,omitempty"`
}

type EventHandler interface {
	HandleEvent(ctx *UserContext, data *ReceivedEventData) error
}

type ExportedTypesStructMemberMeta struct {
	// Name 成员名称
	Name string `json:"name"`

	// Type 成员类型
	Type string `json:"type"`

	// BTFType BTF 类型
	BTFType btf.Type `json:"btf_type"`
}

type ExportedTypesStructMeta struct {
	// Name 结构体名称
	Name string `json:"name"`

	// Members 结构体成员列表
	Members []ExportedTypesStructMemberMeta `json:"members"`

	// Size 结构体大小（字节）
	Size uint32 `json:"size"`

	// TypeID BTF 类型 ID
	Type btf.Type `json:"type"`
}

type Map struct {
	// Name 映射名称
	Name string

	// ExportHandler 导出处理器
	ExportHandler EventHandler

	// Properties 映射配置
	Properties *MapProperties
}

type MapExportConfig string

type MapMeta struct {
	// Name map 名称
	Name string `json:"name"`

	// Ident map 标识符
	Ident string `json:"ident"`

	// Mmaped 该 map 的值是否用于描述数据段
	Mmaped bool `json:"mmaped"`

	// Sample map 采样配置
	Sample *MapSampleMeta `json:"sample,omitempty"`

	// ExportConfig map 导出配置
	ExportConfig MapExportConfig `json:"export_config"`

	// Interpreter 缓冲区值解释器配置
	Interpreter BufferValueInterpreter `json:"interpreter"`

	// Properties map 配置
	Properties *MapProperties `json:"properties,omitempty"`

	// ExportHandler 导出处理器
	ExportHandler EventHandler `json:"export_handler"`
}

type MapProperties struct {
	// PinPath 用于指定 eBPF 映射的 pin 路径，下次加载时从该路径加载
	PinPath string
}

type MapSampleMeta struct {
	// Interval 采样间隔（毫秒）
	Interval uint `json:"interval"`

	// Type map 类型
	Type SampleMapType `json:"type"`

	// Unit 打印直方图时的单位
	Unit string `json:"unit"`

	// ClearMap 采样完成后是否清理 map
	ClearMap bool `json:"clear_map"`
}

type MetricsHandler interface {
	// Handle 处理统计信息
	Handle(stats *MetricsStats) error
}

type MetricsStats struct {
	// CPU 使用率
	CPUTimePercent float64

	// 每秒事件数
	EventsPerSecond int64

	// 平均运行时间(ns)
	AvgRunTimeNS uint64

	// 总平均运行时间(ns)
	TotalAvgRunTimeNS uint64

	// 采样周期(ns)
	PeriodNS uint64

	// 最后更新时间
	LastUpdate time.Time
}

type OverridedStructMember struct {
	// Name 字段名称
	Name string `json:"name"`

	// Offset 字段偏移量（字节）
	Offset uint `json:"offset"`

	// BtfTypeID BTF 类型 ID
	BtfTypeID uint32 `json:"btf_type_id"`
}

type Process struct {
	PID  int32
	Comm string
}

type ProgMeta struct {
	// Name 程序名称
	Name string `json:"name"`

	// Attach 程序附加点
	Attach string `json:"attach"`

	// Link 程序附加是否生成 bpf_link
	Link bool `json:"link"`

	// Properties 程序特定配置
	Properties *ProgramProperties `json:"properties,omitempty"`
}

type Program struct {
	// Name 程序名称
	Name string

	// Properties 程序配置
	Properties *ProgramProperties
}

type ProgramProperties struct {
	// CGroupPath 用于 cgroup 程序的 cgroup 路径
	CGroupPath string

	// PinPath 用于指定 eBPF 程序的 pin 路径，下次加载时从该路径加载
	PinPath string

	// LinkPinPath 用于指定 eBPF 程序的 pin 路径，下次加载时从该路径加载
	LinkPinPath string

	// Tc 流量控制配置
	Tc *TCCLS
}

type ProgramStats struct {
	// 程序 ID
	ID uint32

	// 程序类型
	Type string

	// 程序名称
	Name string

	// 运行时统计
	RunTimeNS   uint64
	PrevRunTime uint64

	// 运行次数统计
	RunCount  uint64
	PrevCount uint64

	// 最后更新时间
	LastUpdate time.Time

	// 关联的进程信息
	Processes []Process
}

type Properties struct {
	// Maps 映射列表
	Maps map[string]*Map

	// Programs 程序列表
	Programs map[string]*Program

	// Stats 统计配置
	Stats *Stats

	// EventHandler 全局事件处理器
	EventHandler EventHandler

	// MetricsHandler 全局指标处理器
	MetricsHandler MetricsHandler
}

type ReceivedEventData struct {
	Type     DataType
	Buffer   []byte
	KeyBuf   []byte
	ValueBuf []byte
	Text     string
	JsonText string
}

type RunnerConfig struct {
	// PrintKernelDebug 是否从 /sys/kernel/debug/tracing/trace_pipe 打印 bpf_printk 输出
	PrintKernelDebug bool `json:"print_kernel_debug"`

	// ProgProperties 程序特定配置
	ProgProperties ProgramProperties `json:"prog_properties,omitempty"`
}

type SampleMapType string

type StackTraceConfig struct {
	// FieldMap 字段映射配置
	FieldMap StackTraceFieldMapping `json:"field_map"`

	// WithSymbols 是否包含符号信息
	WithSymbols bool `json:"with_symbols"`
}

type StackTraceFieldMapping struct {
	// PID 进程 ID 字段名
	PID string `json:"pid,omitempty"`

	// CPUID CPU ID 字段名
	CPUID string `json:"cpu_id,omitempty"`

	// Comm 进程名字段名
	Comm string `json:"comm,omitempty"`

	// KstackSz 内核栈大小字段名
	KstackSz string `json:"kstack_sz,omitempty"`

	// UstackSz 用户栈大小字段名
	UstackSz string `json:"ustack_sz,omitempty"`

	// Kstack 内核栈字段名
	Kstack string `json:"kstack,omitempty"`

	// Ustack 用户栈字段名
	Ustack string `json:"ustack,omitempty"`
}

type Stats struct {
	// Interval 统计间隔
	Interval time.Duration

	// Handler 指标处理器
	Handler MetricsHandler
}

type TCAttachPoint string

type TCCLS struct {
	// Ifindex 接口索引
	Ifindex int32

	// Ifname 接口名称
	Ifname string

	// AttachType 附加点类型
	AttachType ebpf.AttachType
}

type TCHook struct {
	// Ifindex 接口索引
	Ifindex int32 `json:"ifindex"`

	// AttachPoint 附加点类型
	AttachPoint TCAttachPoint `json:"attach_point"`
}

type TCOpts struct {
	// Handle TC handle 值
	Handle uint32 `json:"handle"`

	// Priority TC 优先级
	Priority uint32 `json:"priority"`
}

type UserContext struct {
	Value interface{}
	// contains filtered or unexported fields
}

type VariableCommandArgument struct {
	// Default 参数默认值
	Default *json.RawMessage `json:"default,omitempty"`

	// Long 长参数名
	Long string `json:"long,omitempty"`

	// Short 短参数名（单个字符）
	Short string `json:"short,omitempty"`

	// Help 帮助信息
	Help string `json:"help,omitempty"`
}

type XDPOpts struct {
	// OldProgFD 旧程序的文件描述符
	OldProgFD int32 `json:"old_prog_fd"`
}