Bug 35967

Summary: rc.conf(5) manual missing "dumpdir" and "savecore_flags", etc.
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Gary W. Swearingen 2002-03-16 06:10:01 UTC
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.

================

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".
How-To-Repeat: n/a
================
Comment 1 Murray Stokely freebsd_committer freebsd_triage 2002-03-27 11:41:49 UTC
State Changed
From-To: open->feedback

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.
Comment 2 Jeroen Ruigrok van der Werven freebsd_committer freebsd_triage 2002-04-05 22:46:29 UTC
State Changed
From-To: feedback->open

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.
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-07-15 03:21:54 UTC
State Changed
From-To: open->patched

"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 :) 


Comment 4 Giorgos Keramidas freebsd_committer freebsd_triage 2002-07-15 03:21:54 UTC
Responsible Changed
From-To: freebsd-doc->keramida

I'll handle the MFC.
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2002-08-24 01:22:24 UTC
State Changed
From-To: patched->closed

Merged to STABLE.