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