From owner-svn-src-head@FreeBSD.ORG  Fri Sep 14 22:10:02 2012
Return-Path: <owner-svn-src-head@FreeBSD.ORG>
Delivered-To: svn-src-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 6EBA2106566B;
	Fri, 14 Sep 2012 22:10:02 +0000 (UTC)
	(envelope-from jilles@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 553F98FC0C;
	Fri, 14 Sep 2012 22:10:02 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q8EMA2X8019131;
	Fri, 14 Sep 2012 22:10:02 GMT (envelope-from jilles@svn.freebsd.org)
Received: (from jilles@localhost)
	by svn.freebsd.org (8.14.4/8.14.4/Submit) id q8EMA2Oc019130;
	Fri, 14 Sep 2012 22:10:02 GMT (envelope-from jilles@svn.freebsd.org)
Message-Id: <201209142210.q8EMA2Oc019130@svn.freebsd.org>
From: Jilles Tjoelker <jilles@FreeBSD.org>
Date: Fri, 14 Sep 2012 22:10:02 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-head@freebsd.org
X-SVN-Group: head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r240523 - head/share/man/man3
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
	<svn-src-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Sep 2012 22:10:02 -0000

Author: jilles
Date: Fri Sep 14 22:10:01 2012
New Revision: 240523
URL: http://svn.freebsd.org/changeset/base/240523

Log:
  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

Modified:
  head/share/man/man3/siginfo.3

Modified: head/share/man/man3/siginfo.3
==============================================================================
--- head/share/man/man3/siginfo.3	Fri Sep 14 22:05:09 2012	(r240522)
+++ head/share/man/man3/siginfo.3	Fri Sep 14 22:10:01 2012	(r240523)
@@ -197,6 +197,9 @@ signal generated by completion of an asy
 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
+.It Ta Dv SI_LWP Ta
+signal sent by
+.Xr pthread_kill 3
 .El
 .Pp
 In addition, the following signal-specific information is available:
@@ -273,6 +276,10 @@ the value passed to
 system call
 .It Ta Va si_mqd Ta
 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
 .Sh NOTES
 Currently, the kernel never generates the
@@ -284,9 +291,10 @@ signal is queued when a process changed 
 Realtime Extensions like aio, timer, and message queue also queue
 signals.
 Signals with code
-.Dv SI_USER
-or
+.Dv SI_USER ,
 .Dv SI_KERNEL
+or
+.Dv SI_LWP
 are only queued if there are sufficient resources;
 otherwise,
 .Dv SI_NOINFO
@@ -321,6 +329,10 @@ and
 .Dv SI_KERNEL
 can be generated as of
 .Fx 8.1 .
+The code
+.Dv SI_LWP
+can be generated as of
+.Fx 9.0 .
 .Sh AUTHORS
 This manual page was written by
 .An "David Xu" Aq davidxu@FreeBSD.org .