trace

type BufferedTraceReader struct {
	// contains filtered or unexported fields
}

type BulkTraceReader struct {
	// contains filtered or unexported fields
}

type CloudSuiteInstr struct {
	// IP 指令地址
	IP uint64

	// IsBranch 指示该指令是否为分支
	IsBranch uint8

	// BranchTaken 分支是否跳转
	BranchTaken uint8

	// DestRegisters 目标寄存器编号 (最多 4 个, SPARC)
	DestRegisters [instruction.NumInstrDestinationsSparc]uint8

	// SrcRegisters 源寄存器编号 (最多 4 个)
	SrcRegisters [instruction.NumInstrSources]uint8

	// DestMemory 写内存地址 (最多 4 个)
	DestMemory [instruction.NumInstrDestinationsSparc]uint64

	// SrcMemory 读内存地址 (最多 4 个)
	SrcMemory [instruction.NumInstrSources]uint64

	// ASID 地址空间标识符 [虚拟ASID, 物理ASID]
	// 用于支持虚拟化和多地址空间模拟
	ASID [2]uint8
}

type InputInstr struct {
	// IP 指令地址 (Program Counter)
	IP uint64

	// IsBranch 指示该指令是否为分支
	// 注意: ChampSim 会根据寄存器读写模式重新识别分支类型
	IsBranch uint8

	// BranchTaken 分支是否跳转 (仅对分支指令有效)
	BranchTaken uint8

	// DestRegisters 目标寄存器编号 (最多 2 个)
	// 0 表示无寄存器
	DestRegisters [instruction.NumInstrDestinations]uint8

	// SrcRegisters 源寄存器编号 (最多 4 个)
	// 0 表示无寄存器
	SrcRegisters [instruction.NumInstrSources]uint8

	// DestMemory 写内存地址 (最多 2 个)
	// 0 表示无内存操作
	DestMemory [instruction.NumInstrDestinations]uint64

	// SrcMemory 读内存地址 (最多 4 个)
	// 0 表示无内存操作
	SrcMemory [instruction.NumInstrSources]uint64
}

type SharedTraceData struct {
	// contains filtered or unexported fields
}

type SharedTracePool struct {
	// contains filtered or unexported fields
}

type SharedTraceReader struct {
	// contains filtered or unexported fields
}

type TraceBlock struct {
	// contains filtered or unexported fields
}

type TraceFormat int

type TraceReader interface {
	// ReadInstruction 读取下一条指令
	// 返回 nil, io.EOF 表示 trace 结束
	ReadInstruction() (*instruction.OOOModelInstr, error)

	// EOF 返回是否已到达 trace 末尾
	EOF() bool

	// Close 关闭 trace 文件
	Close() error

	// Warmup 预热 trace reader，提前加载数据但不改变读取位置
	// 用于避免第一次读取时的延迟（例如解压缩）
	Warmup() error
}