gdb/
[binutils-gdb.git] / gdb / thread.c
index 1be325fef62cad5c9b2f6d3c8002de6ad3edcad2..6ad1807db83247e89b499c44984e5f8702e1505d 100644 (file)
@@ -1,7 +1,7 @@
 /* Multi-process/thread control for GDB, the GNU debugger.
 
    Copyright (C) 1986, 1987, 1988, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
-   2000, 2001, 2002, 2003, 2004, 2007, 2008, 2009, 2010
+   2000, 2001, 2002, 2003, 2004, 2007, 2008, 2009, 2010, 2011
    Free Software Foundation, Inc.
 
    Contributed by Lynx Real-Time Systems, Inc.  Los Gatos, CA.
 #include "observer.h"
 #include "annotate.h"
 #include "cli/cli-decode.h"
+#include "gdb_regex.h"
+#include "cli/cli-utils.h"
 
-/* Definition of struct thread_info exported to gdbthread.h */
+/* Definition of struct thread_info exported to gdbthread.h */
 
-/* Prototypes for exported functions. */
+/* Prototypes for exported functions.  */
 
 void _initialize_thread (void);
 
-/* Prototypes for local functions. */
+/* Prototypes for local functions.  */
 
 static struct thread_info *thread_list = NULL;
 static int highest_thread_num;
@@ -141,6 +143,7 @@ free_thread (struct thread_info *tp)
        xfree (tp->private);
     }
 
+  xfree (tp->name);
   xfree (tp);
 }
 
@@ -432,7 +435,7 @@ in_thread_list (ptid_t ptid)
     if (ptid_equal (tp->ptid, ptid))
       return 1;
 
-  return 0;                    /* Never heard of 'im */
+  return 0;                    /* Never heard of 'im */
 }
 
 /* Finds the first thread of the inferior given by PID.  If PID is -1,
@@ -482,7 +485,7 @@ any_live_thread_of_process (int pid)
 }
 
 /* Print a list of thread ids currently known, and the total number of
-   threads. To be used from within catch_errors. */
+   threads.  To be used from within catch_errors.  */
 static int
 do_captured_list_thread_ids (struct ui_out *uiout, void *arg)
 {
@@ -516,7 +519,7 @@ do_captured_list_thread_ids (struct ui_out *uiout, void *arg)
 }
 
 /* Official gdblib interface function to get a list of thread ids and
-   the total number. */
+   the total number.  */
 enum gdb_rc
 gdb_list_thread_ids (struct ui_out *uiout, char **error_message)
 {
@@ -526,7 +529,7 @@ gdb_list_thread_ids (struct ui_out *uiout, char **error_message)
   return GDB_RC_OK;
 }
 
-/* Return true if TP is an active thread. */
+/* Return true if TP is an active thread.  */
 static int
 thread_alive (struct thread_info *tp)
 {
@@ -753,23 +756,23 @@ finish_thread_state_cleanup (void *arg)
 }
 
 /* Prints the list of threads and their details on UIOUT.
-   This is a version of 'info_thread_command' suitable for
-   use from MI.  
+   This is a version of 'info_threads_command' suitable for
+   use from MI.
    If REQUESTED_THREAD is not -1, it's the GDB id of the thread
    that should be printed.  Otherwise, all threads are
-   printed.  
+   printed.
    If PID is not -1, only print threads from the process PID.
-   Otherwise, threads from all attached PIDs are printed.   
+   Otherwise, threads from all attached PIDs are printed.
    If both REQUESTED_THREAD and PID are not -1, then the thread
    is printed if it belongs to the specified process.  Otherwise,
    an error is raised.  */
 void
