From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-43217-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 10715 invoked by alias); 9 Mar 2006 18:15:44 -0000
Received: (qmail 10701 invoked by uid 22791); 9 Mar 2006 18:15:41 -0000
X-Spam-Check-By: sourceware.org
Received: from xproxy.gmail.com (HELO xproxy.gmail.com) (66.249.82.200)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Thu, 09 Mar 2006 18:14:47 +0000
Received: by xproxy.gmail.com with SMTP id t15so352760wxc         for <gdb-patches@sourceware.org>; Thu, 09 Mar 2006 10:14:45 -0800 (PST)
Received: by 10.70.116.3 with SMTP id o3mr2519092wxc;         Thu, 09 Mar 2006 10:14:44 -0800 (PST)
Received: by 10.70.125.17 with HTTP; Thu, 9 Mar 2006 10:14:44 -0800 (PST)
Message-ID: <8f2776cb0603091014s2df735a3u2f25c6fc87594976@mail.gmail.com>
Date: Thu, 09 Mar 2006 19:13:00 -0000
From: "Jim Blandy" <jimb@red-bean.com>
To: "Eli Zaretskii" <eliz@gnu.org>
Subject: Re: RFA: Document 'target remote pipe'
Cc: gdb-patches@sourceware.org
In-Reply-To: <uek1cs03a.fsf@gnu.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
References: <vt2hd69vqi1.fsf@theseus.home.> <uek1cs03a.fsf@gnu.org>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2006-03/txt/msg00140.txt.bz2

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
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- 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