This is the mail archive of the
gdb@sourceware.org
mailing list for the GDB project.
[commit] Clarify "monitor" command (was: [RFC] plugin/extension interface)
> Date: Sat, 03 Dec 2005 16:25:41 +1100
> From: Russell Shaw <rjshaw@netspace.net.au>
> Cc: gdb@sourceware.org
>
> It would be useful if the manual actually said that this is the way to
> add new commands for an external monitor. It is bad when i can only learn
> new things about gdb by complaining.
Thank you for pointing this out. I've just committed the following
change to the GDB manual:
2005-12-03 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Connecting): Explain that `monitor' is a way to
extend GDB with commands for external monitor.
Index: gdb/doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.298
diff -u -r1.298 gdb.texinfo
--- gdb/doc/gdb.texinfo 2 Dec 2005 11:44:19 -0000 1.298
+++ gdb/doc/gdb.texinfo 3 Dec 2005 12:42:11 -0000
@@ -11966,10 +11966,15 @@
another target.
@cindex send command to remote monitor
+@cindex extend @value{GDBN} for remote targets
+@cindex add new commands for external monitor
@kindex monitor
@item monitor @var{cmd}
-This command allows you to send commands directly to the remote
-monitor.
+This command allows you to send arbitrary commands directly to the
+remote monitor. Since @value{GDBN} doesn't care about the commands it
+sends like this, this command is the way to extend @value{GDBN}---you
+can add new commands that only the external monitor will understand
+and implement.
@end table
@node Server