From stefan@fafoe.narf.at Mon Dec 8 02:54:39 2003 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4B7BC16A4CE; Mon, 8 Dec 2003 02:54:39 -0800 (PST) Received: from fafoe.narf.at (chello212186121237.14.vie.surfer.at [212.186.121.237]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1BE1343FDD; Mon, 8 Dec 2003 02:54:26 -0800 (PST) (envelope-from stefan@fafoe.narf.at) Received: from wombat.fafoe.narf.at (wombat.fafoe.narf.at [192.168.1.42]) by fafoe.narf.at (Postfix) with ESMTP id 1A67D3FA9; Mon, 8 Dec 2003 11:54:22 +0100 (CET) Received: by wombat.fafoe.narf.at (Postfix, from userid 1001) id 9992F1B3; Mon, 8 Dec 2003 11:54:21 +0100 (CET) Message-Id: <20031208105421.9992F1B3@wombat.fafoe.narf.at> Date: Mon, 8 Dec 2003 11:54:21 +0100 (CET) From: Stefan Farfeleder Reply-To: Stefan Farfeleder To: FreeBSD-gnats-submit@freebsd.org Cc: stefan@fafoe.narf.at, jeff@FreeBSD.org Subject: [patch] Add signal numbers to signal(3) X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 60044 >Category: docs >Synopsis: [patch] Add signal numbers to signal(3) >Confidential: no >Severity: non-critical >Priority: low >Responsible: josef >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon Dec 08 03:00:33 PST 2003 >Closed-Date: Mon Mar 01 13:57:31 PST 2004 >Last-Modified: Mon Mar 01 13:57:31 PST 2004 >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: Responsible-Changed-From-To: freebsd-doc->josef Responsible-Changed-By: josef Responsible-Changed-When: Tue Jan 20 14:46:30 PST 2004 Responsible-Changed-Why: I'll take this one, stefan is local friend of mine. http://www.freebsd.org/cgi/query-pr.cgi?pr=60044 State-Changed-From-To: open->closed State-Changed-By: josef State-Changed-When: Mon Feb 23 05:21:16 PST 2004 State-Changed-Why: Committed, thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=60044 State-Changed-From-To: closed->patched State-Changed-By: josef State-Changed-When: Mon Feb 23 05:30:32 PST 2004 State-Changed-Why: Committed to -CURRENT. I will MFC later. http://www.freebsd.org/cgi/query-pr.cgi?pr=60044 State-Changed-From-To: patched->closed State-Changed-By: josef State-Changed-When: Mon Mar 1 13:57:12 PST 2004 State-Changed-Why: MFC done, thanks again stefanf. http://www.freebsd.org/cgi/query-pr.cgi?pr=60044 >Unformatted: