siginfo(3): Document SI_LWP signal code.

Describe SI_LWP as being generated by pthread_kill() because thr_kill() is
a private undocumented function.

MFC after:	1 week
This commit is contained in:
Jilles Tjoelker 2012-09-14 22:10:01 +00:00
parent a4c22c274e
commit 5437c0d6ea
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=240523

View File

@ -197,6 +197,9 @@ signal generated by completion of an asynchronous I/O request
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
signal sent by
.Xr pthread_kill 3
.El .El
.Pp .Pp
In addition, the following signal-specific information is available: In addition, the following signal-specific information is available:
@ -273,6 +276,10 @@ the value passed to
system call system call
.It Ta Va si_mqd Ta .It Ta Va si_mqd Ta
the ID of the message queue which generated the signal the ID of the message queue which generated the signal
.It Dv SI_LWP Ta Va si_pid Ta
the process ID that sent the signal
.It Ta Va si_uid Ta
real user ID of the process that sent the signal
.El .El
.Sh NOTES .Sh NOTES
Currently, the kernel never generates the Currently, the kernel never generates the
@ -284,9 +291,10 @@ signal is queued when a process changed its status or exited.
Realtime Extensions like aio, timer, and message queue also queue Realtime Extensions like aio, timer, and message queue also queue
signals. signals.
Signals with code Signals with code
.Dv SI_USER .Dv SI_USER ,
or
.Dv SI_KERNEL .Dv SI_KERNEL
or
.Dv SI_LWP
are only queued if there are sufficient resources; are only queued if there are sufficient resources;
otherwise, otherwise,
.Dv SI_NOINFO .Dv SI_NOINFO
@ -321,6 +329,10 @@ and
.Dv SI_KERNEL .Dv SI_KERNEL
can be generated as of can be generated as of
.Fx 8.1 . .Fx 8.1 .
The code
.Dv SI_LWP
can be generated as of
.Fx 9.0 .
.Sh AUTHORS .Sh AUTHORS
This manual page was written by This manual page was written by
.An "David Xu" Aq davidxu@FreeBSD.org . .An "David Xu" Aq davidxu@FreeBSD.org .