aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorPedro Alves <palves@redhat.com>2016-01-13 10:56:10 +0000
committerPedro Alves <palves@redhat.com>2016-01-13 11:03:19 +0000
commit663f6d42f47265d2deaa86c8a976e658fb13f820 (patch)
treebd245ce035bd243e40c05056a39ee0d28e8bc3c5 /gdb/doc
parentc84f6bbfe50ff13928360d3cc349d7c553867ce6 (diff)
downloadgdb-663f6d42f47265d2deaa86c8a976e658fb13f820.zip
gdb-663f6d42f47265d2deaa86c8a976e658fb13f820.tar.gz
gdb-663f6d42f47265d2deaa86c8a976e658fb13f820.tar.bz2
Add $_gthread convenience variable
This commit adds a new $_gthread convenience variable, that is like $_thread, but holds the current thread's global thread id. gdb/ChangeLog: 2016-01-13 Pedro Alves <palves@redhat.com> * NEWS: Mention $_gthread. * gdbthread.h (struct thread_info) <global_num>: Mention $_gthread. * thread.c (thread_num_make_value_helper): New function. (thread_id_make_value): Delete. (thread_id_per_inf_num_make_value, global_thread_id_make_value): New. (thread_funcs): Adjust. (gthread_funcs): New. (_initialize_thread): Register $_gthread variable. gdb/testsuite/ChangeLog: 2016-01-13 Pedro Alves <palves@redhat.com> * gdb.base/default.exp: Expect $_gthread as well. * gdb.multi/tids.exp: Test $_gthread. * gdb.threads/thread-specific.exp: Test $_gthread. gdb/doc/ChangeLog: 2016-01-13 Pedro Alves <palves@redhat.com> * gdb.texinfo (Threads): Document the $_gthread convenience variable. (Convenience Vars): Likewise.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog6
-rw-r--r--gdb/doc/gdb.texinfo9
2 files changed, 13 insertions, 2 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index d723276..4b59057 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,11 @@
2016-01-13 Pedro Alves <palves@redhat.com>
+ * gdb.texinfo (Threads): Document the $_gthread convenience
+ variable.
+ (Convenience Vars): Likewise.
+
+2016-01-13 Pedro Alves <palves@redhat.com>
+
* gdb.texinfo (Threads): Document "info threads -gid".
2016-01-13 Pedro Alves <palves@redhat.com>
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 654efa4..7da31c8 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -2937,8 +2937,10 @@ thread. In other words, @value{GDBN} assigns a thread number to the
program's ``main thread'' even if the program is not multi-threaded.
@vindex $_thread@r{, convenience variable}
-The debugger convenience variable @samp{$_thread} contains the
-per-inferior thread number of the current thread. You may find this
+@vindex $_gthread@r{, convenience variable}
+The debugger convenience variables @samp{$_thread} and
+@samp{$_gthread} contain, respectively, the per-inferior thread number
+and the global thread number of the current thread. You may find this
useful in writing breakpoint conditional expressions, command scripts,
and so forth. @xref{Convenience Vars,, Convenience Variables}, for
general information on convenience variables.
@@ -10459,6 +10461,9 @@ Programs, ,Debugging Multiple Inferiors and Programs}.
@item $_thread
The thread number of the current thread. @xref{thread numbers}.
+@item $_gthread
+The global number of the current thread. @xref{global thread numbers}.
+
@end table
@node Convenience Funs