From jdc@koitsu.dyndns.org Wed Aug 10 17:01:27 2011 Return-Path: Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8CCBA106566B for ; Wed, 10 Aug 2011 17:01:27 +0000 (UTC) (envelope-from jdc@koitsu.dyndns.org) Received: from qmta11.emeryville.ca.mail.comcast.net (qmta11.emeryville.ca.mail.comcast.net [76.96.27.211]) by mx1.freebsd.org (Postfix) with ESMTP id 77BFA8FC16 for ; Wed, 10 Aug 2011 17:01:27 +0000 (UTC) Received: from omta10.emeryville.ca.mail.comcast.net ([76.96.30.28]) by qmta11.emeryville.ca.mail.comcast.net with comcast id Jgpm1h0080cQ2SLABh1Pon; Wed, 10 Aug 2011 17:01:23 +0000 Received: from koitsu.dyndns.org ([67.180.84.87]) by omta10.emeryville.ca.mail.comcast.net with comcast id Jh1M1h00C1t3BNj8Wh1Ngo; Wed, 10 Aug 2011 17:01:23 +0000 Received: by icarus.home.lan (Postfix, from userid 1000) id EE661102C19; Wed, 10 Aug 2011 10:01:24 -0700 (PDT) Message-Id: <20110810170124.EE661102C19@icarus.home.lan> Date: Wed, 10 Aug 2011 10:01:24 -0700 (PDT) From: Jeremy Chadwick Reply-To: Jeremy Chadwick To: FreeBSD-gnats-submit@freebsd.org Cc: Steven Hartland Subject: dumpdev variable was changed to "no" on September 2009 X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 159650 >Category: docs >Synopsis: [developers-handbook] dumpdev variable was changed to "no" on September 2009 >Confidential: no >Severity: non-critical >Priority: medium >Responsible: ryusuke >State: closed >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Aug 10 17:10:09 UTC 2011 >Closed-Date: Fri Jan 20 15:59:56 UTC 2012 >Last-Modified: Fri Jan 20 16:00:27 UTC 2012 >Originator: Jeremy Chadwick >Release: FreeBSD 8.2-STABLE amd64 >Organization: >Environment: System: FreeBSD icarus.home.lan 8.2-STABLE FreeBSD 8.2-STABLE #0: Mon Aug 8 07:16:45 PDT 2011 root@icarus.home.lan:/usr/obj/usr/src/sys/X7SBA_RELENG_8_amd64 amd64 >Description: In the following freebsd-stable@ discussion thread, the "dumpdev" rc.conf variable and its defaults have come under scrutiny: http://lists.freebsd.org/pipermail/freebsd-stable/2011-August/063543.html In September 2009 a commit was made to change the default value of dumpdev from "AUTO" to "NO": http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.358.2.2 Yet the FreeBSD Handbook "Kernel Debugging" section 10.1.1 states: "AUTO is the default as of FreeBSD 6.0." Which is no longer true for any release/build past September 2009 (sans HEAD/CURRENT, where "AUTO" is still the default). >How-To-Repeat: n/a >Fix: Please update the Handbook to reflect reality. :-) Someone will need to review the RELENG_7 tag to see if/when src/etc/defaults/rc.conf was changed there as well. >Release-Note: >Audit-Trail: Responsible-Changed-From-To: freebsd-doc->ryusuke Responsible-Changed-By: ryusuke Responsible-Changed-When: Sat Aug 20 14:33:12 UTC 2011 Responsible-Changed-Why: I'll take this. http://www.freebsd.org/cgi/query-pr.cgi?pr=159650 From: Ryusuke SUZUKI To: freebsd@jdc.parodius.com Cc: FreeBSD-gnats-submit@FreeBSD.org, killing@multiplay.co.uk, ryusuke@FreeBSD.org Subject: Re: docs/159650: dumpdev variable was changed to "no" on September 2009 Date: Sun, 28 Aug 2011 23:38:08 +0900 (JST) ----Security_Multipart(Sun_Aug_28_23_38_08_2011_097)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, Thanks for your submitting PR/159650. I also confirmed that dumpdev is set to be "NO", by default, for RELENG_3, 4, 5, 6, 8 and "AUTO" for RELENG_7, and HEAD (I suspect that this variable should be "NO" for RELENG_7 as well...). In the near feature, the RELENG_9 will be branched. After creating RELENG_9, I will fix this issue. Regards, Ryusuke ----Security_Multipart(Sun_Aug_28_23_38_08_2011_097)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEABECAAYFAk5aUtAACgkQG5rRvmPSlyTzWgCeKWGYzlZM7aYbQMBbQUx6qyxc tS4AmwQY9HsGQuGZBoMU5m3OOizCoqPJ =yhgs -----END PGP SIGNATURE----- ----Security_Multipart(Sun_Aug_28_23_38_08_2011_097)---- From: Ryusuke SUZUKI To: freebsd-doc@FreeBSD.org Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/159650: Call for review : Description of crash dump (developers-handbook) Date: Sat, 07 Jan 2012 17:11:03 +0900 (JST) ----Security_Multipart(Sat_Jan__7_17_11_03_2012_364)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hello, Last year, I took PR/159650. This PR is related to the crash dump. http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/159650 As you know, "dumpdev" variable of rc.conf file is "AUTO" in HEAD, but changed to "NO" on the stable branches. References RELENG_9 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.394.2.2 RELENG_8 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.358.2.2 RELENG_6 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.252.2.17 However, developers-handbook "10.1.1 Configuring the Dump Device" only says "AUTO is the default as of FreeBSD 6.0." http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug.html#CONFIG-DUMPDEV We should update this sentence. And I also would like to mention the crash dump menu of the bsdinstall, recently kensmith@ added http://docs.freebsd.org/cgi/getmsg.cgi?fetch=1485239+0+archive/2011/svn-src-all/20111204.svn-src-all Please review the follwoing patch: Index: chapter.sgml =================================================================== RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v retrieving revision 1.80 diff -u -r1.80 chapter.sgml --- chapter.sgml 2 Dec 2010 14:53:45 -0000 1.80 +++ chapter.sgml 7 Jan 2012 06:54:34 -0000 @@ -76,8 +76,13 @@ &man.rc.conf.5; to the path of the swap device (the recommended way to extract a kernel dump) or AUTO to use the first configured swap - device. AUTO is the default as of - &os; 6.0. + device. The defualt for dumpdev is + AUTO in HEAD, and changed to + NO on RELENG_* branches (exceptionally, + it leave AUTO in RELENG_7). + On &os; 9.0-RELEASE and later versions, + bsdinstall will prompt if crash dumps + should be enabled on the target system during the install process. Check /etc/fstab or &man.swapinfo.8; for a list of swap devices. Regards, Ryusuke ----Security_Multipart(Sat_Jan__7_17_11_03_2012_364)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEABECAAYFAk8H/hcACgkQG5rRvmPSlyTPQQCgg44r+bIGEhkj+275D+Wnh1bo 8OYAnitwXwAElyASJBUHs7lrCGmhmggN =NIsP -----END PGP SIGNATURE----- ----Security_Multipart(Sat_Jan__7_17_11_03_2012_364)---- From: Ryusuke SUZUKI To: wblock@wonkity.com, bcr@FreeBSD.org Cc: ryusuke@FreeBSD.org, freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/159650: Call for review : Description of crash dump (developers-handbook) Date: Mon, 09 Jan 2012 02:39:52 +0900 (JST) ----Security_Multipart(Mon_Jan__9_02_39_52_2012_186)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Benedict-san, Warren-san, Thanks for reviewing the patch! I will commit updated follwoing patch in a few days. Ryusuke Index: chapter.sgml =================================================================== RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v retrieving revision 1.80 diff -u -r1.80 chapter.sgml --- chapter.sgml 2 Dec 2010 14:53:45 -0000 1.80 +++ chapter.sgml 8 Jan 2012 16:30:52 -0000 @@ -75,9 +75,14 @@ handled by setting the dumpdev variable in &man.rc.conf.5; to the path of the swap device (the recommended way to extract a kernel dump) or - AUTO to use the first configured swap - device. AUTO is the default as of - &os; 6.0. + AUTO to use the first configured swap + device. The default for dumpdev is + AUTO in HEAD, and changed to + NO on RELENG_* branches (except for RELENG_7, + which was left set to AUTO). + On &os; 9.0-RELEASE and later versions, + bsdinstall will ask whether crash dumps + should be enabled on the target system during the install process. Check /etc/fstab or &man.swapinfo.8; for a list of swap devices. From: Warren Block Subject: Re: docs/159650: Call for review : Description of crash dump (developers-handbook) Date: Sat, 7 Jan 2012 08:26:33 -0700 (MST) > On Sat, 7 Jan 2012, Benedict Reuschling wrote: > > > Am 07.01.12 09:11, schrieb Ryusuke SUZUKI: > >> Hello, > >> > >> Last year, I took PR/159650. This PR is related to the crash dump. > >> http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/159650 > >> > >> > >> As you know, "dumpdev" variable of rc.conf file is "AUTO" in HEAD, > >> but changed to "NO" on the stable branches. > >> > >> References > >> RELENG_9 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.394.2.2 > >> RELENG_8 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.358.2.2 > >> RELENG_6 : http://www.freebsd.org/cgi/cvsweb.cgi/src/etc/defaults/rc.conf#rev1.252.2.17 > >> > >> > >> However, developers-handbook "10.1.1 Configuring the Dump Device" only says > >> > >> "AUTO is the default as of FreeBSD 6.0." > >> > >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug.html#CONFIG-DUMPDEV > >> > >> > >> We should update this sentence. > > > > Yes, we should. > >> > >> And I also would like to mention the crash dump menu of the bsdinstall, > >> recently kensmith@ added > >> http://docs.freebsd.org/cgi/getmsg.cgi?fetch=1485239+0+archive/2011/svn-src-all/20111204.svn-src-all > >> > >> Please review the follwoing patch: > > I've made a few corrections inline below. > > > >> > >> Index: chapter.sgml > >> =================================================================== > >> RCS file: /home/ryusuke/work/cvs-doc/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml,v > >> retrieving revision 1.80 > >> diff -u -r1.80 chapter.sgml > >> --- chapter.sgml 2 Dec 2010 14:53:45 -0000 1.80 > >> +++ chapter.sgml 7 Jan 2012 06:54:34 -0000 > >> @@ -76,8 +76,13 @@ > >> &man.rc.conf.5; to the path of the swap device (the > >> recommended way to extract a kernel dump) or > >> AUTO to use the first configured swap > >> - device. AUTO is the default as of > >> - &os; 6.0. > >> + device. The defualt for dumpdev is > > s/defualt/default > > > >> + AUTO in HEAD, and changed to > >> + NO on RELENG_* branches (exceptionally, > >> + it leave AUTO in RELENG_7). > > Not sure what you mean by "leave" here, it does not sound right. Did you > > miss a word? You probably meant something like "... it is set to > > AUTO in RELENG_7. > > I think: > > NO on RELENG_* branches (except for RELENG_7, > which was left set to AUTO). > > Those tags maybe ought to be , I'm not sure. > > >> + On &os; 9.0-RELEASE and later versions, > >> + bsdinstall will prompt if crash dumps > > The "if" can be read two ways. Suggestion: > > bsdinstall will ask whether crash dumps > > >> + should be enabled on the target system during the install process. ----Security_Multipart(Mon_Jan__9_02_39_52_2012_186)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEABECAAYFAk8J1OgACgkQG5rRvmPSlyRu6QCg0uHyduMBWNw1eQcV06m4L0Rx SKwAoKnRNAyibJ+MpNfTblma/q5IimfC =jdet -----END PGP SIGNATURE----- ----Security_Multipart(Mon_Jan__9_02_39_52_2012_186)---- State-Changed-From-To: open->closed State-Changed-By: ryusuke State-Changed-When: Fri Jan 20 15:59:37 UTC 2012 State-Changed-Why: Committed. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=159650 From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/159650: commit references a PR Date: Fri, 20 Jan 2012 15:56:14 +0000 (UTC) ryusuke 2012-01-20 15:56:00 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/books/developers-handbook/kerneldebug chapter.sgml Log: PR: docs/159650 Update the description about the dumpdev variable in rc.conf. Reported by: Jeremy Chadwick Reviewed by: bcr, wblock, freebsd-doc Revision Changes Path 1.81 +8 -3 doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" >Unformatted: