gas/
[deliverable/binutils-gdb.git] / gdb / exceptions.c
index ccf486303a39c55961b947c2f01fad85a82479f8..014524f88c891c3e7fd6d8fb5b8d67ddca457d71 100644 (file)
@@ -1,8 +1,8 @@
 /* Exception (throw catch) mechanism, for GDB, the GNU debugger.
 
    Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
-   1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Free Software
-   Foundation, Inc.
+   1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free
+   Software Foundation, Inc.
 
    This file is part of GDB.
 
@@ -23,7 +23,6 @@
 
 #include "defs.h"
 #include "exceptions.h"
-#include <setjmp.h>
 #include "breakpoint.h"
 #include "target.h"
 #include "inferior.h"
 #include "ui-out.h"
 #include "gdb_assert.h"
 #include "gdb_string.h"
+#include "serial.h"
 
-const struct exception exception_none = { 0, NO_ERROR, NULL };
-
-/* One should use catch_errors rather than manipulating these
-   directly.  */
-#if defined(HAVE_SIGSETJMP)
-#define SIGJMP_BUF             sigjmp_buf
-#define SIGSETJMP(buf)         sigsetjmp((buf), 1)
-#define SIGLONGJMP(buf,val)    siglongjmp((buf), (val))
-#else
-#define SIGJMP_BUF             jmp_buf
-#define SIGSETJMP(buf)         setjmp(buf)
-#define SIGLONGJMP(buf,val)    longjmp((buf), (val))
-#endif
+const struct gdb_exception exception_none = { 0, NO_ERROR, NULL };
 
 /* Possible catcher states.  */
 enum catcher_state {
@@ -68,13 +56,11 @@ struct catcher
 {
   enum catcher_state state;
   /* Jump buffer pointing back at the exception handler.  */
-  SIGJMP_BUF buf;
-  /* Status buffer belonging to that exception handler.  */
-  volatile struct exception *exception;
+  EXCEPTIONS_SIGJMP_BUF buf;
+  /* Status buffer belonging to the exception handler.  */
+  volatile struct gdb_exception *exception;
   /* Saved/current state.  */
   int mask;
-  char *saved_error_pre_print;
-  char *saved_quit_pre_print;
   struct ui_out *saved_uiout;
   struct cleanup *saved_cleanup_chain;
   /* Back link.  */
@@ -84,11 +70,10 @@ struct catcher
 /* Where to go for throw_exception().  */
 static struct catcher *current_catcher;
 
-static SIGJMP_BUF *
-catcher_init (struct ui_out *func_uiout,
-             char *errstring,
-             volatile struct exception *exception,
-             return_mask mask)
+EXCEPTIONS_SIGJMP_BUF *
+exceptions_state_mc_init (struct ui_out *func_uiout,
+                         volatile struct gdb_exception *exception,
+                         return_mask mask)
 {
   struct catcher *new_catcher = XZALLOC (struct catcher);
 
@@ -100,14 +85,6 @@ catcher_init (struct ui_out *func_uiout,
 
   new_catcher->mask = mask;
 
-  /* Override error/quit messages during FUNC. */
-  new_catcher->saved_error_pre_print = error_pre_print;
-  new_catcher->saved_quit_pre_print = quit_pre_print;
-  if (mask & RETURN_MASK_ERROR)
-    error_pre_print = errstring;
-  if (mask & RETURN_MASK_QUIT)
-    quit_pre_print = errstring;
-
   /* Override the global ``struct ui_out'' builder.  */
   new_catcher->saved_uiout = uiout;
   uiout = func_uiout;
@@ -137,17 +114,14 @@ catcher_pop (void)
 
   uiout = old_catcher->saved_uiout;
 
-  quit_pre_print = old_catcher->saved_quit_pre_print;
-  error_pre_print = old_catcher->saved_error_pre_print;
-
   xfree (old_catcher);
 }
 
 /* Catcher state machine.  Returns non-zero if the m/c should be run
    again, zero if it should abort.  */
 
-int
-catcher_state_machine (enum catcher_action action)
+static int
+exceptions_state_mc (enum catcher_action action)
 {
   switch (current_catcher->state)
     {
@@ -159,7 +133,7 @@ catcher_state_machine (enum catcher_action action)
          current_catcher->state = CATCHER_RUNNING;
          return 1;
        default:
-         internal_error (__FILE__, __LINE__, "bad state");
+         internal_error (__FILE__, __LINE__, _("bad state"));
        }
     case CATCHER_RUNNING:
       switch (action)
@@ -176,7 +150,7 @@ catcher_state_machine (enum catcher_action action)
          /* See also throw_exception.  */
          return 1;
        default:
-         internal_error (__FILE__, __LINE__, "bad switch");
+         internal_error (__FILE__, __LINE__, _("bad switch"));
        }
     case CATCHER_RUNNING_1:
       switch (action)
@@ -193,14 +167,14 @@ catcher_state_machine (enum catcher_action action)
          /* See also throw_exception.  */
          return 1;
        default:
-         internal_error (__FILE__, __LINE__, "bad switch");
+         internal_error (__FILE__, __LINE__, _("bad switch"));
        }
     case CATCHER_ABORTING:
       switch (action)
        {
        case CATCH_ITER:
          {
-           struct exception exception = *current_catcher->exception;
+           struct gdb_exception exception = *current_catcher->exception;
            if (current_catcher->mask & RETURN_MASK (exception.reason))
              {
                /* Exit normally if this catcher can handle this
@@ -216,17 +190,29 @@ catcher_state_machine (enum catcher_action action)
            throw_exception (exception);
          }
        default:
-         internal_error (__FILE__, __LINE__, "bad state");
+         internal_error (__FILE__, __LINE__, _("bad state"));
        }
     default:
-      internal_error (__FILE__, __LINE__, "bad switch");
+      internal_error (__FILE__, __LINE__, _("bad switch"));
     }
 }
 
+int
+exceptions_state_mc_action_iter (void)
+{
+  return exceptions_state_mc (CATCH_ITER);
+}
+
+int
+exceptions_state_mc_action_iter_1 (void)
+{
+  return exceptions_state_mc (CATCH_ITER_1);
+}
+
 /* Return EXCEPTION to the nearest containing catch_errors().  */
 
 NORETURN void
-throw_exception (struct exception exception)
+throw_exception (struct gdb_exception exception)
 {
   quit_flag = 0;
   immediate_quit = 0;
@@ -242,32 +228,20 @@ throw_exception (struct exception exception)
   if (sync_execution)
     do_exec_error_cleanups (ALL_CLEANUPS);
 
-  if (annotation_level > 1)
-    switch (exception.reason)
-      {
-      case RETURN_QUIT:
-       annotate_quit ();
-       break;
-      case RETURN_ERROR:
-       /* Assume that these are all errors.  */
-       annotate_error ();
-       break;
-      default:
-       internal_error (__FILE__, __LINE__, "Bad switch.");
-      }
-
   /* Jump to the containing catch_errors() call, communicating REASON
      to that call via setjmp's return value.  Note that REASON can't
      be zero, by definition in defs.h. */
-  catcher_state_machine (CATCH_THROWING);
+  exceptions_state_mc (CATCH_THROWING);
   *current_catcher->exception = exception;
-  SIGLONGJMP (current_catcher->buf, exception.reason);
+  EXCEPTIONS_SIGLONGJMP (current_catcher->buf, exception.reason);
 }
 
+static char *last_message;
+
 NORETURN void
-throw_reason (enum return_reason reason)
+deprecated_throw_reason (enum return_reason reason)
 {
-  struct exception exception;
+  struct gdb_exception exception;
   memset (&exception, 0, sizeof exception);
 
   exception.reason = reason;
@@ -277,15 +251,171 @@ throw_reason (enum return_reason reason)
       break;
     case RETURN_ERROR:
       exception.error = GENERIC_ERROR;
-      exception.message = error_last_message ();
       break;
     default:
-      internal_error (__FILE__, __LINE__, "bad switch");
+      internal_error (__FILE__, __LINE__, _("bad switch"));
     }
   
   throw_exception (exception);
 }
 
+static void
+print_flush (void)
+{
+  struct serial *gdb_stdout_serial;
+
+  if (deprecated_error_begin_hook)
+    deprecated_error_begin_hook ();
+  target_terminal_ours ();
+
+  /* We want all output to appear now, before we print the error.  We
+     have 3 levels of buffering we have to flush (it's possible that
+     some of these should be changed to flush the lower-level ones
+     too):  */
+
+  /* 1.  The _filtered buffer.  */
+  wrap_here ("");
+
+  /* 2.  The stdio buffer.  */
+  gdb_flush (gdb_stdout);
+  gdb_flush (gdb_stderr);
+
+  /* 3.  The system-level buffer.  */
+  gdb_stdout_serial = serial_fdopen (1);
+  if (gdb_stdout_serial)
+    {
+      serial_drain_output (gdb_stdout_serial);
+      serial_un_fdopen (gdb_stdout_serial);
+    }
+
+  annotate_error_begin ();
+}
+
+static void
+print_exception (struct ui_file *file, struct gdb_exception e)
+{
+  /* KLUGE: cagney/2005-01-13: Write the string out one line at a time
+     as that way the MI's behavior is preserved.  */
+  const char *start;
+  const char *end;
+  for (start = e.message; start != NULL; start = end)
+    {
+      end = strchr (start, '\n');
+      if (end == NULL)
+       fputs_filtered (start, file);
+      else
+       {
+         end++;
+         ui_file_write (file, start, end - start);
+       }
+    }                                      
+  fprintf_filtered (file, "\n");
+
+  /* Now append the annotation.  */
+  switch (e.reason)
+    {
+    case RETURN_QUIT:
+      annotate_quit ();
+      break;
+    case RETURN_ERROR:
+      /* Assume that these are all errors.  */
+      annotate_error ();
+      break;
+    default:
+      internal_error (__FILE__, __LINE__, _("Bad switch."));
+    }
+}
+
+void
+exception_print (struct ui_file *file, struct gdb_exception e)
+{
+  if (e.reason < 0 && e.message != NULL)
+    {
+      print_flush ();
+      print_exception (file, e);
+    }
+}
+
+void
+exception_fprintf (struct ui_file *file, struct gdb_exception e,
+                  const char *prefix, ...)
+{
+  if (e.reason < 0 && e.message != NULL)
+    {
+      va_list args;
+
+      print_flush ();
+
+      /* Print the prefix.  */
+      va_start (args, prefix);
+      vfprintf_filtered (file, prefix, args);
+      va_end (args);
+
+      print_exception (file, e);
+    }
+}
+
+void
+print_any_exception (struct ui_file *file, const char *prefix,
+                    struct gdb_exception e)
+{
+  if (e.reason < 0 && e.message != NULL)
+    {
+      target_terminal_ours ();
+      wrap_here ("");          /* Force out any buffered output */
+      gdb_flush (gdb_stdout);
+      annotate_error_begin ();
+
+      /* Print the prefix.  */
+      if (prefix != NULL && prefix[0] != '\0')
+       fputs_filtered (prefix, file);
+      print_exception (file, e);
+    }
+}
+
+NORETURN static void ATTR_NORETURN ATTR_FORMAT (printf, 3, 0)
+throw_it (enum return_reason reason, enum errors error, const char *fmt,
+         va_list ap)
+{
+  struct gdb_exception e;
+  char *new_message;
+
+  /* Save the message.  Create the new message before deleting the
+     old, the new message may include the old message text.  */
+  new_message = xstrvprintf (fmt, ap);
+  xfree (last_message);
+  last_message = new_message;
+
+  /* Create the exception.  */
+  e.reason = reason;
+  e.error = error;
+  e.message = last_message;
+
+  /* Throw the exception.  */
+  throw_exception (e);
+}
+
+NORETURN void
+throw_verror (enum errors error, const char *fmt, va_list ap)
+{
+  throw_it (RETURN_ERROR, error, fmt, ap);
+}
+
+NORETURN void
+throw_vfatal (const char *fmt, va_list ap)
+{
+  throw_it (RETURN_QUIT, NO_ERROR, fmt, ap);
+}
+
+NORETURN void
+throw_error (enum errors error, const char *fmt, ...)
+{
+  va_list args;
+  va_start (args, fmt);
+  throw_it (RETURN_ERROR, error, fmt, args);
+  va_end (args);
+}
+
 /* Call FUNC() with args FUNC_UIOUT and FUNC_ARGS, catching any
    errors.  Set FUNC_CAUGHT to an ``enum return_reason'' if the
    function is aborted (using throw_exception() or zero if the
@@ -322,25 +452,22 @@ int
 catch_exceptions (struct ui_out *uiout,
                  catch_exceptions_ftype *func,
                  void *func_args,
-                 char *errstring,
                  return_mask mask)
 {
-  return catch_exceptions_with_msg (uiout, func, func_args, errstring,
-                                   NULL, mask);
+  return catch_exceptions_with_msg (uiout, func, func_args, NULL, mask);
 }
 
-struct exception
+struct gdb_exception
 catch_exception (struct ui_out *uiout,
                 catch_exception_ftype *func,
                 void *func_args,
                 return_mask mask)
 {
-  volatile struct exception exception;
-  SIGJMP_BUF *catch;
-  catch = catcher_init (uiout, NULL, &exception, mask);
-  for (SIGSETJMP ((*catch));
-       catcher_state_machine (CATCH_ITER);)
-    (*func) (uiout, func_args);
+  volatile struct gdb_exception exception;
+  TRY_CATCH (exception, mask)
+    {
+      (*func) (uiout, func_args);
+    }
   return exception;
 }
 
@@ -348,15 +475,16 @@ int
 catch_exceptions_with_msg (struct ui_out *uiout,
                           catch_exceptions_ftype *func,
                           void *func_args,
-                          char *errstring,
                           char **gdberrmsg,
                           return_mask mask)
 {
-  volatile struct exception exception;
+  volatile struct gdb_exception exception;
   volatile int val = 0;
-  SIGJMP_BUF *catch = catcher_init (uiout, errstring, &exception, mask);
-  for (SIGSETJMP ((*catch)); catcher_state_machine (CATCH_ITER);)
-    val = (*func) (uiout, func_args);
+  TRY_CATCH (exception, mask)
+    {
+      val = (*func) (uiout, func_args);
+    }
+  print_any_exception (gdb_stderr, NULL, exception);
   gdb_assert (val >= 0);
   gdb_assert (exception.reason <= 0);
   if (exception.reason < 0)
@@ -365,7 +493,12 @@ catch_exceptions_with_msg (struct ui_out *uiout,
         one.  This is used in the case of a silent error whereby the
         caller may optionally want to issue the message.  */
       if (gdberrmsg != NULL)
-       *gdberrmsg = exception.message;
+       {
+         if (exception.message != NULL)
+           *gdberrmsg = xstrdup (exception.message);
+         else
+           *gdberrmsg = NULL;
+       }
       return exception.reason;
     }
   return val;
@@ -376,48 +509,28 @@ catch_errors (catch_errors_ftype *func, void *func_args, char *errstring,
              return_mask mask)
 {
   volatile int val = 0;
-  volatile struct exception exception;
-  SIGJMP_BUF *catch = catcher_init (uiout, errstring, &exception, mask);
-  /* This illustrates how it is possible to nest the mechanism and
-     hence catch "break".  Of course this doesn't address the need to
-     also catch "return".  */
-  for (SIGSETJMP ((*catch)); catcher_state_machine (CATCH_ITER);)
-    val = func (func_args);
+  volatile struct gdb_exception exception;
+  TRY_CATCH (exception, mask)
+    {
+      val = func (func_args);
+    }
+  print_any_exception (gdb_stderr, errstring, exception);
   if (exception.reason != 0)
     return 0;
   return val;
 }
 
-struct captured_command_args
-  {
-    catch_command_errors_ftype *command;
-    char *arg;
-    int from_tty;
-  };
-
-static int
-do_captured_command (void *data)
-{
-  struct captured_command_args *context = data;
-  context->command (context->arg, context->from_tty);
-  /* FIXME: cagney/1999-11-07: Technically this do_cleanups() call
-     isn't needed.  Instead an assertion check could be made that
-     simply confirmed that the called function correctly cleaned up
-     after itself.  Unfortunately, old code (prior to 1999-11-04) in
-     main.c was calling SET_TOP_LEVEL(), calling the command function,
-     and then *always* calling do_cleanups().  For the moment we
-     remain ``bug compatible'' with that old code..  */
-  do_cleanups (ALL_CLEANUPS);
-  return 1;
-}
-
 int
 catch_command_errors (catch_command_errors_ftype * command,
                      char *arg, int from_tty, return_mask mask)
 {
-  struct captured_command_args args;
-  args.command = command;
-  args.arg = arg;
-  args.from_tty = from_tty;
-  return catch_errors (do_captured_command, &args, "", mask);
+  volatile struct gdb_exception e;
+  TRY_CATCH (e, mask)
+    {
+      command (arg, from_tty);
+    }
+  print_any_exception (gdb_stderr, NULL, e);
+  if (e.reason < 0)
+    return 0;
+  return 1;
 }
This page took 0.11325 seconds and 4 git commands to generate.