xref: /linux/include/uapi/asm-generic/siginfo.h (revision b0d5c81e872ed21de1e56feb0fa6e4161da7be61)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef _UAPI_ASM_GENERIC_SIGINFO_H
3 #define _UAPI_ASM_GENERIC_SIGINFO_H
4 
5 #include <linux/compiler.h>
6 #include <linux/types.h>
7 
8 typedef union sigval {
9 	int sival_int;
10 	void __user *sival_ptr;
11 } sigval_t;
12 
13 /*
14  * This is the size (including padding) of the part of the
15  * struct siginfo that is before the union.
16  */
17 #ifndef __ARCH_SI_PREAMBLE_SIZE
18 #define __ARCH_SI_PREAMBLE_SIZE	(3 * sizeof(int))
19 #endif
20 
21 #define SI_MAX_SIZE	128
22 #ifndef SI_PAD_SIZE
23 #define SI_PAD_SIZE	((SI_MAX_SIZE - __ARCH_SI_PREAMBLE_SIZE) / sizeof(int))
24 #endif
25 
26 /*
27  * The default "si_band" type is "long", as specified by POSIX.
28  * However, some architectures want to override this to "int"
29  * for historical compatibility reasons, so we allow that.
30  */
31 #ifndef __ARCH_SI_BAND_T
32 #define __ARCH_SI_BAND_T long
33 #endif
34 
35 #ifndef __ARCH_SI_CLOCK_T
36 #define __ARCH_SI_CLOCK_T __kernel_clock_t
37 #endif
38 
39 #ifndef __ARCH_SI_ATTRIBUTES
40 #define __ARCH_SI_ATTRIBUTES
41 #endif
42 
43 typedef struct siginfo {
44 	int si_signo;
45 #ifndef __ARCH_HAS_SWAPPED_SIGINFO
46 	int si_errno;
47 	int si_code;
48 #else
49 	int si_code;
50 	int si_errno;
51 #endif
52 
53 	union {
54 		int _pad[SI_PAD_SIZE];
55 
56 		/* kill() */
57 		struct {
58 			__kernel_pid_t _pid;	/* sender's pid */
59 			__kernel_uid32_t _uid;	/* sender's uid */
60 		} _kill;
61 
62 		/* POSIX.1b timers */
63 		struct {
64 			__kernel_timer_t _tid;	/* timer id */
65 			int _overrun;		/* overrun count */
66 			sigval_t _sigval;	/* same as below */
67 			int _sys_private;       /* not to be passed to user */
68 		} _timer;
69 
70 		/* POSIX.1b signals */
71 		struct {
72 			__kernel_pid_t _pid;	/* sender's pid */
73 			__kernel_uid32_t _uid;	/* sender's uid */
74 			sigval_t _sigval;
75 		} _rt;
76 
77 		/* SIGCHLD */
78 		struct {
79 			__kernel_pid_t _pid;	/* which child */
80 			__kernel_uid32_t _uid;	/* sender's uid */
81 			int _status;		/* exit code */
82 			__ARCH_SI_CLOCK_T _utime;
83 			__ARCH_SI_CLOCK_T _stime;
84 		} _sigchld;
85 
86 		/* SIGILL, SIGFPE, SIGSEGV, SIGBUS, SIGTRAP, SIGEMT */
87 		struct {
88 			void __user *_addr; /* faulting insn/memory ref. */
89 #ifdef __ARCH_SI_TRAPNO
90 			int _trapno;	/* TRAP # which caused the signal */
91 #endif
92 #ifdef __ia64__
93 			int _imm;		/* immediate value for "break" */
94 			unsigned int _flags;	/* see ia64 si_flags */
95 			unsigned long _isr;	/* isr */
96 #endif
97 			union {
98 				/*
99 				 * used when si_code=BUS_MCEERR_AR or
100 				 * used when si_code=BUS_MCEERR_AO
101 				 */
102 				short _addr_lsb; /* LSB of the reported address */
103 				/* used when si_code=SEGV_BNDERR */
104 				struct {
105 					void *_dummy_bnd;
106 					void __user *_lower;
107 					void __user *_upper;
108 				} _addr_bnd;
109 				/* used when si_code=SEGV_PKUERR */
110 				struct {
111 					void *_dummy_pkey;
112 					__u32 _pkey;
113 				} _addr_pkey;
114 			};
115 		} _sigfault;
116 
117 		/* SIGPOLL */
118 		struct {
119 			__ARCH_SI_BAND_T _band;	/* POLL_IN, POLL_OUT, POLL_MSG */
120 			int _fd;
121 		} _sigpoll;
122 
123 		/* SIGSYS */
124 		struct {
125 			void __user *_call_addr; /* calling user insn */
126 			int _syscall;	/* triggering system call number */
127 			unsigned int _arch;	/* AUDIT_ARCH_* of syscall */
128 		} _sigsys;
129 	} _sifields;
130 } __ARCH_SI_ATTRIBUTES siginfo_t;
131 
132 /*
133  * How these fields are to be accessed.
134  */
135 #define si_pid		_sifields._kill._pid
136 #define si_uid		_sifields._kill._uid
137 #define si_tid		_sifields._timer._tid
138 #define si_overrun	_sifields._timer._overrun
139 #define si_sys_private  _sifields._timer._sys_private
140 #define si_status	_sifields._sigchld._status
141 #define si_utime	_sifields._sigchld._utime
142 #define si_stime	_sifields._sigchld._stime
143 #define si_value	_sifields._rt._sigval
144 #define si_int		_sifields._rt._sigval.sival_int
145 #define si_ptr		_sifields._rt._sigval.sival_ptr
146 #define si_addr		_sifields._sigfault._addr
147 #ifdef __ARCH_SI_TRAPNO
148 #define si_trapno	_sifields._sigfault._trapno
149 #endif
150 #define si_addr_lsb	_sifields._sigfault._addr_lsb
151 #define si_lower	_sifields._sigfault._addr_bnd._lower
152 #define si_upper	_sifields._sigfault._addr_bnd._upper
153 #define si_pkey		_sifields._sigfault._addr_pkey._pkey
154 #define si_band		_sifields._sigpoll._band
155 #define si_fd		_sifields._sigpoll._fd
156 #define si_call_addr	_sifields._sigsys._call_addr
157 #define si_syscall	_sifields._sigsys._syscall
158 #define si_arch		_sifields._sigsys._arch
159 
160 /*
161  * si_code values
162  * Digital reserves positive values for kernel-generated signals.
163  */
164 #define SI_USER		0		/* sent by kill, sigsend, raise */
165 #define SI_KERNEL	0x80		/* sent by the kernel from somewhere */
166 #define SI_QUEUE	-1		/* sent by sigqueue */
167 #define SI_TIMER	-2		/* sent by timer expiration */
168 #define SI_MESGQ	-3		/* sent by real time mesq state change */
169 #define SI_ASYNCIO	-4		/* sent by AIO completion */
170 #define SI_SIGIO	-5		/* sent by queued SIGIO */
171 #define SI_TKILL	-6		/* sent by tkill system call */
172 #define SI_DETHREAD	-7		/* sent by execve() killing subsidiary threads */
173 #define SI_ASYNCNL	-60		/* sent by glibc async name lookup completion */
174 
175 #define SI_FROMUSER(siptr)	((siptr)->si_code <= 0)
176 #define SI_FROMKERNEL(siptr)	((siptr)->si_code > 0)
177 
178 /*
179  * SIGILL si_codes
180  */
181 #define ILL_ILLOPC	1	/* illegal opcode */
182 #define ILL_ILLOPN	2	/* illegal operand */
183 #define ILL_ILLADR	3	/* illegal addressing mode */
184 #define ILL_ILLTRP	4	/* illegal trap */
185 #define ILL_PRVOPC	5	/* privileged opcode */
186 #define ILL_PRVREG	6	/* privileged register */
187 #define ILL_COPROC	7	/* coprocessor error */
188 #define ILL_BADSTK	8	/* internal stack error */
189 #define ILL_BADIADDR	9	/* unimplemented instruction address */
190 #define __ILL_BREAK	10	/* illegal break */
191 #define __ILL_BNDMOD	11	/* bundle-update (modification) in progress */
192 #define NSIGILL		11
193 
194 /*
195  * SIGFPE si_codes
196  */
197 #define FPE_INTDIV	1	/* integer divide by zero */
198 #define FPE_INTOVF	2	/* integer overflow */
199 #define FPE_FLTDIV	3	/* floating point divide by zero */
200 #define FPE_FLTOVF	4	/* floating point overflow */
201 #define FPE_FLTUND	5	/* floating point underflow */
202 #define FPE_FLTRES	6	/* floating point inexact result */
203 #define FPE_FLTINV	7	/* floating point invalid operation */
204 #define FPE_FLTSUB	8	/* subscript out of range */
205 #define __FPE_DECOVF	9	/* decimal overflow */
206 #define __FPE_DECDIV	10	/* decimal division by zero */
207 #define __FPE_DECERR	11	/* packed decimal error */
208 #define __FPE_INVASC	12	/* invalid ASCII digit */
209 #define __FPE_INVDEC	13	/* invalid decimal digit */
210 #define NSIGFPE		13
211 
212 /*
213  * SIGSEGV si_codes
214  */
215 #define SEGV_MAPERR	1	/* address not mapped to object */
216 #define SEGV_ACCERR	2	/* invalid permissions for mapped object */
217 #define SEGV_BNDERR	3	/* failed address bound checks */
218 #ifdef __ia64__
219 # define __SEGV_PSTKOVF	4	/* paragraph stack overflow */
220 #else
221 # define SEGV_PKUERR	4	/* failed protection key checks */
222 #endif
223 #define NSIGSEGV	4
224 
225 /*
226  * SIGBUS si_codes
227  */
228 #define BUS_ADRALN	1	/* invalid address alignment */
229 #define BUS_ADRERR	2	/* non-existent physical address */
230 #define BUS_OBJERR	3	/* object specific hardware error */
231 /* hardware memory error consumed on a machine check: action required */
232 #define BUS_MCEERR_AR	4
233 /* hardware memory error detected in process but not consumed: action optional*/
234 #define BUS_MCEERR_AO	5
235 #define NSIGBUS		5
236 
237 /*
238  * SIGTRAP si_codes
239  */
240 #define TRAP_BRKPT	1	/* process breakpoint */
241 #define TRAP_TRACE	2	/* process trace trap */
242 #define TRAP_BRANCH     3	/* process taken branch trap */
243 #define TRAP_HWBKPT     4	/* hardware breakpoint/watchpoint */
244 #define NSIGTRAP	4
245 
246 /*
247  * There is an additional set of SIGTRAP si_codes used by ptrace
248  * that are of the form: ((PTRACE_EVENT_XXX << 8) | SIGTRAP)
249  */
250 
251 /*
252  * SIGCHLD si_codes
253  */
254 #define CLD_EXITED	1	/* child has exited */
255 #define CLD_KILLED	2	/* child was killed */
256 #define CLD_DUMPED	3	/* child terminated abnormally */
257 #define CLD_TRAPPED	4	/* traced child has trapped */
258 #define CLD_STOPPED	5	/* child has stopped */
259 #define CLD_CONTINUED	6	/* stopped child has continued */
260 #define NSIGCHLD	6
261 
262 /*
263  * SIGPOLL (or any other signal without signal specific si_codes) si_codes
264  */
265 #define POLL_IN		1	/* data input available */
266 #define POLL_OUT	2	/* output buffers available */
267 #define POLL_MSG	3	/* input message available */
268 #define POLL_ERR	4	/* i/o error */
269 #define POLL_PRI	5	/* high priority input available */
270 #define POLL_HUP	6	/* device disconnected */
271 #define NSIGPOLL	6
272 
273 /*
274  * SIGSYS si_codes
275  */
276 #define SYS_SECCOMP	1	/* seccomp triggered */
277 #define NSIGSYS		1
278 
279 /*
280  * sigevent definitions
281  *
282  * It seems likely that SIGEV_THREAD will have to be handled from
283  * userspace, libpthread transmuting it to SIGEV_SIGNAL, which the
284  * thread manager then catches and does the appropriate nonsense.
285  * However, everything is written out here so as to not get lost.
286  */
287 #define SIGEV_SIGNAL	0	/* notify via signal */
288 #define SIGEV_NONE	1	/* other notification: meaningless */
289 #define SIGEV_THREAD	2	/* deliver via thread creation */
290 #define SIGEV_THREAD_ID 4	/* deliver to thread */
291 
292 /*
293  * This works because the alignment is ok on all current architectures
294  * but we leave open this being overridden in the future
295  */
296 #ifndef __ARCH_SIGEV_PREAMBLE_SIZE
297 #define __ARCH_SIGEV_PREAMBLE_SIZE	(sizeof(int) * 2 + sizeof(sigval_t))
298 #endif
299 
300 #define SIGEV_MAX_SIZE	64
301 #define SIGEV_PAD_SIZE	((SIGEV_MAX_SIZE - __ARCH_SIGEV_PREAMBLE_SIZE) \
302 		/ sizeof(int))
303 
304 typedef struct sigevent {
305 	sigval_t sigev_value;
306 	int sigev_signo;
307 	int sigev_notify;
308 	union {
309 		int _pad[SIGEV_PAD_SIZE];
310 		 int _tid;
311 
312 		struct {
313 			void (*_function)(sigval_t);
314 			void *_attribute;	/* really pthread_attr_t */
315 		} _sigev_thread;
316 	} _sigev_un;
317 } sigevent_t;
318 
319 #define sigev_notify_function	_sigev_un._sigev_thread._function
320 #define sigev_notify_attributes	_sigev_un._sigev_thread._attribute
321 #define sigev_notify_thread_id	 _sigev_un._tid
322 
323 
324 #endif /* _UAPI_ASM_GENERIC_SIGINFO_H */
325