1 /* Multi-process/thread control for GDB, the GNU debugger.
3 Copyright (C) 1986-2015 Free Software Foundation, Inc.
5 Contributed by Lynx Real-Time Systems, Inc. Los Gatos, CA.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
29 #include "gdbthread.h"
37 #include <sys/types.h>
42 #include "cli/cli-decode.h"
43 #include "gdb_regex.h"
44 #include "cli/cli-utils.h"
45 #include "continuations.h"
47 /* Definition of struct thread_info exported to gdbthread.h. */
49 /* Prototypes for exported functions. */
51 void _initialize_thread (void);
53 /* Prototypes for local functions. */
55 struct thread_info
*thread_list
= NULL
;
56 static int highest_thread_num
;
58 /* True if any thread is, or may be executing. We need to track this
59 separately because until we fully sync the thread list, we won't
60 know whether the target is fully stopped, even if we see stop
61 events for all known threads, because any of those threads may have
62 spawned new threads we haven't heard of yet. */
63 static int threads_executing
;
65 static void thread_apply_all_command (char *, int);
66 static int thread_alive (struct thread_info
*);
67 static void info_threads_command (char *, int);
68 static void thread_apply_command (char *, int);
69 static void restore_current_thread (ptid_t
);
71 /* Data to cleanup thread array. */
73 struct thread_array_cleanup
75 /* Array of thread pointers used to set
77 struct thread_info
**tp_array
;
79 /* Thread count in the array. */
85 inferior_thread (void)
87 struct thread_info
*tp
= find_thread_ptid (inferior_ptid
);
92 /* Delete the breakpoint pointed at by BP_P, if there's one. */
95 delete_thread_breakpoint (struct breakpoint
**bp_p
)
99 delete_breakpoint (*bp_p
);
105 delete_step_resume_breakpoint (struct thread_info
*tp
)
108 delete_thread_breakpoint (&tp
->control
.step_resume_breakpoint
);
112 delete_exception_resume_breakpoint (struct thread_info
*tp
)
115 delete_thread_breakpoint (&tp
->control
.exception_resume_breakpoint
);
118 /* See gdbthread.h. */
121 delete_single_step_breakpoints (struct thread_info
*tp
)
124 delete_thread_breakpoint (&tp
->control
.single_step_breakpoints
);
127 /* Delete the breakpoint pointed at by BP_P at the next stop, if
131 delete_at_next_stop (struct breakpoint
**bp
)
135 (*bp
)->disposition
= disp_del_at_next_stop
;
140 /* See gdbthread.h. */
143 thread_has_single_step_breakpoints_set (struct thread_info
*tp
)
145 return tp
->control
.single_step_breakpoints
!= NULL
;
148 /* See gdbthread.h. */
151 thread_has_single_step_breakpoint_here (struct thread_info
*tp
,
152 struct address_space
*aspace
,
155 struct breakpoint
*ss_bps
= tp
->control
.single_step_breakpoints
;
157 return (ss_bps
!= NULL
158 && breakpoint_has_location_inserted_here (ss_bps
, aspace
, addr
));
162 clear_thread_inferior_resources (struct thread_info
*tp
)
164 /* NOTE: this will take care of any left-over step_resume breakpoints,
165 but not any user-specified thread-specific breakpoints. We can not
166 delete the breakpoint straight-off, because the inferior might not
167 be stopped at the moment. */
168 delete_at_next_stop (&tp
->control
.step_resume_breakpoint
);
169 delete_at_next_stop (&tp
->control
.exception_resume_breakpoint
);
170 delete_at_next_stop (&tp
->control
.single_step_breakpoints
);
172 delete_longjmp_breakpoint_at_next_stop (tp
->num
);
174 bpstat_clear (&tp
->control
.stop_bpstat
);
176 btrace_teardown (tp
);
178 do_all_intermediate_continuations_thread (tp
, 1);
179 do_all_continuations_thread (tp
, 1);
183 free_thread (struct thread_info
*tp
)
187 if (tp
->private_dtor
)
188 tp
->private_dtor (tp
->priv
);
198 init_thread_list (void)
200 struct thread_info
*tp
, *tpnext
;
202 highest_thread_num
= 0;
207 for (tp
= thread_list
; tp
; tp
= tpnext
)
214 threads_executing
= 0;
217 /* Allocate a new thread with target id PTID and add it to the thread
220 static struct thread_info
*
221 new_thread (ptid_t ptid
)
223 struct thread_info
*tp
;
225 tp
= xcalloc (1, sizeof (*tp
));
228 tp
->num
= ++highest_thread_num
;
229 tp
->next
= thread_list
;
232 /* Nothing to follow yet. */
233 tp
->pending_follow
.kind
= TARGET_WAITKIND_SPURIOUS
;
234 tp
->state
= THREAD_STOPPED
;
235 tp
->suspend
.waitstatus
.kind
= TARGET_WAITKIND_IGNORE
;
241 add_thread_silent (ptid_t ptid
)
243 struct thread_info
*tp
;
245 tp
= find_thread_ptid (ptid
);
247 /* Found an old thread with the same id. It has to be dead,
248 otherwise we wouldn't be adding a new thread with the same id.
249 The OS is reusing this id --- delete it, and recreate a new
252 /* In addition to deleting the thread, if this is the current
253 thread, then we need to take care that delete_thread doesn't
254 really delete the thread if it is inferior_ptid. Create a
255 new template thread in the list with an invalid ptid, switch
256 to it, delete the original thread, reset the new thread's
257 ptid, and switch to it. */
259 if (ptid_equal (inferior_ptid
, ptid
))
261 tp
= new_thread (null_ptid
);
263 /* Make switch_to_thread not read from the thread. */
264 tp
->state
= THREAD_EXITED
;
265 switch_to_thread (null_ptid
);
267 /* Now we can delete it. */
268 delete_thread (ptid
);
270 /* Now reset its ptid, and reswitch inferior_ptid to it. */
272 tp
->state
= THREAD_STOPPED
;
273 switch_to_thread (ptid
);
275 observer_notify_new_thread (tp
);
281 /* Just go ahead and delete it. */
282 delete_thread (ptid
);
285 tp
= new_thread (ptid
);
286 observer_notify_new_thread (tp
);
292 add_thread_with_info (ptid_t ptid
, struct private_thread_info
*priv
)
294 struct thread_info
*result
= add_thread_silent (ptid
);
298 if (print_thread_events
)
299 printf_unfiltered (_("[New %s]\n"), target_pid_to_str (ptid
));
301 annotate_new_thread ();
306 add_thread (ptid_t ptid
)
308 return add_thread_with_info (ptid
, NULL
);
311 /* Add TP to the end of the step-over chain LIST_P. */
314 step_over_chain_enqueue (struct thread_info
**list_p
, struct thread_info
*tp
)
316 gdb_assert (tp
->step_over_next
== NULL
);
317 gdb_assert (tp
->step_over_prev
== NULL
);
322 tp
->step_over_prev
= tp
->step_over_next
= tp
;
326 struct thread_info
*head
= *list_p
;
327 struct thread_info
*tail
= head
->step_over_prev
;
329 tp
->step_over_prev
= tail
;
330 tp
->step_over_next
= head
;
331 head
->step_over_prev
= tp
;
332 tail
->step_over_next
= tp
;
336 /* Remove TP from step-over chain LIST_P. */
339 step_over_chain_remove (struct thread_info
**list_p
, struct thread_info
*tp
)
341 gdb_assert (tp
->step_over_next
!= NULL
);
342 gdb_assert (tp
->step_over_prev
!= NULL
);
346 if (tp
== tp
->step_over_next
)
349 *list_p
= tp
->step_over_next
;
352 tp
->step_over_prev
->step_over_next
= tp
->step_over_next
;
353 tp
->step_over_next
->step_over_prev
= tp
->step_over_prev
;
354 tp
->step_over_prev
= tp
->step_over_next
= NULL
;
357 /* See gdbthread.h. */
360 thread_step_over_chain_next (struct thread_info
*tp
)
362 struct thread_info
*next
= tp
->step_over_next
;
364 return (next
== step_over_queue_head
? NULL
: next
);
367 /* See gdbthread.h. */
370 thread_is_in_step_over_chain (struct thread_info
*tp
)
372 return (tp
->step_over_next
!= NULL
);
375 /* See gdbthread.h. */
378 thread_step_over_chain_enqueue (struct thread_info
*tp
)
380 step_over_chain_enqueue (&step_over_queue_head
, tp
);
383 /* See gdbthread.h. */
386 thread_step_over_chain_remove (struct thread_info
*tp
)
388 step_over_chain_remove (&step_over_queue_head
, tp
);
391 /* Delete thread PTID. If SILENT, don't notify the observer of this
394 delete_thread_1 (ptid_t ptid
, int silent
)
396 struct thread_info
*tp
, *tpprev
;
400 for (tp
= thread_list
; tp
; tpprev
= tp
, tp
= tp
->next
)
401 if (ptid_equal (tp
->ptid
, ptid
))
407 /* Dead threads don't need to step-over. Remove from queue. */
408 if (tp
->step_over_next
!= NULL
)
409 thread_step_over_chain_remove (tp
);
411 /* If this is the current thread, or there's code out there that
412 relies on it existing (refcount > 0) we can't delete yet. Mark
413 it as exited, and notify it. */
415 || ptid_equal (tp
->ptid
, inferior_ptid
))
417 if (tp
->state
!= THREAD_EXITED
)
419 observer_notify_thread_exit (tp
, silent
);
421 /* Tag it as exited. */
422 tp
->state
= THREAD_EXITED
;
424 /* Clear breakpoints, etc. associated with this thread. */
425 clear_thread_inferior_resources (tp
);
428 /* Will be really deleted some other time. */
432 /* Notify thread exit, but only if we haven't already. */
433 if (tp
->state
!= THREAD_EXITED
)
434 observer_notify_thread_exit (tp
, silent
);
436 /* Tag it as exited. */
437 tp
->state
= THREAD_EXITED
;
438 clear_thread_inferior_resources (tp
);
441 tpprev
->next
= tp
->next
;
443 thread_list
= tp
->next
;
448 /* Delete thread PTID and notify of thread exit. If this is
449 inferior_ptid, don't actually delete it, but tag it as exited and
450 do the notification. If PTID is the user selected thread, clear
453 delete_thread (ptid_t ptid
)
455 delete_thread_1 (ptid
, 0 /* not silent */);
459 delete_thread_silent (ptid_t ptid
)
461 delete_thread_1 (ptid
, 1 /* silent */);
465 find_thread_id (int num
)
467 struct thread_info
*tp
;
469 for (tp
= thread_list
; tp
; tp
= tp
->next
)
476 /* Find a thread_info by matching PTID. */
478 find_thread_ptid (ptid_t ptid
)
480 struct thread_info
*tp
;
482 for (tp
= thread_list
; tp
; tp
= tp
->next
)
483 if (ptid_equal (tp
->ptid
, ptid
))
490 * Thread iterator function.
492 * Calls a callback function once for each thread, so long as
493 * the callback function returns false. If the callback function
494 * returns true, the iteration will end and the current thread
495 * will be returned. This can be useful for implementing a
496 * search for a thread with arbitrary attributes, or for applying
497 * some operation to every thread.
499 * FIXME: some of the existing functionality, such as
500 * "Thread apply all", might be rewritten using this functionality.
504 iterate_over_threads (int (*callback
) (struct thread_info
*, void *),
507 struct thread_info
*tp
, *next
;
509 for (tp
= thread_list
; tp
; tp
= next
)
512 if ((*callback
) (tp
, data
))
523 struct thread_info
*tp
;
525 for (tp
= thread_list
; tp
; tp
= tp
->next
)
532 valid_thread_id (int num
)
534 struct thread_info
*tp
;
536 for (tp
= thread_list
; tp
; tp
= tp
->next
)
544 pid_to_thread_id (ptid_t ptid
)
546 struct thread_info
*tp
;
548 for (tp
= thread_list
; tp
; tp
= tp
->next
)
549 if (ptid_equal (tp
->ptid
, ptid
))
556 thread_id_to_pid (int num
)
558 struct thread_info
*thread
= find_thread_id (num
);
563 return pid_to_ptid (-1);
567 in_thread_list (ptid_t ptid
)
569 struct thread_info
*tp
;
571 for (tp
= thread_list
; tp
; tp
= tp
->next
)
572 if (ptid_equal (tp
->ptid
, ptid
))
575 return 0; /* Never heard of 'im. */
578 /* Finds the first thread of the inferior given by PID. If PID is -1,
579 return the first thread in the list. */
582 first_thread_of_process (int pid
)
584 struct thread_info
*tp
, *ret
= NULL
;
586 for (tp
= thread_list
; tp
; tp
= tp
->next
)
587 if (pid
== -1 || ptid_get_pid (tp
->ptid
) == pid
)
588 if (ret
== NULL
|| tp
->num
< ret
->num
)
595 any_thread_of_process (int pid
)
597 struct thread_info
*tp
;
599 gdb_assert (pid
!= 0);
601 /* Prefer the current thread. */
602 if (ptid_get_pid (inferior_ptid
) == pid
)
603 return inferior_thread ();
605 ALL_NON_EXITED_THREADS (tp
)
606 if (ptid_get_pid (tp
->ptid
) == pid
)
613 any_live_thread_of_process (int pid
)
615 struct thread_info
*curr_tp
= NULL
;
616 struct thread_info
*tp
;
617 struct thread_info
*tp_executing
= NULL
;
619 gdb_assert (pid
!= 0);
621 /* Prefer the current thread if it's not executing. */
622 if (ptid_get_pid (inferior_ptid
) == pid
)
624 /* If the current thread is dead, forget it. If it's not
625 executing, use it. Otherwise, still choose it (below), but
626 only if no other non-executing thread is found. */
627 curr_tp
= inferior_thread ();
628 if (curr_tp
->state
== THREAD_EXITED
)
630 else if (!curr_tp
->executing
)
634 ALL_NON_EXITED_THREADS (tp
)
635 if (ptid_get_pid (tp
->ptid
) == pid
)
643 /* If both the current thread and all live threads are executing,
644 prefer the current thread. */
648 /* Otherwise, just return an executing thread, if any. */
652 /* Print a list of thread ids currently known, and the total number of
653 threads. To be used from within catch_errors. */
655 do_captured_list_thread_ids (struct ui_out
*uiout
, void *arg
)
657 struct thread_info
*tp
;
659 struct cleanup
*cleanup_chain
;
660 int current_thread
= -1;
662 update_thread_list ();
664 cleanup_chain
= make_cleanup_ui_out_tuple_begin_end (uiout
, "thread-ids");
666 for (tp
= thread_list
; tp
; tp
= tp
->next
)
668 if (tp
->state
== THREAD_EXITED
)
671 if (ptid_equal (tp
->ptid
, inferior_ptid
))
672 current_thread
= tp
->num
;
675 ui_out_field_int (uiout
, "thread-id", tp
->num
);
678 do_cleanups (cleanup_chain
);
680 if (current_thread
!= -1)
681 ui_out_field_int (uiout
, "current-thread-id", current_thread
);
682 ui_out_field_int (uiout
, "number-of-threads", num
);
686 /* Official gdblib interface function to get a list of thread ids and
689 gdb_list_thread_ids (struct ui_out
*uiout
, char **error_message
)
691 if (catch_exceptions_with_msg (uiout
, do_captured_list_thread_ids
, NULL
,
692 error_message
, RETURN_MASK_ALL
) < 0)
697 /* Return true if TP is an active thread. */
699 thread_alive (struct thread_info
*tp
)
701 if (tp
->state
== THREAD_EXITED
)
703 if (!target_thread_alive (tp
->ptid
))
708 /* See gdbthreads.h. */
713 struct thread_info
*tp
, *tmp
;
715 ALL_THREADS_SAFE (tp
, tmp
)
717 if (!thread_alive (tp
))
718 delete_thread (tp
->ptid
);
722 /* See gdbthreads.h. */
725 delete_exited_threads (void)
727 struct thread_info
*tp
, *tmp
;
729 ALL_THREADS_SAFE (tp
, tmp
)
731 if (tp
->state
== THREAD_EXITED
)
732 delete_thread (tp
->ptid
);
736 /* Disable storing stack temporaries for the thread whose id is
740 disable_thread_stack_temporaries (void *data
)
743 struct thread_info
*tp
= find_thread_ptid (*pd
);
747 tp
->stack_temporaries_enabled
= 0;
748 VEC_free (value_ptr
, tp
->stack_temporaries
);
754 /* Enable storing stack temporaries for thread with id PTID and return a
755 cleanup which can disable and clear the stack temporaries. */
758 enable_thread_stack_temporaries (ptid_t ptid
)
760 struct thread_info
*tp
= find_thread_ptid (ptid
);
764 gdb_assert (tp
!= NULL
);
766 tp
->stack_temporaries_enabled
= 1;
767 tp
->stack_temporaries
= NULL
;
768 data
= (ptid_t
*) xmalloc (sizeof (ptid_t
));
770 c
= make_cleanup (disable_thread_stack_temporaries
, data
);
775 /* Return non-zero value if stack temporaies are enabled for the thread
779 thread_stack_temporaries_enabled_p (ptid_t ptid
)
781 struct thread_info
*tp
= find_thread_ptid (ptid
);
786 return tp
->stack_temporaries_enabled
;
789 /* Push V on to the stack temporaries of the thread with id PTID. */
792 push_thread_stack_temporary (ptid_t ptid
, struct value
*v
)
794 struct thread_info
*tp
= find_thread_ptid (ptid
);
796 gdb_assert (tp
!= NULL
&& tp
->stack_temporaries_enabled
);
797 VEC_safe_push (value_ptr
, tp
->stack_temporaries
, v
);
800 /* Return 1 if VAL is among the stack temporaries of the thread
801 with id PTID. Return 0 otherwise. */
804 value_in_thread_stack_temporaries (struct value
*val
, ptid_t ptid
)
806 struct thread_info
*tp
= find_thread_ptid (ptid
);
808 gdb_assert (tp
!= NULL
&& tp
->stack_temporaries_enabled
);
809 if (!VEC_empty (value_ptr
, tp
->stack_temporaries
))
814 for (i
= 0; VEC_iterate (value_ptr
, tp
->stack_temporaries
, i
, v
); i
++)
822 /* Return the last of the stack temporaries for thread with id PTID.
823 Return NULL if there are no stack temporaries for the thread. */
826 get_last_thread_stack_temporary (ptid_t ptid
)
828 struct value
*lastval
= NULL
;
829 struct thread_info
*tp
= find_thread_ptid (ptid
);
831 gdb_assert (tp
!= NULL
);
832 if (!VEC_empty (value_ptr
, tp
->stack_temporaries
))
833 lastval
= VEC_last (value_ptr
, tp
->stack_temporaries
);
839 thread_change_ptid (ptid_t old_ptid
, ptid_t new_ptid
)
841 struct inferior
*inf
;
842 struct thread_info
*tp
;
844 /* It can happen that what we knew as the target inferior id
845 changes. E.g, target remote may only discover the remote process
846 pid after adding the inferior to GDB's list. */
847 inf
= find_inferior_ptid (old_ptid
);
848 inf
->pid
= ptid_get_pid (new_ptid
);
850 tp
= find_thread_ptid (old_ptid
);
853 observer_notify_thread_ptid_changed (old_ptid
, new_ptid
);
856 /* See gdbthread.h. */
859 set_resumed (ptid_t ptid
, int resumed
)
861 struct thread_info
*tp
;
862 int all
= ptid_equal (ptid
, minus_one_ptid
);
864 if (all
|| ptid_is_pid (ptid
))
866 for (tp
= thread_list
; tp
; tp
= tp
->next
)
867 if (all
|| ptid_get_pid (tp
->ptid
) == ptid_get_pid (ptid
))
868 tp
->resumed
= resumed
;
872 tp
= find_thread_ptid (ptid
);
873 gdb_assert (tp
!= NULL
);
874 tp
->resumed
= resumed
;
878 /* Helper for set_running, that marks one thread either running or
882 set_running_thread (struct thread_info
*tp
, int running
)
886 if (running
&& tp
->state
== THREAD_STOPPED
)
888 tp
->state
= running
? THREAD_RUNNING
: THREAD_STOPPED
;
892 /* If the thread is now marked stopped, remove it from
893 the step-over queue, so that we don't try to resume
894 it until the user wants it to. */
895 if (tp
->step_over_next
!= NULL
)
896 thread_step_over_chain_remove (tp
);
903 set_running (ptid_t ptid
, int running
)
905 struct thread_info
*tp
;
906 int all
= ptid_equal (ptid
, minus_one_ptid
);
909 /* We try not to notify the observer if no thread has actually changed
910 the running state -- merely to reduce the number of messages to
911 frontend. Frontend is supposed to handle multiple *running just fine. */
912 if (all
|| ptid_is_pid (ptid
))
914 for (tp
= thread_list
; tp
; tp
= tp
->next
)
915 if (all
|| ptid_get_pid (tp
->ptid
) == ptid_get_pid (ptid
))
917 if (tp
->state
== THREAD_EXITED
)
920 if (set_running_thread (tp
, running
))
926 tp
= find_thread_ptid (ptid
);
927 gdb_assert (tp
!= NULL
);
928 gdb_assert (tp
->state
!= THREAD_EXITED
);
929 if (set_running_thread (tp
, running
))
933 observer_notify_target_resumed (ptid
);
937 is_thread_state (ptid_t ptid
, enum thread_state state
)
939 struct thread_info
*tp
;
941 tp
= find_thread_ptid (ptid
);
943 return tp
->state
== state
;
947 is_stopped (ptid_t ptid
)
949 return is_thread_state (ptid
, THREAD_STOPPED
);
953 is_exited (ptid_t ptid
)
955 return is_thread_state (ptid
, THREAD_EXITED
);
959 is_running (ptid_t ptid
)
961 return is_thread_state (ptid
, THREAD_RUNNING
);
965 is_executing (ptid_t ptid
)
967 struct thread_info
*tp
;
969 tp
= find_thread_ptid (ptid
);
971 return tp
->executing
;
975 set_executing (ptid_t ptid
, int executing
)
977 struct thread_info
*tp
;
978 int all
= ptid_equal (ptid
, minus_one_ptid
);
980 if (all
|| ptid_is_pid (ptid
))
982 for (tp
= thread_list
; tp
; tp
= tp
->next
)
983 if (all
|| ptid_get_pid (tp
->ptid
) == ptid_get_pid (ptid
))
984 tp
->executing
= executing
;
988 tp
= find_thread_ptid (ptid
);
990 tp
->executing
= executing
;
993 /* It only takes one running thread to spawn more threads.*/
995 threads_executing
= 1;
996 /* Only clear the flag if the caller is telling us everything is
998 else if (ptid_equal (minus_one_ptid
, ptid
))
999 threads_executing
= 0;
1002 /* See gdbthread.h. */
1005 threads_are_executing (void)
1007 return threads_executing
;
1011 set_stop_requested (ptid_t ptid
, int stop
)
1013 struct thread_info
*tp
;
1014 int all
= ptid_equal (ptid
, minus_one_ptid
);
1016 if (all
|| ptid_is_pid (ptid
))
1018 for (tp
= thread_list
; tp
; tp
= tp
->next
)
1019 if (all
|| ptid_get_pid (tp
->ptid
) == ptid_get_pid (ptid
))
1020 tp
->stop_requested
= stop
;
1024 tp
= find_thread_ptid (ptid
);
1026 tp
->stop_requested
= stop
;
1029 /* Call the stop requested observer so other components of GDB can
1030 react to this request. */
1032 observer_notify_thread_stop_requested (ptid
);
1036 finish_thread_state (ptid_t ptid
)
1038 struct thread_info
*tp
;
1040 int any_started
= 0;
1042 all
= ptid_equal (ptid
, minus_one_ptid
);
1044 if (all
|| ptid_is_pid (ptid
))
1046 for (tp
= thread_list
; tp
; tp
= tp
->next
)
1048 if (tp
->state
== THREAD_EXITED
)
1050 if (all
|| ptid_get_pid (ptid
) == ptid_get_pid (tp
->ptid
))
1052 if (set_running_thread (tp
, tp
->executing
))
1059 tp
= find_thread_ptid (ptid
);
1061 if (tp
->state
!= THREAD_EXITED
)
1063 if (set_running_thread (tp
, tp
->executing
))
1069 observer_notify_target_resumed (ptid
);
1073 finish_thread_state_cleanup (void *arg
)
1075 ptid_t
*ptid_p
= arg
;
1079 finish_thread_state (*ptid_p
);
1083 pc_in_thread_step_range (CORE_ADDR pc
, struct thread_info
*thread
)
1085 return (pc
>= thread
->control
.step_range_start
1086 && pc
< thread
->control
.step_range_end
);
1089 /* Prints the list of threads and their details on UIOUT.
1090 This is a version of 'info_threads_command' suitable for
1092 If REQUESTED_THREAD is not -1, it's the GDB id of the thread
1093 that should be printed. Otherwise, all threads are
1095 If PID is not -1, only print threads from the process PID.
1096 Otherwise, threads from all attached PIDs are printed.
1097 If both REQUESTED_THREAD and PID are not -1, then the thread
1098 is printed if it belongs to the specified process. Otherwise,
1099 an error is raised. */
1101 print_thread_info (struct ui_out
*uiout
, char *requested_threads
, int pid
)
1103 struct thread_info
*tp
;
1104 ptid_t current_ptid
;
1105 struct cleanup
*old_chain
;
1106 char *extra_info
, *name
, *target_id
;
1107 int current_thread
= -1;
1109 update_thread_list ();
1110 current_ptid
= inferior_ptid
;
1112 /* We'll be switching threads temporarily. */
1113 old_chain
= make_cleanup_restore_current_thread ();
1115 /* For backward compatibility, we make a list for MI. A table is
1116 preferable for the CLI, though, because it shows table
1118 if (ui_out_is_mi_like_p (uiout
))
1119 make_cleanup_ui_out_list_begin_end (uiout
, "threads");
1124 for (tp
= thread_list
; tp
; tp
= tp
->next
)
1126 if (!number_is_in_list (requested_threads
, tp
->num
))
1129 if (pid
!= -1 && ptid_get_pid (tp
->ptid
) != pid
)
1132 if (tp
->state
== THREAD_EXITED
)
1140 if (requested_threads
== NULL
|| *requested_threads
== '\0')
1141 ui_out_message (uiout
, 0, _("No threads.\n"));
1143 ui_out_message (uiout
, 0, _("No threads match '%s'.\n"),
1145 do_cleanups (old_chain
);
1149 make_cleanup_ui_out_table_begin_end (uiout
, 4, n_threads
, "threads");
1151 ui_out_table_header (uiout
, 1, ui_left
, "current", "");
1152 ui_out_table_header (uiout
, 4, ui_left
, "id", "Id");
1153 ui_out_table_header (uiout
, 17, ui_left
, "target-id", "Target Id");
1154 ui_out_table_header (uiout
, 1, ui_left
, "frame", "Frame");
1155 ui_out_table_body (uiout
);
1158 for (tp
= thread_list
; tp
; tp
= tp
->next
)
1160 struct cleanup
*chain2
;
1163 if (!number_is_in_list (requested_threads
, tp
->num
))
1166 if (pid
!= -1 && ptid_get_pid (tp
->ptid
) != pid
)
1168 if (requested_threads
!= NULL
&& *requested_threads
!= '\0')
1169 error (_("Requested thread not found in requested process"));
1173 if (ptid_equal (tp
->ptid
, current_ptid
))
1174 current_thread
= tp
->num
;
1176 if (tp
->state
== THREAD_EXITED
)
1179 chain2
= make_cleanup_ui_out_tuple_begin_end (uiout
, NULL
);
1181 if (ui_out_is_mi_like_p (uiout
))
1183 /* Compatibility. */
1184 if (ptid_equal (tp
->ptid
, current_ptid
))
1185 ui_out_text (uiout
, "* ");
1187 ui_out_text (uiout
, " ");
1191 if (ptid_equal (tp
->ptid
, current_ptid
))
1192 ui_out_field_string (uiout
, "current", "*");
1194 ui_out_field_skip (uiout
, "current");
1197 ui_out_field_int (uiout
, "id", tp
->num
);
1199 /* For the CLI, we stuff everything into the target-id field.
1200 This is a gross hack to make the output come out looking
1201 correct. The underlying problem here is that ui-out has no
1202 way to specify that a field's space allocation should be
1203 shared by several fields. For MI, we do the right thing
1206 target_id
= target_pid_to_str (tp
->ptid
);
1207 extra_info
= target_extra_thread_info (tp
);
1208 name
= tp
->name
? tp
->name
: target_thread_name (tp
);
1210 if (ui_out_is_mi_like_p (uiout
))
1212 ui_out_field_string (uiout
, "target-id", target_id
);
1214 ui_out_field_string (uiout
, "details", extra_info
);
1216 ui_out_field_string (uiout
, "name", name
);
1220 struct cleanup
*str_cleanup
;
1223 if (extra_info
&& name
)
1224 contents
= xstrprintf ("%s \"%s\" (%s)", target_id
,
1226 else if (extra_info
)
1227 contents
= xstrprintf ("%s (%s)", target_id
, extra_info
);
1229 contents
= xstrprintf ("%s \"%s\"", target_id
, name
);
1231 contents
= xstrdup (target_id
);
1232 str_cleanup
= make_cleanup (xfree
, contents
);
1234 ui_out_field_string (uiout
, "target-id", contents
);
1235 do_cleanups (str_cleanup
);
1238 if (tp
->state
== THREAD_RUNNING
)
1239 ui_out_text (uiout
, "(running)\n");
1242 /* The switch below puts us at the top of the stack (leaf
1244 switch_to_thread (tp
->ptid
);
1245 print_stack_frame (get_selected_frame (NULL
),
1246 /* For MI output, print frame level. */
1247 ui_out_is_mi_like_p (uiout
),
1251 if (ui_out_is_mi_like_p (uiout
))
1253 char *state
= "stopped";
1255 if (tp
->state
== THREAD_RUNNING
)
1257 ui_out_field_string (uiout
, "state", state
);
1260 core
= target_core_of_thread (tp
->ptid
);
1261 if (ui_out_is_mi_like_p (uiout
) && core
!= -1)
1262 ui_out_field_int (uiout
, "core", core
);
1264 do_cleanups (chain2
);
1267 /* Restores the current thread and the frame selected before
1268 the "info threads" command. */
1269 do_cleanups (old_chain
);
1271 if (pid
== -1 && requested_threads
== NULL
)
1273 gdb_assert (current_thread
!= -1
1275 || ptid_equal (inferior_ptid
, null_ptid
));
1276 if (current_thread
!= -1 && ui_out_is_mi_like_p (uiout
))
1277 ui_out_field_int (uiout
, "current-thread-id", current_thread
);
1279 if (current_thread
!= -1 && is_exited (current_ptid
))
1280 ui_out_message (uiout
, 0, "\n\
1281 The current thread <Thread ID %d> has terminated. See `help thread'.\n",
1283 else if (thread_list
1284 && current_thread
== -1
1285 && ptid_equal (current_ptid
, null_ptid
))
1286 ui_out_message (uiout
, 0, "\n\
1287 No selected thread. See `help thread'.\n");
1291 /* Print information about currently known threads
1293 Optional ARG is a thread id, or list of thread ids.
1295 Note: this has the drawback that it _really_ switches
1296 threads, which frees the frame cache. A no-side
1297 effects info-threads command would be nicer. */
1300 info_threads_command (char *arg
, int from_tty
)
1302 print_thread_info (current_uiout
, arg
, -1);
1305 /* Switch from one thread to another. */
1308 switch_to_thread (ptid_t ptid
)
1310 /* Switch the program space as well, if we can infer it from the now
1311 current thread. Otherwise, it's up to the caller to select the
1313 if (!ptid_equal (ptid
, null_ptid
))
1315 struct inferior
*inf
;
1317 inf
= find_inferior_ptid (ptid
);
1318 gdb_assert (inf
!= NULL
);
1319 set_current_program_space (inf
->pspace
);
1320 set_current_inferior (inf
);
1323 if (ptid_equal (ptid
, inferior_ptid
))
1326 inferior_ptid
= ptid
;
1327 reinit_frame_cache ();
1329 /* We don't check for is_stopped, because we're called at times
1330 while in the TARGET_RUNNING state, e.g., while handling an
1332 if (!ptid_equal (inferior_ptid
, null_ptid
)
1333 && !is_exited (ptid
)
1334 && !is_executing (ptid
))
1335 stop_pc
= regcache_read_pc (get_thread_regcache (ptid
));
1337 stop_pc
= ~(CORE_ADDR
) 0;
1341 restore_current_thread (ptid_t ptid
)
1343 switch_to_thread (ptid
);
1347 restore_selected_frame (struct frame_id a_frame_id
, int frame_level
)
1349 struct frame_info
*frame
= NULL
;
1352 /* This means there was no selected frame. */
1353 if (frame_level
== -1)
1355 select_frame (NULL
);
1359 gdb_assert (frame_level
>= 0);
1361 /* Restore by level first, check if the frame id is the same as
1362 expected. If that fails, try restoring by frame id. If that
1363 fails, nothing to do, just warn the user. */
1365 count
= frame_level
;
1366 frame
= find_relative_frame (get_current_frame (), &count
);
1369 /* The frame ids must match - either both valid or both outer_frame_id.
1370 The latter case is not failsafe, but since it's highly unlikely
1371 the search by level finds the wrong frame, it's 99.9(9)% of
1372 the time (for all practical purposes) safe. */
1373 && frame_id_eq (get_frame_id (frame
), a_frame_id
))
1375 /* Cool, all is fine. */
1376 select_frame (frame
);
1380 frame
= frame_find_by_id (a_frame_id
);
1383 /* Cool, refound it. */
1384 select_frame (frame
);
1388 /* Nothing else to do, the frame layout really changed. Select the
1389 innermost stack frame. */
1390 select_frame (get_current_frame ());
1392 /* Warn the user. */
1393 if (frame_level
> 0 && !ui_out_is_mi_like_p (current_uiout
))
1395 warning (_("Couldn't restore frame #%d in "
1396 "current thread. Bottom (innermost) frame selected:"),
1398 /* For MI, we should probably have a notification about
1399 current frame change. But this error is not very
1400 likely, so don't bother for now. */
1401 print_stack_frame (get_selected_frame (NULL
), 1, SRC_AND_LOC
, 1);
1405 /* Data used by the cleanup installed by
1406 'make_cleanup_restore_current_thread'. */
1408 struct current_thread_cleanup
1410 /* Next in list of currently installed 'struct
1411 current_thread_cleanup' cleanups. See
1412 'current_thread_cleanup_chain' below. */
1413 struct current_thread_cleanup
*next
;
1415 ptid_t inferior_ptid
;
1416 struct frame_id selected_frame_id
;
1417 int selected_frame_level
;
1423 /* A chain of currently installed 'struct current_thread_cleanup'
1424 cleanups. Restoring the previously selected thread looks up the
1425 old thread in the thread list by ptid. If the thread changes ptid,
1426 we need to update the cleanup's thread structure so the look up
1428 static struct current_thread_cleanup
*current_thread_cleanup_chain
;
1430 /* A thread_ptid_changed observer. Update all currently installed
1431 current_thread_cleanup cleanups that want to switch back to
1432 OLD_PTID to switch back to NEW_PTID instead. */
1435 restore_current_thread_ptid_changed (ptid_t old_ptid
, ptid_t new_ptid
)
1437 struct current_thread_cleanup
*it
;
1439 for (it
= current_thread_cleanup_chain
; it
!= NULL
; it
= it
->next
)
1441 if (ptid_equal (it
->inferior_ptid
, old_ptid
))
1442 it
->inferior_ptid
= new_ptid
;
1447 do_restore_current_thread_cleanup (void *arg
)
1449 struct thread_info
*tp
;
1450 struct current_thread_cleanup
*old
= arg
;
1452 tp
= find_thread_ptid (old
->inferior_ptid
);
1454 /* If the previously selected thread belonged to a process that has
1455 in the mean time been deleted (due to normal exit, detach, etc.),
1456 then don't revert back to it, but instead simply drop back to no
1459 && find_inferior_ptid (tp
->ptid
) != NULL
)
1460 restore_current_thread (old
->inferior_ptid
);
1463 restore_current_thread (null_ptid
);
1464 set_current_inferior (find_inferior_id (old
->inf_id
));
1467 /* The running state of the originally selected thread may have
1468 changed, so we have to recheck it here. */
1469 if (!ptid_equal (inferior_ptid
, null_ptid
)
1471 && is_stopped (inferior_ptid
)
1472 && target_has_registers
1474 && target_has_memory
)
1475 restore_selected_frame (old
->selected_frame_id
,
1476 old
->selected_frame_level
);
1480 restore_current_thread_cleanup_dtor (void *arg
)
1482 struct current_thread_cleanup
*old
= arg
;
1483 struct thread_info
*tp
;
1484 struct inferior
*inf
;
1486 current_thread_cleanup_chain
= current_thread_cleanup_chain
->next
;
1488 tp
= find_thread_ptid (old
->inferior_ptid
);
1491 inf
= find_inferior_id (old
->inf_id
);
1493 inf
->removable
= old
->was_removable
;
1497 /* Set the thread reference count. */
1500 set_thread_refcount (void *data
)
1503 struct thread_array_cleanup
*ta_cleanup
= data
;
1505 for (k
= 0; k
!= ta_cleanup
->count
; k
++)
1506 ta_cleanup
->tp_array
[k
]->refcount
--;
1510 make_cleanup_restore_current_thread (void)
1512 struct thread_info
*tp
;
1513 struct frame_info
*frame
;
1514 struct current_thread_cleanup
*old
;
1516 old
= xmalloc (sizeof (struct current_thread_cleanup
));
1517 old
->inferior_ptid
= inferior_ptid
;
1518 old
->inf_id
= current_inferior ()->num
;
1519 old
->was_removable
= current_inferior ()->removable
;
1521 old
->next
= current_thread_cleanup_chain
;
1522 current_thread_cleanup_chain
= old
;
1524 if (!ptid_equal (inferior_ptid
, null_ptid
))
1526 old
->was_stopped
= is_stopped (inferior_ptid
);
1527 if (old
->was_stopped
1528 && target_has_registers
1530 && target_has_memory
)
1532 /* When processing internal events, there might not be a
1533 selected frame. If we naively call get_selected_frame
1534 here, then we can end up reading debuginfo for the
1535 current frame, but we don't generally need the debuginfo
1537 frame
= get_selected_frame_if_set ();
1542 old
->selected_frame_id
= get_frame_id (frame
);
1543 old
->selected_frame_level
= frame_relative_level (frame
);
1545 tp
= find_thread_ptid (inferior_ptid
);
1550 current_inferior ()->removable
= 0;
1552 return make_cleanup_dtor (do_restore_current_thread_cleanup
, old
,
1553 restore_current_thread_cleanup_dtor
);
1556 /* If non-zero tp_array_compar should sort in ascending order, otherwise in
1557 descending order. */
1559 static int tp_array_compar_ascending
;
1561 /* Sort an array for struct thread_info pointers by their NUM, order is
1562 determined by TP_ARRAY_COMPAR_ASCENDING. */
1565 tp_array_compar (const void *ap_voidp
, const void *bp_voidp
)
1567 const struct thread_info
*const *ap
= ap_voidp
;
1568 const struct thread_info
*const *bp
= bp_voidp
;
1570 return ((((*ap
)->num
> (*bp
)->num
) - ((*ap
)->num
< (*bp
)->num
))
1571 * (tp_array_compar_ascending
? +1 : -1));
1574 /* Apply a GDB command to a list of threads. List syntax is a whitespace
1575 seperated list of numbers, or ranges, or the keyword `all'. Ranges consist
1576 of two numbers seperated by a hyphen. Examples:
1578 thread apply 1 2 7 4 backtrace Apply backtrace cmd to threads 1,2,7,4
1579 thread apply 2-7 9 p foo(1) Apply p foo(1) cmd to threads 2->7 & 9
1580 thread apply all p x/i $pc Apply x/i $pc cmd to all threads. */
1583 thread_apply_all_command (char *cmd
, int from_tty
)
1585 struct cleanup
*old_chain
;
1588 struct thread_array_cleanup ta_cleanup
;
1590 tp_array_compar_ascending
= 0;
1592 && check_for_argument (&cmd
, "-ascending", strlen ("-ascending")))
1594 cmd
= skip_spaces (cmd
);
1595 tp_array_compar_ascending
= 1;
1598 if (cmd
== NULL
|| *cmd
== '\000')
1599 error (_("Please specify a command following the thread ID list"));
1601 update_thread_list ();
1603 old_chain
= make_cleanup_restore_current_thread ();
1605 /* Save a copy of the command in case it is clobbered by
1607 saved_cmd
= xstrdup (cmd
);
1608 make_cleanup (xfree
, saved_cmd
);
1610 /* Note this includes exited threads. */
1611 tc
= thread_count ();
1614 struct thread_info
**tp_array
;
1615 struct thread_info
*tp
;
1618 /* Save a copy of the thread_list in case we execute detach
1620 tp_array
= xmalloc (sizeof (struct thread_info
*) * tc
);
1621 make_cleanup (xfree
, tp_array
);
1623 ALL_NON_EXITED_THREADS (tp
)
1629 /* Because we skipped exited threads, we may end up with fewer
1630 threads in the array than the total count of threads. */
1631 gdb_assert (i
<= tc
);
1634 qsort (tp_array
, i
, sizeof (*tp_array
), tp_array_compar
);
1636 ta_cleanup
.tp_array
= tp_array
;
1637 ta_cleanup
.count
= i
;
1638 make_cleanup (set_thread_refcount
, &ta_cleanup
);
1640 for (k
= 0; k
!= i
; k
++)
1641 if (thread_alive (tp_array
[k
]))
1643 switch_to_thread (tp_array
[k
]->ptid
);
1644 printf_filtered (_("\nThread %d (%s):\n"),
1646 target_pid_to_str (inferior_ptid
));
1647 execute_command (cmd
, from_tty
);
1649 /* Restore exact command used previously. */
1650 strcpy (cmd
, saved_cmd
);
1654 do_cleanups (old_chain
);
1658 thread_apply_command (char *tidlist
, int from_tty
)
1661 struct cleanup
*old_chain
;
1663 struct get_number_or_range_state state
;
1665 if (tidlist
== NULL
|| *tidlist
== '\000')
1666 error (_("Please specify a thread ID list"));
1668 for (cmd
= tidlist
; *cmd
!= '\000' && !isalpha (*cmd
); cmd
++);
1671 error (_("Please specify a command following the thread ID list"));
1673 /* Save a copy of the command in case it is clobbered by
1675 saved_cmd
= xstrdup (cmd
);
1676 old_chain
= make_cleanup (xfree
, saved_cmd
);
1678 init_number_or_range (&state
, tidlist
);
1679 while (!state
.finished
&& state
.string
< cmd
)
1681 struct thread_info
*tp
;
1684 start
= get_number_or_range (&state
);
1686 make_cleanup_restore_current_thread ();
1688 tp
= find_thread_id (start
);
1691 warning (_("Unknown thread %d."), start
);
1692 else if (!thread_alive (tp
))
1693 warning (_("Thread %d has terminated."), start
);
1696 switch_to_thread (tp
->ptid
);
1698 printf_filtered (_("\nThread %d (%s):\n"), tp
->num
,
1699 target_pid_to_str (inferior_ptid
));
1700 execute_command (cmd
, from_tty
);
1702 /* Restore exact command used previously. */
1703 strcpy (cmd
, saved_cmd
);
1707 do_cleanups (old_chain
);
1710 /* Switch to the specified thread. Will dispatch off to thread_apply_command
1711 if prefix of arg is `apply'. */
1714 thread_command (char *tidstr
, int from_tty
)
1718 if (ptid_equal (inferior_ptid
, null_ptid
))
1719 error (_("No thread selected"));
1721 if (target_has_stack
)
1723 if (is_exited (inferior_ptid
))
1724 printf_filtered (_("[Current thread is %d (%s) (exited)]\n"),
1725 pid_to_thread_id (inferior_ptid
),
1726 target_pid_to_str (inferior_ptid
));
1728 printf_filtered (_("[Current thread is %d (%s)]\n"),
1729 pid_to_thread_id (inferior_ptid
),
1730 target_pid_to_str (inferior_ptid
));
1733 error (_("No stack."));
1737 gdb_thread_select (current_uiout
, tidstr
, NULL
);
1740 /* Implementation of `thread name'. */
1743 thread_name_command (char *arg
, int from_tty
)
1745 struct thread_info
*info
;
1747 if (ptid_equal (inferior_ptid
, null_ptid
))
1748 error (_("No thread selected"));
1750 arg
= skip_spaces (arg
);
1752 info
= inferior_thread ();
1754 info
->name
= arg
? xstrdup (arg
) : NULL
;
1757 /* Find thread ids with a name, target pid, or extra info matching ARG. */
1760 thread_find_command (char *arg
, int from_tty
)
1762 struct thread_info
*tp
;
1764 unsigned long match
= 0;
1766 if (arg
== NULL
|| *arg
== '\0')
1767 error (_("Command requires an argument."));
1769 tmp
= re_comp (arg
);
1771 error (_("Invalid regexp (%s): %s"), tmp
, arg
);
1773 update_thread_list ();
1774 for (tp
= thread_list
; tp
; tp
= tp
->next
)
1776 if (tp
->name
!= NULL
&& re_exec (tp
->name
))
1778 printf_filtered (_("Thread %d has name '%s'\n"),
1783 tmp
= target_thread_name (tp
);
1784 if (tmp
!= NULL
&& re_exec (tmp
))
1786 printf_filtered (_("Thread %d has target name '%s'\n"),
1791 tmp
= target_pid_to_str (tp
->ptid
);
1792 if (tmp
!= NULL
&& re_exec (tmp
))
1794 printf_filtered (_("Thread %d has target id '%s'\n"),
1799 tmp
= target_extra_thread_info (tp
);
1800 if (tmp
!= NULL
&& re_exec (tmp
))
1802 printf_filtered (_("Thread %d has extra info '%s'\n"),
1808 printf_filtered (_("No threads match '%s'\n"), arg
);
1811 /* Print notices when new threads are attached and detached. */
1812 int print_thread_events
= 1;
1814 show_print_thread_events (struct ui_file
*file
, int from_tty
,
1815 struct cmd_list_element
*c
, const char *value
)
1817 fprintf_filtered (file
,
1818 _("Printing of thread events is %s.\n"),
1823 do_captured_thread_select (struct ui_out
*uiout
, void *tidstr
)
1826 struct thread_info
*tp
;
1828 num
= value_as_long (parse_and_eval (tidstr
));
1830 tp
= find_thread_id (num
);
1833 error (_("Thread ID %d not known."), num
);
1835 if (!thread_alive (tp
))
1836 error (_("Thread ID %d has terminated."), num
);
1838 switch_to_thread (tp
->ptid
);
1840 annotate_thread_changed ();
1842 ui_out_text (uiout
, "[Switching to thread ");
1843 ui_out_field_int (uiout
, "new-thread-id", pid_to_thread_id (inferior_ptid
));
1844 ui_out_text (uiout
, " (");
1845 ui_out_text (uiout
, target_pid_to_str (inferior_ptid
));
1846 ui_out_text (uiout
, ")]");
1848 /* Note that we can't reach this with an exited thread, due to the
1849 thread_alive check above. */
1850 if (tp
->state
== THREAD_RUNNING
)
1851 ui_out_text (uiout
, "(running)\n");
1854 ui_out_text (uiout
, "\n");
1855 print_stack_frame (get_selected_frame (NULL
), 1, SRC_AND_LOC
, 1);
1858 /* Since the current thread may have changed, see if there is any
1859 exited thread we can now delete. */
1866 gdb_thread_select (struct ui_out
*uiout
, char *tidstr
, char **error_message
)
1868 if (catch_exceptions_with_msg (uiout
, do_captured_thread_select
, tidstr
,
1869 error_message
, RETURN_MASK_ALL
) < 0)
1874 /* Update the 'threads_executing' global based on the threads we know
1878 update_threads_executing (void)
1880 struct thread_info
*tp
;
1882 threads_executing
= 0;
1883 ALL_NON_EXITED_THREADS (tp
)
1887 threads_executing
= 1;
1894 update_thread_list (void)
1896 target_update_thread_list ();
1897 update_threads_executing ();
1900 /* Return a new value for the selected thread's id. Return a value of 0 if
1901 no thread is selected, or no threads exist. */
1903 static struct value
*
1904 thread_id_make_value (struct gdbarch
*gdbarch
, struct internalvar
*var
,
1907 struct thread_info
*tp
= find_thread_ptid (inferior_ptid
);
1909 return value_from_longest (builtin_type (gdbarch
)->builtin_int
,
1910 (tp
? tp
->num
: 0));
1913 /* Commands with a prefix of `thread'. */
1914 struct cmd_list_element
*thread_cmd_list
= NULL
;
1916 /* Implementation of `thread' variable. */
1918 static const struct internalvar_funcs thread_funcs
=
1920 thread_id_make_value
,
1926 _initialize_thread (void)
1928 static struct cmd_list_element
*thread_apply_list
= NULL
;
1930 add_info ("threads", info_threads_command
,
1931 _("Display currently known threads.\n\
1932 Usage: info threads [ID]...\n\
1933 Optional arguments are thread IDs with spaces between.\n\
1934 If no arguments, all threads are displayed."));
1936 add_prefix_cmd ("thread", class_run
, thread_command
, _("\
1937 Use this command to switch between threads.\n\
1938 The new thread ID must be currently known."),
1939 &thread_cmd_list
, "thread ", 1, &cmdlist
);
1941 add_prefix_cmd ("apply", class_run
, thread_apply_command
,
1942 _("Apply a command to a list of threads."),
1943 &thread_apply_list
, "thread apply ", 1, &thread_cmd_list
);
1945 add_cmd ("all", class_run
, thread_apply_all_command
,
1947 Apply a command to all threads.\n\
1949 Usage: thread apply all [-ascending] <command>\n\
1950 -ascending: Call <command> for all threads in ascending order.\n\
1951 The default is descending order.\
1953 &thread_apply_list
);
1955 add_cmd ("name", class_run
, thread_name_command
,
1956 _("Set the current thread's name.\n\
1957 Usage: thread name [NAME]\n\
1958 If NAME is not given, then any existing name is removed."), &thread_cmd_list
);
1960 add_cmd ("find", class_run
, thread_find_command
, _("\
1961 Find threads that match a regular expression.\n\
1962 Usage: thread find REGEXP\n\
1963 Will display thread ids whose name, target ID, or extra info matches REGEXP."),
1966 add_com_alias ("t", "thread", class_run
, 1);
1968 add_setshow_boolean_cmd ("thread-events", no_class
,
1969 &print_thread_events
, _("\
1970 Set printing of thread events (such as thread start and exit)."), _("\
1971 Show printing of thread events (such as thread start and exit)."), NULL
,
1973 show_print_thread_events
,
1974 &setprintlist
, &showprintlist
);
1976 create_internalvar_type_lazy ("_thread", &thread_funcs
, NULL
);
1978 observer_attach_thread_ptid_changed (restore_current_thread_ptid_changed
);