1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *  * Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  *  * Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in
12  *    the documentation and/or other materials provided with the
13  *    distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #ifndef _SIGNAL_H_
30 #define _SIGNAL_H_
31 
32 #include <sys/cdefs.h>
33 #include <sys/types.h>
34 
35 #include <asm/sigcontext.h>
36 #include <bits/pthread_types.h>
37 #include <bits/signal_types.h>
38 #include <bits/timespec.h>
39 #include <limits.h>
40 
41 #include <sys/ucontext.h>
42 #define __BIONIC_HAVE_UCONTEXT_T
43 
44 __BEGIN_DECLS
45 
46 /* The kernel headers define SIG_DFL (0) and SIG_IGN (1) but not SIG_HOLD, since
47  * SIG_HOLD is only used by the deprecated SysV signal API.
48  */
49 #define SIG_HOLD __BIONIC_CAST(reinterpret_cast, sighandler_t, 2)
50 
51 /* We take a few real-time signals for ourselves. May as well use the same names as glibc. */
52 #define SIGRTMIN (__libc_current_sigrtmin())
53 #define SIGRTMAX (__libc_current_sigrtmax())
54 int __libc_current_sigrtmin(void);
55 int __libc_current_sigrtmax(void);
56 
57 extern const char* _Nonnull const sys_siglist[_NSIG];
58 extern const char* _Nonnull const sys_signame[_NSIG]; /* BSD compatibility. */
59 
60 #define si_timerid si_tid /* glibc compatibility. */
61 
62 int sigaction(int __signal, const struct sigaction* _Nullable __new_action, struct sigaction* _Nullable __old_action);
63 int sigaction64(int __signal, const struct sigaction64* _Nullable __new_action, struct sigaction64* _Nullable __old_action) __INTRODUCED_IN(28);
64 
65 int siginterrupt(int __signal, int __flag);
66 
67 sighandler_t _Nonnull signal(int __signal, sighandler_t _Nullable __handler);
68 int sigaddset(sigset_t* _Nonnull __set, int __signal);
69 int sigaddset64(sigset64_t* _Nonnull __set, int __signal) __INTRODUCED_IN(28);
70 int sigdelset(sigset_t* _Nonnull __set, int __signal);
71 int sigdelset64(sigset64_t* _Nonnull __set, int __signal) __INTRODUCED_IN(28);
72 int sigemptyset(sigset_t* _Nonnull __set);
73 int sigemptyset64(sigset64_t* _Nonnull __set) __INTRODUCED_IN(28);
74 int sigfillset(sigset_t* _Nonnull __set);
75 int sigfillset64(sigset64_t* _Nonnull __set) __INTRODUCED_IN(28);
76 int sigismember(const sigset_t* _Nonnull __set, int __signal);
77 int sigismember64(const sigset64_t* _Nonnull __set, int __signal) __INTRODUCED_IN(28);
78 
79 int sigpending(sigset_t* _Nonnull __set);
80 int sigpending64(sigset64_t* _Nonnull __set) __INTRODUCED_IN(28);
81 int sigprocmask(int __how, const sigset_t* _Nullable __new_set, sigset_t* _Nullable __old_set);
82 int sigprocmask64(int __how, const sigset64_t* _Nullable __new_set, sigset64_t* _Nullable __old_set) __INTRODUCED_IN(28);
83 int sigsuspend(const sigset_t* _Nonnull __mask);
84 int sigsuspend64(const sigset64_t* _Nonnull __mask) __INTRODUCED_IN(28);
85 int sigwait(const sigset_t* _Nonnull __set, int* _Nonnull __signal);
86 int sigwait64(const sigset64_t* _Nonnull __set, int* _Nonnull __signal) __INTRODUCED_IN(28);
87 
88 int sighold(int __signal)
89   __attribute__((__deprecated__("use sigprocmask() or pthread_sigmask() instead")))
90   __INTRODUCED_IN(26);
91 int sigignore(int __signal)
92   __attribute__((__deprecated__("use sigaction() instead"))) __INTRODUCED_IN(26);
93 int sigpause(int __signal)
94   __attribute__((__deprecated__("use sigsuspend() instead"))) __INTRODUCED_IN(26);
95 int sigrelse(int __signal)
96   __attribute__((__deprecated__("use sigprocmask() or pthread_sigmask() instead")))
97   __INTRODUCED_IN(26);
98 sighandler_t _Nonnull sigset(int __signal, sighandler_t _Nullable __handler)
99   __attribute__((__deprecated__("use sigaction() instead"))) __INTRODUCED_IN(26);
100 
101 int raise(int __signal);
102 int kill(pid_t __pid, int __signal);
103 int killpg(int __pgrp, int __signal);
104 int tgkill(int __tgid, int __tid, int __signal);
105 
106 int sigaltstack(const stack_t* _Nullable __new_signal_stack, stack_t*  _Nullable __old_signal_stack);
107 
108 void psiginfo(const siginfo_t* _Nonnull __info, const char* _Nullable __msg);
109 void psignal(int __signal, const char* _Nullable __msg);
110 
111 int pthread_kill(pthread_t __pthread, int __signal);
112 #if defined(__USE_GNU)
113 int pthread_sigqueue(pthread_t __pthread, int __signal, const union sigval __value) __INTRODUCED_IN(29);
114 #endif
115 
116 int pthread_sigmask(int __how, const sigset_t* _Nullable __new_set, sigset_t* _Nullable __old_set);
117 int pthread_sigmask64(int __how, const sigset64_t* _Nullable __new_set, sigset64_t* _Nullable __old_set) __INTRODUCED_IN(28);
118 
119 int sigqueue(pid_t __pid, int __signal, const union sigval __value) __INTRODUCED_IN(23);
120 int sigtimedwait(const sigset_t* _Nonnull __set, siginfo_t* _Nullable __info, const struct timespec* _Nullable __timeout) __INTRODUCED_IN(23);
121 int sigtimedwait64(const sigset64_t* _Nonnull __set, siginfo_t* _Nullable __info, const struct timespec* _Nullable __timeout) __INTRODUCED_IN(28);
122 int sigwaitinfo(const sigset_t* _Nonnull __set, siginfo_t* _Nullable __info) __INTRODUCED_IN(23);
123 int sigwaitinfo64(const sigset64_t* _Nonnull __set, siginfo_t* _Nullable __info) __INTRODUCED_IN(28);
124 
125 __END_DECLS
126 
127 #endif
128