gdb/thread.c

   1 /* Multi-process/thread control for GDB, the GNU debugger.
   2
   3    Copyright (C) 1986-2014 Free Software Foundation, Inc.
   4
   5    Contributed by Lynx Real-Time Systems, Inc.  Los Gatos, CA.
   6
   7    This file is part of GDB.
   8
   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.
  13
  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.
  18
  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/>.  */
  21
  22 #include "defs.h"
  23 #include "symtab.h"
  24 #include "frame.h"
  25 #include "inferior.h"
  26 #include "environ.h"
  27 #include "value.h"
  28 #include "target.h"
  29 #include "gdbthread.h"
  30 #include "exceptions.h"
  31 #include "command.h"
  32 #include "gdbcmd.h"
  33 #include "regcache.h"
  34 #include "gdb.h"
  35 #include <string.h>
  36 #include "btrace.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 #include "cli/cli-decode.h"
  45 #include "gdb_regex.h"
  46 #include "cli/cli-utils.h"
  47 #include "continuations.h"
  48
  49 /* Definition of struct thread_info exported to gdbthread.h.  */
  50
  51 /* Prototypes for exported functions.  */
  52
  53 void _initialize_thread (void);
  54
  55 /* Prototypes for local functions.  */
  56
  57 struct thread_info *thread_list = NULL;
  58 static int highest_thread_num;
  59
  60 static void thread_command (char *tidstr, int from_tty);
  61 static void thread_apply_all_command (char *, int);
  62 static int thread_alive (struct thread_info *);
  63 static void info_threads_command (char *, int);
  64 static void thread_apply_command (char *, int);
  65 static void restore_current_thread (ptid_t);
  66 static void prune_threads (void);
  67
  68 /* Data to cleanup thread array.  */
  69
  70 struct thread_array_cleanup
  71 {
  72   /* Array of thread pointers used to set
  73      reference count.  */
  74   struct thread_info **tp_array;
  75
  76   /* Thread count in the array.  */
  77   int count;
  78 };
  79
  80
  81 struct thread_info*
  82 inferior_thread (void)
  83 {
  84   struct thread_info *tp = find_thread_ptid (inferior_ptid);
  85   gdb_assert (tp);
  86   return tp;
  87 }
  88
  89 void
  90 delete_step_resume_breakpoint (struct thread_info *tp)
  91 {
  92   if (tp && tp->control.step_resume_breakpoint)
  93     {
  94       delete_breakpoint (tp->control.step_resume_breakpoint);
  95       tp->control.step_resume_breakpoint = NULL;
  96     }
  97 }
  98
  99 void
 100 delete_exception_resume_breakpoint (struct thread_info *tp)
 101 {
 102   if (tp && tp->control.exception_resume_breakpoint)
 103     {
 104       delete_breakpoint (tp->control.exception_resume_breakpoint);
 105       tp->control.exception_resume_breakpoint = NULL;
 106     }
 107 }
 108
 109 static void
 110 clear_thread_inferior_resources (struct thread_info *tp)
 111 {
 112   /* NOTE: this will take care of any left-over step_resume breakpoints,
 113      but not any user-specified thread-specific breakpoints.  We can not
 114      delete the breakpoint straight-off, because the inferior might not
 115      be stopped at the moment.  */
 116   if (tp->control.step_resume_breakpoint)
 117     {
 118       tp->control.step_resume_breakpoint->disposition = disp_del_at_next_stop;
 119       tp->control.step_resume_breakpoint = NULL;
 120     }
 121
 122   if (tp->control.exception_resume_breakpoint)
 123     {
 124       tp->control.exception_resume_breakpoint->disposition
 125         = disp_del_at_next_stop;
 126       tp->control.exception_resume_breakpoint = NULL;
 127     }
 128
 129   delete_longjmp_breakpoint_at_next_stop (tp->num);
 130
 131   bpstat_clear (&tp->control.stop_bpstat);
 132
 133   btrace_teardown (tp);
 134
 135   do_all_intermediate_continuations_thread (tp, 1);
 136   do_all_continuations_thread (tp, 1);
 137 }
 138
 139 static void
 140 free_thread (struct thread_info *tp)
 141 {
 142   if (tp->private)
 143     {
 144       if (tp->private_dtor)
 145         tp->private_dtor (tp->private);
 146       else
 147         xfree (tp->private);
 148     }
 149
 150   xfree (tp->name);
 151   xfree (tp);
 152 }
 153
 154 void
 155 init_thread_list (void)
 156 {
 157   struct thread_info *tp, *tpnext;
 158
 159   highest_thread_num = 0;
 160
 161   if (!thread_list)
 162     return;
 163
 164   for (tp = thread_list; tp; tp = tpnext)
 165     {
 166       tpnext = tp->next;
 167       free_thread (tp);
 168     }
 169
 170   thread_list = NULL;
 171 }
 172
 173 /* Allocate a new thread with target id PTID and add it to the thread
 174    list.  */
 175
 176 static struct thread_info *
 177 new_thread (ptid_t ptid)
 178 {
 179   struct thread_info *tp;
 180
 181   tp = xcalloc (1, sizeof (*tp));
 182
 183   tp->ptid = ptid;
 184   tp->num = ++highest_thread_num;
 185   tp->next = thread_list;
 186   thread_list = tp;
 187
 188   /* Nothing to follow yet.  */
 189   tp->pending_follow.kind = TARGET_WAITKIND_SPURIOUS;
 190   tp->state = THREAD_STOPPED;
 191
 192   return tp;
 193 }
 194
 195 struct thread_info *
 196 add_thread_silent (ptid_t ptid)
 197 {
 198   struct thread_info *tp;
 199
 200   tp = find_thread_ptid (ptid);
 201   if (tp)
 202     /* Found an old thread with the same id.  It has to be dead,
 203        otherwise we wouldn't be adding a new thread with the same id.
 204        The OS is reusing this id --- delete it, and recreate a new
 205        one.  */
 206     {
 207       /* In addition to deleting the thread, if this is the current
 208          thread, then we need to take care that delete_thread doesn't
 209          really delete the thread if it is inferior_ptid.  Create a
 210          new template thread in the list with an invalid ptid, switch
 211          to it, delete the original thread, reset the new thread's
 212          ptid, and switch to it.  */
 213
 214       if (ptid_equal (inferior_ptid, ptid))
 215         {
 216           tp = new_thread (null_ptid);
 217
 218           /* Make switch_to_thread not read from the thread.  */
 219           tp->state = THREAD_EXITED;
 220           switch_to_thread (null_ptid);
 221
 222           /* Now we can delete it.  */
 223           delete_thread (ptid);
 224
 225           /* Now reset its ptid, and reswitch inferior_ptid to it.  */
 226           tp->ptid = ptid;
 227           tp->state = THREAD_STOPPED;
 228           switch_to_thread (ptid);
 229
 230           observer_notify_new_thread (tp);
 231
 232           /* All done.  */
 233           return tp;
 234         }
 235       else
 236         /* Just go ahead and delete it.  */
 237         delete_thread (ptid);
 238     }
 239
 240   tp = new_thread (ptid);
 241   observer_notify_new_thread (tp);
 242
 243   return tp;
 244 }
 245
 246 struct thread_info *
 247 add_thread_with_info (ptid_t ptid, struct private_thread_info *private)
 248 {
 249   struct thread_info *result = add_thread_silent (ptid);
 250
 251   result->private = private;
 252
 253   if (print_thread_events)
 254     printf_unfiltered (_("[New %s]\n"), target_pid_to_str (ptid));
 255
 256   annotate_new_thread ();
 257   return result;
 258 }
 259
 260 struct thread_info *
 261 add_thread (ptid_t ptid)
 262 {
 263   return add_thread_with_info (ptid, NULL);
 264 }
 265
 266 /* Delete thread PTID.  If SILENT, don't notify the observer of this
 267    exit.  */
 268 static void
 269 delete_thread_1 (ptid_t ptid, int silent)
 270 {
 271   struct thread_info *tp, *tpprev;
 272
 273   tpprev = NULL;
 274
 275   for (tp = thread_list; tp; tpprev = tp, tp = tp->next)
 276     if (ptid_equal (tp->ptid, ptid))
 277       break;
 278
 279   if (!tp)
 280     return;
 281
 282   /* If this is the current thread, or there's code out there that
 283      relies on it existing (refcount > 0) we can't delete yet.  Mark
 284      it as exited, and notify it.  */
 285   if (tp->refcount > 0
 286       || ptid_equal (tp->ptid, inferior_ptid))
 287     {
 288       if (tp->state != THREAD_EXITED)
 289         {
 290           observer_notify_thread_exit (tp, silent);
 291
 292           /* Tag it as exited.  */
 293           tp->state = THREAD_EXITED;
 294
 295           /* Clear breakpoints, etc. associated with this thread.  */
 296           clear_thread_inferior_resources (tp);
 297         }
 298
 299        /* Will be really deleted some other time.  */
 300        return;
 301      }
 302
 303   /* Notify thread exit, but only if we haven't already.  */
 304   if (tp->state != THREAD_EXITED)
 305     observer_notify_thread_exit (tp, silent);
 306
 307   /* Tag it as exited.  */
 308   tp->state = THREAD_EXITED;
 309   clear_thread_inferior_resources (tp);
 310
 311   if (tpprev)
 312     tpprev->next = tp->next;
 313   else
 314     thread_list = tp->next;
 315
 316   free_thread (tp);
 317 }
 318
 319 /* Delete thread PTID and notify of thread exit.  If this is
 320    inferior_ptid, don't actually delete it, but tag it as exited and
 321    do the notification.  If PTID is the user selected thread, clear
 322    it.  */
 323 void
 324 delete_thread (ptid_t ptid)
 325 {
 326   delete_thread_1 (ptid, 0 /* not silent */);
 327 }
 328
 329 void
 330 delete_thread_silent (ptid_t ptid)
 331 {
 332   delete_thread_1 (ptid, 1 /* silent */);
 333 }
 334
 335 struct thread_info *
 336 find_thread_id (int num)
 337 {
 338   struct thread_info *tp;
 339
 340   for (tp = thread_list; tp; tp = tp->next)
 341     if (tp->num == num)
 342       return tp;
 343
 344   return NULL;
 345 }
 346
 347 /* Find a thread_info by matching PTID.  */
 348 struct thread_info *
 349 find_thread_ptid (ptid_t ptid)
 350 {
 351   struct thread_info *tp;
 352
 353   for (tp = thread_list; tp; tp = tp->next)
 354     if (ptid_equal (tp->ptid, ptid))
 355       return tp;
 356
 357   return NULL;
 358 }
 359
 360 /*
 361  * Thread iterator function.
 362  *
 363  * Calls a callback function once for each thread, so long as
 364  * the callback function returns false.  If the callback function
 365  * returns true, the iteration will end and the current thread
 366  * will be returned.  This can be useful for implementing a
 367  * search for a thread with arbitrary attributes, or for applying
 368  * some operation to every thread.
 369  *
 370  * FIXME: some of the existing functionality, such as
 371  * "Thread apply all", might be rewritten using this functionality.
 372  */
 373
 374 struct thread_info *
 375 iterate_over_threads (int (*callback) (struct thread_info *, void *),
 376                       void *data)
 377 {
 378   struct thread_info *tp, *next;
 379
 380   for (tp = thread_list; tp; tp = next)
 381     {
 382       next = tp->next;
 383       if ((*callback) (tp, data))
 384         return tp;
 385     }
 386
 387   return NULL;
 388 }
 389
 390 int
 391 thread_count (void)
 392 {
 393   int result = 0;
 394   struct thread_info *tp;
 395
 396   for (tp = thread_list; tp; tp = tp->next)
 397     ++result;
 398
 399   return result;
 400 }
 401
 402 int
 403 valid_thread_id (int num)
 404 {
 405   struct thread_info *tp;
 406
 407   for (tp = thread_list; tp; tp = tp->next)
 408     if (tp->num == num)
 409       return 1;
 410
 411   return 0;
 412 }
 413
 414 int
 415 pid_to_thread_id (ptid_t ptid)
 416 {
 417   struct thread_info *tp;
 418
 419   for (tp = thread_list; tp; tp = tp->next)
 420     if (ptid_equal (tp->ptid, ptid))
 421       return tp->num;
 422
 423   return 0;
 424 }
 425
 426 ptid_t
 427 thread_id_to_pid (int num)
 428 {
 429   struct thread_info *thread = find_thread_id (num);
 430
 431   if (thread)
 432     return thread->ptid;
 433   else
 434     return pid_to_ptid (-1);
 435 }
 436
 437 int
 438 in_thread_list (ptid_t ptid)
 439 {
 440   struct thread_info *tp;
 441
 442   for (tp = thread_list; tp; tp = tp->next)
 443     if (ptid_equal (tp->ptid, ptid))
 444       return 1;
 445
 446   return 0;                     /* Never heard of 'im.  */
 447 }
 448
 449 /* Finds the first thread of the inferior given by PID.  If PID is -1,
 450    return the first thread in the list.  */
 451
 452 struct thread_info *
 453 first_thread_of_process (int pid)
 454 {
 455   struct thread_info *tp, *ret = NULL;
 456
 457   for (tp = thread_list; tp; tp = tp->next)
 458     if (pid == -1 || ptid_get_pid (tp->ptid) == pid)
 459       if (ret == NULL || tp->num < ret->num)
 460         ret = tp;
 461
 462   return ret;
 463 }
 464
 465 struct thread_info *
 466 any_thread_of_process (int pid)
 467 {
 468   struct thread_info *tp;
 469
 470   for (tp = thread_list; tp; tp = tp->next)
 471     if (ptid_get_pid (tp->ptid) == pid)
 472       return tp;
 473
 474   return NULL;
 475 }
 476
 477 struct thread_info *
 478 any_live_thread_of_process (int pid)
 479 {
 480   struct thread_info *tp;
 481   struct thread_info *tp_executing = NULL;
 482
 483   for (tp = thread_list; tp; tp = tp->next)
 484     if (tp->state != THREAD_EXITED && ptid_get_pid (tp->ptid) == pid)
 485       {
 486         if (tp->executing)
 487           tp_executing = tp;
 488         else
 489           return tp;
 490       }
 491
 492   return tp_executing;
 493 }
 494
 495 /* Print a list of thread ids currently known, and the total number of
 496    threads.  To be used from within catch_errors.  */
 497 static int
 498 do_captured_list_thread_ids (struct ui_out *uiout, void *arg)
 499 {
 500   struct thread_info *tp;
 501   int num = 0;
 502   struct cleanup *cleanup_chain;
 503   int current_thread = -1;
 504
 505   update_thread_list ();
 506
 507   cleanup_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "thread-ids");
 508
 509   for (tp = thread_list; tp; tp = tp->next)
 510     {
 511       if (tp->state == THREAD_EXITED)
 512         continue;
 513
 514       if (ptid_equal (tp->ptid, inferior_ptid))
 515         current_thread = tp->num;
 516
 517       num++;
 518       ui_out_field_int (uiout, "thread-id", tp->num);
 519     }
 520
 521   do_cleanups (cleanup_chain);
 522
 523   if (current_thread != -1)
 524     ui_out_field_int (uiout, "current-thread-id", current_thread);
 525   ui_out_field_int (uiout, "number-of-threads", num);
 526   return GDB_RC_OK;
 527 }
 528
 529 /* Official gdblib interface function to get a list of thread ids and
 530    the total number.  */
 531 enum gdb_rc
 532 gdb_list_thread_ids (struct ui_out *uiout, char **error_message)
 533 {
 534   if (catch_exceptions_with_msg (uiout, do_captured_list_thread_ids, NULL,
 535                                  error_message, RETURN_MASK_ALL) < 0)
 536     return GDB_RC_FAIL;
 537   return GDB_RC_OK;
 538 }
 539
 540 /* Return true if TP is an active thread.  */
 541 static int
 542 thread_alive (struct thread_info *tp)
 543 {
 544   if (tp->state == THREAD_EXITED)
 545     return 0;
 546   if (!target_thread_alive (tp->ptid))
 547     return 0;
 548   return 1;
 549 }
 550
 551 static void
 552 prune_threads (void)
 553 {
 554   struct thread_info *tp, *next;
 555
 556   for (tp = thread_list; tp; tp = next)
 557     {
 558       next = tp->next;
 559       if (!thread_alive (tp))
 560         delete_thread (tp->ptid);
 561     }
 562 }
 563
 564 void
 565 thread_change_ptid (ptid_t old_ptid, ptid_t new_ptid)
 566 {
 567   struct inferior *inf;
 568   struct thread_info *tp;
 569
 570   /* It can happen that what we knew as the target inferior id
 571      changes.  E.g, target remote may only discover the remote process
 572      pid after adding the inferior to GDB's list.  */
 573   inf = find_inferior_pid (ptid_get_pid (old_ptid));
 574   inf->pid = ptid_get_pid (new_ptid);
 575
 576   tp = find_thread_ptid (old_ptid);
 577   tp->ptid = new_ptid;
 578
 579   observer_notify_thread_ptid_changed (old_ptid, new_ptid);
 580 }
 581
 582 void
 583 set_running (ptid_t ptid, int running)
 584 {
 585   struct thread_info *tp;
 586   int all = ptid_equal (ptid, minus_one_ptid);
 587
 588   /* We try not to notify the observer if no thread has actually changed
 589      the running state -- merely to reduce the number of messages to
 590      frontend.  Frontend is supposed to handle multiple *running just fine.  */
 591   if (all || ptid_is_pid (ptid))
 592     {
 593       int any_started = 0;
 594
 595       for (tp = thread_list; tp; tp = tp->next)
 596         if (all || ptid_get_pid (tp->ptid) == ptid_get_pid (ptid))
 597           {
 598             if (tp->state == THREAD_EXITED)
 599               continue;
 600             if (running && tp->state == THREAD_STOPPED)
 601               any_started = 1;
 602             tp->state = running ? THREAD_RUNNING : THREAD_STOPPED;
 603           }
 604       if (any_started)
 605         observer_notify_target_resumed (ptid);
 606     }
 607   else
 608     {
 609       int started = 0;
 610
 611       tp = find_thread_ptid (ptid);
 612       gdb_assert (tp);
 613       gdb_assert (tp->state != THREAD_EXITED);
 614       if (running && tp->state == THREAD_STOPPED)
 615         started = 1;
 616       tp->state = running ? THREAD_RUNNING : THREAD_STOPPED;
 617       if (started)
 618         observer_notify_target_resumed (ptid);
 619     }
 620 }
 621
 622 static int
 623 is_thread_state (ptid_t ptid, enum thread_state state)
 624 {
 625   struct thread_info *tp;
 626
 627   tp = find_thread_ptid (ptid);
 628   gdb_assert (tp);
 629   return tp->state == state;
 630 }
 631
 632 int
 633 is_stopped (ptid_t ptid)
 634 {
 635   return is_thread_state (ptid, THREAD_STOPPED);
 636 }
 637
 638 int
 639 is_exited (ptid_t ptid)
 640 {
 641   return is_thread_state (ptid, THREAD_EXITED);
 642 }
 643
 644 int
 645 is_running (ptid_t ptid)
 646 {
 647   return is_thread_state (ptid, THREAD_RUNNING);
 648 }
 649
 650 int
 651 is_executing (ptid_t ptid)
 652 {
 653   struct thread_info *tp;
 654
 655   tp = find_thread_ptid (ptid);
 656   gdb_assert (tp);
 657   return tp->executing;
 658 }
 659
 660 void
 661 set_executing (ptid_t ptid, int executing)
 662 {
 663   struct thread_info *tp;
 664   int all = ptid_equal (ptid, minus_one_ptid);
 665
 666   if (all || ptid_is_pid (ptid))
 667     {
 668       for (tp = thread_list; tp; tp = tp->next)
 669         if (all || ptid_get_pid (tp->ptid) == ptid_get_pid (ptid))
 670           tp->executing = executing;
 671     }
 672   else
 673     {
 674       tp = find_thread_ptid (ptid);
 675       gdb_assert (tp);
 676       tp->executing = executing;
 677     }
 678 }
 679
 680 void
 681 set_stop_requested (ptid_t ptid, int stop)
 682 {
 683   struct thread_info *tp;
 684   int all = ptid_equal (ptid, minus_one_ptid);
 685
 686   if (all || ptid_is_pid (ptid))
 687     {
 688       for (tp = thread_list; tp; tp = tp->next)
 689         if (all || ptid_get_pid (tp->ptid) == ptid_get_pid (ptid))
 690           tp->stop_requested = stop;
 691     }
 692   else
 693     {
 694       tp = find_thread_ptid (ptid);
 695       gdb_assert (tp);
 696       tp->stop_requested = stop;
 697     }
 698
 699   /* Call the stop requested observer so other components of GDB can
 700      react to this request.  */
 701   if (stop)
 702     observer_notify_thread_stop_requested (ptid);
 703 }
 704
 705 void
 706 finish_thread_state (ptid_t ptid)
 707 {
 708   struct thread_info *tp;
 709   int all;
 710   int any_started = 0;
 711
 712   all = ptid_equal (ptid, minus_one_ptid);
 713
 714   if (all || ptid_is_pid (ptid))
 715     {
 716       for (tp = thread_list; tp; tp = tp->next)
 717         {
 718           if (tp->state == THREAD_EXITED)
 719             continue;
 720           if (all || ptid_get_pid (ptid) == ptid_get_pid (tp->ptid))
 721             {
 722               if (tp->executing && tp->state == THREAD_STOPPED)
 723                 any_started = 1;
 724               tp->state = tp->executing ? THREAD_RUNNING : THREAD_STOPPED;
 725             }
 726         }
 727     }
 728   else
 729     {
 730       tp = find_thread_ptid (ptid);
 731       gdb_assert (tp);
 732       if (tp->state != THREAD_EXITED)
 733         {
 734           if (tp->executing && tp->state == THREAD_STOPPED)
 735             any_started = 1;
 736           tp->state = tp->executing ? THREAD_RUNNING : THREAD_STOPPED;
 737         }
 738     }
 739
 740   if (any_started)
 741     observer_notify_target_resumed (ptid);
 742 }
 743
 744 void
 745 finish_thread_state_cleanup (void *arg)
 746 {
 747   ptid_t *ptid_p = arg;
 748
 749   gdb_assert (arg);
 750
 751   finish_thread_state (*ptid_p);
 752 }
 753
 754 int
 755 pc_in_thread_step_range (CORE_ADDR pc, struct thread_info *thread)
 756 {
 757   return (pc >= thread->control.step_range_start
 758           && pc < thread->control.step_range_end);
 759 }
 760
 761 /* Prints the list of threads and their details on UIOUT.
 762    This is a version of 'info_threads_command' suitable for
 763    use from MI.
 764    If REQUESTED_THREAD is not -1, it's the GDB id of the thread
 765    that should be printed.  Otherwise, all threads are
 766    printed.
 767    If PID is not -1, only print threads from the process PID.
 768    Otherwise, threads from all attached PIDs are printed.
 769    If both REQUESTED_THREAD and PID are not -1, then the thread
 770    is printed if it belongs to the specified process.  Otherwise,
 771    an error is raised.  */
 772 void
 773 print_thread_info (struct ui_out *uiout, char *requested_threads, int pid)
 774 {
 775   struct thread_info *tp;
 776   ptid_t current_ptid;
 777   struct cleanup *old_chain;
 778   char *extra_info, *name, *target_id;
 779   int current_thread = -1;
 780
 781   update_thread_list ();
 782   current_ptid = inferior_ptid;
 783
 784   /* We'll be switching threads temporarily.  */
 785   old_chain = make_cleanup_restore_current_thread ();
 786
 787   /* For backward compatibility, we make a list for MI.  A table is
 788      preferable for the CLI, though, because it shows table
 789      headers.  */
 790   if (ui_out_is_mi_like_p (uiout))
 791     make_cleanup_ui_out_list_begin_end (uiout, "threads");
 792   else
 793     {
 794       int n_threads = 0;
 795
 796       for (tp = thread_list; tp; tp = tp->next)
 797         {
 798           if (!number_is_in_list (requested_threads, tp->num))
 799             continue;
 800
 801           if (pid != -1 && ptid_get_pid (tp->ptid) != pid)
 802             continue;
 803
 804           if (tp->state == THREAD_EXITED)
 805             continue;
 806
 807           ++n_threads;
 808         }
 809
 810       if (n_threads == 0)
 811         {
 812           if (requested_threads == NULL || *requested_threads == '\0')
 813             ui_out_message (uiout, 0, _("No threads.\n"));
 814           else
 815             ui_out_message (uiout, 0, _("No threads match '%s'.\n"),
 816                             requested_threads);
 817           do_cleanups (old_chain);
 818           return;
 819         }
 820
 821       make_cleanup_ui_out_table_begin_end (uiout, 4, n_threads, "threads");
 822
 823       ui_out_table_header (uiout, 1, ui_left, "current", "");
 824       ui_out_table_header (uiout, 4, ui_left, "id", "Id");
 825       ui_out_table_header (uiout, 17, ui_left, "target-id", "Target Id");
 826       ui_out_table_header (uiout, 1, ui_left, "frame", "Frame");
 827       ui_out_table_body (uiout);
 828     }
 829
 830   for (tp = thread_list; tp; tp = tp->next)
 831     {
 832       struct cleanup *chain2;
 833       int core;
 834
 835       if (!number_is_in_list (requested_threads, tp->num))
 836         continue;
 837
 838       if (pid != -1 && ptid_get_pid (tp->ptid) != pid)
 839         {
 840           if (requested_threads != NULL && *requested_threads != '\0')
 841             error (_("Requested thread not found in requested process"));
 842           continue;
 843         }
 844
 845       if (ptid_equal (tp->ptid, current_ptid))
 846         current_thread = tp->num;
 847
 848       if (tp->state == THREAD_EXITED)
 849         continue;
 850
 851       chain2 = make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
 852
 853       if (ui_out_is_mi_like_p (uiout))
 854         {
 855           /* Compatibility.  */
 856           if (ptid_equal (tp->ptid, current_ptid))
 857             ui_out_text (uiout, "* ");
 858           else
 859             ui_out_text (uiout, "  ");
 860         }
 861       else
 862         {
 863           if (ptid_equal (tp->ptid, current_ptid))
 864             ui_out_field_string (uiout, "current", "*");
 865           else
 866             ui_out_field_skip (uiout, "current");
 867         }
 868
 869       ui_out_field_int (uiout, "id", tp->num);
 870
 871       /* For the CLI, we stuff everything into the target-id field.
 872          This is a gross hack to make the output come out looking
 873          correct.  The underlying problem here is that ui-out has no
 874          way to specify that a field's space allocation should be
 875          shared by several fields.  For MI, we do the right thing
 876          instead.  */
 877
 878       target_id = target_pid_to_str (tp->ptid);
 879       extra_info = target_extra_thread_info (tp);
 880       name = tp->name ? tp->name : target_thread_name (tp);
 881
 882       if (ui_out_is_mi_like_p (uiout))
 883         {
 884           ui_out_field_string (uiout, "target-id", target_id);
 885           if (extra_info)
 886             ui_out_field_string (uiout, "details", extra_info);
 887           if (name)
 888             ui_out_field_string (uiout, "name", name);
 889         }
 890       else
 891         {
 892           struct cleanup *str_cleanup;
 893           char *contents;
 894
 895           if (extra_info && name)
 896             contents = xstrprintf ("%s \"%s\" (%s)", target_id,
 897                                    name, extra_info);
 898           else if (extra_info)
 899             contents = xstrprintf ("%s (%s)", target_id, extra_info);
 900           else if (name)
 901             contents = xstrprintf ("%s \"%s\"", target_id, name);
 902           else
 903             contents = xstrdup (target_id);
 904           str_cleanup = make_cleanup (xfree, contents);
 905
 906           ui_out_field_string (uiout, "target-id", contents);
 907           do_cleanups (str_cleanup);
 908         }
 909
 910       if (tp->state == THREAD_RUNNING)
 911         ui_out_text (uiout, "(running)\n");
 912       else
 913         {
 914           /* The switch below puts us at the top of the stack (leaf
 915              frame).  */
 916           switch_to_thread (tp->ptid);
 917           print_stack_frame (get_selected_frame (NULL),
 918                              /* For MI output, print frame level.  */
 919                              ui_out_is_mi_like_p (uiout),
 920                              LOCATION, 0);
 921         }
 922
 923       if (ui_out_is_mi_like_p (uiout))
 924         {
 925           char *state = "stopped";
 926
 927           if (tp->state == THREAD_RUNNING)
 928             state = "running";
 929           ui_out_field_string (uiout, "state", state);
 930         }
 931
 932       core = target_core_of_thread (tp->ptid);
 933       if (ui_out_is_mi_like_p (uiout) && core != -1)
 934         ui_out_field_int (uiout, "core", core);
 935
 936       do_cleanups (chain2);
 937     }
 938
 939   /* Restores the current thread and the frame selected before
 940      the "info threads" command.  */
 941   do_cleanups (old_chain);
 942
 943   if (pid == -1 && requested_threads == NULL)
 944     {
 945       gdb_assert (current_thread != -1
 946                   || !thread_list
 947                   || ptid_equal (inferior_ptid, null_ptid));
 948       if (current_thread != -1 && ui_out_is_mi_like_p (uiout))
 949         ui_out_field_int (uiout, "current-thread-id", current_thread);
 950
 951       if (current_thread != -1 && is_exited (current_ptid))
 952         ui_out_message (uiout, 0, "\n\
 953 The current thread <Thread ID %d> has terminated.  See `help thread'.\n",
 954                         current_thread);
 955       else if (thread_list
 956                && current_thread == -1
 957                && ptid_equal (current_ptid, null_ptid))
 958         ui_out_message (uiout, 0, "\n\
 959 No selected thread.  See `help thread'.\n");
 960     }
 961 }
 962
 963 /* Print information about currently known threads
 964
 965    Optional ARG is a thread id, or list of thread ids.
 966
 967    Note: this has the drawback that it _really_ switches
 968          threads, which frees the frame cache.  A no-side
 969          effects info-threads command would be nicer.  */
 970
 971 static void
 972 info_threads_command (char *arg, int from_tty)
 973 {
 974   print_thread_info (current_uiout, arg, -1);
 975 }
 976
 977 /* Switch from one thread to another.  */
 978
 979 void
 980 switch_to_thread (ptid_t ptid)
 981 {
 982   /* Switch the program space as well, if we can infer it from the now
 983      current thread.  Otherwise, it's up to the caller to select the
 984      space it wants.  */
 985   if (!ptid_equal (ptid, null_ptid))
 986     {
 987       struct inferior *inf;
 988
 989       inf = find_inferior_pid (ptid_get_pid (ptid));
 990       gdb_assert (inf != NULL);
 991       set_current_program_space (inf->pspace);
 992       set_current_inferior (inf);
 993     }
 994
 995   if (ptid_equal (ptid, inferior_ptid))
 996     return;
 997
 998   inferior_ptid = ptid;
 999   reinit_frame_cache ();
1000
1001   /* We don't check for is_stopped, because we're called at times
1002      while in the TARGET_RUNNING state, e.g., while handling an
1003      internal event.  */
1004   if (!ptid_equal (inferior_ptid, null_ptid)
1005       && !is_exited (ptid)
1006       && !is_executing (ptid))
1007     stop_pc = regcache_read_pc (get_thread_regcache (ptid));
1008   else
1009     stop_pc = ~(CORE_ADDR) 0;
1010 }
1011
1012 static void
1013 restore_current_thread (ptid_t ptid)
1014 {
1015   switch_to_thread (ptid);
1016 }
1017
1018 static void
1019 restore_selected_frame (struct frame_id a_frame_id, int frame_level)
1020 {
1021   struct frame_info *frame = NULL;
1022   int count;
1023
1024   /* This means there was no selected frame.  */
1025   if (frame_level == -1)
1026     {
1027       select_frame (NULL);
1028       return;
1029     }
1030
1031   gdb_assert (frame_level >= 0);
1032
1033   /* Restore by level first, check if the frame id is the same as
1034      expected.  If that fails, try restoring by frame id.  If that
1035      fails, nothing to do, just warn the user.  */
1036
1037   count = frame_level;
1038   frame = find_relative_frame (get_current_frame (), &count);
1039   if (count == 0
1040       && frame != NULL
1041       /* The frame ids must match - either both valid or both outer_frame_id.
1042          The latter case is not failsafe, but since it's highly unlikely
1043          the search by level finds the wrong frame, it's 99.9(9)% of
1044          the time (for all practical purposes) safe.  */
1045       && frame_id_eq (get_frame_id (frame), a_frame_id))
1046     {
1047       /* Cool, all is fine.  */
1048       select_frame (frame);
1049       return;
1050     }
1051
1052   frame = frame_find_by_id (a_frame_id);
1053   if (frame != NULL)
1054     {
1055       /* Cool, refound it.  */
1056       select_frame (frame);
1057       return;
1058     }
1059
1060   /* Nothing else to do, the frame layout really changed.  Select the
1061      innermost stack frame.  */
1062   select_frame (get_current_frame ());
1063
1064   /* Warn the user.  */
1065   if (frame_level > 0 && !ui_out_is_mi_like_p (current_uiout))
1066     {
1067       warning (_("Couldn't restore frame #%d in "
1068                  "current thread.  Bottom (innermost) frame selected:"),
1069                frame_level);
1070       /* For MI, we should probably have a notification about
1071          current frame change.  But this error is not very
1072          likely, so don't bother for now.  */
1073       print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
1074     }
1075 }
1076
1077 struct current_thread_cleanup
1078 {
1079   ptid_t inferior_ptid;
1080   struct frame_id selected_frame_id;
1081   int selected_frame_level;
1082   int was_stopped;
1083   int inf_id;
1084   int was_removable;
1085 };
1086
1087 static void
1088 do_restore_current_thread_cleanup (void *arg)
1089 {
1090   struct thread_info *tp;
1091   struct current_thread_cleanup *old = arg;
1092
1093   tp = find_thread_ptid (old->inferior_ptid);
1094
1095   /* If the previously selected thread belonged to a process that has
1096      in the mean time been deleted (due to normal exit, detach, etc.),
1097      then don't revert back to it, but instead simply drop back to no
1098      thread selected.  */
1099   if (tp
1100       && find_inferior_pid (ptid_get_pid (tp->ptid)) != NULL)
1101     restore_current_thread (old->inferior_ptid);
1102   else
1103     {
1104       restore_current_thread (null_ptid);
1105       set_current_inferior (find_inferior_id (old->inf_id));
1106     }
1107
1108   /* The running state of the originally selected thread may have
1109      changed, so we have to recheck it here.  */
1110   if (!ptid_equal (inferior_ptid, null_ptid)
1111       && old->was_stopped
1112       && is_stopped (inferior_ptid)
1113       && target_has_registers
1114       && target_has_stack
1115       && target_has_memory)
1116     restore_selected_frame (old->selected_frame_id,
1117                             old->selected_frame_level);
1118 }
1119
1120 static void
1121 restore_current_thread_cleanup_dtor (void *arg)
1122 {
1123   struct current_thread_cleanup *old = arg;
1124   struct thread_info *tp;
1125   struct inferior *inf;
1126
1127   tp = find_thread_ptid (old->inferior_ptid);
1128   if (tp)
1129     tp->refcount--;
1130   inf = find_inferior_id (old->inf_id);
1131   if (inf != NULL)
1132     inf->removable = old->was_removable;
1133   xfree (old);
1134 }
1135
1136 /* Set the thread reference count.  */
1137
1138 static void
1139 set_thread_refcount (void *data)
1140 {
1141   int k;
1142   struct thread_array_cleanup *ta_cleanup = data;
1143
1144   for (k = 0; k != ta_cleanup->count; k++)
1145     ta_cleanup->tp_array[k]->refcount--;
1146 }
1147
1148 struct cleanup *
1149 make_cleanup_restore_current_thread (void)
1150 {
1151   struct thread_info *tp;
1152   struct frame_info *frame;
1153   struct current_thread_cleanup *old;
1154
1155   old = xmalloc (sizeof (struct current_thread_cleanup));
1156   old->inferior_ptid = inferior_ptid;
1157   old->inf_id = current_inferior ()->num;
1158   old->was_removable = current_inferior ()->removable;
1159
1160   if (!ptid_equal (inferior_ptid, null_ptid))
1161     {
1162       old->was_stopped = is_stopped (inferior_ptid);
1163       if (old->was_stopped
1164           && target_has_registers
1165           && target_has_stack
1166           && target_has_memory)
1167         {
1168           /* When processing internal events, there might not be a
1169              selected frame.  If we naively call get_selected_frame
1170              here, then we can end up reading debuginfo for the
1171              current frame, but we don't generally need the debuginfo
1172              at this point.  */
1173           frame = get_selected_frame_if_set ();
1174         }
1175       else
1176         frame = NULL;
1177
1178       old->selected_frame_id = get_frame_id (frame);
1179       old->selected_frame_level = frame_relative_level (frame);
1180
1181       tp = find_thread_ptid (inferior_ptid);
1182       if (tp)
1183         tp->refcount++;
1184     }
1185
1186   current_inferior ()->removable = 0;
1187
1188   return make_cleanup_dtor (do_restore_current_thread_cleanup, old,
1189                             restore_current_thread_cleanup_dtor);
1190 }
1191
1192 /* Apply a GDB command to a list of threads.  List syntax is a whitespace
1193    seperated list of numbers, or ranges, or the keyword `all'.  Ranges consist
1194    of two numbers seperated by a hyphen.  Examples:
1195
1196    thread apply 1 2 7 4 backtrace       Apply backtrace cmd to threads 1,2,7,4
1197    thread apply 2-7 9 p foo(1)  Apply p foo(1) cmd to threads 2->7 & 9
1198    thread apply all p x/i $pc   Apply x/i $pc cmd to all threads.  */
1199
1200 static void
1201 thread_apply_all_command (char *cmd, int from_tty)
1202 {
1203   struct cleanup *old_chain;
1204   char *saved_cmd;
1205   int tc;
1206   struct thread_array_cleanup ta_cleanup;
1207
1208   if (cmd == NULL || *cmd == '\000')
1209     error (_("Please specify a command following the thread ID list"));
1210
1211   update_thread_list ();
1212
1213   old_chain = make_cleanup_restore_current_thread ();
1214
1215   /* Save a copy of the command in case it is clobbered by
1216      execute_command.  */
1217   saved_cmd = xstrdup (cmd);
1218   make_cleanup (xfree, saved_cmd);
1219   tc = thread_count ();
1220
1221   if (tc)
1222     {
1223       struct thread_info **tp_array;
1224       struct thread_info *tp;
1225       int i = 0, k;
1226
1227       /* Save a copy of the thread_list in case we execute detach
1228          command.  */
1229       tp_array = xmalloc (sizeof (struct thread_info *) * tc);
1230       make_cleanup (xfree, tp_array);
1231       ta_cleanup.tp_array = tp_array;
1232       ta_cleanup.count = tc;
1233
1234       ALL_NON_EXITED_THREADS (tp)
1235         {
1236           tp_array[i] = tp;
1237           tp->refcount++;
1238           i++;
1239         }
1240
1241       make_cleanup (set_thread_refcount, &ta_cleanup);
1242
1243       for (k = 0; k != i; k++)
1244         if (thread_alive (tp_array[k]))
1245           {
1246             switch_to_thread (tp_array[k]->ptid);
1247             printf_filtered (_("\nThread %d (%s):\n"),
1248                              tp_array[k]->num,
1249                              target_pid_to_str (inferior_ptid));
1250             execute_command (cmd, from_tty);
1251
1252             /* Restore exact command used previously.  */
1253             strcpy (cmd, saved_cmd);
1254           }
1255     }
1256
1257   do_cleanups (old_chain);
1258 }
1259
1260 static void
1261 thread_apply_command (char *tidlist, int from_tty)
1262 {
1263   char *cmd;
1264   struct cleanup *old_chain;
1265   char *saved_cmd;
1266   struct get_number_or_range_state state;
1267
1268   if (tidlist == NULL || *tidlist == '\000')
1269     error (_("Please specify a thread ID list"));
1270
1271   for (cmd = tidlist; *cmd != '\000' && !isalpha (*cmd); cmd++);
1272
1273   if (*cmd == '\000')
1274     error (_("Please specify a command following the thread ID list"));
1275
1276   /* Save a copy of the command in case it is clobbered by
1277      execute_command.  */
1278   saved_cmd = xstrdup (cmd);
1279   old_chain = make_cleanup (xfree, saved_cmd);
1280
1281   init_number_or_range (&state, tidlist);
1282   while (!state.finished && state.string < cmd)
1283     {
1284       struct thread_info *tp;
1285       int start;
1286
1287       start = get_number_or_range (&state);
1288
1289       make_cleanup_restore_current_thread ();
1290
1291       tp = find_thread_id (start);
1292
1293       if (!tp)
1294         warning (_("Unknown thread %d."), start);
1295       else if (!thread_alive (tp))
1296         warning (_("Thread %d has terminated."), start);
1297       else
1298         {
1299           switch_to_thread (tp->ptid);
1300
1301           printf_filtered (_("\nThread %d (%s):\n"), tp->num,
1302                            target_pid_to_str (inferior_ptid));
1303           execute_command (cmd, from_tty);
1304
1305           /* Restore exact command used previously.  */
1306           strcpy (cmd, saved_cmd);
1307         }
1308     }
1309
1310   do_cleanups (old_chain);
1311 }
1312
1313 /* Switch to the specified thread.  Will dispatch off to thread_apply_command
1314    if prefix of arg is `apply'.  */
1315
1316 static void
1317 thread_command (char *tidstr, int from_tty)
1318 {
1319   if (!tidstr)
1320     {
1321       if (ptid_equal (inferior_ptid, null_ptid))
1322         error (_("No thread selected"));
1323
1324       if (target_has_stack)
1325         {
1326           if (is_exited (inferior_ptid))
1327             printf_filtered (_("[Current thread is %d (%s) (exited)]\n"),
1328                              pid_to_thread_id (inferior_ptid),
1329                              target_pid_to_str (inferior_ptid));
1330           else
1331             printf_filtered (_("[Current thread is %d (%s)]\n"),
1332                              pid_to_thread_id (inferior_ptid),
1333                              target_pid_to_str (inferior_ptid));
1334         }
1335       else
1336         error (_("No stack."));
1337       return;
1338     }
1339
1340   gdb_thread_select (current_uiout, tidstr, NULL);
1341 }
1342
1343 /* Implementation of `thread name'.  */
1344
1345 static void
1346 thread_name_command (char *arg, int from_tty)
1347 {
1348   struct thread_info *info;
1349
1350   if (ptid_equal (inferior_ptid, null_ptid))
1351     error (_("No thread selected"));
1352
1353   arg = skip_spaces (arg);
1354
1355   info = inferior_thread ();
1356   xfree (info->name);
1357   info->name = arg ? xstrdup (arg) : NULL;
1358 }
1359
1360 /* Find thread ids with a name, target pid, or extra info matching ARG.  */
1361
1362 static void
1363 thread_find_command (char *arg, int from_tty)
1364 {
1365   struct thread_info *tp;
1366   char *tmp;
1367   unsigned long match = 0;
1368
1369   if (arg == NULL || *arg == '\0')
1370     error (_("Command requires an argument."));
1371
1372   tmp = re_comp (arg);
1373   if (tmp != 0)
1374     error (_("Invalid regexp (%s): %s"), tmp, arg);
1375
1376   update_thread_list ();
1377   for (tp = thread_list; tp; tp = tp->next)
1378     {
1379       if (tp->name != NULL && re_exec (tp->name))
1380         {
1381           printf_filtered (_("Thread %d has name '%s'\n"),
1382                            tp->num, tp->name);
1383           match++;
1384         }
1385
1386       tmp = target_thread_name (tp);
1387       if (tmp != NULL && re_exec (tmp))
1388         {
1389           printf_filtered (_("Thread %d has target name '%s'\n"),
1390                            tp->num, tmp);
1391           match++;
1392         }
1393
1394       tmp = target_pid_to_str (tp->ptid);
1395       if (tmp != NULL && re_exec (tmp))
1396         {
1397           printf_filtered (_("Thread %d has target id '%s'\n"),
1398                            tp->num, tmp);
1399           match++;
1400         }
1401
1402       tmp = target_extra_thread_info (tp);
1403       if (tmp != NULL && re_exec (tmp))
1404         {
1405           printf_filtered (_("Thread %d has extra info '%s'\n"),
1406                            tp->num, tmp);
1407           match++;
1408         }
1409     }
1410   if (!match)
1411     printf_filtered (_("No threads match '%s'\n"), arg);
1412 }
1413
1414 /* Print notices when new threads are attached and detached.  */
1415 int print_thread_events = 1;
1416 static void
1417 show_print_thread_events (struct ui_file *file, int from_tty,
1418                           struct cmd_list_element *c, const char *value)
1419 {
1420   fprintf_filtered (file,
1421                     _("Printing of thread events is %s.\n"),
1422                     value);
1423 }
1424
1425 static int
1426 do_captured_thread_select (struct ui_out *uiout, void *tidstr)
1427 {
1428   int num;
1429   struct thread_info *tp;
1430
1431   num = value_as_long (parse_and_eval (tidstr));
1432
1433   tp = find_thread_id (num);
1434
1435   if (!tp)
1436     error (_("Thread ID %d not known."), num);
1437
1438   if (!thread_alive (tp))
1439     error (_("Thread ID %d has terminated."), num);
1440
1441   switch_to_thread (tp->ptid);
1442
1443   annotate_thread_changed ();
1444
1445   ui_out_text (uiout, "[Switching to thread ");
1446   ui_out_field_int (uiout, "new-thread-id", pid_to_thread_id (inferior_ptid));
1447   ui_out_text (uiout, " (");
1448   ui_out_text (uiout, target_pid_to_str (inferior_ptid));
1449   ui_out_text (uiout, ")]");
1450
1451   /* Note that we can't reach this with an exited thread, due to the
1452      thread_alive check above.  */
1453   if (tp->state == THREAD_RUNNING)
1454     ui_out_text (uiout, "(running)\n");
1455   else
1456     {
1457       ui_out_text (uiout, "\n");
1458       print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
1459     }
1460
1461   /* Since the current thread may have changed, see if there is any
1462      exited thread we can now delete.  */
1463   prune_threads ();
1464
1465   return GDB_RC_OK;
1466 }
1467
1468 enum gdb_rc
1469 gdb_thread_select (struct ui_out *uiout, char *tidstr, char **error_message)
1470 {
1471   if (catch_exceptions_with_msg (uiout, do_captured_thread_select, tidstr,
1472                                  error_message, RETURN_MASK_ALL) < 0)
1473     return GDB_RC_FAIL;
1474   return GDB_RC_OK;
1475 }
1476
1477 void
1478 update_thread_list (void)
1479 {
1480   prune_threads ();
1481   target_find_new_threads ();
1482 }
1483
1484 /* Return a new value for the selected thread's id.  Return a value of 0 if
1485    no thread is selected, or no threads exist.  */
1486
1487 static struct value *
1488 thread_id_make_value (struct gdbarch *gdbarch, struct internalvar *var,
1489                       void *ignore)
1490 {
1491   struct thread_info *tp = find_thread_ptid (inferior_ptid);
1492
1493   return value_from_longest (builtin_type (gdbarch)->builtin_int,
1494                              (tp ? tp->num : 0));
1495 }
1496
1497 /* Commands with a prefix of `thread'.  */
1498 struct cmd_list_element *thread_cmd_list = NULL;
1499
1500 /* Implementation of `thread' variable.  */
1501
1502 static const struct internalvar_funcs thread_funcs =
1503 {
1504   thread_id_make_value,
1505   NULL,
1506   NULL
1507 };
1508
1509 void
1510 _initialize_thread (void)
1511 {
1512   static struct cmd_list_element *thread_apply_list = NULL;
1513
1514   add_info ("threads", info_threads_command,
1515             _("Display currently known threads.\n\
1516 Usage: info threads [ID]...\n\
1517 Optional arguments are thread IDs with spaces between.\n\
1518 If no arguments, all threads are displayed."));
1519
1520   add_prefix_cmd ("thread", class_run, thread_command, _("\
1521 Use this command to switch between threads.\n\
1522 The new thread ID must be currently known."),
1523                   &thread_cmd_list, "thread ", 1, &cmdlist);
1524
1525   add_prefix_cmd ("apply", class_run, thread_apply_command,
1526                   _("Apply a command to a list of threads."),
1527                   &thread_apply_list, "thread apply ", 1, &thread_cmd_list);
1528
1529   add_cmd ("all", class_run, thread_apply_all_command,
1530            _("Apply a command to all threads."), &thread_apply_list);
1531
1532   add_cmd ("name", class_run, thread_name_command,
1533            _("Set the current thread's name.\n\
1534 Usage: thread name [NAME]\n\
1535 If NAME is not given, then any existing name is removed."), &thread_cmd_list);
1536
1537   add_cmd ("find", class_run, thread_find_command, _("\
1538 Find threads that match a regular expression.\n\
1539 Usage: thread find REGEXP\n\
1540 Will display thread ids whose name, target ID, or extra info matches REGEXP."),
1541            &thread_cmd_list);
1542
1543   if (!xdb_commands)
1544     add_com_alias ("t", "thread", class_run, 1);
1545
1546   add_setshow_boolean_cmd ("thread-events", no_class,
1547          &print_thread_events, _("\
1548 Set printing of thread events (such as thread start and exit)."), _("\
1549 Show printing of thread events (such as thread start and exit)."), NULL,
1550          NULL,
1551          show_print_thread_events,
1552          &setprintlist, &showprintlist);
1553
1554   create_internalvar_type_lazy ("_thread", &thread_funcs, NULL);
1555 }