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
  1. 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;
    
  1. PPC_PTRACE_DELHWDEBUG

接受一个整数,该整数标识现有断点或观察点(即,从PTRACE_SETHWDEBUG返回的值),并删除相应的断点或观察点。