Bug 14449 - Ambiguity in SIGSYS <-> SIGUNUSED portion of signal(7)
Summary: Ambiguity in SIGSYS <-> SIGUNUSED portion of signal(7)
Status: RESOLVED CODE_FIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 low
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL: http://www.nabble.com/New-test-%3A-sn...
Keywords:
Depends on:
Blocks:
 
Reported: 2009-10-21 05:34 UTC by Garrett Cooper
Modified: 2010-08-31 04:30 UTC (History)
2 users (show)

See Also:
Kernel Version: 2.6.30-gentoo-r4
Subsystem:
Regression: No
Bisected commit-id:


Attachments
Application driven by the sniperkill script. (2.31 KB, text/x-csrc)
2009-10-21 05:34 UTC, Garrett Cooper
Details
Execution log for kernel specified. (28.95 KB, text/x-log)
2009-10-21 05:35 UTC, Garrett Cooper
Details
Driver script for killme application (8.46 KB, application/x-shellscript)
2009-10-21 05:35 UTC, Garrett Cooper
Details

Description Garrett Cooper 2009-10-21 05:34:35 UTC
Created attachment 23482 [details]
Application driven by the sniperkill script.

signal(7) states that signal # 31 for ppc, *86, etc should result in termination only, in the 3rd column, but the `will be SIGSYS' comment is unnecessarily ambiguous:

       SIGUNUSED    -,31,-     Term    Unused signal (will be SIGSYS)

       SIGSYS      12,-,12     Core    Bad argument to routine (SVID)

The behavior as shown in my log for the `sniperkill' test I've recommended adding to LTP demonstrates that the behavior for SIGUNUSED matches SIGSYS.

The documentation for SIGUNUSED should either clearly state a) that the process will `Core'-dump, and/or the indirection should be changed such that SIGUNUSED directly maps to SIGSYS.

I've attached the logs and test. The email to ltp-list is in the URL field.
Comment 1 Garrett Cooper 2009-10-21 05:35:07 UTC
Created attachment 23483 [details]
Execution log for kernel specified.
Comment 2 Garrett Cooper 2009-10-21 05:35:34 UTC
Created attachment 23484 [details]
Driver script for killme application
Comment 3 Michael Kerrisk 2010-02-03 05:55:18 UTC
Thanks for this report. I applied the patch below. Satisfactory?

--- a/man7/signal.7
+++ b/man7/signal.7
@@ -270,7 +270,7 @@ SIGBUS      10,7,10 Core    Bus error (bad memory access)
 SIGPOLL                Term    Pollable event (Sys V).
                        Synonym for \fBSIGIO\fP
 SIGPROF        27,27,29        Term    Profiling timer expired
-SIGSYS 12,\-,12        Core    Bad argument to routine (SVr4)
+SIGSYS 12,31,12        Core    Bad argument to routine (SVr4)
 SIGTRAP        5       Core    Trace/breakpoint trap
 SIGURG 16,23,21        Ign     Urgent condition on socket (4.2BSD)
 SIGVTALRM      26,26,28        Term    Virtual alarm clock (4.2BSD)
@@ -304,7 +304,7 @@ SIGPWR      29,30,19        Term    Power failure (System V)
 SIGINFO        29,\-,\-                A synonym for \fBSIGPWR\fP
 SIGLOST        \-,\-,\-        Term    File lock lost
 SIGWINCH       28,28,20        Ign     Window resize signal (4.3BSD, Sun)
-SIGUNUSED      \-,31,\-        Term    Unused signal (will be \fBSIGSYS\fP)
+SIGUNUSED      \-,31,\-        Core    Synonymous with \fBSIGSYS\fP
 .TE

 (Signal 29 is
@@ -328,6 +328,13 @@ by default on those other Unix systems where it appears.
 .B SIGIO
 (which is not specified in POSIX.1-2001) is ignored by default
 on several other Unix systems.
+
+Where defined,
+.B SIGUNUSED
+is synonymous with
+.\" parisc is the only exception: SIGSYS is 12, SIGUNUSED is 31
+.B SIGSYS
+on most architectures.
 .SS "Real-time Signals"
 Linux supports real-time signals as originally defined in the POSIX.1b
 real-time extensions (and now included in POSIX.1-2001).
Comment 4 Garrett Cooper 2010-02-08 01:40:43 UTC
Sounds good -- thanks!

Note You need to log in before you can comment on or make changes to this bug.