From dcc180c51b9c13df3d1158d14d450308711fe93c Mon Sep 17 00:00:00 2001
From: Konstantin Belousov <kib@FreeBSD.org>
Date: Sun, 21 Apr 2024 00:58:15 +0300
Subject: [PATCH] sigqueue(2): Document __SIGQUEUE_TID

Reviewed by:	markj
Sponsored by:	The FreeBSD Foundation
MFC after:	1 week
Differential revision:	https://reviews.freebsd.org/D44867
---
 lib/libsys/sigqueue.2 | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/lib/libsys/sigqueue.2 b/lib/libsys/sigqueue.2
index 5b154efa20fd..2fac63610ac7 100644
--- a/lib/libsys/sigqueue.2
+++ b/lib/libsys/sigqueue.2
@@ -25,7 +25,7 @@
 .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 5, 2017
+.Dd April 21, 2024
 .Dt SIGQUEUE 2
 .Os
 .Sh NAME
@@ -96,6 +96,19 @@ be selected for delivery, it is the lowest numbered
 one.
 The selection order between realtime and non-realtime signals, or
 between multiple pending non-realtime signals, is unspecified.
+.Pp
+As a
+.Fx
+extension, the value of
+.Fa signo
+can be or-ed with the following flags:
+.Bl -tag -width __SIGQUEUE_TID
+.It Dv __SIGQUEUE_TID
+The
+.Fa pid
+parameter is the thread identifier of a thread in the current process,
+and the specified signal is queued into the specified thread' queue.
+.El
 .Sh RETURN VALUES
 .Rv -std
 .Sh ERRORS
@@ -122,6 +135,10 @@ to the receiving process.
 The process
 .Fa pid
 does not exist.
+.It Bq Er ESRCH
+The thread with id
+.Fa pid
+does not exist in the current process.
 .El
 .Sh SEE ALSO
 .Xr kill 2 ,