yggdrasil/binutils-gdb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

gdb, doc: correct argument description for info connections/inferiors

Browse Source 
It said for 'info inferiors' and 'info connections' that the argument
could be 'a space separated list of inferior numbers' which is correct
but incomplete.  In fact the arguments can be any space separated
combination of numbers and (ascending) ranges.

The beginning of the section now describes the ID list as a new keyword.

Co-Authored-By: Christina Schimpe <christina.schimpe@intel.com>
This commit is contained in:
Nils-Christian Kempke 2021-11-25 10:53:30 +00:00 committed by Christina Schimpe
parent 7bb9e56c6a
commit d8ca1d2fc5
1 changed files with 13 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
gdb/doc/gdb.texinfo
View File

@ -3216,6 +3216,15 @@ embedded targets may have several inferiors running in different parts
of a single address space. Each inferior may in turn have multiple
threads running in it.
@cindex ID list
The commands @code{info inferiors} and @code{info connections}, which will be
introduced below, accept a space-separated @dfn{ID list} as their argument
specifying one or more elements on which to operate. A list element can be
either a single non-negative number, like @samp{5}, or an ascending range of
such numbers, like @samp{5-7}. A list can consist of any combination of such
elements, even duplicates or overlapping ranges are valid. E.g.@:
@samp{1 4-6 5 4-4} or @samp{1 2 4-7}.
To find out what inferiors exist at any moment, use @w{@code{info
inferiors}}:
@ -3223,9 +3232,8 @@ inferiors}}:
@kindex info inferiors [ @var{id}@dots{} ]
@item info inferiors
Print a list of all inferiors currently being managed by @value{GDBN}.
By default all inferiors are printed, but the argument @var{id}@dots{}
-- a space separated list of inferior numbers -- can be used to limit
the display to just the requested inferiors.
By default all inferiors are printed, but the ID list @var{id}@dots{} can be
used to limit the display to just the requested inferiors.
@value{GDBN} displays for each inferior (in this order):
@ -3284,9 +3292,8 @@ To find out what open target connections exist at any moment, use
@kindex info connections [ @var{id}@dots{} ]
@item info connections
Print a list of all open target connections currently being managed by
@value{GDBN}. By default all connections are printed, but the
argument @var{id}@dots{} -- a space separated list of connections
numbers -- can be used to limit the display to just the requested
@value{GDBN}. By default all connections are printed, but the ID list
@var{id}@dots{} can be used to limit the display to just the requested
connections.
@value{GDBN} displays for each connection (in this order):