This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: RFA: Document 'target remote pipe'
- From: "Jim Blandy" <jimb at red-bean dot com>
- To: "Eli Zaretskii" <eliz at gnu dot org>
- Cc: gdb-patches at sourceware dot org
- Date: Thu, 9 Mar 2006 10:14:44 -0800
- Subject: Re: RFA: Document 'target remote pipe'
- References: <vt2hd69vqi1.fsf@theseus.home.> <uek1cs03a.fsf@gnu.org>
On 3/8/06, Eli Zaretskii <eliz@gnu.org> wrote:
> > From: Jim Blandy <jimb@red-bean.com>
> > Date: Tue, 07 Mar 2006 14:28:38 -0800
> >
> >
> > src/gdb/doc/ChangeLog:
> > 2006-03-07 Jim Blandy <jimb@red-bean.com>
> >
> > * gdb.texinfo (Connecting): Document 'target remote pipe'.
>
> Approved, thanks.
>
> Would it be a good idea to add a sentence or two about when this
> method is useful?
Yes --- how about:
src/gdb/doc/ChangeLog:
2006-03-07 Jim Blandy <jimb@red-bean.com>
* gdb.texinfo (Connecting): Document 'target remote pipe'.
Index: src/gdb/doc/gdb.texinfo
===================================================================
--- src.orig/gdb/doc/gdb.texinfo
+++ src/gdb/doc/gdb.texinfo
@@ -12220,6 +12220,20 @@ keep in mind that the `U' stands for ``U
can silently drop packets on busy or unreliable networks, which will
cause havoc with your debugging session.
+@item target remote | @var{command}
+@cindex pipe, @code{target remote} to
+Run @var{command} in the background and communicate with it using a
+pipe. The @var{command} is a shell command, to be parsed and expanded
+by the system's command shell, @code{/bin/sh}; it should expect remote
+protocol packets on its standard input, and send replies on its
+standard output. You could use this to run a stand-alone simulator
+that speaks the remote debugging protocol, to make net connections
+using programs like @code{ssh}, or for other similar tricks.
+
+If @var{command} closes its standard output (perhaps by exiting),
+@value{GDBN} will try to send it a @code{SIGTERM} signal. (If the
+program has already exited, this will have no effect.)
+
@end table
Once the connection has been established, you can use all the usual