diff options
author | Christina Schimpe <christina.schimpe@intel.com> | 2021-11-26 18:23:48 +0000 |
---|---|---|
committer | Christina Schimpe <christina.schimpe@intel.com> | 2023-01-30 12:45:31 +0100 |
commit | fe4c3ca0036b37ea43be1c36728b323f195ef1bb (patch) | |
tree | d370dbdef4f70cc7694e634642feaead7175b4d0 /gdb/doc/gdb.texinfo | |
parent | ff52c0736a637fec4938f4b957bc8847c709b13c (diff) | |
download | binutils-gdb-fe4c3ca0036b37ea43be1c36728b323f195ef1bb.tar.gz |
gdb: Add per-remote target variables for memory read and write config
This patch adds per-remote target variables for the configuration of
memory read- and write packet size. It is a further change to commit
"gdb: Make global feature array a per-remote target array" to apply the
fixme notes described in commit 5b6d1e4 "Multi-target support".
The former global variables for that configuration are still available
to allow the command line configuration for all future remote
connections. Similar to the command line configuration of the per-
remote target feature array, the commands
- set remotewritesize (deprecated)
- set remote memory-read-packet-size
- set remote memory-write-packet-size
will configure the current target (if available). If no target is
available, the default configuration for future remote connections is
adapted. The show command will display the current remote target's
packet size configuration. If no remote target is selected, the default
configuration for future connections will be shown.
It is required to adapt the test gdb.base/remote.exp which is failing
for --target_board=native-extended-gdbserver. With that board GDB
connects to gdbserver at gdb start time. Due to this patch two loggings
"The target may not be able to.." are shown if the command 'set remote
memory-write-packet-size fixed' is executed while a target is connected
for the current inferior. To fix this, the clean_restart command is
moved to a later time point of the test. It is sufficient to be
connected to the server when "runto_main" is executed. Now the
connection time is similar to a testrun with
--target_board=native-gdbserver.
To allow the user to distinguish between the packet-size configuration
for future remote connections and for the currently selected target, the
commands' loggings are adapted.
Diffstat (limited to 'gdb/doc/gdb.texinfo')
-rw-r--r-- | gdb/doc/gdb.texinfo | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index afbb4dea998..03033c7f9e3 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -24128,6 +24128,21 @@ future connections is shown. The available settings are: @end multitable +@cindex packet size, remote, configuring +The number of bytes per memory-read or memory-write packet for a remote target +can be configured using the commands +@w{@code{set remote memory-read-packet-size}} and +@w{@code{set remote memory-write-packet-size}}. If set to @samp{0} (zero) the +default packet size will be used. The actual limit is further reduced depending +on the target. Specify @samp{fixed} to disable the target-dependent restriction +and @samp{limit} to enable it. Similar to the enabling and disabling of remote +packets, the command applies to the currently selected target (if available). +If no remote target is selected, it applies to all future remote connections. +The configuration of the selected target can be displayed using the commands +@w{@code{show remote memory-read-packet-size}} and +@w{@code{show remote memory-write-packet-size}}. If no remote target is +selected, the default configuration for future connections is shown. + @node Remote Stub @section Implementing a Remote Stub |