Differential D25777 Diff 75082 head/share/man/man3/siginfo.3

Changeset View

Standalone View

head/share/man/man3/siginfo.3

	Show All 21 Lines
	.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR			.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
	.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,			.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
	.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE			.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
	.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,			.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
	.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.			.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd May 8, 2020			.Dd July 28, 2020
	.Dt SIGINFO 3			.Dt SIGINFO 3
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm siginfo			.Nm siginfo
	.Nd "signal generation information"			.Nd "signal generation information"
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.In signal.h			.In signal.h
	.Sh DESCRIPTION			.Sh DESCRIPTION
	Show All 24 Lines
	signal code			signal code
	.It Vt union sigval Ta Va si_value Ta			.It Vt union sigval Ta Va si_value Ta
	signal value			signal value
	.It Vt pid_t Ta Va si_pid Ta			.It Vt pid_t Ta Va si_pid Ta
	sending process ID			sending process ID
	.It Vt uid_t Ta Va si_uid Ta			.It Vt uid_t Ta Va si_uid Ta
	sending process's real user ID			sending process's real user ID
	.It Vt void Ta Va *si_addr Ta			.It Vt void Ta Va *si_addr Ta
	address of faulting instruction			virtual address
	.It Vt int Ta Va si_status Ta			.It Vt int Ta Va si_status Ta
	exit value or signal			exit value or signal
	.It Vt long Ta Va si_band Ta			.It Vt long Ta Va si_band Ta
	band event for			band event for
	.Dv SIGPOLL			.Dv SIGPOLL
	.It Vt int Ta Va si_trapno Ta			.It Vt int Ta Va si_trapno Ta
	machine trap code			machine trap code
	.It Vt int Ta Va si_timerid Ta			.It Vt int Ta Va si_timerid Ta
	▲ Show 20 Lines • Show All 123 Lines • ▼ Show 20 Lines
	signal generated by arrival of a message on an empty message queue			signal generated by arrival of a message on an empty message queue
	.It Ta Dv SI_KERNEL Ta			.It Ta Dv SI_KERNEL Ta
	signal generated by miscellaneous parts of the kernel			signal generated by miscellaneous parts of the kernel
	.It Ta Dv SI_LWP Ta			.It Ta Dv SI_LWP Ta
	signal sent by			signal sent by
	.Xr pthread_kill 3			.Xr pthread_kill 3
	.El			.El
	.Pp			.Pp
				For synchronous signals,
				.Va si_addr
				is generally set to the address of the faulting instruction.
				However, synchronous signals raised by a faulting memory access such as
				.Dv SIGSEGV
				and
				.Dv SIGBUS
				may report the address of the faulting memory access (if available) in
				.Va si_addr
				instead.
				.Pp
				Sychronous signals set
				.Va si_trapno
				to a machine-dependent trap number.
				.Pp
	In addition, the following signal-specific information is available:			In addition, the following signal-specific information is available:
	.Bl -column ".Dv SIGPOLL" ".Dv CLD_CONTINUED"			.Bl -column ".Dv SIGPOLL" ".Dv CLD_CONTINUED"
	.It Sy Signal Ta Sy Member Ta Sy Value			.It Sy Signal Ta Sy Member Ta Sy Value
	.It Dv SIGILL Ta Va si_addr Ta
	address of faulting instruction
	.It Ta Va si_trapno Ta
	machine dependent of trap code
	.It Dv SIGFPE Ta Va si_addr Ta
	address of faulting instruction
	.It Ta Va si_trapno Ta
	machine dependent of trap code
	.It Dv SIGSEGV Ta Va si_addr Ta
	address of faulting memory reference
	.It Ta Va si_trapno Ta
	machine dependent of trap code
	.It Dv SIGBUS Ta Va si_addr Ta
	address of faulting instruction
	.It Ta Va si_trapno Ta
	machine dependent of trap code
	.It Dv SIGCHLD Ta Va si_pid Ta			.It Dv SIGCHLD Ta Va si_pid Ta
	child process ID			child process ID
	.It Ta Va si_status Ta			.It Ta Va si_status Ta
	exit value or signal; if			exit value or signal; if
	.Va si_code			.Va si_code
	is equal to			is equal to
	.Dv CLD_EXITED ,			.Dv CLD_EXITED ,
	then it is equal to the exit value of the child process, otherwise,			then it is equal to the exit value of the child process, otherwise,
	▲ Show 20 Lines • Show All 107 Lines • Show Last 20 Lines