From swear@blarg.net  Thu Mar 28 21:43:18 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 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: dumpon(8) manual misleads about single/multi-user usability
X-GNATS-Notify:

>Number:         36465
>Category:       docs
>Synopsis:       dumpon(8) manual misleads about single/multi-user usability
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 28 21:50:00 PST 2002
>Closed-Date:    Fri Apr 12 09:15:07 PDT 2002
>Last-Modified:  Fri Apr 12 09:15:07 PDT 2002
>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:

From: Tom Rhodes <darklogik@pittgoth.com>
To: Gary Swearingen <swear@blarg.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/36465: [PATCH] dumpon(8)
Date: Fri, 29 Mar 2002 01:25:00 -0500

 --k=.p6QG5iGe6m)ra
 Content-Type: multipart/mixed;
  boundary="Multipart_Fri__29_Mar_2002_01:25:00_-0500_08182600"
 
 
 --Multipart_Fri__29_Mar_2002_01:25:00_-0500_08182600
 Content-Type: text/plain; charset=US-ASCII
 Content-Transfer-Encoding: 7bit
 
 Gary,
 
 	Could you review this diff, see if this will be good for ya?
 My mdoc(7) skills arn't the best in the world ;)
 
 -- 
 Tom (Darklogik) Rhodes
 www.FreeBSD.org  -The Power To Serve
 www.Pittgoth.com -Pittgoth Discussion Portal
 trhodes@ {Pittgoth.com, FreeBSD.org}
 
 --Multipart_Fri__29_Mar_2002_01:25:00_-0500_08182600
 Content-Type: application/txt;
  name="dumpon.8.diff"
 Content-Disposition: attachment;
  filename="dumpon.8.diff"
 Content-Transfer-Encoding: base64
 
 LS0tIGR1bXBvbi44Lm9sZAlGcmkgTWFyIDI5IDAxOjIxOjUyIDIwMDIKKysrIGR1bXBvbi44CUZy
 aSBNYXIgMjkgMDE6MjI6MDAgMjAwMgpAQCAtOTYsOCArOTYsMTEgQEAKIC5QcAogU2luY2UKIC5O
 bQotY2FuIG9ubHkgYmUgY2FsbGVkIGFmdGVyIHRoZSBzeXN0ZW0gZW50ZXJzIHNpbmdsZS11c2Vy
 IG1vZGUsCi1pdCBjYW4gbm90IGJlIHVzZWQgdG8gY3JlYXRlIGR1bXBzIGZvciBzeXN0ZW0gcGFu
 aWNzIGR1cmluZworY2Fubm90IGJlIHVzZWQgZHVyaW5nIGtlcm5lbCBpbml0aWFsaXphdGlvbiwg
 dGhlCisuVmEgZHVtcGRldgordmFyaWFibGUgb2YKKy5YciBsb2FkZXIgOAorbXVzdCBiZSB1c2Vk
 IHRvIGVuYWJsZSBkdW1wcyBmb3Igc3lzdGVtIHBhbmljcyBkdXJpbmcKIGtlcm5lbCBpbml0aWFs
 aXphdGlvbi4KIEluIHN1Y2ggY2FzZXMgdXNlCiAuVmEgZHVtcGRldgo=
 
 --Multipart_Fri__29_Mar_2002_01:25:00_-0500_08182600--
 
 --k=.p6QG5iGe6m)ra
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.6 (FreeBSD)
 
 iD8DBQE8pAjBwPmgiRuevUMRAkAVAKDwYwaCpTkjw06WODzGppgvV2+zaQCeJYR9
 /28Mk+BaCAl055mP5eyXGYo=
 =O88x
 -----END PGP SIGNATURE-----
 
 --k=.p6QG5iGe6m)ra--
 

From: trhodes@FreeBSD.ORG (Tom Rhodes)
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/36465: [PATCH] dumpon(8)
Date: Thu, 28 Mar 2002 22:25:45 -0800 (PST)

 --- dumpon.8.old	Fri Mar 29 01:21:52 2002
 +++ dumpon.8	Fri Mar 29 01:22:00 2002
 @@ -96,8 +96,11 @@
  .Pp
  Since
  .Nm
 -can only be called after the system enters single-user mode,
 -it can not be used to create dumps for system panics during
 +cannot be used during kernel initialization, the
 +.Va dumpdev
 +variable of
 +.Xr loader 8
 +must be used to enable dumps for system panics during
  kernel initialization.
  In such cases use
  .Va dumpdev
 Review the above, sorry about that, my new mailer program is odd

From: swear@blarg.net (Gary W. Swearingen)
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/36465: [PATCH] dumpon(8)
Date: 29 Mar 2002 09:52:17 -0800

 Tom Rhodes <darklogik@pittgoth.com> writes:
 
 > 	Could you review this diff, see if this will be good for ya?
 > My mdoc(7) skills arn't the best in the world ;)
 
 Nor are mine, making testing a required part of patching.
 
 Your diff looks good, except that the sentence starting
 "In such cases use" (see below) should be removed too (it was
 incorporated in the new part).
 
     +.Xr loader 8
     +must be used to enable dumps for system panics during
      kernel initialization.
      In such cases use
      .Va dumpdev
 
 And if you don't mind, you could remove a possible (but nonsensical)
 second meaning in the new text by inserting "which occur" between
 "panics" and "during" (see above).  Thanks.

From: <trhodes@FreeBSD.org>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/36465: [PATCH] dumpon(8)
Date: Mon, 1 Apr 2002 17:39:15 -0800 (PST)

 Gary, this is a new diff that should work for our current
 situation.  What do you think?
 
 --
 Tom (darklogik) Rhodes
 
 --- dumpon.8.old	Mon Apr  1 20:29:36 2002
 +++ dumpon.8	Mon Apr  1 20:43:27 2002
 @@ -96,14 +96,12 @@
  .Pp
  Since
  .Nm
 -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
 +cannot be used during kernel initialization, the
  .Va dumpdev
 -tunable provided by
 +variable of
  .Xr loader 8
 -instead.
 +must be used to enable dumps for system panics which occur
 +during kernel initialization.
  .Sh SEE ALSO
  .Xr sysctl 3 ,
  .Xr fstab 5 ,
State-Changed-From-To: open->analyzed 
State-Changed-By: trhodes 
State-Changed-When: Mon Apr 1 21:01:38 PST 2002 
State-Changed-Why:  
Submitter has accepted my patch, and I will commit it soon 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Apr 1 21:01:38 PST 2002 
Responsible-Changed-Why:  
Submitter has accepted my patch and I will commit it soon 

http://www.freebsd.org/cgi/query-pr.cgi?pr=36465 
State-Changed-From-To: analyzed->patched 
State-Changed-By: trhodes 
State-Changed-When: Tue Apr 9 12:58:33 PDT 2002 
State-Changed-Why:  
I just applyed to CURRENT, and will apply to stable in 3 days, Thanks 
alot Gary! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=36465 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Fri Apr 12 09:14:38 PDT 2002 
State-Changed-Why:  
Committed to STABLE!  Thanks Gary! 

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