File: /usr/include/sys/signal.h

Green shading in the line number column means the source is part of the translation unit, red means it is conditionally excluded. Highlighted line numbers link to the translation unit page. Highlighted macros link to the macro page.

       1: /*
       2:  * Copyright (c) 2000-2006 Apple Computer, Inc. All rights reserved.
       3:  *
       4:  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
       5:  * 
       6:  * This file contains Original Code and/or Modifications of Original Code
       7:  * as defined in and that are subject to the Apple Public Source License
       8:  * Version 2.0 (the 'License'). You may not use this file except in
       9:  * compliance with the License. The rights granted to you under the License
      10:  * may not be used to create, or enable the creation or redistribution of,
      11:  * unlawful or unlicensed copies of an Apple operating system, or to
      12:  * circumvent, violate, or enable the circumvention or violation of, any
      13:  * terms of an Apple operating system software license agreement.
      14:  * 
      15:  * Please obtain a copy of the License at
      16:  * http://www.opensource.apple.com/apsl/ and read it before using this file.
      17:  * 
      18:  * The Original Code and all software distributed under the License are
      19:  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
      20:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
      21:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
      22:  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
      23:  * Please see the License for the specific language governing rights and
      24:  * limitations under the License.
      25:  * 
      26:  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
      27:  */
      28: /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
      29: /*
      30:  * Copyright (c) 1982, 1986, 1989, 1991, 1993
      31:  *    The Regents of the University of California.  All rights reserved.
      32:  * (c) UNIX System Laboratories, Inc.
      33:  * All or some portions of this file are derived from material licensed
      34:  * to the University of California by American Telephone and Telegraph
      35:  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
      36:  * the permission of UNIX System Laboratories, Inc.
      37:  *
      38:  * Redistribution and use in source and binary forms, with or without
      39:  * modification, are permitted provided that the following conditions
      40:  * are met:
      41:  * 1. Redistributions of source code must retain the above copyright
      42:  *    notice, this list of conditions and the following disclaimer.
      43:  * 2. Redistributions in binary form must reproduce the above copyright
      44:  *    notice, this list of conditions and the following disclaimer in the
      45:  *    documentation and/or other materials provided with the distribution.
      46:  * 3. All advertising materials mentioning features or use of this software
      47:  *    must display the following acknowledgement:
      48:  *    This product includes software developed by the University of
      49:  *    California, Berkeley and its contributors.
      50:  * 4. Neither the name of the University nor the names of its contributors
      51:  *    may be used to endorse or promote products derived from this software
      52:  *    without specific prior written permission.
      53:  *
      54:  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
      55:  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
      56:  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
      57:  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
      58:  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
      59:  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
      60:  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      61:  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
      62:  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
      63:  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
      64:  * SUCH DAMAGE.
      65:  *
      66:  *    @(#)signal.h    8.2 (Berkeley) 1/21/94
      67:  */
      68: 
      69: #ifndef    _SYS_SIGNAL_H_
      70: #define    _SYS_SIGNAL_H_
      71: 
      72: #include <sys/cdefs.h>
      73: #include <sys/appleapiopts.h>
      74: #include <Availability.h>
      75: 
      76: #define __DARWIN_NSIG    32    /* counting 0; could be 33 (mask is 1-32) */
      77: 
      78: #if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
      79: #define NSIG    __DARWIN_NSIG
      80: #endif
      81: 
      82: #include <machine/signal.h>    /* sigcontext; codes for SIGILL, SIGFPE */
      83: 
      84: #define    SIGHUP    1    /* hangup */
      85: #define    SIGINT    2    /* interrupt */
      86: #define    SIGQUIT    3    /* quit */
      87: #define    SIGILL    4    /* illegal instruction (not reset when caught) */
      88: #define    SIGTRAP    5    /* trace trap (not reset when caught) */
      89: #define    SIGABRT    6    /* abort() */
      90: #if  (defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE))
      91: #define    SIGPOLL    7    /* pollable event ([XSR] generated, not supported) */
      92: #else    /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
      93: #define    SIGIOT    SIGABRT    /* compatibility */
      94: #define    SIGEMT    7    /* EMT instruction */
      95: #endif    /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
      96: #define    SIGFPE    8    /* floating point exception */
      97: #define    SIGKILL    9    /* kill (cannot be caught or ignored) */
      98: #define    SIGBUS    10    /* bus error */
      99: #define    SIGSEGV    11    /* segmentation violation */
     100: #define    SIGSYS    12    /* bad argument to system call */
     101: #define    SIGPIPE    13    /* write on a pipe with no one to read it */
     102: #define    SIGALRM    14    /* alarm clock */
     103: #define    SIGTERM    15    /* software termination signal from kill */
     104: #define    SIGURG    16    /* urgent condition on IO channel */
     105: #define    SIGSTOP    17    /* sendable stop signal not from tty */
     106: #define    SIGTSTP    18    /* stop signal from tty */
     107: #define    SIGCONT    19    /* continue a stopped process */
     108: #define    SIGCHLD    20    /* to parent on child stop or exit */
     109: #define    SIGTTIN    21    /* to readers pgrp upon background tty read */
     110: #define    SIGTTOU    22    /* like TTIN for output if (tp->t_local&LTOSTOP) */
     111: #if  (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
     112: #define    SIGIO    23    /* input/output possible signal */
     113: #endif
     114: #define    SIGXCPU    24    /* exceeded CPU time limit */
     115: #define    SIGXFSZ    25    /* exceeded file size limit */
     116: #define    SIGVTALRM 26    /* virtual time alarm */
     117: #define    SIGPROF    27    /* profiling time alarm */
     118: #if  (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
     119: #define SIGWINCH 28    /* window size changes */
     120: #define SIGINFO    29    /* information request */
     121: #endif
     122: #define SIGUSR1 30    /* user defined signal 1 */
     123: #define SIGUSR2 31    /* user defined signal 2 */
     124: 
     125: #if defined(_ANSI_SOURCE) || __DARWIN_UNIX03 || defined(__cplusplus)
     126: /*
     127:  * Language spec sez we must list exactly one parameter, even though we
     128:  * actually supply three.  Ugh!
     129:  * SIG_HOLD is chosen to avoid KERN_SIG_* values in <sys/signalvar.h>
     130:  */
     131: #define    SIG_DFL        (void (*)(int))0
     132: #define    SIG_IGN        (void (*)(int))1
     133: #define    SIG_HOLD    (void (*)(int))5
     134: #define    SIG_ERR        ((void (*)(int))-1)
     135: #else
     136: /* DO NOT REMOVE THE COMMENTED OUT int: fixincludes needs to see them */
     137: #define    SIG_DFL        (void (*)(/*int*/))0
     138: #define    SIG_IGN        (void (*)(/*int*/))1
     139: #define    SIG_HOLD    (void (*)(/*int*/))5
     140: #define    SIG_ERR        ((void (*)(/*int*/))-1)
     141: #endif
     142: 
     143: #ifndef _ANSI_SOURCE
     144: #include <sys/_types.h>
     145: 
     146: #include <machine/_mcontext.h>
     147: 
     148: #include <sys/_pthread/_pthread_attr_t.h>
     149: 
     150: #include <sys/_types/_sigaltstack.h>
     151: #include <sys/_types/_ucontext.h>
     152: 
     153: #include <sys/_types/_pid_t.h>
     154: #include <sys/_types/_sigset_t.h>
     155: #include <sys/_types/_size_t.h>
     156: #include <sys/_types/_uid_t.h>
     157: 
     158: union sigval {
     159:     /* Members as suggested by Annex C of POSIX 1003.1b. */
     160:     int    sival_int;
     161:     void    *sival_ptr;
     162: };
     163: 
     164: #define    SIGEV_NONE    0    /* No async notification */
     165: #define    SIGEV_SIGNAL    1    /* aio - completion notification */
     166: #define    SIGEV_THREAD    3    /* [NOTIMP] [RTS] call notification function */
     167: 
     168: struct sigevent {
     169:     int                sigev_notify;                /* Notification type */
     170:     int                sigev_signo;                /* Signal number */
     171:     union sigval    sigev_value;                /* Signal value */
     172:     void            (*sigev_notify_function)(union sigval);      /* Notification function */
     173:     pthread_attr_t    *sigev_notify_attributes;    /* Notification attributes */
     174: };
     175: 
     176: 
     177: typedef struct __siginfo {
     178:     int    si_signo;        /* signal number */
     179:     int    si_errno;        /* errno association */
     180:     int    si_code;        /* signal code */
     181:     pid_t    si_pid;            /* sending process */
     182:     uid_t    si_uid;            /* sender's ruid */
     183:     int    si_status;        /* exit value */
     184:     void    *si_addr;        /* faulting instruction */
     185:     union sigval si_value;        /* signal value */
     186:     long    si_band;        /* band event for SIGPOLL */
     187:     unsigned long    __pad[7];    /* Reserved for Future Use */
     188: } siginfo_t;
     189: 
     190: 
     191: /* 
     192:  * When the signal is SIGILL or SIGFPE, si_addr contains the address of 
     193:  * the faulting instruction.
     194:  * When the signal is SIGSEGV or SIGBUS, si_addr contains the address of 
     195:  * the faulting memory reference. Although for x86 there are cases of SIGSEGV
     196:  * for which si_addr cannot be determined and is NULL. 
     197:  * If the signal is SIGCHLD, the si_pid field will contain the child process ID,
     198:  *  si_status contains the exit value or signal and
     199:  *  si_uid contains the real user ID of the process that sent the signal.
     200:  */
     201: 
     202: /* Values for si_code */
     203: 
     204: /* Codes for SIGILL */
     205: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     206: #define    ILL_NOOP    0    /* if only I knew... */
     207: #endif
     208: #define    ILL_ILLOPC    1    /* [XSI] illegal opcode */
     209: #define    ILL_ILLTRP    2    /* [XSI] illegal trap */
     210: #define    ILL_PRVOPC    3    /* [XSI] privileged opcode */
     211: #define    ILL_ILLOPN    4    /* [XSI] illegal operand -NOTIMP */
     212: #define    ILL_ILLADR    5    /* [XSI] illegal addressing mode -NOTIMP */
     213: #define    ILL_PRVREG    6    /* [XSI] privileged register -NOTIMP */
     214: #define    ILL_COPROC    7    /* [XSI] coprocessor error -NOTIMP */
     215: #define    ILL_BADSTK    8    /* [XSI] internal stack error -NOTIMP */
     216: 
     217: /* Codes for SIGFPE */
     218: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     219: #define    FPE_NOOP    0    /* if only I knew... */
     220: #endif
     221: #define FPE_FLTDIV    1    /* [XSI] floating point divide by zero */
     222: #define FPE_FLTOVF    2    /* [XSI] floating point overflow */
     223: #define FPE_FLTUND    3    /* [XSI] floating point underflow */
     224: #define FPE_FLTRES    4    /* [XSI] floating point inexact result */
     225: #define FPE_FLTINV    5    /* [XSI] invalid floating point operation */
     226: #define    FPE_FLTSUB    6    /* [XSI] subscript out of range -NOTIMP */
     227: #define    FPE_INTDIV    7    /* [XSI] integer divide by zero */
     228: #define    FPE_INTOVF    8    /* [XSI] integer overflow */
     229: 
     230: /* Codes for SIGSEGV */
     231: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     232: #define    SEGV_NOOP    0    /* if only I knew... */
     233: #endif
     234: #define    SEGV_MAPERR    1    /* [XSI] address not mapped to object */
     235: #define    SEGV_ACCERR    2    /* [XSI] invalid permission for mapped object */
     236: 
     237: /* Codes for SIGBUS */
     238: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     239: #define    BUS_NOOP    0    /* if only I knew... */
     240: #endif
     241: #define    BUS_ADRALN    1    /* [XSI] Invalid address alignment */
     242: #define    BUS_ADRERR    2    /* [XSI] Nonexistent physical address -NOTIMP */
     243: #define    BUS_OBJERR    3    /* [XSI] Object-specific HW error - NOTIMP */
     244: 
     245: /* Codes for SIGTRAP */
     246: #define    TRAP_BRKPT    1    /* [XSI] Process breakpoint -NOTIMP */
     247: #define    TRAP_TRACE    2    /* [XSI] Process trace trap -NOTIMP */
     248: 
     249: /* Codes for SIGCHLD */
     250: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     251: #define    CLD_NOOP    0    /* if only I knew... */
     252: #endif
     253: #define    CLD_EXITED    1    /* [XSI] child has exited */
     254: #define    CLD_KILLED    2    /* [XSI] terminated abnormally, no core file */
     255: #define    CLD_DUMPED    3    /* [XSI] terminated abnormally, core file */
     256: #define    CLD_TRAPPED    4    /* [XSI] traced child has trapped */
     257: #define    CLD_STOPPED    5    /* [XSI] child has stopped */
     258: #define    CLD_CONTINUED    6    /* [XSI] stopped child has continued */
     259: 
     260: /* Codes for SIGPOLL */
     261: #define    POLL_IN        1    /* [XSR] Data input available */
     262: #define    POLL_OUT    2    /* [XSR] Output buffers available */
     263: #define    POLL_MSG    3    /* [XSR] Input message available */
     264: #define    POLL_ERR    4    /* [XSR] I/O error */
     265: #define    POLL_PRI    5    /* [XSR] High priority input available */
     266: #define    POLL_HUP    6    /* [XSR] Device disconnected */
     267: 
     268: /* union for signal handlers */
     269: union __sigaction_u {
     270:     void    (*__sa_handler)(int);
     271:     void    (*__sa_sigaction)(int, struct __siginfo *,
     272:                void *);
     273: };
     274: 
     275: /* Signal vector template for Kernel user boundary */
     276: struct    __sigaction {
     277:     union __sigaction_u __sigaction_u;  /* signal handler */
     278:     void    (*sa_tramp)(void *, int, int, siginfo_t *, void *);
     279:     sigset_t sa_mask;        /* signal mask to apply */
     280:     int    sa_flags;        /* see signal options below */
     281: };
     282: 
     283: /*
     284:  * Signal vector "template" used in sigaction call.
     285:  */
     286: struct    sigaction {
     287:     union __sigaction_u __sigaction_u;  /* signal handler */
     288:     sigset_t sa_mask;        /* signal mask to apply */
     289:     int    sa_flags;        /* see signal options below */
     290: };
     291: 
     292: 
     293: 
     294: /* if SA_SIGINFO is set, sa_sigaction is to be used instead of sa_handler. */
     295: #define    sa_handler    __sigaction_u.__sa_handler
     296: #define    sa_sigaction    __sigaction_u.__sa_sigaction
     297: 
     298: #define SA_ONSTACK    0x0001    /* take signal on signal stack */
     299: #define SA_RESTART    0x0002    /* restart system on signal return */
     300: #define    SA_RESETHAND    0x0004    /* reset to SIG_DFL when taking signal */
     301: #define SA_NOCLDSTOP    0x0008    /* do not generate SIGCHLD on child stop */
     302: #define    SA_NODEFER    0x0010    /* don't mask the signal we're delivering */
     303: #define    SA_NOCLDWAIT    0x0020    /* don't keep zombies around */
     304: #define    SA_SIGINFO    0x0040    /* signal handler with SA_SIGINFO args */
     305: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     306: #define    SA_USERTRAMP    0x0100    /* do not bounce off kernel's sigtramp */
     307: /* This will provide 64bit register set in a 32bit user address space */
     308: #define    SA_64REGSET    0x0200    /* signal handler with SA_SIGINFO args with 64bit regs information */
     309: #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
     310: 
     311: /* the following are the only bits we support from user space, the 
     312:  * rest are for kernel use only.
     313:  */
     314: #define SA_USERSPACE_MASK (SA_ONSTACK | SA_RESTART | SA_RESETHAND | SA_NOCLDSTOP | SA_NODEFER | SA_NOCLDWAIT | SA_SIGINFO)
     315: 
     316: /*
     317:  * Flags for sigprocmask:
     318:  */
     319: #define    SIG_BLOCK    1    /* block specified signal set */
     320: #define    SIG_UNBLOCK    2    /* unblock specified signal set */
     321: #define    SIG_SETMASK    3    /* set specified signal set */
     322: 
     323: /* POSIX 1003.1b required values. */
     324: #define SI_USER        0x10001    /* [CX] signal from kill() */
     325: #define SI_QUEUE    0x10002    /* [CX] signal from sigqueue() */
     326: #define SI_TIMER    0x10003    /* [CX] timer expiration */
     327: #define SI_ASYNCIO    0x10004    /* [CX] aio request completion */
     328: #define SI_MESGQ    0x10005    /* [CX]    from message arrival on empty queue */
     329: 
     330: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     331: typedef    void (*sig_t)(int);    /* type of signal function */
     332: #endif
     333: 
     334: /*
     335:  * Structure used in sigaltstack call.
     336:  */
     337: 
     338: #define SS_ONSTACK    0x0001    /* take signal on signal stack */
     339: #define    SS_DISABLE    0x0004    /* disable taking signals on alternate stack */
     340: #define    MINSIGSTKSZ    32768    /* (32K)minimum allowable stack */
     341: #define    SIGSTKSZ    131072    /* (128K)recommended stack size */
     342: 
     343: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     344: /*
     345:  * 4.3 compatibility:
     346:  * Signal vector "template" used in sigvec call.
     347:  */
     348: struct    sigvec {
     349:     void    (*sv_handler)(int);    /* signal handler */
     350:     int    sv_mask;        /* signal mask to apply */
     351:     int    sv_flags;        /* see signal options below */
     352: };
     353: 
     354: #define SV_ONSTACK    SA_ONSTACK
     355: #define SV_INTERRUPT    SA_RESTART    /* same bit, opposite sense */
     356: #define SV_RESETHAND    SA_RESETHAND
     357: #define SV_NODEFER    SA_NODEFER
     358: #define SV_NOCLDSTOP    SA_NOCLDSTOP
     359: #define SV_SIGINFO    SA_SIGINFO
     360: 
     361: #define sv_onstack sv_flags    /* isn't compatibility wonderful! */
     362: #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
     363: 
     364: /*
     365:  * Structure used in sigstack call.
     366:  */
     367: struct    sigstack {
     368:     char    *ss_sp;            /* signal stack pointer */
     369:     int    ss_onstack;        /* current status */
     370: };
     371: 
     372: #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
     373: /*
     374:  * Macro for converting signal number to a mask suitable for
     375:  * sigblock().
     376:  */
     377: #define sigmask(m)    (1 << ((m)-1))
     378: 
     379: 
     380: #define    BADSIG        SIG_ERR
     381: 
     382: #endif    /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
     383: #endif    /* !_ANSI_SOURCE */
     384: 
     385: /*
     386:  * For historical reasons; programs expect signal's return value to be
     387:  * defined by <sys/signal.h>.
     388:  */
     389: __BEGIN_DECLS
     390: void    (*signal(int, void (*)(int)))(int);
     391: __END_DECLS
     392: #endif    /* !_SYS_SIGNAL_H_ */
     393: