bin/80566: bad docs for rc.conf => no kernel core dump

[Palle Girgensohn]

>Number:         80566
>Category:       bin
>Synopsis:       bad docs for rc.conf => no kernel core dump
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 02 23:00:22 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Palle Girgensohn <girgen at FreeBSD.org>
>Release:        FreeBSD 5.4-RC i386
>Organization:
Ping Pong AB
>Environment:
System: FreeBSD palle.girgensohn.se 5.4-RC1 FreeBSD 5.4-RC1 #20: Fri Apr  8 01:03:54 CEST 2005     girgen at palle.girgensohn.se:/usr/obj/4/usr/5src/sys/PALLE  i386


	
>Description:
In man page for rc.conf:

     dumpdev     (str) Indicates the device (usually a swap partition) to
                 which a crash dump should be written in the event of a system
                 crash.  If the value of this variable is ``AUTO'', the first
                 suitable swap device listed in /etc/fstab will be used as
                 dump device.  Otherwise, the value of this variable is passed
                 as the argument to dumpon(8).  To disable crash dumps, set
                 this variable to ``NO''.

Problem is, the AUTO switch is no implemented, neither for
/etc/rc.d/savecore nor /etc/rc.d/dumpon. (it is in 6-current, but not
in 5.4-stable)

>How-To-Repeat:
set dumpdev="AUTO" in /etc/rc.onf
crash machine
there will be an error when trying to retrieve the kernel dump
>Fix:
Either MFC the auto stuff for the named rc.d scripts (best), or apply
this trivial man page patch:

Index: rc.conf.5
===================================================================
RCS file: /misc/ncvs/src/share/man/man5/rc.conf.5,v
retrieving revision 1.221.2.11
diff -u -r1.221.2.11 rc.conf.5
--- rc.conf.5	17 Mar 2005 00:04:45 -0000	1.221.2.11
+++ rc.conf.5	29 Apr 2005 20:21:29 -0000
@@ -2487,12 +2487,7 @@
 .Pq Vt str
 Indicates the device (usually a swap partition) to which a crash dump
 should be written in the event of a system crash.
-If the value of this variable is
-.Dq Li AUTO ,
-the first suitable swap device listed in
-.Pa /etc/fstab
-will be used as dump device.
-Otherwise, the value of this variable is passed as the argument to
+The value of this variable is passed as the argument to
 .Xr dumpon 8 .
 To disable crash dumps, set this variable to
 .Dq Li NO .
>Release-Note:
>Audit-Trail:
>Unformatted: