From 13fd8b81f0460839d154c769d8ef004f41b29c55 Mon Sep 17 00:00:00 2001 From: Tom Tromey Date: Wed, 12 Jan 2011 14:30:45 +0000 Subject: [PATCH] * gdb.texinfo (Threads): Remove duplicate text. Update examples. Fix "thread apply" text. --- gdb/doc/ChangeLog | 5 ++++ gdb/doc/gdb.texinfo | 73 +++++---------------------------------------- 2 files changed, 13 insertions(+), 65 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index a64db4c703e..9529a4a70aa 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2011-01-12 Tom Tromey + + * gdb.texinfo (Threads): Remove duplicate text. Update examples. + Fix "thread apply" text. + 2011-01-11 Sergio Durigan Junior Thiago Jung Bauermann diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 8e429134581..b86e8d253c3 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -2731,70 +2731,13 @@ For example, @smallexample (@value{GDBP}) info threads - 3 process 35 thread 27 0x34e5 in sigpause () - 2 process 35 thread 23 0x34e5 in sigpause () -* 1 process 35 thread 13 main (argc=1, argv=0x7ffffff8) + Id Target Id Frame + 3 process 35 thread 27 0x34e5 in sigpause () + 2 process 35 thread 23 0x34e5 in sigpause () +* 1 process 35 thread 13 main (argc=1, argv=0x7ffffff8) at threadtest.c:68 @end smallexample -On HP-UX systems: - -@cindex debugging multithreaded programs (on HP-UX) -@cindex thread identifier (GDB), on HP-UX -For debugging purposes, @value{GDBN} associates its own thread -number---a small integer assigned in thread-creation order---with each -thread in your program. - -@cindex @code{New} @var{systag} message, on HP-UX -@cindex thread identifier (system), on HP-UX -@c FIXME-implementors!! It would be more helpful if the [New...] message -@c included GDB's numeric thread handle, so you could just go to that -@c thread without first checking `info threads'. -Whenever @value{GDBN} detects a new thread in your program, it displays -both @value{GDBN}'s thread number and the target system's identification for the thread with a message in the -form @samp{[New @var{systag}]}. @var{systag} is a thread identifier -whose form varies depending on the particular system. For example, on -HP-UX, you see - -@smallexample -[New thread 2 (system thread 26594)] -@end smallexample - -@noindent -when @value{GDBN} notices a new thread. - -@table @code -@kindex info threads (HP-UX) -@item info threads -Display a summary of all threads currently in your -program. @value{GDBN} displays for each thread (in this order): - -@enumerate -@item the thread number assigned by @value{GDBN} - -@item the target system's thread identifier (@var{systag}) - -@item the current stack frame summary for that thread -@end enumerate - -@noindent -An asterisk @samp{*} to the left of the @value{GDBN} thread number -indicates the current thread. - -For example, -@end table -@c end table here to get a little more width for example - -@smallexample -(@value{GDBP}) info threads - * 3 system thread 26607 worker (wptr=0x7b09c318 "@@") \@* - at quicksort.c:137 - 2 system thread 26606 0x7b0030d8 in __ksleep () \@* - from /usr/lib/libc.2 - 1 system thread 27905 0x7b003498 in _brk () \@* - from /usr/lib/libc.2 -@end smallexample - On Solaris, you can display more information about user threads with a Solaris-specific command: @@ -2815,10 +2758,10 @@ shown in the first field of the @samp{info threads} display. you selected, and its current stack frame summary: @smallexample -@c FIXME!! This example made up; find a @value{GDBN} w/threads and get real one (@value{GDBP}) thread 2 -[Switching to process 35 thread 23] -0x34e5 in sigpause () +[Switching to thread 2 (Thread 0xb7fdab70 (LWP 12747))] +#0 some_function (ignore=0x0) at example.c:8 +8 printf ("hello\n"); @end smallexample @noindent @@ -2835,7 +2778,7 @@ information on convenience variables. @kindex thread apply @cindex apply command to several threads -@item thread apply [@var{threadno}] [@var{all}] @var{command} +@item thread apply [@var{threadno} | all] @var{command} The @code{thread apply} command allows you to apply the named @var{command} to one or more threads. Specify the numbers of the threads that you want affected with the command argument -- 2.30.2