pub trait MonitorCmd: Target {
// Required method
fn handle_monitor_cmd(
&mut self,
cmd: &[u8],
out: ConsoleOutput<'_>,
) -> Result<(), Self::Error>;
}Expand description
Target Extension - Handle custom GDB monitor commands.
Required Methods§
Sourcefn handle_monitor_cmd(
&mut self,
cmd: &[u8],
out: ConsoleOutput<'_>,
) -> Result<(), Self::Error>
fn handle_monitor_cmd( &mut self, cmd: &[u8], out: ConsoleOutput<'_>, ) -> Result<(), Self::Error>
Handle custom commands sent using the monitor command.
The GDB remote serial protocol includes a built-in mechanism to send
arbitrary commands to the remote stub: the monitor command. For
example, running monitor dbg from the GDB client will invoke
handle_monitor_cmd with cmd = b"dbg".
Commands are not guaranteed to be valid UTF-8, hence the use of
&[u8] as opposed to &str.
Intermediate console output can be written back to the GDB client using
the provided ConsoleOutput object + the
gdbstub::output! macro.
Note: The maximum length of incoming commands is limited by the size
of the packet buffer provided to the GdbStub.
Specifically, commands can only be up to (buf.len() - 10) / 2 bytes.