home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat2 / sigaction.0 < prev    next >
Text File  |  1993-12-07  |  11KB  |  199 lines
  1.  
  2. SIGACTION(2)               UNIX Programmer's Manual               SIGACTION(2)
  3.  
  4. NNAAMMEE
  5.      ssiiggaaccttiioonn - software signal facilities
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssiiggnnaall..hh>>
  9.      struct sigaction {
  10.              void     (*sa_handler)();
  11.              sigset_t sa_mask;
  12.              int      sa_flags;
  13.      };
  14.  
  15.      ssiiggaaccttiioonn(_i_n_t _s_i_g, _s_t_r_u_c_t _s_i_g_a_c_t_i_o_n _*_a_c_t, _s_t_r_u_c_t _s_i_g_a_c_t_i_o_n _*_o_a_c_t)
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The system defines a set of signals that may be delivered to a process.
  19.      Signal delivery resembles the occurence of a hardware interrupt: the sig­
  20.      nal is blocked from further occurrence, the current process context is
  21.      saved, and a new one is built.  A process may specify a _h_a_n_d_l_e_r to which
  22.      a signal is delivered, or specify that a signal is to be _i_g_n_o_r_e_d. A pro­
  23.      cess may also specify that a default action is to be taken by the system
  24.      when a signal occurs.  A signal may also be _b_l_o_c_k_e_d, in which case its
  25.      delivery is postponed until it is _u_n_b_l_o_c_k_e_d. The action to be taken on
  26.      delivery is determined at the time of delivery.  Normally, signal han­
  27.      dlers execute on the current stack of the process.  This may be changed,
  28.      on a per­handler basis, so that signals are taken on a special _s_i_g_n_a_l
  29.      _s_t_a_c_k.
  30.  
  31.      Signal routines execute with the signal that caused their invocation
  32.      _b_l_o_c_k_e_d, but other signals may yet occur.  A global _s_i_g_n_a_l _m_a_s_k defines
  33.      the set of signals currently blocked from delivery to a process.  The
  34.      signal mask for a process is initialized from that of its parent (normal­
  35.      ly empty).  It may be changed with a sigprocmask(2) call, or when a sig­
  36.      nal is delivered to the process.
  37.  
  38.      When a signal condition arises for a process, the signal is added to a
  39.      set of signals pending for the process.  If the signal is not currently
  40.      _b_l_o_c_k_e_d by the process then it is delivered to the process.  Signals may
  41.      be delivered any time a process enters the operating system (e.g., during
  42.      a system call, page fault or trap, or clock interrupt).  If multiple sig­
  43.      nals are ready to be delivered at the same time, any signals that could
  44.      be caused by traps are delivered first.  Additional signals may be pro­
  45.      cessed at the same time, with each appearing to interrupt the handlers
  46.      for the previous signals before their first instructions.  The set of
  47.      pending signals is returned by the sigpending(2) function.  When a caught
  48.      signal is delivered, the current state of the process is saved, a new
  49.      signal mask is calculated (as described below), and the signal handler is
  50.      invoked.  The call to the handler is arranged so that if the signal han­
  51.      dling routine returns normally the process will resume execution in the
  52.      context from before the signal's delivery.  If the process wishes to re­
  53.      sume in a different context, then it must arrange to restore the previous
  54.      context itself.
  55.  
  56.      When a signal is delivered to a process a new signal mask is installed
  57.      for the duration of the process' signal handler (or until a sigprocmask
  58.      call is made).  This mask is formed by taking the union of the current
  59.      signal mask set, the signal to be delivered, and the signal mask associ­
  60.      ated with the handler to be invoked.
  61.  
  62.      SSiiggaaccttiioonn() assigns an action for a specific signal.  If _a_c_t is non­zero,
  63.      it specifies an action (SIG_DFL, SIG_IGN, or a handler routine) and mask
  64.      to be used when delivering the specified signal.  If _o_a_c_t is non­zero,
  65.      the previous handling information for the signal is returned to the user.
  66.  
  67.      Once a signal handler is installed, it remains installed until another
  68.      ssiiggaaccttiioonn() call is made, or an execve(2) is performed.  A signal­
  69.      specific default action may be reset by setting _s_a___h_a_n_d_l_e_r to SIG_DFL.
  70.      The defaults are process termination, possibly with core dump; no action;
  71.      stopping the process; or continuing the process.  See the signal list be­
  72.      low for each signal's default action.  If _s_a___h_a_n_d_l_e_r is SIG_IGN current
  73.      and pending instances of the signal are ignored and discarded.
  74.  
  75.      Options may be specified by setting _s_a___f_l_a_g_s. If the SA_NOCLDSTOP bit is
  76.      set when installing a catching function for the SIGCHLD signal, the
  77.      SIGCHLD signal will be generated only when a child process exits, not
  78.      when a child process stops.  Further, if the SA_ONSTACK bit is set in
  79.      _s_a___f_l_a_g_s, the system will deliver the signal to the process on a _s_i_g_n_a_l
  80.      _s_t_a_c_k, specified with sigstack(2).
  81.  
  82.      If a signal is caught during the system calls listed below, the call may
  83.      be forced to terminate with the error EINTR, or the call may be restart­
  84.      ed.  Restart of pending calls is requested by setting the SA_RESTART bit
  85.      in _s_a___f_l_a_g_s. The affected system calls include read(2),  write(2),
  86.      sendto(2),  recvfrom(2),  sendmsg(2) and recvmsg(2) on a communications
  87.      channel or a slow device (such as a terminal, but not a regular file) and
  88.      during a wait(2) or ioctl(2).  However, calls that have already committed
  89.      are not restarted, but instead return a partial success (for example, a
  90.      short read count).
  91.  
  92.      After a fork(2) or vfork(2) all signals, the signal mask, the signal
  93.      stack, and the restart/interrupt flags are inherited by the child.
  94.  
  95.      Execve(2) reinstates the default action for all signals which were caught
  96.      and resets all signals to be caught on the user stack.  Ignored signals
  97.      remain ignored; the signal mask remains the same; signals that restart
  98.      pending system calls continue to do so.
  99.  
  100.      The following is a list of all signals with names as in the include file
  101.      <_s_i_g_n_a_l_._h>:
  102.  
  103.      NNAAMMEE              DDeeffaauulltt AAccttiioonn                      DDeessccrriippttiioonn
  104.      SIGHUP          terminate process       terminal line hangup
  105.      SIGINT          terminate process       interrupt program
  106.      SIGQUIT         create core image       quit program
  107.      SIGILL          create core image       illegal instruction
  108.      SIGTRAP         create core image       trace trap
  109.      SIGABRT         create core image       abort(2) call (formerly SIGIOT)
  110.      SIGEMT          create core image       emulate instruction executed
  111.      SIGFPE          create core image       floating­point exception
  112.      SIGKILL         terminate process       kill program
  113.      SIGBUS          create core image       bus error
  114.      SIGSEGV         create core image       segmentation violation
  115.      SIGSYS          create core image       system call given invalid
  116.                                              argument
  117.      SIGPIPE         terminate process       write on a pipe with no reader
  118.      SIGALRM         terminate process       real­time timer expired
  119.      SIGTERM         terminate process       software termination signal
  120.      SIGURG          discard signal          urgent condition present on
  121.                                              socket
  122.      SIGSTOP         stop process            stop (cannot be caught or
  123.                                              ignored)
  124.      SIGTSTP         stop process            stop signal generated from
  125.                                              keyboard
  126.      SIGCONT         discard signal          continue after stop
  127.      SIGCHLD         discard signal          child status has changed
  128.      SIGTTIN         stop process            background read attempted from
  129.                                              control terminal
  130.      SIGTTOU         stop process            background write attempted to
  131.  
  132.                                              control terminal
  133.      SIGIO