Skip site navigation (1)Skip section navigation (2)
Date:      Mon,  8 Dec 2003 11:54:21 +0100 (CET)
From:      Stefan Farfeleder <stefan@fafoe.narf.at>
To:        FreeBSD-gnats-submit@FreeBSD.org
Cc:        jeff@FreeBSD.org
Subject:   docs/60044: [patch] Add signal numbers to signal(3)
Message-ID:  <20031208105421.9992F1B3@wombat.fafoe.narf.at>
Resent-Message-ID: <200312081100.hB8B0YUM047203@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         60044
>Category:       docs
>Synopsis:       [patch] Add signal numbers to signal(3)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 08 03:00:33 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Stefan Farfeleder
>Release:        FreeBSD 5.2-BETA i386
>Organization:
>Environment:
System: FreeBSD wombat.fafoe.narf.at 5.2-BETA FreeBSD 5.2-BETA #8: Sat Dec 6 18:47:24 CET 2003 stefan@wombat.fafoe.narf.at:/usr/home/stefan/freebsd/obj/usr/home/stefan/freebsd/src/sys/WOMBAT i386
	
>Description:
This patch adds a signal number row to the existing ones for the name, the
default action and the description in the signal(3) man page.  I keep
forgetting those numbers regularly and always wanted something like
errno(2)/intro(2) does for errno for signals too.  While being there, I added
a line for SIGTHR and took the liberty to CC Jeff to ask if the entry is OK
with him.

>How-To-Repeat:
n/a

>Fix:
I have almost no experience with mdoc stuff, so please bear with me :)

--- signal.3.diff begins here ---
Index: src/lib/libc/gen/signal.3
===================================================================
RCS file: /usr/home/ncvs/src/lib/libc/gen/signal.3,v
retrieving revision 1.33
diff -u -r1.33 signal.3
--- src/lib/libc/gen/signal.3	8 Sep 2003 19:57:14 -0000	1.33
+++ src/lib/libc/gen/signal.3	8 Dec 2003 10:24:49 -0000
@@ -90,47 +90,50 @@
 an interrupt.
 These signals are defined in the file
 .In signal.h :
-.Bl -column SIGVTALARMXX "create core imagexxx"
-.It Sy "Name	Default Action	Description"
-.It Dv SIGHUP Ta "terminate process" Ta "terminal line hangup"
-.It Dv SIGINT Ta "terminate process" Ta "interrupt program"
-.It Dv SIGQUIT Ta "create core image" Ta "quit program"
-.It Dv SIGILL Ta "create core image" Ta "illegal instruction"
-.It Dv SIGTRAP Ta "create core image" Ta "trace trap"
-.It Dv SIGABRT Ta "create core image" Ta "abort program"
+.Bl -column No SIGVTALRM "create core imagex"
+.It Sy "No	Name	Default Action	Description"
+.It Dv 1 Ta SIGHUP Ta "terminate process" Ta "terminal line hangup"
+.It Dv 2 Ta SIGINT Ta "terminate process" Ta "interrupt program"
+.It Dv 3 Ta SIGQUIT Ta "create core image" Ta "quit program"
+.It Dv 4 Ta SIGILL Ta "create core image" Ta "illegal instruction"
+.It Dv 5 Ta SIGTRAP Ta "create core image" Ta "trace trap"
+.It Dv 6 Ta SIGABRT Ta "create core image" Ta "abort program"
 (formerly
 .Dv SIGIOT )
