root/include/uapi/asm-generic/siginfo.h
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
#ifndef _UAPI_ASM_GENERIC_SIGINFO_H
#define _UAPI_ASM_GENERIC_SIGINFO_H

#include <linux/compiler.h>
#include <linux/types.h>

typedef union sigval {
        int sival_int;
        void __user *sival_ptr;
} sigval_t;

#define SI_MAX_SIZE     128

/*
 * The default "si_band" type is "long", as specified by POSIX.
 * However, some architectures want to override this to "int"
 * for historical compatibility reasons, so we allow that.
 */
#ifndef __ARCH_SI_BAND_T
#define __ARCH_SI_BAND_T long
#endif

#ifndef __ARCH_SI_CLOCK_T
#define __ARCH_SI_CLOCK_T __kernel_clock_t
#endif

#ifndef __ARCH_SI_ATTRIBUTES
#define __ARCH_SI_ATTRIBUTES
#endif

/*
 * Be careful when extending this union.  On 32bit siginfo_t is 32bit
 * aligned.  Which means that a 64bit field or any other field that
 * would increase the alignment of siginfo_t will break the ABI.
 */
union __sifields {
        /* kill() */
        struct {
                __kernel_pid_t _pid;    /* sender's pid */
                __kernel_uid32_t _uid;  /* sender's uid */
        } _kill;

        /* POSIX.1b timers */
        struct {
                __kernel_timer_t _tid;  /* timer id */
                int _overrun;           /* overrun count */
                sigval_t _sigval;       /* same as below */
                int _sys_private;       /* Not used by the kernel. Historic leftover. Always 0. */
        } _timer;

        /* POSIX.1b signals */
        struct {
                __kernel_pid_t _pid;    /* sender's pid */
                __kernel_uid32_t _uid;  /* sender's uid */
                sigval_t _sigval;
        } _rt;

        /* SIGCHLD */
        struct {
                __kernel_pid_t _pid;    /* which child */
                __kernel_uid32_t _uid;  /* sender's uid */
                int _status;            /* exit code */
                __ARCH_SI_CLOCK_T _utime;
                __ARCH_SI_CLOCK_T _stime;
        } _sigchld;

        /* SIGILL, SIGFPE, SIGSEGV, SIGBUS, SIGTRAP, SIGEMT */
        struct {
                void __user *_addr; /* faulting insn/memory ref. */

#define __ADDR_BND_PKEY_PAD  (__alignof__(void *) < sizeof(short) ? \
                              sizeof(short) : __alignof__(void *))
                union {
                        /* used on alpha and sparc */
                        int _trapno;    /* TRAP # which caused the signal */
                        /*
                         * used when si_code=BUS_MCEERR_AR or
                         * used when si_code=BUS_MCEERR_AO
                         */
                        short _addr_lsb; /* LSB of the reported address */
                        /* used when si_code=SEGV_BNDERR */
                        struct {
                                char _dummy_bnd[__ADDR_BND_PKEY_PAD];
                                void __user *_lower;
                                void __user *_upper;
                        } _addr_bnd;
                        /* used when si_code=SEGV_PKUERR */
                        struct {
                                char _dummy_pkey[__ADDR_BND_PKEY_PAD];
                                __u32 _pkey;
                        } _addr_pkey;
                        /* used when si_code=TRAP_PERF */
                        struct {
                                unsigned long _data;
                                __u32 _type;
                                __u32 _flags;
                        } _perf;
                };
        } _sigfault;

        /* SIGPOLL */
        struct {
                __ARCH_SI_BAND_T _band; /* POLL_IN, POLL_OUT, POLL_MSG */
                int _fd;
        } _sigpoll;

        /* SIGSYS */
        struct {
                void __user *_call_addr; /* calling user insn */
                int _syscall;   /* triggering system call number */
                unsigned int _arch;     /* AUDIT_ARCH_* of syscall */
        } _sigsys;
};

#ifndef __ARCH_HAS_SWAPPED_SIGINFO
#define __SIGINFO                       \
struct {                                \
        int si_signo;                   \
        int si_errno;                   \
        int si_code;                    \
        union __sifields _sifields;     \
}
#else
#define __SIGINFO                       \
struct {                                \
        int si_signo;                   \
        int si_code;                    \
        int si_errno;                   \
        union __sifields _sifields;     \
}
#endif /* __ARCH_HAS_SWAPPED_SIGINFO */

typedef struct siginfo {
        union {
                __SIGINFO;
                int _si_pad[SI_MAX_SIZE/sizeof(int)];
        };
} __ARCH_SI_ATTRIBUTES siginfo_t;

/*
 * How these fields are to be accessed.
 */
