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