aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorPedro Alves <palves@redhat.com>2016-01-13 10:56:08 +0000
committerPedro Alves <palves@redhat.com>2016-01-13 11:00:54 +0000
commit22a0232400ea09c57ab70d97cffc1f25e6320da7 (patch)
tree795f4c5f87e23dea3bffb5c17cdb6f142f2401de /gdb/doc
parent5d5658a1d3c3eb2a09c03f2f0662a1c01963c869 (diff)
downloadgdb-22a0232400ea09c57ab70d97cffc1f25e6320da7.zip
gdb-22a0232400ea09c57ab70d97cffc1f25e6320da7.tar.gz
gdb-22a0232400ea09c57ab70d97cffc1f25e6320da7.tar.bz2
Add Python InferiorThread.global_num attribute
This commit adds a new Python InferiorThread.global_num attribute. This can be used to pass the correct thread ID to Breakpoint.thread, which takes a global thread ID, not a per-inferior thread number. gdb/ChangeLog: 2016-01-13 Pedro Alves <palves@redhat.com> * NEWS: Mention InferiorThread.global_num. * python/py-infthread.c (thpy_get_global_num): New function. (thread_object_getset): Register "global_num". gdb/testsuite/ChangeLog: 2016-01-13 Pedro Alves <palves@redhat.com> * gdb.multi/tids.exp: Test InferiorThread.global_num and Breakpoint.thread. * gdb.python/py-infthread.exp: Test InferiorThread.global_num. gdb/doc/ChangeLog: 2016-01-13 Pedro Alves <palves@redhat.com> * python.texi (Breakpoints In Python) <Breakpoint.thread>: Add anchor. (Threads In Python): Document new InferiorThread.global_num attribute.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog7
-rw-r--r--gdb/doc/python.texi7
2 files changed, 14 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 46207f6..65f8ed9 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,10 @@
+2016-01-13 Pedro Alves <palves@redhat.com>
+
+ * python.texi (Breakpoints In Python) <Breakpoint.thread>: Add
+ anchor.
+ (Threads In Python): Document new InferiorThread.global_num
+ attribute.
+
2016-01-07 Pedro Alves <palves@redhat.com>
* gdb.texinfo (Threads): Document per-inferior thread IDs,
diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index f9f9e5b..ffbf89a 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -2998,6 +2998,12 @@ user-specified thread name.
The per-inferior number of the thread, as assigned by GDB.
@end defvar
+@defvar InferiorThread.global_num
+The global ID of the thread, as assigned by GDB. You can use this to
+make Python breakpoints thread-specific, for example
+(@pxref{python_breakpoint_thread,,The Breakpoint.thread attribute}).
+@end defvar
+
@defvar InferiorThread.ptid
ID of the thread, as assigned by the operating system. This attribute is a
tuple containing three integers. The first is the Process ID (PID); the second
@@ -4642,6 +4648,7 @@ first command is @code{silent}. This is not reported by the
@code{silent} attribute.
@end defvar
+@anchor{python_breakpoint_thread}
@defvar Breakpoint.thread
If the breakpoint is thread-specific, this attribute holds the
thread's global id. If the breakpoint is not thread-specific, this