-.It Dv SIGEMT Ta "create core image" Ta "emulate instruction executed"
-.It Dv SIGFPE Ta "create core image" Ta "floating-point exception"
-.It Dv SIGKILL Ta "terminate process" Ta "kill program"
-.It Dv SIGBUS Ta "create core image" Ta "bus error"
-.It Dv SIGSEGV Ta "create core image" Ta "segmentation violation"
-.It Dv SIGSYS Ta "create core image" Ta "non-existent system call invoked"
-.It Dv SIGPIPE Ta "terminate process" Ta "write on a pipe with no reader"
-.It Dv SIGALRM Ta "terminate process" Ta "real-time timer expired"
-.It Dv SIGTERM Ta "terminate process" Ta "software termination signal"
-.It Dv SIGURG Ta "discard signal" Ta "urgent condition present on socket"
-.It Dv SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)"
-.It Dv SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard"
-.It Dv SIGCONT Ta "discard signal" Ta "continue after stop"
-.It Dv SIGCHLD Ta "discard signal" Ta "child status has changed"
-.It Dv SIGTTIN Ta "stop process" Ta "background read attempted from control terminal"
-.It Dv SIGTTOU Ta "stop process" Ta "background write attempted to control terminal"
-.It Dv SIGIO Ta "discard signal" Ta Tn "I/O"
+.It Dv 7 Ta SIGEMT Ta "create core image" Ta "emulate instruction executed"
+.It Dv 8 Ta SIGFPE Ta "create core image" Ta "floating-point exception"
+.It Dv 9 Ta SIGKILL Ta "terminate process" Ta "kill program"
+.It Dv 10 Ta SIGBUS Ta "create core image" Ta "bus error"
+.It Dv 11 Ta SIGSEGV Ta "create core image" Ta "segmentation violation"
+.It Dv 12 Ta SIGSYS Ta "create core image" Ta "non-existent system call invoked"
+.It Dv 13 Ta SIGPIPE Ta "terminate process" Ta "write on a pipe with no reader"
+.It Dv 14 Ta SIGALRM Ta "terminate process" Ta "real-time timer expired"
+.It Dv 15 Ta SIGTERM Ta "terminate process" Ta "software termination signal"
+.It Dv 16 Ta SIGURG Ta "discard signal" Ta "urgent condition present on socket"
+.It Dv 17 Ta SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)"
+.It Dv 18 Ta SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard"
+.It Dv 19 Ta SIGCONT Ta "discard signal" Ta "continue after stop"
+.It Dv 20 Ta SIGCHLD Ta "discard signal" Ta "child status has changed"
+.It Dv 21 Ta SIGTTIN Ta "stop process" Ta "background read attempted from"
+control terminal
+.It Dv 22 Ta SIGTTOU Ta "stop process" Ta "background write attempted to"
+control terminal
+.It Dv 23 Ta SIGIO Ta "discard signal" Ta Tn "I/O"
 is possible on a descriptor (see
 .Xr fcntl 2 )
-.It Dv SIGXCPU Ta "terminate process" Ta "cpu time limit exceeded (see"
+.It Dv 24 Ta SIGXCPU Ta "terminate process" Ta "cpu time limit exceeded (see"
 .Xr setrlimit 2 )
-.It Dv SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see"
+.It Dv 25 Ta SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see"
 .Xr setrlimit 2 )
-.It Dv SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see"
+.It Dv 26 Ta SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see"
 .Xr setitimer 2 )
-.It Dv SIGPROF Ta "terminate process" Ta "profiling timer alarm (see"
+.It Dv 27 Ta SIGPROF Ta "terminate process" Ta "profiling timer alarm (see"
 .Xr setitimer 2 )
-.It Dv SIGWINCH Ta "discard signal" Ta "Window size change"
-.It Dv SIGINFO Ta "discard signal" Ta "status request from keyboard"
-.It Dv SIGUSR1 Ta "terminate process" Ta "User defined signal 1"
-.It Dv SIGUSR2 Ta "terminate process" Ta "User defined signal 2"
+.It Dv 28 Ta SIGWINCH Ta "discard signal" Ta "Window size change"
+.It Dv 29 Ta SIGINFO Ta "discard signal" Ta "status request from keyboard"
+.It Dv 30 Ta SIGUSR1 Ta "terminate process" Ta "User defined signal 1"
+.It Dv 31 Ta SIGUSR2 Ta "terminate process" Ta "User defined signal 2"
+.It Dv 32 Ta SIGTHR Ta "terminate process" Ta "thread interrupt"
 .El
 .Pp
 The
--- signal.3.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031208105421.9992F1B3>