aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGary Benson <gbenson@redhat.com>2015-04-02 13:38:29 +0100
committerGary Benson <gbenson@redhat.com>2015-04-02 13:38:29 +0100
commit599bd15cdae16c5c420c85cf4853fcfd769bce75 (patch)
treee59d9fe27ed63fadf8557c42b00c39ff83480524
parentfed040c6a50399617d8265cbddc7fd21b3f134ef (diff)
downloadgdb-599bd15cdae16c5c420c85cf4853fcfd769bce75.zip
gdb-599bd15cdae16c5c420c85cf4853fcfd769bce75.tar.gz
gdb-599bd15cdae16c5c420c85cf4853fcfd769bce75.tar.bz2
Document "target:" sysroot changes
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:".
-rw-r--r--gdb/ChangeLog4
-rw-r--r--gdb/NEWS7
-rw-r--r--gdb/doc/ChangeLog4
-rw-r--r--gdb/doc/gdb.texinfo23
4 files changed, 29 insertions, 9 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index dd27cd8..079a307 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,5 +1,9 @@
2015-04-02 Gary Benson <gbenson@redhat.com>
+ * NEWS: Announce the new default sysroot of "target:".
+
+2015-04-02 Gary Benson <gbenson@redhat.com>
+
* main.c (captured_main): Set gdb_sysroot to "target:"
if not otherwise set.
diff --git a/gdb/NEWS b/gdb/NEWS
index 5013484..884c381 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -24,6 +24,13 @@
present in the debug info. This typically includes the compiler version
and may include things like its command line arguments.
+* Directory names 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:". "remote:" is automatically converted to "target:" for
+ backward compatibility.
+
* Python Scripting
** gdb.Objfile objects have a new attribute "username",
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 8376689..b6c1ca3 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,7 @@
+2015-04-02 Gary Benson <gbenson@redhat.com>
+
+ * gdb.texinfo (set sysroot): Document "target:".
+
2015-04-01 Sasha Smundak <asmundak@google.com>
* doc/python.texi (Writing a Frame Unwinder in Python): Add
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index c6e9b9b..d794893 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -17854,15 +17854,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 is 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:}}. 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