From owner-freebsd-doc@FreeBSD.ORG Sat Jan 7 16:05:23 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 BBABE1065673; Sat, 7 Jan 2012 16:05:23 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 6FDCA8FC1E; Sat, 7 Jan 2012 16:05:23 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q07FQX3q060821; Sat, 7 Jan 2012 08:26:33 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q07FQXWR060818; Sat, 7 Jan 2012 08:26:33 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Sat, 7 Jan 2012 08:26:33 -0700 (MST) From: Warren Block To: Ryusuke SUZUKI , Benedict Reuschling In-Reply-To: <4F082EA7.1010705@FreeBSD.org> Message-ID: References: <20120107.171103.193758902.ryusuke@jp.FreeBSD.org> <4F082EA7.1010705@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Sat, 07 Jan 2012 08:26:33 -0700 (MST) Cc: 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: Sat, 07 Jan 2012 16:05:23 -0000 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.