The C and C++ Include Header Files

/usr/include/asm-generic/siginfo.h


$ cat -n /usr/include/asm-generic/siginfo.h

     1	/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
     2	#ifndef _ASM_GENERIC_SIGINFO_H
     3	#define _ASM_GENERIC_SIGINFO_H
     4	
     5	
     6	#include <linux/types.h>
     7	
     8	typedef union sigval {
     9		int sival_int;
    10		void *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 *_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 *_lower;
    86					void *_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 *_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 /* _ASM_GENERIC_SIGINFO_H */