Ptrace¶
GDB计划支持BookE处理器的以下硬件调试功能
4个硬件断点 (IAC) 2个硬件观察点(读、写和读写)(DAC) 硬件观察点的2个值条件 (DVC)
为此,我们需要扩展ptrace,以便GDB可以查询和设置这些资源。 由于我们正在扩展,我们尝试创建一个可扩展的接口,该接口涵盖BookE和服务器处理器,以便GDB不需要特殊处理它们中的每一个。 我们添加了以下3个新的ptrace请求。
1. PPC_PTRACE_GETHWDBGINFO¶
查询,供GDB发现硬件调试功能。 这里要返回的主要信息是硬件观察点的最小对齐。 BookE处理器没有限制,但服务器处理器对硬件观察点有8字节对齐限制。 我们希望避免根据GDB在AUXV中看到的内容向GDB添加特殊情况。
既然我们正在做,我们添加了内核可以返回给GDB的其他有用信息:此查询将返回硬件断点,硬件观察点的数量,以及它是否支持地址范围和条件。 该查询将填充请求进程提供的以下结构
struct ppc_debug_info {
unit32_t version;
unit32_t num_instruction_bps;
unit32_t num_data_bps;
unit32_t num_condition_regs;
unit32_t data_bp_alignment;
unit32_t sizeof_condition; /* size of the DVC register */
uint64_t features; /* bitmask of the individual flags */
};
features将具有指示是否支持的位
#define PPC_DEBUG_FEATURE_INSN_BP_RANGE 0x1
#define PPC_DEBUG_FEATURE_INSN_BP_MASK 0x2
#define PPC_DEBUG_FEATURE_DATA_BP_RANGE 0x4
#define PPC_DEBUG_FEATURE_DATA_BP_MASK 0x8
#define PPC_DEBUG_FEATURE_DATA_BP_DAWR 0x10
#define PPC_DEBUG_FEATURE_DATA_BP_ARCH_31 0x20
PPC_PTRACE_SETHWDEBUG
根据提供的结构设置硬件断点或观察点
struct ppc_hw_breakpoint {
uint32_t version;
#define PPC_BREAKPOINT_TRIGGER_EXECUTE 0x1
#define PPC_BREAKPOINT_TRIGGER_READ 0x2
#define PPC_BREAKPOINT_TRIGGER_WRITE 0x4
uint32_t trigger_type; /* only some combinations allowed */
#define PPC_BREAKPOINT_MODE_EXACT 0x0
#define PPC_BREAKPOINT_MODE_RANGE_INCLUSIVE 0x1
#define PPC_BREAKPOINT_MODE_RANGE_EXCLUSIVE 0x2
#define PPC_BREAKPOINT_MODE_MASK 0x3
uint32_t addr_mode; /* address match mode */
#define PPC_BREAKPOINT_CONDITION_MODE 0x3
#define PPC_BREAKPOINT_CONDITION_NONE 0x0
#define PPC_BREAKPOINT_CONDITION_AND 0x1
#define PPC_BREAKPOINT_CONDITION_EXACT 0x1 /* different name for the same thing as above */
#define PPC_BREAKPOINT_CONDITION_OR 0x2
#define PPC_BREAKPOINT_CONDITION_AND_OR 0x3
#define PPC_BREAKPOINT_CONDITION_BE_ALL 0x00ff0000 /* byte enable bits */
#define PPC_BREAKPOINT_CONDITION_BE(n) (1<<((n)+16))
uint32_t condition_mode; /* break/watchpoint condition flags */
uint64_t addr;
uint64_t addr2;
uint64_t condition_value;
};
一个请求指定一个事件,不一定只设置一个寄存器。 例如,如果请求是具有条件的观察点,则DAC和DVC寄存器将在同一请求中设置。
有了这个,GDB可以要求BookE支持的各种硬件断点和观察点。 没有考虑服务器处理器中可用的COMEFROM断点,但这不在此工作范围内。
ptrace将返回一个整数(句柄),唯一地标识刚创建的断点或观察点。 该整数将用于PPC_PTRACE_DELHWDEBUG请求中,以请求将其删除。 如果无法在寄存器上分配请求的断点,则返回 -ENOSPC。
使用该结构的一些示例
在第一个断点寄存器中设置断点
p.version = PPC_DEBUG_CURRENT_VERSION; p.trigger_type = PPC_BREAKPOINT_TRIGGER_EXECUTE; p.addr_mode = PPC_BREAKPOINT_MODE_EXACT; p.condition_mode = PPC_BREAKPOINT_CONDITION_NONE; p.addr = (uint64_t) address; p.addr2 = 0; p.condition_value = 0;
设置一个在第二个观察点寄存器中触发读取的观察点
p.version = PPC_DEBUG_CURRENT_VERSION; p.trigger_type = PPC_BREAKPOINT_TRIGGER_READ; p.addr_mode = PPC_BREAKPOINT_MODE_EXACT; p.condition_mode = PPC_BREAKPOINT_CONDITION_NONE; p.addr = (uint64_t) address; p.addr2 = 0; p.condition_value = 0;
设置一个仅用特定值触发的观察点
p.version = PPC_DEBUG_CURRENT_VERSION; p.trigger_type = PPC_BREAKPOINT_TRIGGER_READ; p.addr_mode = PPC_BREAKPOINT_MODE_EXACT; p.condition_mode = PPC_BREAKPOINT_CONDITION_AND | PPC_BREAKPOINT_CONDITION_BE_ALL; p.addr = (uint64_t) address; p.addr2 = 0; p.condition_value = (uint64_t) condition;
设置一个范围硬件断点
p.version = PPC_DEBUG_CURRENT_VERSION; p.trigger_type = PPC_BREAKPOINT_TRIGGER_EXECUTE; p.addr_mode = PPC_BREAKPOINT_MODE_RANGE_INCLUSIVE; p.condition_mode = PPC_BREAKPOINT_CONDITION_NONE; p.addr = (uint64_t) begin_range; p.addr2 = (uint64_t) end_range; p.condition_value = 0;
在服务器处理器 (BookS) 中设置一个观察点
p.version = 1; p.trigger_type = PPC_BREAKPOINT_TRIGGER_RW; p.addr_mode = PPC_BREAKPOINT_MODE_RANGE_INCLUSIVE; or p.addr_mode = PPC_BREAKPOINT_MODE_EXACT; p.condition_mode = PPC_BREAKPOINT_CONDITION_NONE; p.addr = (uint64_t) begin_range; /* For PPC_BREAKPOINT_MODE_RANGE_INCLUSIVE addr2 needs to be specified, where * addr2 - addr <= 8 Bytes. */ p.addr2 = (uint64_t) end_range; p.condition_value = 0;
PPC_PTRACE_DELHWDEBUG
接受一个整数,该整数标识现有断点或观察点(即,从PTRACE_SETHWDEBUG返回的值),并删除相应的断点或观察点。