1/* $NetBSD: siginfo.h,v 1.35 2024/05/12 10:34:56 rillig Exp $ */
2
3/*-
4 * Copyright (c) 2002 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Christos Zoulas.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32#ifndef _SYS_SIGINFO_H_
33#define _SYS_SIGINFO_H_
34
35#include <machine/signal.h>
36#include <sys/featuretest.h>
37#ifdef _KERNEL
38#include <sys/queue.h>
39#endif
40
41typedef union sigval {
42 int sival_int;
43 void *sival_ptr;
44} sigval_t;
45
46struct _ksiginfo {
47 int _signo;
48 int _code;
49 int _errno;
50#ifdef _LP64
51 /* In _LP64 the union starts on an 8-byte boundary. */
52 int _pad;
53#endif
54 union {
55 struct {
56 pid_t _pid;
57 uid_t _uid;
58 sigval_t _value;
59 } _rt;
60
61 struct {
62 pid_t _pid;
63 uid_t _uid;
64 int _status;
65 clock_t _utime;
66 clock_t _stime;
67 } _child;
68
69 struct {
70 void *_addr;
71 int _trap;
72 int _trap2;
73 int _trap3;
74 } _fault;
75
76 struct {
77 long _band;
78 int _fd;
79 } _poll;
80
81 struct {
82 int _sysnum;
83 int _retval[2];
84 int _error;
85 uint64_t _args[8]; /* SYS_MAXSYSARGS */
86 } _syscall;
87
88 struct {
89 int _pe_report_event;
90 union {
91 pid_t _pe_other_pid;
92 lwpid_t _pe_lwp;
93 } _option;
94 } _ptrace_state;
95 } _reason;
96};
97
98#ifdef _KERNEL
99typedef struct ksiginfo {
100 u_long ksi_flags; /* 4 or 8 bytes (LP64) */
101 TAILQ_ENTRY(ksiginfo) ksi_list;
102 struct _ksiginfo ksi_info;
103 lwpid_t ksi_lid; /* 0, or directed to LWP */
104} ksiginfo_t;
105
106#define KSI_TRAP 0x01 /* signal caused by trap */
107#define KSI_EMPTY 0x02 /* no additional information */
108#define KSI_QUEUED 0x04 /* on a sigpend_t queue */
109#define KSI_FROMPOOL 0x08 /* allocated from the ksiginfo pool */
110
111/* Macros to initialize a ksiginfo_t. */
112#define KSI_INIT(ksi) \
113do { \
114 memset((ksi), 0, sizeof(*(ksi))); \
115} while (0)
116
117#define KSI_INIT_EMPTY(ksi) \
118do { \
119 KSI_INIT((ksi)); \
120 (ksi)->ksi_flags = KSI_EMPTY; \
121} while (0)
122
123#define KSI_INIT_TRAP(ksi) \
124do { \
125 KSI_INIT((ksi)); \
126 (ksi)->ksi_flags = KSI_TRAP; \
127} while (0)
128
129/* Copy the part of ksiginfo_t without the queue pointers */
130#define KSI_COPY(fksi, tksi) \
131do { \
132 (tksi)->ksi_info = (fksi)->ksi_info; \
133 (tksi)->ksi_flags = (fksi)->ksi_flags; \
134} while (0)
135
136
137/* Predicate macros to test how a ksiginfo_t was generated. */
138#define KSI_TRAP_P(ksi) (((ksi)->ksi_flags & KSI_TRAP) != 0)
139#define KSI_EMPTY_P(ksi) (((ksi)->ksi_flags & KSI_EMPTY) != 0)
140
141/*
142 * Old-style signal handler "code" arguments were only non-zero for
143 * signals caused by traps.
144 */
145#define KSI_TRAPCODE(ksi) (KSI_TRAP_P(ksi) ? (ksi)->ksi_trap : 0)
146#endif /* _KERNEL */
147
148typedef union siginfo {
149 char si_pad[128]; /* Total size; for future expansion */
150 struct _ksiginfo _info;
151} siginfo_t;
152
153/** Field access macros */
154#define si_signo _info._signo
155#define si_code _info._code
156#define si_errno _info._errno
157
158#define si_value _info._reason._rt._value
159#define si_pid _info._reason._child._pid
160#define si_uid _info._reason._child._uid
161#define si_status _info._reason._child._status
162#define si_utime _info._reason._child._utime
163#define si_stime _info._reason._child._stime
164
165#define si_addr _info._reason._fault._addr
166#define si_trap _info._reason._fault._trap
167#define si_trap2 _info._reason._fault._trap2
168#define si_trap3 _info._reason._fault._trap3
169
170#define si_band _info._reason._poll._band
171#define si_fd _info._reason._poll._fd
172
173#define si_sysnum _info._reason._syscall._sysnum
174#define si_retval _info._reason._syscall._retval
175#define si_error _info._reason._syscall._error
176#define si_args _info._reason._syscall._args
177
178#define si_pe_report_event _info._reason._ptrace_state._pe_report_event
179#define si_pe_other_pid _info._reason._ptrace_state._option._pe_other_pid
180#define si_pe_lwp _info._reason._ptrace_state._option._pe_lwp
181
182#ifdef _KERNEL
183/** Field access macros */
184#define ksi_signo ksi_info._signo
185#define ksi_code ksi_info._code
186#define ksi_errno ksi_info._errno
187
188#define ksi_value ksi_info._reason._rt._value
189#define ksi_pid ksi_info._reason._child._pid
190#define ksi_uid ksi_info._reason._child._uid
191#define ksi_status ksi_info._reason._child._status
192#define ksi_utime ksi_info._reason._child._utime
193#define ksi_stime ksi_info._reason._child._stime
194
195#define ksi_addr ksi_info._reason._fault._addr
196#define ksi_trap ksi_info._reason._fault._trap
197#define ksi_trap2 ksi_info._reason._fault._trap2
198#define ksi_trap3 ksi_info._reason._fault._trap3
199
200#define ksi_band ksi_info._reason._poll._band
201#define ksi_fd ksi_info._reason._poll._fd
202
203#define ksi_sysnum ksi_info._reason._syscall._sysnum
204#define ksi_retval ksi_info._reason._syscall._retval
205#define ksi_error ksi_info._reason._syscall._error
206#define ksi_args ksi_info._reason._syscall._args
207
208#define ksi_pe_report_event ksi_info._reason._ptrace_state._pe_report_event
209#define ksi_pe_other_pid ksi_info._reason._ptrace_state._option._pe_other_pid
210#define ksi_pe_lwp ksi_info._reason._ptrace_state._option._pe_lwp
211#endif /* _KERNEL */
212
213/** si_code */
214/* SIGILL */
215#define ILL_ILLOPC 1 /* Illegal opcode */
216#define ILL_ILLOPN 2 /* Illegal operand */
217#define ILL_ILLADR 3 /* Illegal addressing mode */
218#define ILL_ILLTRP 4 /* Illegal trap */
219#define ILL_PRVOPC 5 /* Privileged opcode */
220#define ILL_PRVREG 6 /* Privileged register */
221#define ILL_COPROC 7 /* Coprocessor error */
222#define ILL_BADSTK 8 /* Internal stack error */
223
224/* SIGFPE */
225#define FPE_INTDIV 1 /* Integer divide by zero */
226#define FPE_INTOVF 2 /* Integer overflow */
227#define FPE_FLTDIV 3 /* Floating point divide by zero */
228#define FPE_FLTOVF 4 /* Floating point overflow */
229#define FPE_FLTUND 5 /* Floating point underflow */
230#define FPE_FLTRES 6 /* Floating point inexact result */
231#define FPE_FLTINV 7 /* Invalid Floating point operation */
232#define FPE_FLTSUB 8 /* Subscript out of range */
233
234/* SIGSEGV */
235#define SEGV_MAPERR 1 /* Address not mapped to object */
236#define SEGV_ACCERR 2 /* Invalid permissions for mapped object*/
237
238/* SIGBUS */
239#define BUS_ADRALN 1 /* Invalid address alignment */
240#define BUS_ADRERR 2 /* Non-existent physical address */
241#define BUS_OBJERR 3 /* Object specific hardware error */
242
243/* SIGTRAP */
244#define TRAP_BRKPT 1 /* Process breakpoint */
245#define TRAP_TRACE 2 /* Process trace trap */
246#define TRAP_EXEC 3 /* Process exec trap */
247#define TRAP_CHLD 4 /* Process child trap */
248#define TRAP_LWP 5 /* Process lwp trap */
249#define TRAP_DBREG 6 /* Process hardware debug register trap */
250#define TRAP_SCE 7 /* Process syscall entry trap */
251#define TRAP_SCX 8 /* Process syscall exit trap */
252
253/* SIGCHLD */
254#define CLD_EXITED 1 /* Child has exited */
255#define CLD_KILLED 2 /* Child has terminated abnormally but */
256 /* did not create a core file */
257#define CLD_DUMPED 3 /* Child has terminated abnormally and */
258 /* created a core file */
259#define CLD_TRAPPED 4 /* Traced child has trapped */
260#define CLD_STOPPED 5 /* Child has stopped */
261#define CLD_CONTINUED 6 /* Stopped child has continued */
262
263/* SIGIO */
264#define POLL_IN 1 /* Data input available */
265#define POLL_OUT 2 /* Output buffers available */
266#define POLL_MSG 3 /* Input message available */
267#define POLL_ERR 4 /* I/O Error */
268#define POLL_PRI 5 /* High priority input available */
269#define POLL_HUP 6 /* Device disconnected */
270
271
272/** si_code */
273#define SI_USER 0 /* Sent by kill(2) */
274#define SI_QUEUE -1 /* Sent by the sigqueue(2) */
275#define SI_TIMER -2 /* Generated by expiration of a timer */
276 /* set by timer_settime(2) */
277#define SI_ASYNCIO -3 /* Generated by completion of an */
278 /* asynchronous I/O signal */
279#define SI_MESGQ -4 /* Generated by arrival of a message on */
280 /* an empty message queue */
281#if defined(_KERNEL) || defined(_NETBSD_SOURCE)
282#define SI_LWP -5 /* Generated by _lwp_kill(2) */
283#define SI_NOINFO 32767 /* No signal specific info available */
284#endif
285
286#endif /* !_SYS_SIGINFO_H_ */