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