-print_thread_info (struct ui_out *uiout, int requested_thread, int pid)
+print_thread_info (struct ui_out *uiout, char *requested_threads, int pid)
 {
   struct thread_info *tp;
   ptid_t current_ptid;
   struct cleanup *old_chain;
-  char *extra_info;
+  char *extra_info, *name, *target_id;
   int current_thread = -1;
 
   update_thread_list ();
@@ -778,18 +781,60 @@ print_thread_info (struct ui_out *uiout, int requested_thread, int pid)
   /* We'll be switching threads temporarily.  */
   old_chain = make_cleanup_restore_current_thread ();
 
-  make_cleanup_ui_out_list_begin_end (uiout, "threads");
+  /* For backward compatibility, we make a list for MI.  A table is
+     preferable for the CLI, though, because it shows table
+     headers.  */
+  if (ui_out_is_mi_like_p (uiout))
+    make_cleanup_ui_out_list_begin_end (uiout, "threads");
+  else
+    {
+      int n_threads = 0;
+
+      for (tp = thread_list; tp; tp = tp->next)
+       {
+         if (!number_is_in_list (requested_threads, tp->num))
+           continue;
+
+         if (pid != -1 && PIDGET (tp->ptid) != pid)
+           continue;
+
+         if (tp->state_ == THREAD_EXITED)
+           continue;
+
+         ++n_threads;
+       }
+
+      if (n_threads == 0)
+       {
+         if (requested_threads == NULL || *requested_threads == '\0')
+           ui_out_message (uiout, 0, _("No threads.\n"));
+         else
+           ui_out_message (uiout, 0, _("No threads match '%s'.\n"),
+                           requested_threads);
+         do_cleanups (old_chain);
+         return;
+       }
+
+      make_cleanup_ui_out_table_begin_end (uiout, 4, n_threads, "threads");
+
+      ui_out_table_header (uiout, 1, ui_left, "current", "");
+      ui_out_table_header (uiout, 4, ui_left, "id", "Id");
+      ui_out_table_header (uiout, 17, ui_left, "target-id", "Target Id");
+      ui_out_table_header (uiout, 1, ui_left, "frame", "Frame");
+      ui_out_table_body (uiout);
+    }
+
   for (tp = thread_list; tp; tp = tp->next)
     {
       struct cleanup *chain2;
       int core;
 
-      if (requested_thread != -1 && tp->num != requested_thread)
+      if (!number_is_in_list (requested_threads, tp->num))
        continue;
 
       if (pid != -1 && PIDGET (tp->ptid) != pid)
        {
-         if (requested_thread != -1)
+         if (requested_threads != NULL && *requested_threads != '\0')
            error (_("Requested thread not found in requested process"));
          continue;
        }
@@ -802,23 +847,62 @@ print_thread_info (struct ui_out *uiout, int requested_thread, int pid)
 
       chain2 = make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
 
-      if (ptid_equal (tp->ptid, current_ptid))
-       ui_out_text (uiout, "* ");
+      if (ui_out_is_mi_like_p (uiout))
+       {
+         /* Compatibility.  */
+         if (ptid_equal (tp->ptid, current_ptid))
+           ui_out_text (uiout, "* ");
+         else
+           ui_out_text (uiout, "  ");
+       }
       else
-       ui_out_text (uiout, "  ");
+       {
+         if (ptid_equal (tp->ptid, current_ptid))
+           ui_out_field_string (uiout, "current", "*");
+         else
+           ui_out_field_skip (uiout, "current");
+       }
 
       ui_out_field_int (uiout, "id", tp->num);
-      ui_out_text (uiout, " ");
-      ui_out_field_string (uiout, "target-id", target_pid_to_str (tp->ptid));
 
+      /* For the CLI, we stuff everything into the target-id field.
+        This is a gross hack to make the output come out looking
+        correct.  The underlying problem here is that ui-out has no
+        way to specify that a field's space allocation should be
+        shared by several fields.  For MI, we do the right thing
+        instead.  */
+
+      target_id = target_pid_to_str (tp->ptid);
       extra_info = target_extra_thread_info (tp);
-      if (extra_info)
+      name = tp->name ? tp->name : target_thread_name (tp);
+
+      if (ui_out_is_mi_like_p (uiout))
+       {
+         ui_out_field_string (uiout, "target-id", target_id);
+         if (extra_info)
+           ui_out_field_string (uiout, "details", extra_info);
+         if (name)
+           ui_out_field_string (uiout, "name", name);
+       }
+      else
        {
-         ui_out_text (uiout, " (");
-         ui_out_field_string (uiout, "details", extra_info);
-         ui_out_text (uiout, ")");
+         struct cleanup *str_cleanup;
+         char *contents;
+
+         if (extra_info && name)
+           contents = xstrprintf ("%s \"%s\" (%s)", target_id,
+                                  name, extra_info);
+         else if (extra_info)
+           contents = xstrprintf ("%s (%s)", target_id, extra_info);
+         else if (name)
+           contents = xstrprintf ("%s \"%s\"", target_id, name);
+         else
+           contents = xstrdup (target_id);
+         str_cleanup = make_cleanup (xfree, contents);
+
+         ui_out_field_string (uiout, "target-id", contents);
+         do_cleanups (str_cleanup);
        }
-      ui_out_text (uiout, "  ");
 
       if (tp->state_ == THREAD_RUNNING)
        ui_out_text (uiout, "(running)\n");
@@ -853,7 +937,7 @@ print_thread_info (struct ui_out *uiout, int requested_thread, int pid)
      the "info threads" command.  */
   do_cleanups (old_chain);
 
-  if (pid == -1 && requested_thread == -1)
+  if (pid == -1 && requested_threads == NULL)
     {
       gdb_assert (current_thread != -1
                  || !thread_list
@@ -873,21 +957,21 @@ No selected thread.  See `help thread'.\n");
     }
 }
 
-
 /* Print information about currently known threads 
 
- * Note: this has the drawback that it _really_ switches
- *       threads, which frees the frame cache.  A no-side
- *       effects info-threads command would be nicer.
- */
+   Optional ARG is a thread id, or list of thread ids.
+
+   Note: this has the drawback that it _really_ switches
+         threads, which frees the frame cache.  A no-side
+         effects info-threads command would be nicer.  */
 
 static void
 info_threads_command (char *arg, int from_tty)
 {
-  print_thread_info (uiout, -1, -1);
+  print_thread_info (uiout, arg, -1);
 }
 
-/* Switch from one thread to another. */
+/* Switch from one thread to another.  */
 
 void
 switch_to_thread (ptid_t ptid)
@@ -935,6 +1019,13 @@ restore_selected_frame (struct frame_id a_frame_id, int frame_level)
   struct frame_info *frame = NULL;
   int count;
 
+  /* This means there was no selected frame.  */
+  if (frame_level == -1)
+    {
+      select_frame (NULL);
+      return;
+    }
+
   gdb_assert (frame_level >= 0);
 
   /* Restore by level first, check if the frame id is the same as
@@ -971,8 +1062,8 @@ restore_selected_frame (struct frame_id a_frame_id, int frame_level)
   /* Warn the user.  */
   if (frame_level > 0 && !ui_out_is_mi_like_p (uiout))
     {
-      warning (_("\
-Couldn't restore frame #%d in current thread, at reparsed frame #0\n"),
+      warning (_("Couldn't restore frame #%d in "
+                "current thread, at reparsed frame #0\n"),
               frame_level);
       /* For MI, we should probably have a notification about
         current frame change.  But this error is not very
@@ -1053,7 +1144,14 @@ make_cleanup_restore_current_thread (void)
          && target_has_registers
          && target_has_stack
          && target_has_memory)
-       frame = get_selected_frame (NULL);
+       {
+         /* When processing internal events, there might not be a
+            selected frame.  If we naively call get_selected_frame
+            here, then we can end up reading debuginfo for the
+            current frame, but we don't generally need the debuginfo
+            at this point.  */
+         frame = get_selected_frame_if_set ();
+       }
       else
        frame = NULL;
 
@@ -1075,8 +1173,7 @@ make_cleanup_restore_current_thread (void)
 
    thread apply 1 2 7 4 backtrace       Apply backtrace cmd to threads 1,2,7,4
    thread apply 2-7 9 p foo(1)  Apply p foo(1) cmd to threads 2->7 & 9
-   thread apply all p x/i $pc   Apply x/i $pc cmd to all threads
- */
+   thread apply all p x/i $pc   Apply x/i $pc cmd to all threads.  */
 
 static void
 thread_apply_all_command (char *cmd, int from_tty)
@@ -1093,7 +1190,7 @@ thread_apply_all_command (char *cmd, int from_tty)
   old_chain = make_cleanup_restore_current_thread ();
 
   /* Save a copy of the command in case it is clobbered by
-     execute_command */
+     execute_command */
   saved_cmd = xstrdup (cmd);
   make_cleanup (xfree, saved_cmd);
   for (tp = thread_list; tp; tp = tp->next)
@@ -1104,7 +1201,8 @@ thread_apply_all_command (char *cmd, int from_tty)
        printf_filtered (_("\nThread %d (%s):\n"),
                         tp->num, target_pid_to_str (inferior_ptid));
        execute_command (cmd, from_tty);
-       strcpy (cmd, saved_cmd);        /* Restore exact command used previously */
+       strcpy (cmd, saved_cmd);        /* Restore exact command used
+                                          previously.  */
       }
 
   do_cleanups (old_chain);
@@ -1114,9 +1212,9 @@ static void
 thread_apply_command (char *tidlist, int from_tty)
 {
   char *cmd;
-  char *p;
   struct cleanup *old_chain;
   char *saved_cmd;
+  struct get_number_or_range_state state;
 
   if (tidlist == NULL || *tidlist == '\000')
     error (_("Please specify a thread ID list"));
@@ -1127,57 +1225,37 @@ thread_apply_command (char *tidlist, int from_tty)
     error (_("Please specify a command following the thread ID list"));
 
   /* Save a copy of the command in case it is clobbered by
-     execute_command */
+     execute_command */
   saved_cmd = xstrdup (cmd);
   old_chain = make_cleanup (xfree, saved_cmd);
-  while (tidlist < cmd)
+
+  init_number_or_range (&state, tidlist);
+  while (!state.finished && state.string < cmd)
     {
       struct thread_info *tp;
-      int start, end;
-
-      start = strtol (tidlist, &p, 10);
-      if (p == tidlist)
-       error (_("Error parsing %s"), tidlist);
-      tidlist = p;
-
-      while (*tidlist == ' ' || *tidlist == '\t')
-       tidlist++;
+      int start;
+      char *p = tidlist;
 
-      if (*tidlist == '-')     /* Got a range of IDs? */
-       {
-         tidlist++;            /* Skip the - */
-         end = strtol (tidlist, &p, 10);
-         if (p == tidlist)
-           error (_("Error parsing %s"), tidlist);
-         tidlist = p;
-
-         while (*tidlist == ' ' || *tidlist == '\t')
-           tidlist++;
-       }
-      else
-       end = start;
+      start = get_number_or_range (&state);
 
       make_cleanup_restore_current_thread ();
 
-      for (; start <= end; start++)
-       {
-         tp = find_thread_id (start);
+      tp = find_thread_id (start);
 
-         if (!tp)
-           warning (_("Unknown thread %d."), start);
-         else if (!thread_alive (tp))
-           warning (_("Thread %d has terminated."), start);
-         else
-           {
-             switch_to_thread (tp->ptid);
+      if (!tp)
+       warning (_("Unknown thread %d."), start);
+      else if (!thread_alive (tp))
+       warning (_("Thread %d has terminated."), start);
+      else
+       {
+         switch_to_thread (tp->ptid);
 
-             printf_filtered (_("\nThread %d (%s):\n"), tp->num,
-                              target_pid_to_str (inferior_ptid));
-             execute_command (cmd, from_tty);
+         printf_filtered (_("\nThread %d (%s):\n"), tp->num,
+                          target_pid_to_str (inferior_ptid));
+         execute_command (cmd, from_tty);
 
-             /* Restore exact command used previously.  */
-             strcpy (cmd, saved_cmd);
-           }
+         /* Restore exact command used previously.  */
+         strcpy (cmd, saved_cmd);
        }
     }
 
@@ -1214,14 +1292,86 @@ thread_command (char *tidstr, int from_tty)
   gdb_thread_select (uiout, tidstr, NULL);
 }
 
+/* Implementation of `thread name'.  */
+
+static void
+thread_name_command (char *arg, int from_tty)
+{
+  struct thread_info *info;
+
+  if (ptid_equal (inferior_ptid, null_ptid))
+    error (_("No thread selected"));
+
+  while (arg && isspace (*arg))
+    ++arg;
+
+  info = inferior_thread ();
+  xfree (info->name);
+  info->name = arg ? xstrdup (arg) : NULL;
+}
+
+/* Find thread ids with a name, target pid, or extra info matching ARG.  */
+
+static void
+thread_find_command (char *arg, int from_tty)
+{
+  struct thread_info *tp;
+  char *tmp;
+  unsigned long match = 0;
+
+  if (arg == NULL || *arg == '\0')
+    error (_("Command requires an argument."));
+
+  tmp = re_comp (arg);
+  if (tmp != 0)
+    error (_("Invalid regexp (%s): %s"), tmp, arg);
+
+  update_thread_list ();
+  for (tp = thread_list; tp; tp = tp->next)
+    {
+      if (tp->name != NULL && re_exec (tp->name))
+       {
+         printf_filtered (_("Thread %d has name '%s'\n"),
+                          tp->num, tp->name);
+         match++;
+       }
+
+      tmp = target_thread_name (tp);
+      if (tmp != NULL && re_exec (tmp))
+       {
+         printf_filtered (_("Thread %d has target name '%s'\n"),
+                          tp->num, tmp);
+         match++;
+       }
+
+      tmp = target_pid_to_str (tp->ptid);
+      if (tmp != NULL && re_exec (tmp))
+       {
+         printf_filtered (_("Thread %d has target id '%s'\n"),
+                          tp->num, tmp);
+         match++;
+       }
+
+      tmp = target_extra_thread_info (tp);
+      if (tmp != NULL && re_exec (tmp))
+       {
+         printf_filtered (_("Thread %d has extra info '%s'\n"),
+                          tp->num, tmp);
+         match++;
+       }
+    }
+  if (!match)
+    printf_filtered (_("No threads match '%s'\n"), arg);
+}
+
 /* Print notices when new threads are attached and detached.  */
 int print_thread_events = 1;
 static void
 show_print_thread_events (struct ui_file *file, int from_tty,
                           struct cmd_list_element *c, const char *value)
 {
-  fprintf_filtered (file, _("\
-Printing of thread events is %s.\n"),
+  fprintf_filtered (file,
+                   _("Printing of thread events is %s.\n"),
                     value);
 }
 
@@ -1256,7 +1406,10 @@ do_captured_thread_select (struct ui_out *uiout, void *tidstr)
   if (tp->state_ == THREAD_RUNNING)
     ui_out_text (uiout, "(running)\n");
   else
-    print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC);
+    {
+      ui_out_text (uiout, "\n");
+      print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC);
+    }
 
   /* Since the current thread may have changed, see if there is any
      exited thread we can now delete.  */
@@ -1301,8 +1454,11 @@ _initialize_thread (void)
 {
   static struct cmd_list_element *thread_apply_list = NULL;
 
-  add_info ("threads", info_threads_command,
-           _("IDs of currently known threads."));
+  add_info ("threads", info_threads_command, 
+           _("Display currently known threads.\n\
+Usage: info threads [ID]...\n\
+Optional arguments are thread IDs with spaces between.\n\
+If no arguments, all threads are displayed."));
 
   add_prefix_cmd ("thread", class_run, thread_command, _("\
 Use this command to switch between threads.\n\
@@ -1316,6 +1472,17 @@ The new thread ID must be currently known."),
   add_cmd ("all", class_run, thread_apply_all_command,
           _("Apply a command to all threads."), &thread_apply_list);
 
+  add_cmd ("name", class_run, thread_name_command,
+          _("Set the current thread's name.\n\
+Usage: thread name [NAME]\n\
+If NAME is not given, then any existing name is removed."), &thread_cmd_list);
+
+  add_cmd ("find", class_run, thread_find_command, _("\
+Find threads that match a regular expression.\n\
+Usage: thread find REGEXP\n\
+Will display thread ids whose name, target ID, or extra info matches REGEXP."),
+          &thread_cmd_list);
+
   if (!xdb_commands)
     add_com_alias ("t", "thread", class_run, 1);