[cgl_discussion] Project Review: lkcd

Mark Haverkamp markh at osdl.org
Mon Sep 9 08:41:05 PDT 2002


Khalid has requested that the CGL project maintainers post project
information for review on the cgl_discussion list with the following
included:

1. Quote the requirements from the requirements doc that your project is
expected to meet.

2. Explain how you think the project you have picked meets the above
requirements.

3. Explain the design of your project or point to a document on the web
that explains the design.

4. Pointer to your code/patch.

================================================================


1. Requirements related to the lkcd project:
---------------------------------------------

4.2 kernel dumps

4.2.1 OSDL CGL shall provide enhancements for producing and storing
kernel dumps.

4.2.2 OSDL CGL will provide enhancements for producing summary dumps
containing only specified data structures. These list of data structures
shall be able to be specified by the system administrator.

5.2 kernel dump analysis
OSDL CGL will provide tools to enable enhanced analysis in the areas of
kernel structures, virtual to physical address translation, and module
access.


2. How lkcd meets the CGL requirements:
---------------------------------------
This is taken from the lkcd project page at lkcd.sourceforge.net

     LKCD contains kernel and user level code designed to:

    * Save the kernel memory image when the system dies due to a
      software failure;
    * Recover the kernel memory image when the system is rebooted;
    * Analyze the memory image to determine what happened when the
      failure occurred.

     The memory image is stored into a dump device, which is 
     represented by one of the disk partitions on the system. 
     That dump is recovered with an application called lcrash
     (Linux Crash) once the system boots back up, before the 
     swap partitions are mounted. A report is generated and 
     saved into /var/log/dump.


lkcd allows the level of dump to be specified from no dump to all
memory.  It does not allow for just specific data structures to be saved
as specified in 4.2.2.

3. Project design information:
-------------------------------

The project is located at lkcd.sourceforge.net and has a documentation
section that contains information on the lkcd/lcrash software.

4. Code location:
-----------------
The kernel patch for lkcd is located in the cgl development tree under
kernel/linux-2.4.18/patches/lkcd

User mode utilities like the lcrash analysis are located in cgl
development tree under components/lkcdutils and
components/lkcd_netserver.

Driver code for alternate dump locations are located in the cgl
development tree under the components tree at lkcd_diskconsole,
lkcd_netconsole.




More information about the cgl_discussion mailing list