From owner-freebsd-doc@FreeBSD.ORG Mon Nov 1 02:00:19 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BC0BD1065672 for ; Mon, 1 Nov 2010 02:00:19 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 77A728FC14 for ; Mon, 1 Nov 2010 02:00:19 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oA120J7r008547 for ; Mon, 1 Nov 2010 02:00:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oA120JGG008546; Mon, 1 Nov 2010 02:00:19 GMT (envelope-from gnats) Resent-Date: Mon, 1 Nov 2010 02:00:19 GMT Resent-Message-Id: <201011010200.oA120JGG008546@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, Stephen Veiss Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B4B89106566C for ; Mon, 1 Nov 2010 01:54:21 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 8800A8FC0A for ; Mon, 1 Nov 2010 01:54:21 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id oA11sLXN018212 for ; Mon, 1 Nov 2010 01:54:21 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id oA11sL7X018211; Mon, 1 Nov 2010 01:54:21 GMT (envelope-from nobody) Message-Id: <201011010154.oA11sL7X018211@www.freebsd.org> Date: Mon, 1 Nov 2010 01:54:21 GMT From: Stephen Veiss To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/151854: table of operations in kdump(1) manpage lists GENIO and SIG instead of GIO and PSIG X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 01 Nov 2010 02:00:19 -0000 >Number: 151854 >Category: docs >Synopsis: table of operations in kdump(1) manpage lists GENIO and SIG instead of GIO and PSIG >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Nov 01 02:00:19 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Stephen Veiss >Release: 8.1-RELEASE >Organization: >Environment: FreeBSD freebsdvm.home.brokenbottle.net 8.1-RELEASE FreeBSD 8.1-RELEASE #0: Mon Jul 19 02:36:49 UTC 2010 root@mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64 >Description: The manpage for kdump(1) contains a table of operation abbreviations, used in the output of kdump(1). Two of these abbreviations are wrong -- the manpage does not match the output of kdump(1). The manpage lists GENIO and SIG, while kdump(1) actually outputs GIO and PSIG respectively. I've attached a patch to the manpage to fix this. >How-To-Repeat: ktrace(1) a program which performs IO and receives a signal. kdump(1) the output, note that kdump lists operations of type GIO and PSIG. Check man 1 kdump, note that GIO and PSIG aren't listed in the table of operations near the bottom. GENIO and SIG are, however. >Fix: Attached patch, against HEAD. Patch attached with submission follows: Index: usr.bin/kdump/kdump.1 =================================================================== --- usr.bin/kdump/kdump.1 (revision 214612) +++ usr.bin/kdump/kdump.1 (working copy) @@ -162,13 +162,13 @@ system call, so 7 is the return value. .Pp The possible operations are: -.Bl -column -offset indent ".Li GENIO" ".No data from user process" +.Bl -column -offset indent ".Li CALL" ".No data from user process" .It Sy Name Ta Sy Operation Ta Sy Fourth field .It Li CALL Ta enter syscall Ta syscall name and arguments .It Li RET Ta return from syscall Ta syscall name and return value .It Li NAMI Ta file name lookup Ta path to file -.It Li GENIO Ta general I/O Ta fd, read/write, number of bytes -.It Li SIG Ta signal Ta signal name, handler, mask, code +.It Li GIO Ta general I/O Ta fd, read/write, number of bytes +.It Li PSIG Ta signal Ta signal name, handler, mask, code .It Li CSW Ta context switch Ta stop/resume user/kernel .It Li USER Ta data from user process Ta the data .It Li STRU Ta various syscalls Ta structure >Release-Note: >Audit-Trail: >Unformatted: