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