From owner-freebsd-doc  Thu Mar 28 21:50:11 2002
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0C37537B41B
	for <freebsd-doc@hub.freebsd.org>; Thu, 28 Mar 2002 21:50:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g2T5o1B12056;
	Thu, 28 Mar 2002 21:50:01 -0800 (PST)
	(envelope-from gnats)
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id BF3AD37B435
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2002 21:43:09 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id B9E93BD29
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2002 21:42:51 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id VAA16037
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2002 21:42:51 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g2T5fPk00506;
	Thu, 28 Mar 2002 21:41:25 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <i4eli4exrv.li4@localhost.localdomain>
Date: 28 Mar 2002 21:41:24 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@FreeBSD.org
Subject: docs/36465: dumpon(8) manual misleads about single/multi-user usability
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         36465
>Category:       docs
>Synopsis:       dumpon(8) manual misleads about single/multi-user usability
>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:   Thu Mar 28 21:50:00 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The dumpon(8) manual's NOTES section has this:

    Since dumpon can only be called after the system enters single-user
    mode, it can not be used to create dumps for system panics during
    kernel initialization.  In such cases use dumpdev tunable provided
    by loader(8) instead.

from which some will infer that dumpon may not be used in multi-user mode.
================
>How-To-Repeat:
n/a
================
>Fix:

Replace the whole paragraph with:

    Since _dumpon_ cannot be used during kernel initialization, the
    _dumpdev_ variable of loader(8) must be used to enable dumps
    for system panics during kernel initialization.
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message