docs/151854: table of operations in kdump(1) manpage lists GENIO and SIG instead of GIO and PSIG

Stephen Veiss stephen at brokenbottle.net
Mon Nov 1 02:00:19 UTC 2010


>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 at 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:



More information about the freebsd-doc mailing list