docs/159650: Call for review : Description of crash dump (developers-handbook)

[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.

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
 	<filename>AUTO</filename> to use the first configured swap
-	device.  <filename>AUTO</filename> is the default as of
-	&os; 6.0.</para>
+	device.  The defualt for <varname>dumpdev</varname> is
+	<filename>AUTO</filename> in HEAD, and changed to
+	<filename>NO</filename> on RELENG_* branches (exceptionally,
+	it leave <filename>AUTO</filename> in RELENG_7).
+	On &os; 9.0-RELEASE and later versions,
+	<application>bsdinstall</application> will prompt if crash dumps
+	should be enabled on the target system during the install process.</para>

       <tip><para>Check <filename>/etc/fstab</filename> or
 	&man.swapinfo.8; for a list of swap devices.</para></tip>



Regards,
  Ryusuke

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 195 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20120107/9277f435/attachment.sig>