From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-43202-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 7092 invoked by alias); 7 Mar 2006 22:28:47 -0000
Received: (qmail 7075 invoked by uid 22791); 7 Mar 2006 22:28:44 -0000
X-Spam-Check-By: sourceware.org
Received: from intranet.codesourcery.com (HELO mail.codesourcery.com) (65.74.133.6)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 07 Mar 2006 22:28:42 +0000
Received: (qmail 31749 invoked from network); 7 Mar 2006 22:28:38 -0000
Received: from unknown (HELO localhost) (jimb@127.0.0.2)   by mail.codesourcery.com with ESMTPA; 7 Mar 2006 22:28:38 -0000
To: gdb-patches@sourceware.org
Subject: RFA: Document 'target remote pipe'
From: Jim Blandy <jimb@red-bean.com>
Date: Wed, 08 Mar 2006 15:28:00 -0000
Message-ID: <vt2hd69vqi1.fsf@theseus.home.>
User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
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/msg00125.txt.bz2


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,18 @@ 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.
+
+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