[deployment-guide/comm-rel: 217/727] Added the Configuring the Dump File subsection.

[Jaromir Hradilek]

commit cc0769b9203cb6b10b51d2a0083bd1de56ccc9b4
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Mon Aug 2 14:54:02 2010 +0200

    Added the Configuring the Dump File subsection.

 en-US/The_kdump_Crash_Recovery_Service.xml |   81 +++++++++++++++++++++++++++-
 1 files changed, 80 insertions(+), 1 deletions(-)
---
diff --git a/en-US/The_kdump_Crash_Recovery_Service.xml b/en-US/The_kdump_Crash_Recovery_Service.xml
index 479ead5..3f768ab 100644
--- a/en-US/The_kdump_Crash_Recovery_Service.xml
+++ b/en-US/The_kdump_Crash_Recovery_Service.xml
@@ -210,13 +210,92 @@ path /usr/local/cores</screen>
         </para>
         <screen>net penguin.example.com:/export/cores</screen>
         <para>
-          To store the dump to a remote machine using the SSH protocol, remove the hash sign (<quote>#</quote>) from the beginning of the <literal>#net user at my.server.com</literal>, and replace the value with a valid username and hostname. For example:
+          To store the dump to a remote machine using the SSH protocol, remove the hash sign (<quote>#</quote>) from the beginning of the <literal>#net user at my.server.com</literal> line, and replace the value with a valid username and hostname. For example:
         </para>
         <screen>net john at penguin.example.com</screen>
         <para>
           Refer to <xref linkend="ch-OpenSSH" /> for information on how to configure an SSH server, and how to set up a key-based authentication.
         </para>
       </section>
+      <section id="s3-kdump-configuration-cli-filtering">
+        <title>Configuring the Dump File</title>
+        <para>
+          To reduce the size of the <filename>vmcore</filename> dump file, <systemitem class="service">kdump</systemitem> allows you to specify an external application (that is, a core collector) to compress the data, and optionally leave out all irrelevant information. Currently, the only fully supported core collector is <command>makedumpfile</command>.
+        </para>
+        <para>
+          To enable the core collector, open the <filename>/etc/kdump.conf</filename> configuration file in a text editor of your choice, remove the hash sign (<quote>#</quote>) from the beginning of the <literal>#core_collector makedumpfile -c --message-level 1 -d 31</literal> line, and edit the command line options as described below.
+        </para>
+        <para>
+          To enable the dump file compression, add the <option>-c</option> parameter. For example:
+        </para>
+        <screen>core_collector makedumpfile -c</screen>
+        <para>
+          To remove certain pages from the dump, add the <option>-d <replaceable>value</replaceable></option> parameter, where <replaceable>value</replaceable> is a sum of values of pages you want to omit as described in <xref linkend="table-kdump-configuration-cli-filtering-makedumpfile" />. For example, to remove both zero and free pages, use the following:
+        </para>
+        <screen>core_collector makedumpfile -d 17 -c</screen>
+        <para>
+          Refer to the <command>makedumpfile</command> manual page for a complete list of available options.
+        </para>
+        <table id="table-kdump-configuration-cli-filtering-makedumpfile">
+          <title>Available filtering levels</title>
+          <tgroup cols="2">
+            <colspec colname="type" colnum="1" />
+            <colspec colname="value" colnum="2" />
+            <thead>
+              <row>
+                <entry>
+                  Page Type
+                </entry>
+                <entry>
+                  Value
+                </entry>
+              </row>
+            </thead>
+            <tbody>
+              <row>
+                <entry>
+                  Zero pages
+                </entry>
+                <entry>
+                  <literal>1</literal>
+                </entry>
+              </row>
+              <row>
+                <entry>
+                  Cache pages
+                </entry>
+                <entry>
+                  <literal>2</literal>
+                </entry>
+              </row>
+              <row>
+                <entry>
+                  Cache private
+                </entry>
+                <entry>
+                  <literal>4</literal>
+                </entry>
+              </row>
+              <row>
+                <entry>
+                  User pages
+                </entry>
+                <entry>
+                  <literal>8</literal>
+                </entry>
+              </row>
+              <row>
+                <entry>
+                  Free pages
+                </entry>
+                <entry>
+                  <literal>16</literal>
+                </entry>
+              </row>
+            </tbody>
+          </tgroup>
+        </table>
+      </section>
       <section id="s3-kdump-configuration-cli-enable">
         <title>Enabling the Service</title>
         <para>