Imported from ../bash-3.1.tar.gz.
[platform/upstream/bash.git] / builtins / trap.def
index b81651d..669bea7 100644 (file)
@@ -1,13 +1,13 @@
 This file is trap.def, from which is created trap.c.
 It implements the builtin "trap" in Bash.
 
-Copyright (C) 1987, 1989, 1991 Free Software Foundation, Inc.
+Copyright (C) 1987-2005 Free Software Foundation, Inc.
 
 This file is part of GNU Bash, the Bourne Again SHell.
 
 Bash is free software; you can redistribute it and/or modify it under
 the terms of the GNU General Public License as published by the Free
-Software Foundation; either version 1, or (at your option) any later
+Software Foundation; either version 2, or (at your option) any later
 version.
 
 Bash is distributed in the hope that it will be useful, but WITHOUT ANY
@@ -17,36 +17,57 @@ for more details.
 
 You should have received a copy of the GNU General Public License along
 with Bash; see the file COPYING.  If not, write to the Free Software
-Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
 
 $PRODUCES trap.c
 
 $BUILTIN trap
 $FUNCTION trap_builtin
-$SHORT_DOC trap [arg] [signal_spec]
+$SHORT_DOC trap [-lp] [arg signal_spec ...]
 The command ARG is to be read and executed when the shell receives
-signal(s) SIGNAL_SPEC.  If ARG is absent all specified signals are
-reset to their original values.  If ARG is the null string this
-signal is ignored by the shell and by the commands it invokes.  If
-SIGNAL_SPEC is EXIT (0) the command ARG is executed on exit from
-the shell.  The trap command with no arguments prints the list of
-commands associated with each signal number.  SIGNAL_SPEC is either
-a signal name in <signal.h>, or a signal number.  The syntax `trap -l'
-prints a list of signal names and their corresponding numbers.
-Note that a signal can be sent to the shell with "kill -signal $$".
+signal(s) SIGNAL_SPEC.  If ARG is absent (and a single SIGNAL_SPEC
+is supplied) or `-', each specified signal is reset to its original
+value.  If ARG is the null string each SIGNAL_SPEC is ignored by the
+shell and by the commands it invokes.  If a SIGNAL_SPEC is EXIT (0)
+the command ARG is executed on exit from the shell.  If a SIGNAL_SPEC
+is DEBUG, ARG is executed after every simple command.  If the`-p' option
+is supplied then the trap commands associated with each SIGNAL_SPEC are
+displayed.  If no arguments are supplied or if only `-p' is given, trap
+prints the list of commands associated with each signal.  Each SIGNAL_SPEC
+is either a signal name in <signal.h> or a signal number.  Signal names
+are case insensitive and the SIG prefix is optional.  `trap -l' prints
+a list of signal names and their corresponding numbers.  Note that a
+signal can be sent to the shell with "kill -signal $$".
 $END
 
-#include <sys/types.h>
+#include <config.h>
+
+#if defined (HAVE_UNISTD_H)
+#  ifdef _MINIX
+#    include <sys/types.h>
+#  endif
+#  include <unistd.h>
+#endif
+
+#include "../bashtypes.h"
 #include <signal.h>
+#include <stdio.h>
+#include "../bashansi.h"
+
 #include "../shell.h"
 #include "../trap.h"
 #include "common.h"
+#include "bashgetopt.h"
+
+static void showtrap __P((int));
+static int display_traps __P((WORD_LIST *));
 
 /* The trap command:
 
    trap <arg> <signal ...>
    trap <signal ...>
    trap -l
+   trap -p [sigspec ...]
    trap [--]
 
    Set things up so that ARG is executed when SIGNAL(s) N is recieved.
@@ -60,67 +81,68 @@ $END
 #define REVERT 1               /* Revert to this signals original value. */
 #define IGNORE 2               /* Ignore this signal. */
 
-extern int interactive;
+extern int posixly_correct;
 
+int
 trap_builtin (list)
      WORD_LIST *list;
 {
-  register int i;
-  int list_signal_names = 0;
+  int list_signal_names, display, result, opt, first_signal;
 
-  while (list)
+  list_signal_names = display = 0;
+  result = EXECUTION_SUCCESS;
+  reset_internal_getopt ();
+  while ((opt = internal_getopt (list, "lp")) != -1)
     {
-      if (ISOPTION (list->word->word, 'l'))
+      switch (opt)
        {
+       case 'l':
          list_signal_names++;
-         list = list->next;
-       }
-      else if (ISOPTION (list->word->word, '-'))
-       {
-         list = list->next;
          break;
-       }
-      else if ((*list->word->word == '-') && list->word->word[1])
-       {
-         bad_option (list->word->word);
-         builtin_error ("usage: trap [-l] [arg] [sigspec]");
+       case 'p':
+         display++;
+         break;
+       default:
+         builtin_usage ();
          return (EX_USAGE);
        }
-      else
-       break;
     }
+  list = loptend;
+
+  opt = DSIG_NOCASE|DSIG_SIGPREFIX;    /* flags for decode_signal */
 
   if (list_signal_names)
+    return (display_signal_list ((WORD_LIST *)NULL, 1));
+  else if (display || list == 0)
+    return (display_traps (list));
+  else
     {
-      int column = 0;
+      char *first_arg;
+      int operation, sig, first_signal;
 
-      for (i = 0; i < NSIG; i++)
-       {
-         printf ("%2d) %s", i, signal_name (i));
-         if (++column < 4)
-           printf ("\t");
-         else
-           {
-             printf ("\n");
-             column = 0;
-           }
-       }
-      if (column != 0)
-       printf ("\n");
-      return (EXECUTION_SUCCESS);
-    }
+      operation = SET;
+      first_arg = list->word->word;
+      first_signal = first_arg && *first_arg && all_digits (first_arg) && signal_object_p (first_arg, opt);
 
-  if (list)
-    {
-      char *first_arg = list->word->word;
-      int operation = SET, any_failed = 0;
-
-      if (signal_object_p (first_arg))
+      /* Backwards compatibility */
+      if (first_signal)
+       operation = REVERT;
+      /* When in posix mode, the historical behavior of looking for a
+        missing first argument is disabled.  To revert to the original
+        signal handling disposition, use `-' as the first argument. */
+      else if (posixly_correct == 0 && first_arg && *first_arg &&
+               (*first_arg != '-' || first_arg[1]) &&
+               signal_object_p (first_arg, opt) && list->next == 0)
        operation = REVERT;
       else
        {
          list = list->next;
-         if (*first_arg == '\0')
+         if (list == 0)
+           {
+             builtin_usage ();
+             return (EX_USAGE);
+           }
+         else if (*first_arg == '\0')
            operation = IGNORE;
          else if (first_arg[0] == '-' && !first_arg[1])
            operation = REVERT;
@@ -128,15 +150,12 @@ trap_builtin (list)
 
       while (list)
        {
-         int sig;
-
-         sig = decode_signal (list->word->word);
+         sig = decode_signal (list->word->word, opt);
 
          if (sig == NO_SIG)
            {
-             builtin_error ("%s: not a signal specification",
-                            list->word->word);
-             any_failed++;
+             sh_invalidsig (list->word->word);
+             result = EXECUTION_FAILURE;
            }
          else
            {
@@ -183,22 +202,64 @@ trap_builtin (list)
            }
          list = list->next;
        }
-      return ((!any_failed) ? EXECUTION_SUCCESS : EXECUTION_FAILURE);
     }
 
