diff options
author | Phil Muldoon <pmuldoon@redhat.com> | 2017-11-16 14:14:03 +0000 |
---|---|---|
committer | Phil Muldoon <pmuldoon@redhat.com> | 2017-11-16 14:14:03 +0000 |
commit | d8ae99a7b08e29e31446aee1e47e59943d7d9926 (patch) | |
tree | ee0081ddb399fd93d02184d9955fe3c0b636d17e /gdb/doc | |
parent | 38b28f7088057d70497de7312cd983ec8e408a76 (diff) | |
download | gdb-d8ae99a7b08e29e31446aee1e47e59943d7d9926.zip gdb-d8ae99a7b08e29e31446aee1e47e59943d7d9926.tar.gz gdb-d8ae99a7b08e29e31446aee1e47e59943d7d9926.tar.bz2 |
Add Python rbreak command.
gdb/Changelog
2017-11-16 Phil Muldoon <pmuldoon@redhat.com>
* python/python.c (gdbpy_rbreak): New function.
* NEWS: Document Python rbreak feature.
testsuite/Changelog
2017-11-16 Phil Muldoon <pmuldoon@redhat.com>
* gdb.python/py-rbreak.exp: New file.
* gdb.python/py-rbreak.c: New file.
* gdb.python/py-rbreak-func2.c: New file.
doc/Changelog
2017-11-16 Phil Muldoon <pmuldoon@redhat.com>
* python.texi (Basic Python): Add rbreak documentation.
Diffstat (limited to 'gdb/doc')
-rw-r--r-- | gdb/doc/ChangeLog | 4 | ||||
-rw-r--r-- | gdb/doc/python.texi | 17 |
2 files changed, 21 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 98eab72..2d8f5af 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2017-11-16 Phil Muldoon <pmuldoon@redhat.com> + + * python.texi (Basic Python): Add rbreak documentation. + 2017-11-07 Xavier Roirand <roirand@adacore.com> Pedro Alves <palves@redhat.com> diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi index f661e48..f411f60 100644 --- a/gdb/doc/python.texi +++ b/gdb/doc/python.texi @@ -243,6 +243,23 @@ were no breakpoints. This peculiarity was subsequently fixed, and now @code{gdb.breakpoints} returns an empty sequence in this case. @end defun +@defun gdb.rbreak (regex @r{[}, minsyms @r{[}, throttle, @r{[}, symtabs @r{]]]}) +Return a Python list holding a collection of newly set +@code{gdb.Breakpoint} objects matching function names defined by the +@var{regex} pattern. If the @var{minsyms} keyword is @code{True}, all +system functions (those not explicitly defined in the inferior) will +also be included in the match. The @var{throttle} keyword takes an +integer that defines the maximum number of pattern matches for +functions matched by the @var{regex} pattern. If the number of +matches exceeds the integer value of @var{throttle}, a +@code{RuntimeError} will be raised and no breakpoints will be created. +If @var{throttle} is not defined then there is no imposed limit on the +maximum number of matches and breakpoints to be created. The +@var{symtabs} keyword takes a Python iterable that yields a collection +of @code{gdb.Symtab} objects and will restrict the search to those +functions only contained within the @code{gdb.Symtab} objects. +@end defun + @findex gdb.parameter @defun gdb.parameter (parameter) Return the value of a @value{GDBN} @var{parameter} given by its name, |