mphdebug(3) physical data structure contents debug function

SYNOPSYS

#include "mph.h"
void mphdebug(headpointer, structurename)
void *headpointer;
char *structurename;

PARAMETER

headpointer
Pointer to a structure to be displayed
structurename
Name of the structure to be explored

DESCRIPTION

mphdebug allows a user interactive visualisation of the internal contents of the physical view of mbk.
Through the use of a small, but convenient, textual user interface, a step by step exploration of each fields of the data structure is made available. However, if the structure is big, it may be painful to use.
First of all, the contents of the expected struture is displayed, with its fields named as they appear in the appropriate header file. Then the user is prompted by a `>>' for an input.
The input may be either a field name, or a predefined symbol. Field names are to be typed the way they are displayed. Predefined symbols are:
_exit
that quit the current debugging session.
_up
that comes back to the previous structure.
_top
returns to the root of the function invocation.
_stop
puts kind of a tag at the current position in the structure. It will be available later on to return to this position.
_back
returns to the previous _stop position.

The debugger functions are easy to understand, so just try it!

EXAMPLE

#include "mph.h"
void scan_na2_y()
{
   getphfig("na2_y", 'A');
   mphdebug(HEAD_PHFIG, "phfig");
}