From owner-freebsd-doc@FreeBSD.ORG Sun Jan 8 17:39:58 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 591071065689; Sun, 8 Jan 2012 17:39:58 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from castle.jp.FreeBSD.org (castle.jp.FreeBSD.org [IPv6:2001:218:422:1::15]) by mx1.freebsd.org (Postfix) with ESMTP id E513B8FC14; Sun, 8 Jan 2012 17:39:57 +0000 (UTC) Received: from localhost (localhost [::1]) by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3/smtpfeed 1.14) with ESMTP/inet6 id q08HduO59914; Mon, 9 Jan 2012 02:39:56 +0900 (JST) (envelope-from ryusuke@FreeBSD.org) Date: Mon, 09 Jan 2012 02:39:52 +0900 (JST) Message-Id: <20120109.023952.193741084.ryusuke@jp.FreeBSD.org> To: wblock@wonkity.com, bcr@FreeBSD.org From: Ryusuke SUZUKI In-Reply-To: References: <20120107.171103.193758902.ryusuke@jp.FreeBSD.org> <4F082EA7.1010705@FreeBSD.org> X-Mailer: Mew version 6.1 on Emacs 22.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Mon_Jan__9_02_39_52_2012_186)--" Content-Transfer-Encoding: 7bit Cc: ryusuke@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/159650: Call for review : Description of crash dump (developers-handbook) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 08 Jan 2012 17:39:58 -0000 ----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)----