[Midnightbsd-cvs] src [8093] trunk/share/man/man3/siginfo.3: document signal codes

[laffer1 at midnightbsd.org]

Revision: 8093
          http://svnweb.midnightbsd.org/src/?rev=8093
Author:   laffer1
Date:     2016-09-15 18:50:59 -0400 (Thu, 15 Sep 2016)
Log Message:
-----------
document signal codes

Modified Paths:
--------------
    trunk/share/man/man3/siginfo.3

Modified: trunk/share/man/man3/siginfo.3
===================================================================
--- trunk/share/man/man3/siginfo.3	2016-09-15 22:50:15 UTC (rev 8092)
+++ trunk/share/man/man3/siginfo.3	2016-09-15 22:50:59 UTC (rev 8093)
@@ -195,6 +195,8 @@
 signal generated by completion of an asynchronous I/O request
 .It Ta Dv SI_MESGQ Ta
 signal generated by arrival of a message on an empty message queue
+.It Ta Dv SI_KERNEL Ta
+signal generated by miscellaneous parts of the kernel
 .El
 .Pp
 In addition, the following signal-specific information is available:
@@ -235,6 +237,10 @@
 Finally, the following code-specific information is available:
 .Bl -column ".Dv SI_QUEUE" ".Va si_overrun"
 .It Sy "Code	Member	Value"
+.It Dv SI_USER 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
 .It Dv SI_QUEUE Ta Va si_value Ta
 the value passed to
 .Xr sigqueue 2
@@ -277,6 +283,14 @@
 .Tn POSIX
 Realtime Extensions like aio, timer, and message queue also queue
 signals.
+Signals with code
+.Dv SI_USER
+or
+.Dv SI_KERNEL
+are only queued if there are sufficient resources;
+otherwise,
+.Dv SI_NOINFO
+results.
 For some hardware architectures, the exact value of
 .Va si_addr
 might not be available.
@@ -289,7 +303,8 @@
 .Xr sigwaitinfo 2 ,
 .Xr timer_create 2 ,
 .Xr timer_settime 2 ,
-.Xr waitpid 2
+.Xr waitpid 2 ,
+.Xr pthread_kill 3
 .Sh STANDARDS
 The
 .Vt siginfo_t
@@ -300,6 +315,12 @@
 .Tn POSIX
 signal information first appeared in
 .Fx 7.0 .
+The codes
+.Dv SI_USER
+and
+.Dv SI_KERNEL
+can be generated as of
+.Fx 8.1 .
 .Sh AUTHORS
 This manual page was written by
 .An "David Xu" Aq davidxu at FreeBSD.org .