From: Greg Clayton Date: Mon, 21 Jan 2013 23:54:42 +0000 (+0000) Subject: Clear up the documentation for the "container-regs" and "invalidate-regs" key/value... X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=8e44d749f762b576d01101d23053e9fe8606bcfb;p=platform%2Fupstream%2Fllvm.git Clear up the documentation for the "container-regs" and "invalidate-regs" key/value pair responses for qRegisterInfo with examples of single and multiple registers for each. llvm-svn: 173107 --- diff --git a/lldb/docs/lldb-gdb-remote.txt b/lldb/docs/lldb-gdb-remote.txt index 83473d3..f9c0afc 100644 --- a/lldb/docs/lldb-gdb-remote.txt +++ b/lldb/docs/lldb-gdb-remote.txt @@ -377,9 +377,17 @@ container-regs This specifies that this register is contained in other concrete register values. For example "eax" is in the lower 32 bits of the "rax" register value for x86_64, so "eax" could specify that it is - contained in "rax" by specifying the register number for "rax". + contained in "rax" by specifying the register number for "rax" (whose + register number is 0x00) - "container-regs:00,0a,3b;" + "container-regs:00;" + + If a register is comprised of one or more registers, like "d0" is ARM + which is a 64 bit register, it might be made up of "s0" and "s1". If + the register number for "s0" is 0x20, and the register number of "s1" + is "0x21", the "container-regs" key/value pair would be: + + "container-regs:20,21;" This is handy for defining what GDB used to call "pseudo" registers. These registers are never requested by LLDB via the register read @@ -391,9 +399,17 @@ invalidate-regs leading "0x") register numbers. This specifies which register values should be invalidated when this - register is modified. + register is modified. For example if modifying "eax" would cause "rax", + "eax", "ax", "ah", and "al" to be modified where rax is 0x0, eax is 15, + ax is 0x25, ah is 0x35, and al is 0x39, the "invalidate-regs" key/value + pair would be: - "invalidate-regs:01,0b,1e;" + "invalidate-regs:0,15,25,35,39;" + + If there is a single register that gets invalidated, then omit the comma + and just list a single register: + + "invalidate-regs:0;" This is handy when modifying a specific register can cause other register values to change. For example, when debugging an ARM target,