# @(#)66	1.1  src/bos/usr/bin/sysdumpdev/dumpfmt/README.S, cmdcrash, bos720 1/11/96 14:46:49
# IBM_PROLOG_BEGIN_TAG 
# This is an automatically generated prolog. 
#  
# bos720 src/bos/usr/bin/sysdumpdev/dumpfmt/README.S 1.1 
#  
# Licensed Materials - Property of IBM 
#  
# Restricted Materials of IBM 
#  
# COPYRIGHT International Business Machines Corp. 1996 
# All Rights Reserved 
#  
# US Government Users Restricted Rights - Use, duplication or 
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 
#  
# IBM_PROLOG_END_TAG 
#
# COMPONENT_NAME: (CMDCRASH) Dump table formatting example
#
# FUNCTIONS: README
#
# ORIGINS: 27
#
# (C) COPYRIGHT International Business Machines Corp. 1996
# All Rights Reserved
# Licensed Materials - Property of IBM
#
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#

This sample consists of a kernel extension which creates a dump 
table, a program to load and configure the extension, and a crash
dump formatting routine.  The kernel extension and loading program
are in the kext subdirectory.  You must be root to run the ketest program
which loads and configures the extension.

Developers can use the get_cdt() and unpack() routines found in unpack.h
to get a component dump table's structures and data.  The sequence is to
call get_cdt() to get the cdt itself, then use unpack() to retrieve the data
for each of the dump table's entries.

For a description of component dump tables see the dmp_add() article in
Info Explorer.  A dump table formatter is called by crash when it is
placed in the /usr/lib/ras/dmprtns directory, and the dump table is
selected using the "dump" crash subcommand.

This sample consists of the following files:
kext/ketest.c - loader
kext/ketestext.c - kernel extension that creates the sample dump table.
kext/ketestext.exp - ketestext's exported symbols

README - this file
ketest.h - some shared data between the extension and formatter
sample_table.c - sample formatter
unpack.c - routines used to retrieve the dump table
unpack.h - unpack interfaces