From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6750 invoked by alias); 7 Mar 2006 22:27:49 -0000 Received: (qmail 6740 invoked by uid 22791); 7 Mar 2006 22:27:48 -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:27:47 +0000 Received: (qmail 31727 invoked from network); 7 Mar 2006 22:27:46 -0000 Received: from unknown (HELO localhost) (jimb@127.0.0.2) by mail.codesourcery.com with ESMTPA; 7 Mar 2006 22:27:46 -0000 To: gdb-patches@sourceware.org Subject: RFA: update 'target remote' description From: Jim Blandy Date: Wed, 08 Mar 2006 10:57:00 -0000 Message-ID: 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 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-03/txt/msg00124.txt.bz2 src/gdb/doc/ChangeLog: 2006-03-07 Jim Blandy * gdb.texinfo (Target Commands): Update text describing how to specify a target. Refer to the detailed section on remote debugging, not the brief mention. Index: src/gdb/doc/gdb.texinfo =================================================================== --- src.orig/gdb/doc/gdb.texinfo +++ src/gdb/doc/gdb.texinfo @@ -11906,14 +11906,24 @@ An executable file. @samp{target exec @ A core dump file. @samp{target core @var{filename}} is the same as @samp{core-file @var{filename}}. -@item target remote @var{dev} +@item target remote @var{medium} +@cindex @code{target remote} @cindex remote target -Remote serial target in GDB-specific protocol. The argument @var{dev} -specifies what serial device to use for the connection (e.g.@: -@file{/dev/ttya}). @xref{Remote, ,Remote debugging}. @code{target remote} -supports the @code{load} command. This is only useful if you have -some other way of getting the stub to the target system, and you can put -it somewhere in memory where it won't get clobbered by the download. +A remote system connected to @value{GDBN} via a serial line or network +connection. This command tells @value{GDBN} to use its own remote +protocol over @var{medium} for debugging. @xref{Remote Debugging}. + +For example, if you have a board connected to @file{/dev/ttya} on the +machine running @value{GDBN}, you could say: + +@smallexample +target remote /dev/ttya +@end smallexample + +@code{target remote} supports the @code{load} command. This is only +useful if you have some other way of getting the stub to the target +system, and you can put it somewhere in memory where it won't get +clobbered by the download. @item target sim @cindex built-in simulator target