<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

<!-- include -->
<!ENTITY introduction SYSTEM "introduction.sgml">
<!ENTITY installation SYSTEM "installation.sgml">
<!ENTITY generalusage SYSTEM "generalusage.sgml">
<!ENTITY commandreference SYSTEM "commandreference.sgml">
<!ENTITY samplesessions SYSTEM "samplesessions.sgml">
<!ENTITY fdl SYSTEM "fdl.sgml">
<!ENTITY bibliography SYSTEM "bibliography.sgml">

]>

<!--  lcrash HOWTO. -->
<!--  Copyright (C) 2001, 2002 IBM Deutschland Entwicklung GmbH, -->
<!--                           IBM Corporation -->
<!--  Permission is granted to copy, distribute and/or modify this -->
<!--  document under the terms of the GNU Free Documentation License, -->
<!--  Version 1.1 or any later version published by the Free Software -->
<!--  Foundation; with no Invariant Sections, no Front-Cover Texts and -->
<!--  no Back-Cover Texts.  A copy of the license is included in the -->
<!--  section entitled "GNU Free Documentation License". -->

<book id="index">

<!-- book header -->
  <bookinfo>
    <title>Lcrash HOWTO</title>
    <pubdate>2002/02/05</pubdate>
    <revhistory>
      <revision>
	<revnumber>v1.0 </revnumber>
	<date>2002/02/05/</date>
<!-- 	<date>31 October 2001/</date> -->
	<authorinitials>AH</authorinitials>
	<revremark>
	  Initial version.
	</revremark>
      </revision>
    </revhistory>
    <authorgroup>
      <author>
	<firstname>Andreas</firstname>
	<surname>Herrman</surname>
	<affiliation>
	  <address><email>aherrman@de.ibm.com</email></address>
	</affiliation>
      </author>
    </authorgroup>
    <copyright>
      <year>2001</year>
      <year>2002</year>
      <holder>IBM Deutschland Entwicklung GmbH, IBM Corporation</holder>
    </copyright>
    <legalnotice>
      <para>
	Permission is granted to copy, distribute and/or modify this
	document under the terms of the GNU Free Documentation License,
	Version 1.1 or any later version published by the Free Software
	Foundation; with no Invariant Sections, no Front-Cover Texts and
	no Back-Cover Texts.  A copy of the license is included in the
	section entitled "GNU Free Documentation License".
      </para>
    </legalnotice>
    <abstract>
      <para>
	This document describes <command>lcrash</command>, the
	Linux crash dump analyzer.
      </para>
      <para>
	Most commercial UNIX systems have a feature that dumps the real
	storage to disk in case of a system crash.
	Afterwards a dump-analysis tool is used to analyze such dumps of the
	system's memory state at the time of the system crash.
      </para>
      <para>
	A team at SGI has worked on extensions of the Linux Kernel to
	provide	such a dump feature for GNU/Linux. They called
	their project Linux Kernel Crash Dumps (LKCD). The analysis tool
	<command>lcrash</command> (Linux Crash) is a part of LKCD.
      </para>
      <para>
	Please refer to <ulink url="http://lkcd.sourceforge.net/">
	  <citetitle>the LKCD Project Home Page</citetitle></ulink>.
	The LKCD code was released under
	the GNU	General Public License (GPL) and it is available from
	<ulink url="http://sourceforge.net/projects/lkcd">
	  <citetitle>sourceforge</citetitle></ulink>.
      </para>
      <para>
	This is the first version of the document. It is written in DocBook 4.1.
	Please let me know if you find any markup and other errors.
      </para>
    </abstract>
  </bookinfo>


<!-- about lcrash, about the book, copyright -->
  &introduction;

<!-- where to get the code, compilation, installation -->
  &installation;

<!-- general usage -->
  &generalusage;

<!-- command reference -->
  &commandreference;

<!-- sample sessions -->
  &samplesessions;

<!--  GPL -->
  &fdl;

<!--  GPL -->
  &bibliography;

</book>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-always-quote-attributes:t
sgml-auto-insert-required-elements:t
sgml-balanced-tag-edit:t
sgml-exposed-tags:nil
sgml-general-insert-case:lower
sgml-indent-data:t
sgml-indent-step:2
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
sgml-minimize-attributes:nil
sgml-namecase-general:t
sgml-omittag:t
sgml-shorttag:t
sgml-tag-region-if-active:t
End:
-->
