debian man page for mphdebug

MPHDEBUG(3)						  MBK PHYSICAL UTILITY FUNCTIONS					       MPHDEBUG(3)

NAME
       mphdebug - physical data structure contents debug function

ORIGIN
       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

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");
       }

SEE ALSO
       mbk(1), phfig(3), phcon(3), phins(3), phvia(3), phref(3), mlodebug(3).

BUG REPORT
       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						       MPHDEBUG(3)