target/riscv: extend trigger controls

* Add control for action mode.
* Introduce `riscv mtrigger` command.
* Introduce `riscv *trigger list` command

Author: lz-bro

doc/openocd.texi

@@ -11728,12 +11728,15 @@ set those triggers directly. (It's also possible to do so by writing the
 appropriate CSRs.)
 
 @deffn {Command} {riscv etrigger set} [@option{m}] [@option{s}] [@option{u}] [@option{vs}] [@option{vu}] exception_codes
-Set an exception trigger (type 5) on the current target, which halts the target when it
-fires.  @option{m}, @option{s}, @option{u}, @option{vs}, and @option{vu} control
-which execution modes the trigger fires in. @var{exception_codes} is a bit
-field, where each bit corresponds to an exception code in mcause (defined in the
-RISC-V Privileged Spec). The etrigger will fire on the exceptions whose bits are
-set in @var{exception_codes}.
+[@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}]
+Set an exception trigger (type 5) on the current target, which sets the desired behavior on
+the target when it fires.  @option{m}, @option{s}, @option{u}, @option{vs}, and @option{vu}
+control which execution modes the trigger fires in. @var{exception_codes} is a bit field,
+where each bit corresponds to an exception code in mcause (defined in the RISC-V Privileged Spec).
+The etrigger will fire on the exceptions whose bits are set in @var{exception_codes}.
+@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}
+control the desired behavior on the target when the trigger fires. Defaults to @option{halt},
+which halts the target.
 
 For details on this trigger type, see the RISC-V Debug Specification.
 @end deffn
@@ -11742,15 +11745,21 @@ For details on this trigger type, see the RISC-V Debug Specification.
 Clear the type 5 trigger that was set using @command{riscv etrigger set}.
 @end deffn
 
+@deffn {Command} {riscv etrigger list}
+List the type 5 trigger that was set using @command{riscv etrigger set}.
+@end deffn
+
 @deffn {Command} {riscv icount set} [@option{m}] [@option{s}] [@option{u}] [@option{vs}] [@option{vu}] [@option{pending}] count
-Set an instruction count
-trigger (type 3) on the current target, which halts the target when it fires.
-@option{m}, @option{s}, @option{u}, @option{vs}, and @option{vu} control which
-execution modes the trigger fires in. If [@option{pending}] is passed then the
-pending bit is set, which is unlikely to be useful unless you're debugging the
-hardware implementation of this trigger.
-@var{count} sets the number of instructions to execute before the trigger is
-taken.
+[@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}]
+Set an instruction count trigger (type 3) on the current target, which sets the desired behavior
+on the target when it fires. @option{m}, @option{s}, @option{u}, @option{vs}, and @option{vu}
+control which execution modes the trigger fires in. If [@option{pending}] is passed then the
+pending bit is set, which is unlikely to be useful unless you're debugging the hardware
+implementation of this trigger. @var{count} sets the number of instructions to execute before
+the trigger is taken.
+@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}
+control the desired behavior on the target when the trigger fires. Defaults to @option{halt},
+which halts the target.
 
 For details on this trigger type, see the RISC-V Debug Specification.
 @end deffn
@@ -11759,13 +11768,21 @@ For details on this trigger type, see the RISC-V Debug Specification.
 Clear the type 3 trigger that was set using @command{riscv icount set}.
 @end deffn
 
+@deffn {Command} {riscv icount list}
+List the type 3 trigger that was set using @command{riscv icount set}.
+@end deffn
+
 @deffn {Command} {riscv itrigger set} [@option{m}] [@option{s}] [@option{u}] [@option{vs}] [@option{vu}] [@option{nmi}] mie_bits
-Set an interrupt trigger (type 4) on the current target, which halts the target when it
-fires.  @option{m}, @option{s}, @option{u}, @option{vs}, and @option{vu} control
-which execution modes the trigger fires in.  If [@option{nmi}] is passed then
-the trigger will fire on non-maskable interrupts in those modes. @var{mie_bits}
-controls which interrupts the trigger fires on, using the same bit assignments
-as in the mie CSR (defined in the RISC-V Privileged Spec).
+[@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}]
+Set an interrupt trigger (type 4) on the current target, which sets the desired behavior on
+the target when it fires.  @option{m}, @option{s}, @option{u}, @option{vs}, and @option{vu}
+control which execution modes the trigger fires in.  If [@option{nmi}] is passed then the
+trigger will fire on non-maskable interrupts in those modes. @var{mie_bits} controls which
+interrupts the trigger fires on, using the same bit assignments as in the mie CSR (defined
+in the RISC-V Privileged Spec).
+@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}
+control the desired behavior on the target when the trigger fires. Defaults to @option{halt},
+which halts the target.
 
 For details on this trigger type, see the RISC-V Debug Specification.
 @end deffn
@@ -11789,6 +11806,31 @@ control over the trigger. By default there are no reserved triggers.
 Clear the type 4 trigger that was set using @command{riscv itrigger set}.
 @end deffn
 
+@deffn {Command} {riscv itrigger list}
+List the type 4 trigger that was set using @command{riscv itrigger set}.
+@end deffn
+
+@deffn {Command} {riscv mtrigger set} [@option{m}] [@option{s}] [@option{u}] [@option{vs}] [@option{vu}]
+[@option{execute}] [@option{store}] [@option{load}] [@option{exception}|@option{halt}|@option{trace_on}|
+@option{trace_off}|@option{trace_notify}] Set an match trigger (type 2 or 6) on the current target,
+which sets the desired behavior on the target when it fires.  @option{m}, @option{s}, @option{u},
+@option{vs}, and @option{vu} control which execution modes the trigger fires in. @option{execute},
+@option{store}, and @option{load} control the trigger how to fire.
+@option{exception}|@option{halt}|@option{trace_on}|@option{trace_off}|@option{trace_notify}
+control the desired behavior on the target when the trigger fires. Defaults to @option{halt},
+which halts the target.
+
+For details on this trigger type, see the RISC-V Debug Specification.
+@end deffn
+
+@deffn {Command} {riscv mtrigger clear}
+Clear the type 2 or 6 trigger that was set using @command{riscv mtrigger set}.
+@end deffn
+
+@deffn {Command} {riscv mtrigger list}
+List the type 2 or 6 trigger that was set using @command{riscv mtrigger set}.
+@end deffn
+
 @subsection RISC-V Program Buffer Commands
 
 Program Buffer is an optional feature of RISC-V targets - it is a mechanism that debuggers