From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 36961 invoked by alias); 20 Mar 2015 16:57:36 -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 36892 invoked by uid 89); 20 Mar 2015 16:57:35 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.1 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; Fri, 20 Mar 2015 16:57:34 +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 (Postfix) with ESMTPS id 499442B6482 for ; Fri, 20 Mar 2015 16:48:13 +0000 (UTC) Received: from blade.nx (ovpn-116-93.ams2.redhat.com [10.36.116.93]) by int-mx09.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id t2KGmCxb010592 for ; Fri, 20 Mar 2015 12:48:12 -0400 Received: from blade.nx (localhost [127.0.0.1]) by blade.nx (Postfix) with ESMTP id CC84D26410F for ; Fri, 20 Mar 2015 16:48:10 +0000 (GMT) From: Gary Benson To: gdb-patches@sourceware.org Subject: [PATCH 9/9] Document "target:" sysroot changes Date: Fri, 20 Mar 2015 16:57:00 -0000 Message-Id: <1426870087-32654-10-git-send-email-gbenson@redhat.com> In-Reply-To: <1426870087-32654-1-git-send-email-gbenson@redhat.com> References: <1426870087-32654-1-git-send-email-gbenson@redhat.com> X-IsSubscribed: yes X-SW-Source: 2015-03/txt/msg00652.txt.bz2 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:". + * Python Scripting ** gdb.Objfile objects have a new attribute "username", diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 552da31..c5c3724 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -17814,15 +17814,20 @@ libraries, they need to be laid out in the same way that they are on the target, with e.g.@: a @file{/lib} and @file{/usr/lib} hierarchy under @var{path}. -If @var{path} starts with the sequence @file{remote:}, @value{GDBN} will -retrieve the target libraries 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{remote:} -(if present) is used as system root prefix on the remote file system. -@footnote{If you want to specify a local system root using a directory -that happens to be named @file{remote:}, you need to use some equivalent -variant of the name like @file{./remote:}.} +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 +@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 -- 1.7.1