Browse Prior Art Database

Structure Formatting for Dump Formatters and Debuggers

IP.com Disclosure Number: IPCOM000115369D
Original Publication Date: 1995-Apr-01
Included in the Prior Art Database: 2005-Mar-30
Document File: 4 page(s) / 83K

Publishing Venue

IBM

Related People

Jaramillo, D: AUTHOR [+2]

Abstract

Disclosed is a tool, called the Structure Compiler (SC), for compiling a set of given header files into a special format, called a Structure Definition File (SDF), which contains special information describing a structure, so that a set of SDF Formatting functions can display memory for a dump formatter or debugger in a structured format.

This text was extracted from an ASCII text file.
This is the abbreviated version, containing approximately 52% of the total text.

Structure Formatting for Dump Formatters and Debuggers

      Disclosed is a tool, called the Structure Compiler (SC), for
compiling a set of given header files into a special format, called a
Structure Definition File (SDF), which contains special information
describing a structure, so that a set of SDF Formatting functions can
display memory for a dump formatter or debugger in a structured
format.

      Without this tool, most dump formatters and debuggers are
limited concerning how data can be interpreted because they must be
provided with, or compiled with, the internal structures of the
memory being displayed.  The presently disclosed tool overcomes the
limitation of formatting memory structures accurately across releases
in either a retail or debug environment.  This tool also protects the
internal layout of a structure.

      Fig. 1 is a block diagram showing the SC 1 using ".h" files 2
as input to produce a default SDF 3.  This file 3 is then edited with
a Structure Edit File (SEF) 4, in an SDF editor 5, customizing the
structures for formatting in a custom SDF 6.  An SDF is made up of
structures containing member elements.  Each structure member may
have display preferences associated with memory, such as ASCII
string, hex address, symbol name, structure pointer, embedded
structure, linked list pointer, child structure pointer, 16-bit near
pointer, linear address, selector:offset, selector, or suppress
display.

      Fig. 2 is a block diagram showing how the dump formatter or
debugger can then produce a formatted output for memory structures,
using memory addresses 7 and structure names 8 from the SDF file,
together with Display Functions 9, such as DispSdfStruct(),
DispSdfChain(), and DispSdfArray().   DispSdfMember() 10 is the
underlying function for displaying the final output.

The following listing is a sample header file:
  /***LT+ EXITLIST - Exit list data structures */
  struct     ExEntry_s {
      struct ExEntry_s   *exl next;    // link to next block/order
      ptr_t               exl_addr;    // Exit list routine address
      USHORT              exl_class;   // order & position 0 thru
01FF
      USHORT              ext_type;    // 16:16 or 0:32
    };
  typedef struct ExEntry_s EXENT;
  typedef struct ExEntry_s *PEXENT;
  /*end*/

The following listing is a sample Structure Edit File ...