From owner-freebsd-doc@FreeBSD.ORG Mon Dec 8 03:00:42 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E4ABD16A4CE for ; Mon, 8 Dec 2003 03:00:41 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5FE2243F75 for ; Mon, 8 Dec 2003 03:00:34 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id hB8B0YFY047204 for ; Mon, 8 Dec 2003 03:00:34 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id hB8B0YUM047203; Mon, 8 Dec 2003 03:00:34 -0800 (PST) (envelope-from gnats) Resent-Date: Mon, 8 Dec 2003 03:00:34 -0800 (PST) Resent-Message-Id: <200312081100.hB8B0YUM047203@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Stefan Farfeleder 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: stefan@fafoe.narf.at cc: jeff@FreeBSD.org Subject: docs/60044: [patch] Add signal numbers to signal(3) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Stefan Farfeleder List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Dec 2003 11:00:42 -0000 >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: