This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[commit] Clarify "monitor" command (was: [RFC] plugin/extension interface)
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Russell Shaw <rjshaw at netspace dot net dot au>
- Cc: gdb at sourceware dot org, gdb-patches at sources dot redhat dot com
- Date: Sat, 03 Dec 2005 14:48:47 +0200
- Subject: [commit] Clarify "monitor" command (was: [RFC] plugin/extension interface)
- References: <20051202233207.GA19812@nevyn.them.org> <8f2776cb0512021657i3f780f77sb1294b51753ffaaa@mail.gmail.com> <20051203023154.GA22527@nevyn.them.org> <439105DF.5040708@netspace.net.au> <20051203024500.GA22826@nevyn.them.org> <43910D47.2070300@netspace.net.au> <20051203033336.GA23537@nevyn.them.org> <43911985.9050901@netspace.net.au> <20051203041402.GA24030@nevyn.them.org> <439122AF.5080606@netspace.net.au> <20051203044939.GA24620@nevyn.them.org> <43912C55.7090708@netspace.net.au>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> 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