#define si_pid          _sifields._kill._pid
#define si_uid          _sifields._kill._uid
#define si_tid          _sifields._timer._tid
#define si_overrun      _sifields._timer._overrun
#define si_sys_private  _sifields._timer._sys_private
#define si_status       _sifields._sigchld._status
#define si_utime        _sifields._sigchld._utime
#define si_stime        _sifields._sigchld._stime
#define si_value        _sifields._rt._sigval
#define si_int          _sifields._rt._sigval.sival_int
#define si_ptr          _sifields._rt._sigval.sival_ptr
#define si_addr         _sifields._sigfault._addr
#define si_trapno       _sifields._sigfault._trapno
#define si_addr_lsb     _sifields._sigfault._addr_lsb
#define si_lower        _sifields._sigfault._addr_bnd._lower
#define si_upper        _sifields._sigfault._addr_bnd._upper
#define si_pkey         _sifields._sigfault._addr_pkey._pkey
#define si_perf_data    _sifields._sigfault._perf._data
#define si_perf_type    _sifields._sigfault._perf._type
#define si_perf_flags   _sifields._sigfault._perf._flags
#define si_band         _sifields._sigpoll._band
#define si_fd           _sifields._sigpoll._fd
#define si_call_addr    _sifields._sigsys._call_addr
#define si_syscall      _sifields._sigsys._syscall
#define si_arch         _sifields._sigsys._arch

/*
 * si_code values
 * Digital reserves positive values for kernel-generated signals.
 */
#define SI_USER         0               /* sent by kill, sigsend, raise */
#define SI_KERNEL       0x80            /* sent by the kernel from somewhere */
#define SI_QUEUE        -1              /* sent by sigqueue */
#define SI_TIMER        -2              /* sent by timer expiration */
#define SI_MESGQ        -3              /* sent by real time mesq state change */
#define SI_ASYNCIO      -4              /* sent by AIO completion */
#define SI_SIGIO        -5              /* sent by queued SIGIO */
#define SI_TKILL        -6              /* sent by tkill system call */
#define SI_DETHREAD     -7              /* sent by execve() killing subsidiary threads */
#define SI_ASYNCNL      -60             /* sent by glibc async name lookup completion */

#define SI_FROMUSER(siptr)      ((siptr)->si_code <= 0)
#define SI_FROMKERNEL(siptr)    ((siptr)->si_code > 0)

/*
 * SIGILL si_codes
 */
#define ILL_ILLOPC      1       /* illegal opcode */
#define ILL_ILLOPN      2       /* illegal operand */
#define ILL_ILLADR      3       /* illegal addressing mode */
#define ILL_ILLTRP      4       /* illegal trap */
#define ILL_PRVOPC      5       /* privileged opcode */
#define ILL_PRVREG      6       /* privileged register */
#define ILL_COPROC      7       /* coprocessor error */
#define ILL_BADSTK      8       /* internal stack error */
#define ILL_BADIADDR    9       /* unimplemented instruction address */
#define __ILL_BREAK     10      /* illegal break */
#define __ILL_BNDMOD    11      /* bundle-update (modification) in progress */
#define NSIGILL         11

/*
 * SIGFPE si_codes
 */
#define FPE_INTDIV      1       /* integer divide by zero */
#define FPE_INTOVF      2       /* integer overflow */
#define FPE_FLTDIV      3       /* floating point divide by zero */
#define FPE_FLTOVF      4       /* floating point overflow */
#define FPE_FLTUND      5       /* floating point underflow */
#define FPE_FLTRES      6       /* floating point inexact result */
#define FPE_FLTINV      7       /* floating point invalid operation */
#define FPE_FLTSUB      8       /* subscript out of range */
#define __FPE_DECOVF    9       /* decimal overflow */
#define __FPE_DECDIV    10      /* decimal division by zero */
#define __FPE_DECERR    11      /* packed decimal error */
#define __FPE_INVASC    12      /* invalid ASCII digit */
#define __FPE_INVDEC    13      /* invalid decimal digit */
#define FPE_FLTUNK      14      /* undiagnosed floating-point exception */
#define FPE_CONDTRAP    15      /* trap on condition */
#define NSIGFPE         15

/*
 * SIGSEGV si_codes
 */
#define SEGV_MAPERR     1       /* address not mapped to object */
#define SEGV_ACCERR     2       /* invalid permissions for mapped object */
#define SEGV_BNDERR     3       /* failed address bound checks */
#ifdef __ia64__
# define __SEGV_PSTKOVF 4       /* paragraph stack overflow */
#else
# define SEGV_PKUERR    4       /* failed protection key checks */
#endif
#define SEGV_ACCADI     5       /* ADI not enabled for mapped object */
#define SEGV_ADIDERR    6       /* Disrupting MCD error */
#define SEGV_ADIPERR    7       /* Precise MCD exception */
#define SEGV_MTEAERR    8       /* Asynchronous ARM MTE error */
#define SEGV_MTESERR    9       /* Synchronous ARM MTE exception */
#define SEGV_CPERR      10      /* Control protection fault */
#define NSIGSEGV        10

