summaryrefslogtreecommitdiff
path: root/static/netbsd/man2/siginfo.2
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
commit5cb84ec742fd33f78c8022863fadaa8d0d93e176 (patch)
tree1a81ca3665e6153923e40db7b0d988f8573ab59c /static/netbsd/man2/siginfo.2
parenta59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff)
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man2/siginfo.2')
-rw-r--r--static/netbsd/man2/siginfo.2442
1 files changed, 442 insertions, 0 deletions
diff --git a/static/netbsd/man2/siginfo.2 b/static/netbsd/man2/siginfo.2
new file mode 100644
index 00000000..61cae785
--- /dev/null
+++ b/static/netbsd/man2/siginfo.2
@@ -0,0 +1,442 @@
+.\" $NetBSD: siginfo.2,v 1.24 2020/06/08 17:19:44 sevan Exp $
+.\"
+.\" Copyright (c) 2003 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Christos Zoulas.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd May 25, 2019
+.Dt SIGINFO 2
+.Os
+.Sh NAME
+.Nm siginfo
+.Nd signal information
+.Sh SYNOPSIS
+.In signal.h
+.Sh DESCRIPTION
+.Nm
+is a structure type which contains information about a signal delivered
+to a process.
+.Pp
+.Nm
+includes the following members:
+.Bd -literal -offset indent
+int si_signo;
+int si_errno;
+int si_code;
+.Ed
+.Pp
+.Fa si_signo
+contains the signal number generated by the system.
+.Pp
+If
+.Fa si_errno
+is non-zero, then it contains a system specific error number associated
+with this signal.
+This number is defined in
+.Xr errno 2 .
+.Pp
+If
+.Fa si_code
+is less than or equal to zero, the signal was generated by a user process
+or a user requested service:
+.Bl -tag -width SI_ASYNCIO
+.It SI_USER
+The signal was generated via
+.Xr kill 2 .
+The
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+pid_t si_pid;
+uid_t si_uid;
+.Ed
+.Pp
+The
+.Fa si_pid
+field contains the pid of the sending process and the
+.Fa si_uid
+field contains the user id of the sending process.
+.It SI_QUEUE
+The signal was generated via
+.Xr sigqueue 2 .
+The
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+pid_t si_pid;
+uid_t si_uid;
+sigval_t si_value;
+.Ed
+.Pp
+The
+.Fa si_pid
+field contains the pid of the sending process and the
+.Fa si_uid
+field contains the user id of the sending process.
+Finally, the
+.Fa si_value
+field contains the value sent via
+.Xr sigqueue 2 .
+.It SI_TIMER
+The signal was generated because a timer set by
+.Xr timer_settime 2
+has expired.
+The
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+sigval_t si_value;
+.Ed
+.Pp
+The
+.Fa si_value
+field contains the value set via
+.Xr timer_create 2 .
+.It SI_ASYNCIO
+The signal was generated by completion of an asynchronous I/O operation.
+The
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+int si_fd;
+long si_band;
+.Ed
+.Pp
+The
+.Fa si_fd
+argument contains the file descriptor number on which the operation was
+completed and the
+.Fa si_band
+field contains the side and priority of the operation.
+If the operation was a normal read,
+.Fa si_band
+will contain
+.Dv POLLIN | POLLRDNORM ;
+on an out-of-band read it will contain
+.Dv POLLPRI | POLLRDBAND ;
+on a normal write it will contain
+.Dv POLLOUT | POLLWRNORM ;
+on an out-of-band write it will contain
+.Dv POLLPRI | POLLWRBAND .
+.It SI_MESGQ
+The signal was generated because of the arrival of a message on an empty
+message queue.
+See
+.Xr mq_notify 3 .
+.It SI_LWP
+The signal was generated via
+.Xr _lwp_kill 2 .
+The
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+pid_t si_pid;
+uid_t si_uid;
+.Ed
+.Pp
+The
+.Fa si_pid
+field contains the pid of the sending process and the
+.Fa si_uid
+field contains the user id of the sending process.
+.It SI_NOINFO
+The signal was generated without specific info available.
+.El
+.Pp
+If
+.Fa si_code
+is positive, then it contains a signal specific reason
+why the signal was generated:
+.Bl -tag -width SIGCHLD
+.It SIGILL
+.Bl -tag -width ILL_ILLOPC
+.It ILL_BADSTK
+Internal stack error
+.It ILL_COPROC
+Coprocessor error
+.It ILL_ILLADR
+Illegal addressing mode
+.It ILL_ILLOPC
+Illegal opcode
+.It ILL_ILLOPN
+Illegal operand
+.It ILL_ILLTRP
+Illegal trap
+.It ILL_PRVOPC
+Privileged opcode
+.It ILL_PRVREG
+Privileged register
+.El
+.It SIGFPE
+.Bl -tag -width FPE_INTDIV
+.It FPE_FLTDIV
+Floating-point divide by zero
+.It FPE_FLTINV
+Invalid floating-point operation
+.It FPE_FLTOVF
+Floating-point overflow
+.It FPE_FLTRES
+Floating-point inexact result
+.It FPE_FLTUND
+Floating-point underflow
+.It FPE_FLTSUB
+Subscript out of range
+.It FPE_INTDIV
+Integer divide by zero
+.It FPE_INTOVF
+Integer overflow
+.El
+.It SIGSEGV
+.Bl -tag -width SEGV_MAPERR
+.It SEGV_ACCERR
+Invalid permissions for mapped object
+.It SEGV_MAPERR
+Address not mapped to object
+.El
+.It SIGBUS
+.Bl -tag -width BUS_ADRALN
+.It BUS_ADRALN
+Invalid address alignment
+.It BUS_ADRERR
+Nonexistent physical address
+.It BUS_OBJERR
+Object-specific hardware error
+.El
+.It SIGTRAP
+.Bl -tag -width TRAP_BRKPT
+.It TRAP_BRKPT
+Process breakpoint
+.It TRAP_CHLD
+Process child trap
+.It TRAP_DBREG
+Process hardware debug register trap
+.It TRAP_EXEC
+Process exec trap
+.It TRAP_LWP
+Process LWP trap
+.It TRAP_SCE
+Process syscall entry trap
+.It TRAP_SCX
+Process syscall exit trap
+.It TRAP_TRACE
+Process trace trap
+.El
+.It SIGCHLD
+.Bl -tag -width CLD_CONTINUED
+.It CLD_CONTINUED
+Stopped child has continued
+.It CLD_DUMPED
+Child has terminated abnormally and created a core file
+.It CLD_EXITED
+Child has exited
+.It CLD_KILLED
+Child has terminated abnormally but did not create a core file
+.It CLD_STOPPED
+Child has stopped
+.It CLD_TRAPPED
+Traced child has trapped
+.El
+.It SIGIO
+.Bl -tag -width POLL_OUT
+.It POLL_ERR
+I/O error
+.It POLL_HUP
+Device disconnected
+.It POLL_IN
+Data input available
+.It POLL_MSG
+Input message available
+.It POLL_OUT
+Output buffers available
+.It POLL_PRI
+High priority input available
+.El
+.El
+.Pp
+For
+.Dv SIGILL ,
+.Dv SIGFPE ,
+.Dv SIGBUS
+and
+.Dv SIGSEGV
+the
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+void *si_addr;
+int si_trap;
+.Ed
+.Pp
+.Fa si_addr
+contains the address of the faulting instruction or data and
+.Fa si_trap
+contains a hardware specific reason.
+.Pp
+For
+.Dv SIGTRAP
+and
+.Dv TRAP_BRKPT ,
+.Dv TRAP_TRACE
+or
+.Dv TRAP_DBREG
+the
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+void *si_addr;
+int si_trap;
+.Ed
+.Pp
+.Fa si_addr
+contains the address of the faulting data and
+.Fa si_trap
+contains a hardware specific reason.
+.Pp
+For
+.Dv SIGTRAP
+and
+.Dv TRAP_SCE
+or
+.Dv TRAP_SCX
+the
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+int si_sysnum;
+int si_retval[2];
+int si_error;
+uint64_t si_args[8];
+.Ed
+.Pp
+.Fa si_sysnum
+contains the syscall number,
+.Fa si_retval
+contains the syscall return value (meaningful for
+.Dv TRAP_SCX
+only),
+.Fa si_error
+contains the syscall error value (meaningful for
+.Dv TRAP_SCX
+only) and
+.Fa si_args[8]
+contains the syscall arguments,
+.Pp
+For
+.Dv SIGIO
+the
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+int si_fd;
+long si_band;
+.Ed
+.Pp
+The
+.Fa si_fd
+argument contains the file descriptor number on which the operation was
+completed and the
+.Fa si_band
+field contains the side and priority of the operation as described above.
+.Pp
+Finally, for
+.Dv SIGCHLD
+the
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+pid_t si_pid;
+uid_t si_uid;
+int si_status;
+clock_t si_utime;
+clock_t si_stime;
+.Ed
+.Pp
+The
+.Fa si_pid
+field contains the pid of the process who's status changed, the
+.Fa si_uid
+field contains the user id of the that process, the
+.Fa si_status
+field contains either the exit code of the process (for
+.Dv CLD_EXITED ) ,
+or the signal number received by the process.
+.Xr waitid 2 ,
+.Xr waitpid 2 ,
+and the
+.Fa si_utime
+and
+.Fa si_stime
+fields contain the user and system process accounting time.
+.Sh STANDARDS
+The
+.Nm
+type conforms to
+.St -xsh5 .
+.Pp
+Signals specifying
+.Dv SI_LWP
+or
+.Dv SI_NOINFO
+are
+.Nx
+extensions.
+.Pp
+The
+.Dv TRAP_CHLD ,
+.Dv TRAP_DBREG ,
+.Dv TRAP_EXEC ,
+.Dv TRAP_LWP ,
+.Dv TRAP_SCE
+and
+.Dv TRAP_SCX
+signal specific reasons of
+.Dv SIGTRAP
+are
+.Nx
+extensions.
+.Sh HISTORY
+The
+.Nm
+functionality first appeared in
+.At V.4 .
+.Pp
+.Dv TRAP_CHLD ,
+.Dv TRAP_DBREG ,
+.Dv TRAP_EXEC ,
+.Dv TRAP_LWP ,
+.Dv TRAP_SCE
+and
+.Dv TRAP_SCX
+first appeared
+in
+.Nx 8 .
+.Pp
+The additional parameters with syscall information in
+.Dv TRAP_SCE
+and
+.Dv TRAP_SCX
+first appeared in
+.Nx 9 .