windows-server-2003/inetsrv/iis/svcs/staxcore/dbgdumpx

Platinum CDB Extension Library:



General Usage:

  -include ptdbgext.h and link with ptdbgext.lib

  -define structure using macros described below

  -define globals ExtensionNames, Extensions, and g_pExtensionInitRoutine

  -Use DEFINE_EXPORTED_FUNCTIONS do define exported functions

  -Export "dump" and "help" from your dll using the def file

  -Copy extension dll to a directory in your path

  -Start CDB and attach to process

  -Type "!<dll name>.help" for help



Demo files:

  - extdemex directory contains sample application to debug

  - extdemdl directory contains sample CDB extension dll



Demo Usage:

  - Attach to process using "cdb /p <pid>"

  - Type "!extdemdl.help"... you'll see the following



Demo CDB debugger extensions

   help -- This command 

   dump <Struct Type Name>@<address expr> 



  - Type "dd extdemex!g_pMyClass l 1"... you'll see something like the following:

00402190  00313240



  - Using the 2nd number, type "!extdemdl.dump CMyClass@0x00313240":

0:001> !extdemdl.dump CMyClass@0x00313240

++++++++++++++++ CMyClass@313240 ++++++++++++++++

<... dump deleted>

    m_MyStruct                     @0x00313248

<... dump deleted>

---------------- CMyClass@313240 ----------------





  - Use the m_MyStruct field to dump the embeded structure 

    by typing "!extdemdl.dump MY_STRUCT@0x00313248"

++++++++++++++++ MY_STRUCT@313248 ++++++++++++++++

    m_cbName                       26              

    m_szName                       This is a MY_STRUCT struct

---------------- MY_STRUCT@313248 ----------------





** Macro usage from _dbgdump.h

//  Usage:

//      Create a head file that includes this file and defines your field

//      descriptors using only the following macros:

//

//      BIT MASKS:

//          BEGIN_BIT_MASK_DESCRIPTOR(BitMaskName) -

//              start bit mask descriptor

//          BIT_MASK_VALUE(Value) -

//              Give a defined value for a bit mask.  Uses #Value 

//              to describe the value.  If your bitmask values are

//              defined using #defines... then only the numerical

//              values will appear in the dump... use BIT_MASK_VALUE2

//              instead.

//          BIT_MASK_VALUE2(Value, Description) -

//              Give a value and description for a bit mask.

//          END_BIT_MASK_DESCRIPTOR

//              Mark the end of a bit mask descriptor

//

//      ENUMS:

//          BEGIN_ENUM_DESCRIPTOR(BitMaskName) -

//              start enum descriptor

//          ENUM_VALUE(Value) -

//              Give a defined value for a enum.  Uses #Value 

//              to describe the value.

//          ENUM_VALUE2(Value, Description) -

//              Give a value and description for a enum.

//          END__DESCRIPTOR -

//              Mark the end of a enum descriptor

//

//      STRUCTURES & CLASSES:

//          BEGIN_FIELD_DESCRIPTOR(FieldDescriptorName) - 

//              start field decscritor

//          FIELD3(FieldType, StructureName, FieldName) - 

//              define non-enum public field

//          FIELD4(FieldType, StructureName, FieldName, AuxInfo) - 

//              define enum public field

//              For FIELD4, you should pass one of the following to

//              to define the aux info:

//                  GET_ENUM_DESCRIPTOR(x)

//                  GET_BITMASK_DESCRIPTOR(x)

//              Where x is one of the values used to define a bit mask

//              or enum.

//              

//          END_FIELD_DESCRIPTOR -

//              Define end of field descriptors for class/struct

//

//      GLOBALS: - Used to tell ptdbgext what class/structures to dump

//          BEGIN_STRUCT_DESCRIPTOR -

//              Marks the begining of the global stuct descriptor

//          STRUCT(TypeName,FieldDescriptor) -

//              Defines a struct to dump.  TypeName is the name of the 

//              type, and FieldDescriptor is a name given in a 

//              BEGIN_FIELD_DESCRIPTOR.

//

//      NOTE: You must define bit masks & enums before classes and structures.  

//      You must also define the global STRUCT_DESCRIPTOR last.