1MPHDEBUG(3)             MBK PHYSICAL UTILITY FUNCTIONS             MPHDEBUG(3)
2
3
4

NAME

6       mphdebug - physical data structure contents debug function
7

SYNOPSIS

9       #include "mph.h"
10       void mphdebug(headpointer, structurename)
11       void ∗headpointer;
12       char ∗structurename;
13

PARAMETER

15       headpointer         Pointer to a structure to be displayed
16
17       structurename       Name of the structure to be explored
18

DESCRIPTION

20       mphdebug  allows  a user interactive visualisation of the internal con‐
21       tents of the physical view of mbk.
22       Through the use of a small, but convenient, textual user  interface,  a
23       step  by  step exploration of each fields of the data structure is made
24       available.  However, if the structure is big, it may be painful to use.
25       First of all, the contents of the expected struture is displayed,  with
26       its  fields  named as they appear in the appropriate header file.  Then
27       the user is prompted by a `>>' for an input.
28       The input may be either a field name, or a  predefined  symbol.   Field
29       names  are  to be typed the way they are displayed.  Predefined symbols
30       are:
31
32       _exit               that quit the current debugging session.
33
34       _up                 that comes back to the previous structure.
35
36       _top                returns to the root of the function invocation.
37
38       _stop               puts kind of a tag at the current position  in  the
39                           structure.  It will be available later on to return
40                           to this position.
41
42       _back               returns to the previous _stop position.
43
44       The debugger functions are easy to understand, so just try it!
45

EXAMPLE

47       #include "mph.h"
48       void scan_na2_y()
49       {
50          getphfig("na2_y", 'A');
51          mphdebug(HEAD_PHFIG, "phfig");
52       }
53

SEE ALSO

55       mbk(1), phfig(3), phcon(3), phins(3), phvia(3), phref(3), mlodebug(3).
56
57
58
59
60
61
62ASIM/LIP6                       October 1, 1997                    MPHDEBUG(3)
Impressum