From swear@blarg.net  Fri Mar 15 22:08:53 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 681BA37B41A
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 15 Mar 2002 22:08:52 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 1BCE9BD6F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 15 Mar 2002 22:08:52 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id WAA00730
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 15 Mar 2002 22:08:51 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g2G6BZn68994;
	Fri, 15 Mar 2002 22:11:35 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <ctlmctavoo.mct@localhost.localdomain>
Date: 15 Mar 2002 22:11:35 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: rc.conf(5) manual missing "dumpdir" and "savecore_flags", etc.
X-GNATS-Notify:

>Number:         35967
>Category:       docs
>Synopsis:       rc.conf(5) manual missing "dumpdir" and "savecore_flags", etc.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 15 22:10:01 PST 2002
>Closed-Date:    Fri Aug 23 17:22:34 PDT 2002
>Last-Modified:  Fri Aug 23 17:22:34 PDT 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The rc.conf(5) manual is missing "dumpdir" and "savecore_flags" entries
and this "dumpdev" entry needs updating:

  (str) If not set to ''NO'' then point kernel crash-dumps at the swap
  device specified as value.  When the system restarts, a crash-dump
  found on the specified device will typically be stored in the
  /var/crash directory by the savecore(8) program.

================
>How-To-Repeat:
n/a
================
>Fix:

dumpdev

    (str) If not set to ''NO'' then dumpon(8) is used to cause kernel
    crash dumps to be saved in the (usually swap) device specified as
    _value_.  When the system restarts, a crash dump found on the
    specified device will be stored by the savecore(8) program using
    "savecore_flags" in the directory specified by the "dumpdir" value.
    Not effective unless crash occurs after booting with this set.
    See crash(8) manual for related info.

dumpdir

    (str) Specifies the directory where a crash dump will be saved by
    savecore(8) during a post-crash-dump OS boot (if the directory
    exists). See "dumpdev".

savecore_flags

    (str) The options (with leading "-") for savecore(8) to use during
    post-crash-dump OS boot. See "dumpdev".
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: murray 
State-Changed-When: Wed Mar 27 03:41:49 PST 2002 
State-Changed-Why:  
I do see a dumpdir description in rc.conf(5), so it's not clear to me 
what needs to be changed.  Can you please generate a diff against the 
-CURRENT version of the rc.conf man page?  Thanks for all your work 
cleaning up our docs. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=35967 
State-Changed-From-To: feedback->open 
State-Changed-By: asmodai 
State-Changed-When: Fri Apr 5 13:46:29 PST 2002 
State-Changed-Why:  
Gary was pointing his patch at STABLE, where the descriptions introduced 
by DES end last year didn't migrate to. 

Gary, I would like to work a bit on the rc.conf manual page with you if 
possible, since changing these three entries leaves a bit taste in my 
mouth with regard to inconsistent style throughout the entire document. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35967 
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Sun Jul 14 19:21:54 PDT 2002 
State-Changed-Why:  
"dumpdir" as already documented by the time I saw this. 
I've added a description of "savecore_flags" to rc.conf(5). 
Thanks for submitting this :) 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Sun Jul 14 19:21:54 PDT 2002 
Responsible-Changed-Why:  
I'll handle the MFC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35967 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Fri Aug 23 17:22:24 PDT 2002 
State-Changed-Why:  
Merged to STABLE. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=35967 
>Unformatted:
