Skip to contentSkip to conversation

tkill.2: document EAGAIN error for real-time signals

PATCH In review Jann Horn 2 participants 2 messages Feb 6, 2017 – Feb 8, 2017 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Jann Horn

author
#0 lore raw

PATCH 1/1 tkill.2: document EAGAIN error for real-time signals

See __send_signal() in kernel/signal.c:

if (sig >= SIGRTMIN && info->si_code != SI_USER) {
/*
* Queue overflow, abort. We may abort if the
* signal was rt and sent by user using something
* other than kill().
*/
result = TRACE_SIGNAL_OVERFLOW_FAIL;
ret = -EAGAIN;
goto ret;
}

(kill() uses SI_USER, but tkill() and tgkill() use SI_TKILL.)

---
 man2/tkill.2 | 12 ++++++++++++
 1 file changed, 12 insertions(+)
man2/tkill.2 +12 -0
index a61ef3182..dce5dd94c 100644
@@ -103,6 +103,18 @@ For the required permissions, see
 .TP
 .B ESRCH
 No process with the specified thread ID (and thread group ID) exists.
+.TP
+.B EAGAIN
+The
+.B RLIMIT_SIGPENDING
+resource limit was reached and
+.I sig
+is a real-time signal.
+.TP
+.B EAGAIN
+Insufficient kernel memory was available and
+.I sig
+is a real-time signal.
 .SH VERSIONS
 .BR tkill ()
 is supported since Linux 2.4.19 / 2.5.4.
Signature · 6 lines
2.11.0.483.g087da7b7c-goog

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): 20170206155748.66643-1-jannh-hpIqsD4AKlfQT0dZR+AlfA@public.gmane.org

#2 lore raw
Quoted 1 line · Jann Horn

See __send_signal() in kernel/signal.c:

Thanks, Jann. Patch applied.

Cheers,

Michael

Quoted 42 lines

if (sig >= SIGRTMIN && info->si_code != SI_USER) {
/*
* Queue overflow, abort. We may abort if the
* signal was rt and sent by user using something
* other than kill().
*/
result = TRACE_SIGNAL_OVERFLOW_FAIL;
ret = -EAGAIN;
goto ret;
}

(kill() uses SI_USER, but tkill() and tgkill() use SI_TKILL.)

---
 man2/tkill.2 | 12 ++++++++++++
 1 file changed, 12 insertions(+)
man2/tkill.2 +12 -0
index a61ef3182..dce5dd94c 100644
@@ -103,6 +103,18 @@ For the required permissions, see
 .TP
 .B ESRCH
 No process with the specified thread ID (and thread group ID) exists.
+.TP
+.B EAGAIN
+The
+.B RLIMIT_SIGPENDING
+resource limit was reached and
+.I sig
+is a real-time signal.
+.TP
+.B EAGAIN
+Insufficient kernel memory was available and
+.I sig
+is a real-time signal.
 .SH VERSIONS
 .BR tkill ()
 is supported since Linux 2.4.19 / 2.5.4.
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html