-  for (i = 0; i < NSIG; i++)
+  return (result);
+}
+
+static void
+showtrap (i)
+     int i;
+{
+  char *t, *p, *sn;
+
+  p = trap_list[i];
+  if (p == (char *)DEFAULT_SIG)
+    return;
+
+  t = (p == (char *)IGNORE_SIG) ? (char *)NULL : sh_single_quote (p);
+  sn = signal_name (i);
+  /* Make sure that signals whose names are unknown (for whatever reason)
+     are printed as signal numbers. */
+  if (STREQN (sn, "SIGJUNK", 7) || STREQN (sn, "unknown", 7))
+    printf ("trap -- %s %d\n", t ? t : "''", i);
+  else if (posixly_correct)
     {
-      char *t, *p;
+      if (STREQN (sn, "SIG", 3))
+       printf ("trap -- %s %s\n", t ? t : "''", sn+3);
+      else
+       printf ("trap -- %s %s\n", t ? t : "''", sn);
+    }
+  else
+    printf ("trap -- %s %s\n", t ? t : "''", sn);
+
+  FREE (t);
+}
 
-      p = trap_list[i];
+static int
+display_traps (list)
+     WORD_LIST *list;
+{
+  int result, i;
 
-      if (p == (char *)DEFAULT_SIG)
-       continue;
+  if (list == 0)
+    {
+      for (i = 0; i < BASH_NSIG; i++)
+       showtrap (i);
+      return (EXECUTION_SUCCESS);
+    }
 
-      t = (p == (char *)IGNORE_SIG) ? (char *)NULL : single_quote (p);
-      printf ("trap -- %s %s\n", t ? t : "''", signal_name (i));
-      if (t)
-       free (t);
+  for (result = EXECUTION_SUCCESS; list; list = list->next)
+    {
+      i = decode_signal (list->word->word, DSIG_NOCASE|DSIG_SIGPREFIX);
+      if (i == NO_SIG)
+       {
+         sh_invalidsig (list->word->word);
+         result = EXECUTION_FAILURE;
+       }
+      else
+       showtrap (i);
     }
-  return (EXECUTION_SUCCESS);
+
+  return (result);
 }