Re: RFA: Document 'target remote pipe'

["Jim Blandy" <jimb@red-bean.com>]

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