include/uapi/asm-generic/siginfo.h

   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 used by the kernel. Historic leftover. Always 0. */
  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 */