From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 77587 invoked by alias); 1 Apr 2015 12:15:51 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 77571 invoked by uid 89); 1 Apr 2015 12:15:50 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.0 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS,T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-GCM-SHA384 encrypted) ESMTPS; Wed, 01 Apr 2015 12:15:45 +0000 Received: from int-mx09.intmail.prod.int.phx2.redhat.com (int-mx09.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id t31CFhJc016985 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Wed, 1 Apr 2015 08:15:44 -0400 Received: from [127.0.0.1] (ovpn01.gateway.prod.ext.ams2.redhat.com [10.39.146.11]) by int-mx09.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id t31CFfgg008498; Wed, 1 Apr 2015 08:15:42 -0400 Message-ID: <551BE16D.3090508@redhat.com> Date: Wed, 01 Apr 2015 12:15:00 -0000 From: Pedro Alves User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.5.0 MIME-Version: 1.0 To: Gary Benson , gdb-patches@sourceware.org Subject: Re: [PATCH 9/9] Document "target:" sysroot changes References: <1426870087-32654-1-git-send-email-gbenson@redhat.com> <1426870087-32654-10-git-send-email-gbenson@redhat.com> In-Reply-To: <1426870087-32654-10-git-send-email-gbenson@redhat.com> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit X-SW-Source: 2015-04/txt/msg00033.txt.bz2 On 03/20/2015 04:48 PM, Gary Benson wrote: > This commit documents the newly added "target:" sysroot feature. > > gdb/ChangeLog: > > * NEWS: Announce the new default sysroot of "target:". > > gdb/doc/ChangeLog: > > * gdb.texinfo (set sysroot): Document "target:". > --- > gdb/ChangeLog | 4 ++++ > gdb/NEWS | 5 +++++ > gdb/doc/ChangeLog | 4 ++++ > gdb/doc/gdb.texinfo | 23 ++++++++++++++--------- > 4 files changed, 27 insertions(+), 9 deletions(-) > > diff --git a/gdb/NEWS b/gdb/NEWS > index bda4a35..3d4f98d 100644 > --- a/gdb/NEWS > +++ b/gdb/NEWS > @@ -7,6 +7,11 @@ > present in the debug info. This typically includes the compiler version > and may include things like its command line arguments. > > +* Paths supplied to the "set sysroot" commands may be prefixed with > + "target:" to tell GDB to access shared libraries from the target > + system, be it local or remote. This replaces the prefix "remote:". > + The default sysroot has been changed from "" to "target:". I think you should mention also what happens if you still use "remote:". Something around '"remote:" is automatically converted to "target:" for backward compatibility'. > +If @var{path} starts with the sequence @file{target:} and the target > +system is remote then @value{GDBN} will retrieve the target binaries > +from the remote system. This is only supported when using a remote > +target that supports the @code{remote get} command (@pxref{File > +Transfer,,Sending files to a remote system}). The part of @var{path} > +following the initial @file{target:} (if present) is used as system > +root prefix on the remote file system. If @var{path} starts with the > +sequence @file{remote:} this will be converted to the sequence s/this will be converted/this is converted/ > +@file{target:} by @code{set sysroot}. @footnote{Historically the > +functionality to retrieve binaries from the remote system was > +provided by prefixing @var{path} with @file{remote:}} @footnote{If you > +want to specify a local system root using a directory that happens to > +be named @file{target:} or @file{remote:}, you need to use some > +equivalent variant of the name like @file{./target:}.} > > For targets with an MS-DOS based filesystem, such as MS-Windows and > SymbianOS, @value{GDBN} tries prefixing a few variants of the target > Thanks, Pedro Alves