Differences

This shows you the differences between two versions of the page.

--- gdbs:cmd_lc_z [2025/05/29 23:18] – created lars
+++ gdbs:cmd_lc_z [2025/05/29 23:42] (current) – lars
@@ Line 1: / Line 1: @@
 ====== command z ======
-**Format:** ‘z type,addr,kind’
 **Meaning:** Remove a type breakpoint or watchpoint starting at address 'address' of kind 'kind'.
-Each breakpoint and watchpoint packet type is documented separately.
 Implementation notes: A remote target shall return an empty string for an unrecognized breakpoint or watchpoint packet type. A remote target shall support either both or neither of a given ‘Ztype…’ and ‘ztype…’ packet pair. To avoid potential problems with duplicate packets, the operations should be implemented in an idempotent way.
+===== software breakpoint =====
+**Format:** ‘z0,addr,kind’
+**Meaning:** Remove a software breakpoint at address addr of type kind.
+The kind is target-specific and typically indicates the size of the breakpoint in bytes that should be inserted. E.g., the ARM and MIPS can insert either a 2 or 4 byte breakpoint. Some architectures have additional meanings for kind; if no architecture-specific value is being used, it should be ‘0’. kind is hex-encoded.
+**Reply:** <code>OK</code>
+===== hardware breakpoint =====
+**Format:** ‘z1,addr,kind’
+**Meaning:** Remove a hardware breakpoint at address addr.
+A hardware breakpoint is implemented using a mechanism that is not dependent on being able to modify the target’s memory.
+The kind is target-specific and typically indicates the size of the breakpoint in bytes that should be inserted. E.g., the ARM and MIPS can insert either a 2 or 4 byte breakpoint. Some architectures have additional meanings for kind; if no architecture-specific value is being used, it should be ‘0’. kind is hex-encoded.
+Implementation note: A hardware breakpoint is not affected by code movement.
+**Reply:** <code>OK</code>
+===== write watchpoint =====
+**Format:** ‘z2,addr,kind’
+**Meaning:** Remove a write watchpoint at addr. The number of bytes to watch is specified by kind.
+**Reply:** <code>OK</code>
+===== read watchpoint =====
+**Format:** ‘z3,addr,kind’
+**Meaning:** Remove a read watchpoint at addr. The number of bytes to watch is specified by kind.
+**Reply:** <code>OK</code>
+===== access watchpoint =====
+**Format:** ‘z4,addr,kind’
+**Meaning:** Remove an access watchpoint at addr. The number of bytes to watch is specified by kind.
 **Reply:** <code>OK</code>