git: afc8b17816e4 - stable/14 - sigqueue(2): Document __SIGQUEUE_TID

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Tue, 30 Apr 2024 00:48:59 UTC
The branch stable/14 has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=afc8b17816e49cd3d318c8760452d8f1e5b898a6

commit afc8b17816e49cd3d318c8760452d8f1e5b898a6
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2024-04-20 21:58:15 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-04-30 00:48:09 +0000

    sigqueue(2): Document __SIGQUEUE_TID
    
    (cherry picked from commit dcc180c51b9c13df3d1158d14d450308711fe93c)
---
 lib/libc/sys/sigqueue.2 | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/lib/libc/sys/sigqueue.2 b/lib/libc/sys/sigqueue.2
index 5b154efa20fd..2fac63610ac7 100644
--- a/lib/libc/sys/sigqueue.2
+++ b/lib/libc/sys/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 ,