aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorLuis Machado <lgustavo@codesourcery.com>2017-02-13 07:29:30 -0600
committerLuis Machado <lgustavo@codesourcery.com>2017-02-13 07:29:30 -0600
commit5cf30ebf64d3c6da961094c615a94d2f1682a478 (patch)
tree803ac25d3d10a00b7bd49481a37f578d02f1b899 /gdb
parentbf5f525c8908b03f4892433baa707310b0b9959d (diff)
downloadgdb-5cf30ebf64d3c6da961094c615a94d2f1682a478.zip
gdb-5cf30ebf64d3c6da961094c615a94d2f1682a478.tar.gz
gdb-5cf30ebf64d3c6da961094c615a94d2f1682a478.tar.bz2
Improve load command's help text
This fairly obvious patch adds usage text to the load command's help text. Originally it did not have usage and mentioned things like FILE and OFFSET without explaining how those should be passed in the command. gdb/ChangeLog: 2017-02-13 Luis Machado <lgustavo@codesourcery.com> * symfile (_initialize_symfile): Add usage text to the load command's help text. gdb/doc/ChangeLog: 2017-02-13 Luis Machado <lgustavo@codesourcery.com> * gdb.texinfo (Target Commands): Document the optional offset argument for the load command.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/ChangeLog5
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo8
-rw-r--r--gdb/symfile.c5
4 files changed, 20 insertions, 3 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index dcd047a..e274191 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2017-02-13 Luis Machado <lgustavo@codesourcery.com>
+
+ * symfile (_initialize_symfile): Add usage text to the load command's
+ help text.
+
2017-02-10 Simon Marchi <simon.marchi@ericsson.com>
* utils.c (defaulted_query): Don't query on secondary UIs.
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 8acc482..7f125bc 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2017-02-13 Luis Machado <lgustavo@codesourcery.com>
+
+ * gdb.texinfo (Target Commands): Document the optional offset
+ argument for the load command.
+
2017-02-10 Martin Galvan <martingalvan@sourceware.org>
PR gdb/21122
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 35804c1..f619470 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -19600,8 +19600,8 @@ Show the current status of displaying communications between
@table @code
-@kindex load @var{filename}
-@item load @var{filename}
+@kindex load @var{filename} @var{offset}
+@item load @var{filename} @var{offset}
@anchor{load}
Depending on what remote debugging facilities are configured into
@value{GDBN}, the @code{load} command may be available. Where it exists, it
@@ -19620,6 +19620,10 @@ link the program; for other formats, like a.out, the object file format
specifies a fixed address.
@c FIXME! This would be a good place for an xref to the GNU linker doc.
+It is also possible to tell @value{GDBN} to load the executable file at a
+specific offset described by the optional argument @var{offset}. When
+@var{offset} is provided, @var{filename} must also be provided.
+
Depending on the remote side capabilities, @value{GDBN} may be able to
load programs into flash memory.
diff --git a/gdb/symfile.c b/gdb/symfile.c
index f31075d..f2528fc 100644
--- a/gdb/symfile.c
+++ b/gdb/symfile.c
@@ -3927,7 +3927,10 @@ that lies within the boundaries of this symbol file in memory."),
c = add_cmd ("load", class_files, load_command, _("\
Dynamically load FILE into the running program, and record its symbols\n\
for access from GDB.\n\
-A load OFFSET may also be given."), &cmdlist);
+An optional load OFFSET may also be given as a literal address.\n\
+When OFFSET is provided, FILE must also be provided. FILE can be provided\n\
+on its own.\n\
+Usage: load [FILE] [OFFSET]"), &cmdlist);
set_cmd_completer (c, filename_completer);
add_prefix_cmd ("overlay", class_support, overlay_command,