home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / ixemul-39.47-env-bin.lha / 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           discard signal          I/O is possible on a descriptor
  134.                                              (see fcntl(2))
  135.      SIGXCPU         terminate process       cpu time limit exceeded (see
  136.                                              setrlimit(2))
  137.      SIGXFSZ         terminate process       file size limit exceeded (see
  138.                                              setrlimit(2))
  139.      SIGVTALRM       terminate process       virtual time alarm (see
  140.                                              setitimer(2))
  141.      SIGPROF         terminate process       profiling timer alarm (see
  142.                                              setitimer(2))
  143.      SIGWINCH        discard signal          Window size change
  144.      SIGINFO         discard signal          status request from keyboard
  145.      SIGUSR1         terminate process       User defined signal 1
  146.      SIGUSR2         terminate process       User defined signal 2
  147.  
  148. NNOOTTEE
  149.      The mask specified in _a_c_t is not allowed to block SIGKILL or SIGSTOP This
  150.      is done silently by the system.
  151.  
  152. RREETTUURRNN VVAALLUUEESS
  153.      A 0 value indicated that the call succeeded.  A -1 return value indicates
  154.      an error occurred and _e_r_r_n_o is set to indicated the reason.
  155.  
  156. EERRRROORR
  157.      SSiiggaaccttiioonn() will fail and no new signal handler will be installed if one
  158.      of the following occurs: Either _a_c_t or _o_a_c_t points to memory that is not
  159.      a valid part of the process address space.  _S_i_g is not a valid signal
  160.      number.  An attempt is made to ignore or supply a handler for _S_I_G_K_I_L or
  161.      SIGSTOP
  162.  
  163. SSTTAANNDDAARRDD
  164.      The ssiiggaaccttiioonn function is defined by IEEE Std1003.1­1988 (``POSIX''). The
  165.      SA_ONSTACK and SA_RESTART flags are Berkeley extensions, as are the sig­
  166.      nals, SIGTRAP, SIGEMT, SIGBUS, SIGSYS, SIGURG, SIGIO, SIGXCPU, SIGXFSZ,
  167.      SIGVTALRM, SIGPROF, SIGWINCH, and SIGINFO. Most of those signals are
  168.      available on most BSD-derived systems.
  169.  
  170. SSEEEE AALLSSOO
  171.      kill(1),  ptrace(2),  kill(2),  sigaction(2),  sigprocmask(2),  _s_i_g_s_e_t_o_p_s
  172.      _2, sigsuspend(2),  sigblock(2),  sigsetmask(2),  sigpause(2),
  173.      sigstack(2),  sigvec(2),  setjmp(3),  _s_i_g_i_n_t_e_r_r_u_p_t _3, tty(4)
  174.  
  175. EEXXAAMMPPLLEE
  176.      On a VAX-11, the handler routine can be declared:
  177.  
  178.            void handler(sig, code, scp)
  179.            int sig, code;
  180.            struct sigcontext *scp;
  181.  
  182.      Here _s_i_g is the signal number, into which the hardware faults and traps
  183.      are mapped as defined below.  _C_o_d_e is a parameter that is either a con­
  184.      stant as given below or the code provided by the hardware (Compatibility
  185.      mode faults are distinguished from the other SIGILL traps by having
  186.      PSL_CM set in the psl).  _S_c_p is a pointer to the _s_i_g_c_o_n_t_e_x_t structure
  187.      (defined in <_s_i_g_n_a_l_._h>), used to restore the context from before the sig­
  188.      nal.
  189.  
  190. BSD Experimental                 July 23, 1991                               3
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.