/*
 * SIGBUS si_codes
 */
#define BUS_ADRALN      1       /* invalid address alignment */
#define BUS_ADRERR      2       /* non-existent physical address */
#define BUS_OBJERR      3       /* object specific hardware error */
/* hardware memory error consumed on a machine check: action required */
#define BUS_MCEERR_AR   4
/* hardware memory error detected in process but not consumed: action optional*/
#define BUS_MCEERR_AO   5
#define NSIGBUS         5

/*
 * SIGTRAP si_codes
 */
#define TRAP_BRKPT      1       /* process breakpoint */
#define TRAP_TRACE      2       /* process trace trap */
#define TRAP_BRANCH     3       /* process taken branch trap */
#define TRAP_HWBKPT     4       /* hardware breakpoint/watchpoint */
#define TRAP_UNK        5       /* undiagnosed trap */
#define TRAP_PERF       6       /* perf event with sigtrap=1 */
#define NSIGTRAP        6

/*
 * There is an additional set of SIGTRAP si_codes used by ptrace
 * that are of the form: ((PTRACE_EVENT_XXX << 8) | SIGTRAP)
 */

/*
 * Flags for si_perf_flags if SIGTRAP si_code is TRAP_PERF.
 */
#define TRAP_PERF_FLAG_ASYNC (1u << 0)

/*
 * SIGCHLD si_codes
 */
#define CLD_EXITED      1       /* child has exited */
#define CLD_KILLED      2       /* child was killed */
#define CLD_DUMPED      3       /* child terminated abnormally */
#define CLD_TRAPPED     4       /* traced child has trapped */
#define CLD_STOPPED     5       /* child has stopped */
#define CLD_CONTINUED   6       /* stopped child has continued */
#define NSIGCHLD        6

/*
 * SIGPOLL (or any other signal without signal specific si_codes) si_codes
 */
#define POLL_IN         1       /* data input available */
#define POLL_OUT        2       /* output buffers available */
#define POLL_MSG        3       /* input message available */
#define POLL_ERR        4       /* i/o error */
#define POLL_PRI        5       /* high priority input available */
#define POLL_HUP        6       /* device disconnected */
#define NSIGPOLL        6

/*
 * SIGSYS si_codes
 */
#define SYS_SECCOMP     1       /* seccomp triggered */
#define SYS_USER_DISPATCH 2     /* syscall user dispatch triggered */
#define NSIGSYS         2

/*
 * SIGEMT si_codes
 */
#define EMT_TAGOVF      1       /* tag overflow */
#define NSIGEMT         1

/*
 * sigevent definitions
 * 
 * It seems likely that SIGEV_THREAD will have to be handled from 
 * userspace, libpthread transmuting it to SIGEV_SIGNAL, which the
 * thread manager then catches and does the appropriate nonsense.
 * However, everything is written out here so as to not get lost.
 */
#define SIGEV_SIGNAL    0       /* notify via signal */
#define SIGEV_NONE      1       /* other notification: meaningless */
#define SIGEV_THREAD    2       /* deliver via thread creation */
#define SIGEV_THREAD_ID 4       /* deliver to thread */

/*
 * This works because the alignment is ok on all current architectures
 * but we leave open this being overridden in the future
 */
#ifndef __ARCH_SIGEV_PREAMBLE_SIZE
#define __ARCH_SIGEV_PREAMBLE_SIZE      (sizeof(int) * 2 + sizeof(sigval_t))
#endif

#define SIGEV_MAX_SIZE  64
#define SIGEV_PAD_SIZE  ((SIGEV_MAX_SIZE - __ARCH_SIGEV_PREAMBLE_SIZE) \
                / sizeof(int))

typedef struct sigevent {
        sigval_t sigev_value;
        int sigev_signo;
        int sigev_notify;
        union {
                int _pad[SIGEV_PAD_SIZE];
                 int _tid;

                struct {
                        void (*_function)(sigval_t);
                        void *_attribute;       /* really pthread_attr_t */
                } _sigev_thread;
        } _sigev_un;
} sigevent_t;

#define sigev_notify_function   _sigev_un._sigev_thread._function
#define sigev_notify_attributes _sigev_un._sigev_thread._attribute
#define sigev_notify_thread_id   _sigev_un._tid


#endif /* _UAPI_ASM_GENERIC_SIGINFO_H */