* annotate.c (annotate_thread_changed): New function.
[external/binutils.git] / gdb / thread.c
1 /* Multi-process/thread control for GDB, the GNU debugger.
2
3    Copyright (C) 1986, 1987, 1988, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4    2000, 2001, 2002, 2003, 2004, 2007, 2008 Free Software Foundation, Inc.
5
6    Contributed by Lynx Real-Time Systems, Inc.  Los Gatos, CA.
7
8    This file is part of GDB.
9
10    This program is free software; you can redistribute it and/or modify
11    it under the terms of the GNU General Public License as published by
12    the Free Software Foundation; either version 3 of the License, or
13    (at your option) any later version.
14
15    This program is distributed in the hope that it will be useful,
16    but WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18    GNU General Public License for more details.
19
20    You should have received a copy of the GNU General Public License
21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
22
23 #include "defs.h"
24 #include "symtab.h"
25 #include "frame.h"
26 #include "inferior.h"
27 #include "environ.h"
28 #include "value.h"
29 #include "target.h"
30 #include "gdbthread.h"
31 #include "exceptions.h"
32 #include "command.h"
33 #include "gdbcmd.h"
34 #include "regcache.h"
35 #include "gdb.h"
36 #include "gdb_string.h"
37
38 #include <ctype.h>
39 #include <sys/types.h>
40 #include <signal.h>
41 #include "ui-out.h"
42 #include "observer.h"
43 #include "annotate.h"
44
45 /* Definition of struct thread_info exported to gdbthread.h */
46
47 /* Prototypes for exported functions. */
48
49 void _initialize_thread (void);
50
51 /* Prototypes for local functions. */
52
53 static struct thread_info *thread_list = NULL;
54 static int highest_thread_num;
55
56 static struct thread_info *find_thread_id (int num);
57
58 static void thread_command (char *tidstr, int from_tty);
59 static void thread_apply_all_command (char *, int);
60 static int thread_alive (struct thread_info *);
61 static void info_threads_command (char *, int);
62 static void thread_apply_command (char *, int);
63 static void restore_current_thread (ptid_t);
64 static void prune_threads (void);
65
66 void
67 delete_step_resume_breakpoint (void *arg)
68 {
69   struct breakpoint **breakpointp = (struct breakpoint **) arg;
70   struct thread_info *tp;
71
72   if (*breakpointp != NULL)
73     {
74       delete_breakpoint (*breakpointp);
75       for (tp = thread_list; tp; tp = tp->next)
76         if (tp->step_resume_breakpoint == *breakpointp)
77           tp->step_resume_breakpoint = NULL;
78
79       *breakpointp = NULL;
80     }
81 }
82
83 static void
84 free_thread (struct thread_info *tp)
85 {
86   /* NOTE: this will take care of any left-over step_resume breakpoints,
87      but not any user-specified thread-specific breakpoints.  We can not
88      delete the breakpoint straight-off, because the inferior might not
89      be stopped at the moment.  */
90   if (tp->step_resume_breakpoint)
91     tp->step_resume_breakpoint->disposition = disp_del_at_next_stop;
92
93   /* FIXME: do I ever need to call the back-end to give it a
94      chance at this private data before deleting the thread?  */
95   if (tp->private)
96     xfree (tp->private);
97
98   xfree (tp);
99 }
100
101 void
102 init_thread_list (void)
103 {
104   struct thread_info *tp, *tpnext;
105
106   highest_thread_num = 0;
107   if (!thread_list)
108     return;
109
110   for (tp = thread_list; tp; tp = tpnext)
111     {
112       tpnext = tp->next;
113       free_thread (tp);
114     }
115
116   thread_list = NULL;
117 }
118
119 struct thread_info *
120 add_thread_silent (ptid_t ptid)
121 {
122   struct thread_info *tp;
123
124   tp = (struct thread_info *) xmalloc (sizeof (*tp));
125   memset (tp, 0, sizeof (*tp));
126   tp->ptid = ptid;
127   tp->num = ++highest_thread_num;
128   tp->next = thread_list;
129   thread_list = tp;
130
131   observer_notify_new_thread (tp);
132
133   return tp;
134 }
135
136 struct thread_info *
137 add_thread_with_info (ptid_t ptid, struct private_thread_info *private)
138 {
139   struct thread_info *result = add_thread_silent (ptid);
140
141   result->private = private;
142
143   if (print_thread_events)
144     printf_unfiltered (_("[New %s]\n"), target_pid_to_str (ptid));
145
146   annotate_new_thread ();
147   return result;
148 }
149
150 struct thread_info *
151 add_thread (ptid_t ptid)
152 {
153   return add_thread_with_info (ptid, NULL);
154 }
155
156 void
157 delete_thread (ptid_t ptid)
158 {
159   struct thread_info *tp, *tpprev;
160
161   tpprev = NULL;
162
163   for (tp = thread_list; tp; tpprev = tp, tp = tp->next)
164     if (ptid_equal (tp->ptid, ptid))
165       break;
166
167   if (!tp)
168     return;
169
170   if (tpprev)
171     tpprev->next = tp->next;
172   else
173     thread_list = tp->next;
174
175   observer_notify_thread_exit (tp);
176
177   free_thread (tp);
178 }
179
180 static struct thread_info *
181 find_thread_id (int num)
182 {
183   struct thread_info *tp;
184
185   for (tp = thread_list; tp; tp = tp->next)
186     if (tp->num == num)
187       return tp;
188
189   return NULL;
190 }
191
192 /* Find a thread_info by matching PTID.  */
193 struct thread_info *
194 find_thread_pid (ptid_t ptid)
195 {
196   struct thread_info *tp;
197
198   for (tp = thread_list; tp; tp = tp->next)
199     if (ptid_equal (tp->ptid, ptid))
200       return tp;
201
202   return NULL;
203 }
204
205 /*
206  * Thread iterator function.
207  *
208  * Calls a callback function once for each thread, so long as
209  * the callback function returns false.  If the callback function
210  * returns true, the iteration will end and the current thread
211  * will be returned.  This can be useful for implementing a 
212  * search for a thread with arbitrary attributes, or for applying
213  * some operation to every thread.
214  *
215  * FIXME: some of the existing functionality, such as 
216  * "Thread apply all", might be rewritten using this functionality.
217  */
218
219 struct thread_info *
220 iterate_over_threads (int (*callback) (struct thread_info *, void *),
221                       void *data)
222 {
223   struct thread_info *tp;
224
225   for (tp = thread_list; tp; tp = tp->next)
226     if ((*callback) (tp, data))
227       return tp;
228
229   return NULL;
230 }
231
232 int
233 valid_thread_id (int num)
234 {
235   struct thread_info *tp;
236
237   for (tp = thread_list; tp; tp = tp->next)
238     if (tp->num == num)
239       return 1;
240
241   return 0;
242 }
243
244 int
245 pid_to_thread_id (ptid_t ptid)
246 {
247   struct thread_info *tp;
248
249   for (tp = thread_list; tp; tp = tp->next)
250     if (ptid_equal (tp->ptid, ptid))
251       return tp->num;
252
253   return 0;
254 }
255
256 ptid_t
257 thread_id_to_pid (int num)
258 {
259   struct thread_info *thread = find_thread_id (num);
260   if (thread)
261     return thread->ptid;
262   else
263     return pid_to_ptid (-1);
264 }
265
266 int
267 in_thread_list (ptid_t ptid)
268 {
269   struct thread_info *tp;
270
271   for (tp = thread_list; tp; tp = tp->next)
272     if (ptid_equal (tp->ptid, ptid))
273       return 1;
274
275   return 0;                     /* Never heard of 'im */
276 }
277
278 /* Print a list of thread ids currently known, and the total number of
279    threads. To be used from within catch_errors. */
280 static int
281 do_captured_list_thread_ids (struct ui_out *uiout, void *arg)
282 {
283   struct thread_info *tp;
284   int num = 0;
285   struct cleanup *cleanup_chain;
286
287   prune_threads ();
288   target_find_new_threads ();
289
290   cleanup_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "thread-ids");
291
292   for (tp = thread_list; tp; tp = tp->next)
293     {
294       num++;
295       ui_out_field_int (uiout, "thread-id", tp->num);
296     }
297
298   do_cleanups (cleanup_chain);
299   ui_out_field_int (uiout, "number-of-threads", num);
300   return GDB_RC_OK;
301 }
302
303 /* Official gdblib interface function to get a list of thread ids and
304    the total number. */
305 enum gdb_rc
306 gdb_list_thread_ids (struct ui_out *uiout, char **error_message)
307 {
308   if (catch_exceptions_with_msg (uiout, do_captured_list_thread_ids, NULL,
309                                  error_message, RETURN_MASK_ALL) < 0)
310     return GDB_RC_FAIL;
311   return GDB_RC_OK;
312 }
313
314 /* Load infrun state for the thread PID.  */
315
316 void
317 load_infrun_state (ptid_t ptid,
318                    CORE_ADDR *prev_pc,
319                    int *trap_expected,
320                    struct breakpoint **step_resume_breakpoint,
321                    CORE_ADDR *step_range_start,
322                    CORE_ADDR *step_range_end,
323                    struct frame_id *step_frame_id,
324                    int *stepping_over_breakpoint,
325                    int *stepping_through_solib_after_catch,
326                    bpstat *stepping_through_solib_catchpoints,
327                    int *current_line,
328                    struct symtab **current_symtab)
329 {
330   struct thread_info *tp;
331
332   /* If we can't find the thread, then we're debugging a single threaded
333      process.  No need to do anything in that case.  */
334   tp = find_thread_id (pid_to_thread_id (ptid));
335   if (tp == NULL)
336     return;
337
338   *prev_pc = tp->prev_pc;
339   *trap_expected = tp->trap_expected;
340   *step_resume_breakpoint = tp->step_resume_breakpoint;
341   *step_range_start = tp->step_range_start;
342   *step_range_end = tp->step_range_end;
343   *step_frame_id = tp->step_frame_id;
344   *stepping_over_breakpoint = tp->stepping_over_breakpoint;
345   *stepping_through_solib_after_catch =
346     tp->stepping_through_solib_after_catch;
347   *stepping_through_solib_catchpoints =
348     tp->stepping_through_solib_catchpoints;
349   *current_line = tp->current_line;
350   *current_symtab = tp->current_symtab;
351 }
352
353 /* Save infrun state for the thread PID.  */
354
355 void
356 save_infrun_state (ptid_t ptid,
357                    CORE_ADDR prev_pc,
358                    int trap_expected,
359                    struct breakpoint *step_resume_breakpoint,
360                    CORE_ADDR step_range_start,
361                    CORE_ADDR step_range_end,
362                    const struct frame_id *step_frame_id,
363                    int stepping_over_breakpoint,
364                    int stepping_through_solib_after_catch,
365                    bpstat stepping_through_solib_catchpoints,
366                    int current_line,
367                    struct symtab *current_symtab)
368 {
369   struct thread_info *tp;
370
371   /* If we can't find the thread, then we're debugging a single-threaded
372      process.  Nothing to do in that case.  */
373   tp = find_thread_id (pid_to_thread_id (ptid));
374   if (tp == NULL)
375     return;
376
377   tp->prev_pc = prev_pc;
378   tp->trap_expected = trap_expected;
379   tp->step_resume_breakpoint = step_resume_breakpoint;
380   tp->step_range_start = step_range_start;
381   tp->step_range_end = step_range_end;
382   tp->step_frame_id = (*step_frame_id);
383   tp->stepping_over_breakpoint = stepping_over_breakpoint;
384   tp->stepping_through_solib_after_catch = stepping_through_solib_after_catch;
385   tp->stepping_through_solib_catchpoints = stepping_through_solib_catchpoints;
386   tp->current_line = current_line;
387   tp->current_symtab = current_symtab;
388 }
389
390 /* Return true if TP is an active thread. */
391 static int
392 thread_alive (struct thread_info *tp)
393 {
394   if (PIDGET (tp->ptid) == -1)
395     return 0;
396   if (!target_thread_alive (tp->ptid))
397     {
398       tp->ptid = pid_to_ptid (-1);      /* Mark it as dead */
399       return 0;
400     }
401   return 1;
402 }
403
404 static void
405 prune_threads (void)
406 {
407   struct thread_info *tp, *next;
408
409   for (tp = thread_list; tp; tp = next)
410     {
411       next = tp->next;
412       if (!thread_alive (tp))
413         delete_thread (tp->ptid);
414     }
415 }
416
417 /* Prints the list of threads and their details on UIOUT.
418    This is a version of 'info_thread_command' suitable for
419    use from MI.  
420    If REQESTED_THREAD is not -1, it's the GDB id of the thread
421    that should be printed.  Otherwise, all threads are
422    printed.  */
423 void
424 print_thread_info (struct ui_out *uiout, int requested_thread)
425 {
426   struct thread_info *tp;
427   ptid_t current_ptid;
428   struct frame_info *cur_frame;
429   struct cleanup *old_chain;
430   struct frame_id saved_frame_id;
431   char *extra_info;
432   int current_thread = -1;
433
434   /* Backup current thread and selected frame.  */
435   saved_frame_id = get_frame_id (get_selected_frame (NULL));
436   old_chain = make_cleanup_restore_current_thread (inferior_ptid, saved_frame_id);
437
438   make_cleanup_ui_out_list_begin_end (uiout, "threads");
439
440   prune_threads ();
441   target_find_new_threads ();
442   current_ptid = inferior_ptid;
443   for (tp = thread_list; tp; tp = tp->next)
444     {
445       struct cleanup *chain2;
446
447       if (requested_thread != -1 && tp->num != requested_thread)
448         continue;
449
450       chain2 = make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
451
452       if (ptid_equal (tp->ptid, current_ptid))
453         {
454           current_thread = tp->num;
455           ui_out_text (uiout, "* ");
456         }
457       else
458         ui_out_text (uiout, "  ");
459
460       ui_out_field_int (uiout, "id", tp->num);
461       ui_out_text (uiout, " ");
462       ui_out_field_string (uiout, "target-id", target_tid_to_str (tp->ptid));
463
464       extra_info = target_extra_thread_info (tp);
465       if (extra_info)
466         {
467           ui_out_text (uiout, " (");
468           ui_out_field_string (uiout, "details", extra_info);
469           ui_out_text (uiout, ")");
470         }
471       ui_out_text (uiout, "  ");
472       /* That switch put us at the top of the stack (leaf frame).  */
473       switch_to_thread (tp->ptid);
474       print_stack_frame (get_selected_frame (NULL), 
475                          /* For MI output, print frame level.  */
476                          ui_out_is_mi_like_p (uiout),
477                          LOCATION);
478
479       do_cleanups (chain2);
480     }
481
482   /* Restores the current thread and the frame selected before
483      the "info threads" command.  */
484   do_cleanups (old_chain);
485
486   if (requested_thread == -1)
487     {
488       gdb_assert (current_thread != -1 || !thread_list);
489       if (current_thread != -1 && ui_out_is_mi_like_p (uiout))
490         ui_out_field_int (uiout, "current-thread-id", current_thread);
491     }
492
493   /*  If case we were not able to find the original frame, print the
494       new selected frame.  */
495   if (frame_find_by_id (saved_frame_id) == NULL)
496     {
497       warning (_("Couldn't restore frame in current thread, at frame 0"));
498       /* For MI, we should probably have a notification about
499          current frame change.  But this error is not very likely, so
500          don't bother for now.  */
501       if (!ui_out_is_mi_like_p (uiout))
502         print_stack_frame (get_selected_frame (NULL), 0, LOCATION);
503     }
504 }
505
506
507 /* Print information about currently known threads 
508
509  * Note: this has the drawback that it _really_ switches
510  *       threads, which frees the frame cache.  A no-side
511  *       effects info-threads command would be nicer.
512  */
513
514 static void
515 info_threads_command (char *arg, int from_tty)
516 {
517   print_thread_info (uiout, -1);
518 }
519
520 /* Switch from one thread to another. */
521
522 void
523 switch_to_thread (ptid_t ptid)
524 {
525   if (ptid_equal (ptid, inferior_ptid))
526     return;
527
528   inferior_ptid = ptid;
529   reinit_frame_cache ();
530   registers_changed ();
531   stop_pc = read_pc ();
532 }
533
534 static void
535 restore_current_thread (ptid_t ptid)
536 {
537   if (!ptid_equal (ptid, inferior_ptid))
538     {
539       switch_to_thread (ptid);
540     }
541 }
542
543 static void
544 restore_selected_frame (struct frame_id a_frame_id)
545 {
546   struct frame_info *selected_frame_info = NULL;
547
548   if (frame_id_eq (a_frame_id, null_frame_id))
549     return;        
550
551   if ((selected_frame_info = frame_find_by_id (a_frame_id)) != NULL)
552     {
553       select_frame (selected_frame_info);
554     }
555 }
556
557 struct current_thread_cleanup
558 {
559   ptid_t inferior_ptid;
560   struct frame_id selected_frame_id;
561 };
562
563 static void
564 do_restore_current_thread_cleanup (void *arg)
565 {
566   struct current_thread_cleanup *old = arg;
567   restore_current_thread (old->inferior_ptid);
568   restore_selected_frame (old->selected_frame_id);
569   xfree (old);
570 }
571
572 struct cleanup *
573 make_cleanup_restore_current_thread (ptid_t inferior_ptid, 
574                                      struct frame_id a_frame_id)
575 {
576   struct current_thread_cleanup *old
577     = xmalloc (sizeof (struct current_thread_cleanup));
578   old->inferior_ptid = inferior_ptid;
579   old->selected_frame_id = a_frame_id;
580   return make_cleanup (do_restore_current_thread_cleanup, old);
581 }
582
583 /* Apply a GDB command to a list of threads.  List syntax is a whitespace
584    seperated list of numbers, or ranges, or the keyword `all'.  Ranges consist
585    of two numbers seperated by a hyphen.  Examples:
586
587    thread apply 1 2 7 4 backtrace       Apply backtrace cmd to threads 1,2,7,4
588    thread apply 2-7 9 p foo(1)  Apply p foo(1) cmd to threads 2->7 & 9
589    thread apply all p x/i $pc   Apply x/i $pc cmd to all threads
590  */
591
592 static void
593 thread_apply_all_command (char *cmd, int from_tty)
594 {
595   struct thread_info *tp;
596   struct cleanup *old_chain;
597   struct cleanup *saved_cmd_cleanup_chain;
598   char *saved_cmd;
599   struct frame_id saved_frame_id;
600   ptid_t current_ptid;
601   int thread_has_changed = 0;
602
603   if (cmd == NULL || *cmd == '\000')
604     error (_("Please specify a command following the thread ID list"));
605   
606   current_ptid = inferior_ptid;
607   saved_frame_id = get_frame_id (get_selected_frame (NULL));
608   old_chain = make_cleanup_restore_current_thread (inferior_ptid, saved_frame_id);
609
610   /* It is safe to update the thread list now, before
611      traversing it for "thread apply all".  MVS */
612   target_find_new_threads ();
613
614   /* Save a copy of the command in case it is clobbered by
615      execute_command */
616   saved_cmd = xstrdup (cmd);
617   saved_cmd_cleanup_chain = make_cleanup (xfree, (void *) saved_cmd);
618   for (tp = thread_list; tp; tp = tp->next)
619     if (thread_alive (tp))
620       {
621         switch_to_thread (tp->ptid);
622         printf_filtered (_("\nThread %d (%s):\n"),
623                          tp->num, target_tid_to_str (inferior_ptid));
624         execute_command (cmd, from_tty);
625         strcpy (cmd, saved_cmd);        /* Restore exact command used previously */
626       }
627
628   if (!ptid_equal (current_ptid, inferior_ptid))
629     thread_has_changed = 1;
630
631   do_cleanups (saved_cmd_cleanup_chain);
632   do_cleanups (old_chain);
633   /* Print stack frame only if we changed thread.  */
634   if (thread_has_changed)
635     print_stack_frame (get_current_frame (), 1, SRC_LINE);
636
637 }
638
639 static void
640 thread_apply_command (char *tidlist, int from_tty)
641 {
642   char *cmd;
643   char *p;
644   struct cleanup *old_chain;
645   struct cleanup *saved_cmd_cleanup_chain;
646   char *saved_cmd;
647   struct frame_id saved_frame_id;
648   ptid_t current_ptid;
649   int thread_has_changed = 0;
650
651   if (tidlist == NULL || *tidlist == '\000')
652     error (_("Please specify a thread ID list"));
653
654   for (cmd = tidlist; *cmd != '\000' && !isalpha (*cmd); cmd++);
655
656   if (*cmd == '\000')
657     error (_("Please specify a command following the thread ID list"));
658
659   current_ptid = inferior_ptid;
660   saved_frame_id = get_frame_id (get_selected_frame (NULL));
661   old_chain = make_cleanup_restore_current_thread (inferior_ptid, saved_frame_id);
662
663   /* Save a copy of the command in case it is clobbered by
664      execute_command */
665   saved_cmd = xstrdup (cmd);
666   saved_cmd_cleanup_chain = make_cleanup (xfree, (void *) saved_cmd);
667   while (tidlist < cmd)
668     {
669       struct thread_info *tp;
670       int start, end;
671
672       start = strtol (tidlist, &p, 10);
673       if (p == tidlist)
674         error (_("Error parsing %s"), tidlist);
675       tidlist = p;
676
677       while (*tidlist == ' ' || *tidlist == '\t')
678         tidlist++;
679
680       if (*tidlist == '-')      /* Got a range of IDs? */
681         {
682           tidlist++;            /* Skip the - */
683           end = strtol (tidlist, &p, 10);
684           if (p == tidlist)
685             error (_("Error parsing %s"), tidlist);
686           tidlist = p;
687
688           while (*tidlist == ' ' || *tidlist == '\t')
689             tidlist++;
690         }
691       else
692         end = start;
693
694       for (; start <= end; start++)
695         {
696           tp = find_thread_id (start);
697
698           if (!tp)
699             warning (_("Unknown thread %d."), start);
700           else if (!thread_alive (tp))
701             warning (_("Thread %d has terminated."), start);
702           else
703             {
704               switch_to_thread (tp->ptid);
705               printf_filtered (_("\nThread %d (%s):\n"), tp->num,
706                                target_tid_to_str (inferior_ptid));
707               execute_command (cmd, from_tty);
708               strcpy (cmd, saved_cmd);  /* Restore exact command used previously */
709             }
710         }
711     }
712
713   if (!ptid_equal (current_ptid, inferior_ptid))
714     thread_has_changed = 1;
715
716   do_cleanups (saved_cmd_cleanup_chain);
717   do_cleanups (old_chain);
718   /* Print stack frame only if we changed thread.  */
719   if (thread_has_changed)
720     print_stack_frame (get_current_frame (), 1, SRC_LINE);
721 }
722
723 /* Switch to the specified thread.  Will dispatch off to thread_apply_command
724    if prefix of arg is `apply'.  */
725
726 static void
727 thread_command (char *tidstr, int from_tty)
728 {
729   if (!tidstr)
730     {
731       /* Don't generate an error, just say which thread is current. */
732       if (target_has_stack)
733         printf_filtered (_("[Current thread is %d (%s)]\n"),
734                          pid_to_thread_id (inferior_ptid),
735                          target_tid_to_str (inferior_ptid));
736       else
737         error (_("No stack."));
738       return;
739     }
740
741   annotate_thread_changed ();
742   gdb_thread_select (uiout, tidstr, NULL);
743 }
744
745 /* Print notices when new threads are attached and detached.  */
746 int print_thread_events = 1;
747 static void
748 show_print_thread_events (struct ui_file *file, int from_tty,
749                           struct cmd_list_element *c, const char *value)
750 {
751   fprintf_filtered (file, _("\
752 Printing of thread events is %s.\n"),
753                     value);
754 }
755
756 static int
757 do_captured_thread_select (struct ui_out *uiout, void *tidstr)
758 {
759   int num;
760   struct thread_info *tp;
761
762   num = value_as_long (parse_and_eval (tidstr));
763
764   tp = find_thread_id (num);
765
766   if (!tp)
767     error (_("Thread ID %d not known."), num);
768
769   if (!thread_alive (tp))
770     error (_("Thread ID %d has terminated."), num);
771
772   switch_to_thread (tp->ptid);
773
774   ui_out_text (uiout, "[Switching to thread ");
775   ui_out_field_int (uiout, "new-thread-id", pid_to_thread_id (inferior_ptid));
776   ui_out_text (uiout, " (");
777   ui_out_text (uiout, target_tid_to_str (inferior_ptid));
778   ui_out_text (uiout, ")]");
779
780   print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC);
781   return GDB_RC_OK;
782 }
783
784 enum gdb_rc
785 gdb_thread_select (struct ui_out *uiout, char *tidstr, char **error_message)
786 {
787   if (catch_exceptions_with_msg (uiout, do_captured_thread_select, tidstr,
788                                  error_message, RETURN_MASK_ALL) < 0)
789     return GDB_RC_FAIL;
790   return GDB_RC_OK;
791 }
792
793 /* Commands with a prefix of `thread'.  */
794 struct cmd_list_element *thread_cmd_list = NULL;
795
796 void
797 _initialize_thread (void)
798 {
799   static struct cmd_list_element *thread_apply_list = NULL;
800
801   add_info ("threads", info_threads_command,
802             _("IDs of currently known threads."));
803
804   add_prefix_cmd ("thread", class_run, thread_command, _("\
805 Use this command to switch between threads.\n\
806 The new thread ID must be currently known."),
807                   &thread_cmd_list, "thread ", 1, &cmdlist);
808
809   add_prefix_cmd ("apply", class_run, thread_apply_command,
810                   _("Apply a command to a list of threads."),
811                   &thread_apply_list, "thread apply ", 1, &thread_cmd_list);
812
813   add_cmd ("all", class_run, thread_apply_all_command,
814            _("Apply a command to all threads."), &thread_apply_list);
815
816   if (!xdb_commands)
817     add_com_alias ("t", "thread", class_run, 1);
818
819   add_setshow_boolean_cmd ("thread-events", no_class,
820          &print_thread_events, _("\
821 Set printing of thread events (such as thread start and exit)."), _("\
822 Show printing of thread events (such as thread start and exit)."), NULL,
823          NULL,
824          show_print_thread_events,
825          &setprintlist, &showprintlist);
826 }