From 7f44382938335a7607923631d5effd30c8b08c03 Mon Sep 17 00:00:00 2001 From: Craig Small Date: Fri, 24 Apr 2020 19:29:34 +1000 Subject: [PATCH] kill: Adjust documentation for sigqueue Added NEWS item Changed the section for sigqueue as its 3 for me. --- NEWS | 1 + kill.1 | 13 +++++++++++++ 2 files changed, 14 insertions(+) diff --git a/NEWS b/NEWS index 58e689cd..feef020c 100644 --- a/NEWS +++ b/NEWS @@ -1,5 +1,6 @@ procps-ng NEXT -------------- + * kill: Pass int to signalled process merge #32 * pgrep: Check sanity of SG_ARG_MAX issue #152 * pidof: show worker threads Redhat #1803640 * ps.1: Mention stime alias issue #164 diff --git a/kill.1 b/kill.1 index a487f917..62be918d 100644 --- a/kill.1 +++ b/kill.1 @@ -44,6 +44,18 @@ The behavior of signals is explained in .BR signal (7) manual page. .TP +\fB\-q\fR, \fB\-\-queue \fIvalue\fP +Use +.BR sigqueue(3) +rather than +.BR kill(2) +and the value argument is used to specify +an integer to be sent with the signal. If the receiving process has +installed a handler for this signal using the SA_SIGINFO flag to +.BR sigaction(2) +, then it can obtain this data via the si_value field of the +siginfo_t structure. +.TP \fB\-l\fR, \fB\-\-list\fR [\fIsignal\fR] List signal names. This option has optional argument, which will convert signal number to signal name, or other way round. @@ -76,6 +88,7 @@ Send the default signal, SIGTERM, to all those processes. .BR pkill (1), .BR renice (1), .BR signal (7), +.BR sigqueue (3), .BR skill (1) .SH STANDARDS This command meets appropriate standards. The