Annotation of coherent/a/usr/man/COHERENT/signal, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: signal()               COHERENT System Call              signal()
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Specify disposition of a signal
                      9: 
                     10: #include <signal.h>
                     11: iinntt (*ssiiggnnaall(_s_i_g_n_u_m, _a_c_t_i_o_n))()
                     12: iinntt _s_i_g_n_u_m, (*_a_c_t_i_o_n)();
                     13: 
                     14: A process can receive a signal, or interrupt, from a hardware ex-
                     15: ception, terminal input, or  a kill call made by another process.
                     16: A hardware  exception might be  caused by an  illegal instruction
                     17: code  or  a  bad  machine  address,  caught by  the  segmentation
                     18: hardware.  A terminal interrupt character, described in detail in
                     19: tty, generates  a process interrupt (and in one  case a core dump
                     20: file for debugging purposes).
                     21: 
                     22: When  a process  receives a  signal,  it performs  an appropriate
                     23: action.  The  default action SIG_DFL  causes the process  to ter-
                     24: minate.   By calling  signal,  you can  specify  what action  the
                     25: process takes when it receives  a given signal signum is the num-
                     26: ber of  the signal, and  action points to the  routine to execute
                     27: when signum  is received.  The action SIG_IGN  causes a signal to
                     28: be ignored.  Note that the signal SIGKILL, which kills a process,
                     29: can be  neither caught nor ignored.  signal  returns a pointer to
                     30: the previous action.
                     31: 
                     32: With  the exception  of SIGILL  and  SIGTRAP, caught  signals are
                     33: reset to  the default action  SIG_DFL.  To catch  a signal again,
                     34: the specified action must reissue the signal call.
                     35: 
                     36: The following list  gives machine-independent signals by symbolic
                     37: name (defined  in the header  file signal.h), numeric  value, and
                     38: description.  Signals  marked by an asterisk  produce a core dump
                     39: if the action is SIG_DFL.
                     40: 
                     41: 
                     42:      SSIIGGHHUUPP    1    Hangup
                     43:      SSIIGGIINNTT    2    Interrupt
                     44:      SSIIGGQQUUIITT   3*   Quit
                     45:      SSIIGGAALLRRMM   4    Alarm clock
                     46:      SSIIGGTTEERRMM   5    Termination
                     47:      SSIIGGRREESSTT   6    Restart indication
                     48:      SSIIGGSSYYSS    7*   Bad system call argument
                     49:      SSIIGGPPIIPPEE   8    Write on closed pipe
                     50:      SSIIGGKKIILLLL   9    Kill
                     51:      SSIIGGTTRRAAPP   10*  Breakpoint
                     52:      SSIIGGSSEEGGVV   11*  Segmentation violation
                     53: 
                     54: 
                     55: The  following lists gives  machine-dependent signals  defined in
                     56: the header file msig.h.
                     57: 
                     58: The following signals are  specific to the Zilog Z8002 version of
                     59: COHERENT:
                     60: 
                     61: 
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: signal()               COHERENT System Call              signal()
                     70: 
                     71: 
                     72: 
                     73: 
                     74:      SSIIGGUUNNII    12*  Unimplemented instruction
                     75:      SSIIGGPPRRVV    13*  Privileged instruction
                     76:      SSIIGGNNVVII    14*  Non-vectored interrupt
                     77:      SSIIGGPPAARR    15*  Parity error
                     78: 
                     79: 
                     80: The following signals are  specific to the Zilog Z8001 version of
                     81: COHERENT:
                     82: 
                     83: 
                     84:      SSIIGGEEPPAA    12*  Extended processor trap
                     85:      SSIIGGPPRRVV    13*  Privileged instruction
                     86:      SSIIGGNNVVII    14*  Non-vectored interrupt
                     87:      SSIIGGNNMMII    15*  Non-maskable interrupt (not in all versions)
                     88: 
                     89: 
                     90: The following  signals are  specific to  the Intel 8086  or 80286
                     91: version of COHERENT:
                     92: 
                     93: 
                     94:      SSIIGGDDIIVVEE   12*  Divide error
                     95:      SSIIGGOOVVFFLL   13*  Overflow
                     96: 
                     97: 
                     98: A signal  may be  caught during  a system call  that has  not yet
                     99: returned.  In  this case, the  system call appears  to fail, with
                    100: errno set to EINTR.   If desired, such an interrupted system call
                    101: may be  reissued.  System calls which may  be interrupted in this
                    102: way include pause, read on a  device such as a terminal, write on
                    103: a pipe, and wait.
                    104: 
                    105: ***** See Also *****
                    106: 
                    107: COHERENT system call, kill, ptrace(), sh, signame
                    108: 
                    109: ***** Diagnostics *****
                    110: 
                    111: signal returns  a pointer to the previous  action on success.  It
                    112: returns (int)-1 for invalid signum.
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.