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