beh_debug(3) [debian man page]

BEH_DEBUG(3)							   BHL functions						      BEH_DEBUG(3)

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

NAME

       beh_debug - BEH structures displayer-debugger

SYNOPSYS

       void beh_debug (pnt, type)
       void *pnt;
       char *type;

PARAMETERS

       pnt	 pointer of the structure to be displayed

       type	 name of the structure to be displayed. type can be any of "befig", "beout", "bereg", "bemsg", "bepor", "begen", "berin", "bebus",
		 "beaux", "bebux", "biabl", "binode", "beder", "bequad", "abl", "integer", "long", "short", "character", "ptype", "chain"

DESCRIPTION

       When called, beh_debug() displaies the structure pointed by pnt then, prints the line:

	      COMMAND	>>

       and  waits for a command being entered by the user. If pnt is a NULL pointer or type doesn't represent a known structure, beh_debug() exits
       without making any action.

       To display the structure, beh_debug() prints a line per field. Fields containing immediate value (integer, character, string, ...) are dis-
       played in the following form:

	      name_of_the_field  :  value_of_the_field

       Fields containing a pointer are marked by the symbol ->. If the field contains a NULL pointer, the field is displayed as:

	      -> name_of_the_field  :

       In the other case, beh_debug() prints :

	      -> name_of_the_field  :  available

       Two kinds of command are accepted by the displayer.

       A  command  can	be the name of a field containing a pointer. The command is accepted only if the pointer is not a NULL pointer (field dis-
       played as "available"). When the debugger receives such a command, it first pushes the current structure on its stack then,  displaies  the
       structure pointed by the named field.

       The second kind of commands are predefined commands :

	      _exit	to exit from the debugger

	      _up	to return to the previous structure

	      _stop	to put a stop mark on the current structure

	      _top	to return to the first structure (pointed by pnt)

	      _back	to return to the last structure marked with a stop mark

	      _save	to  save  the current structure in a static table. At most 10 structures may be saved. (example : "_save 1" saves the cur-
			rent structure in the entry number ! of the table)

	      _jump	to jump to a saved structure (example : "_jump 1" dislpaies the etructure save in the entry number 1 of the table).

	      _display	displaies a field under a given format. (example : "_display next integer" displaies the field named next as an integer).

       In addition to these commands, the command . (dot) can be used to repete the last command.

EXAMPLE

       #include <beh109.h>
       struct beout *beout_pnt;

       beh_debug (beout_pnt , "beout");

NOTES

       beh_debug() uses an internal stack. The message "stack overflow" is printed if too many structures have been pushed on the stack.

SEE ALSO

       beh(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						      BEH_DEBUG(3)

Check Out this Related Man Page

ADDPTYPE(3)						       MBK UTILITY FUNCTIONS						       ADDPTYPE(3)

NAME

       addptype - create a ptype and add it to a ptype_list

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 "mut.h"
       ptype_list *addptype(pthead,type,ptdata)
       ptype_list *pthead;
       void *ptdata;
       long type;

PARAMETERS

       pthead		   Pointer to a ptype list

       type		   Flag indicating the pointer owner

       ptdata		   Generic pointer to any kind of information

DESCRIPTION

       addptype creates a new ptype element and adds it to the front of the list pointed to by pthead, and becomes itself the list head.
       The ptype_lists are mosty used to create lists of homogeneous elements in mbk, but also for trees, graphs, and so on.
       The type argument indicates the pointer type, at the C type meaning, for its owner.
       The types allow to access the pointers with adequat cast, and for example to share informations in the USER fields of mbk structures.
       The ptdata points to any kind of list or may itself be a value, if proper cast is performed at compilation time, and fills the  DATA  field
       of the ptype structure.	For details on the structure, see ptype(3).

RETURN VALUE

       addptype returns a pointer to the new head of list.

EXAMPLE

       #include "mut.h"
       #include "mph.h"
       void corner(ptfig, name)
       phfig_list *ptfig;
       char *name;
       {
       phins_list *i = getphins(ptfig, name);
       num_list *ptnum;
       phfig_list *model;
	  model = getphfig(i->FIGNAME);
	  ptnum = addnum((num_list *)NULL, model->X2 - model->X1);
	  ptnum = addnum(ptnum, model->Y2 - model->Y1);
	  i->USER = addptype(i->USER, (long)PLACEABOX, (void *)ptnum);
       }

SEE ALSO

       mbk(1), ptype(3), freeptype(3), getptype(3), delptype(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						       ADDPTYPE(3)

Linux and UNIX Man Pages

beh_debug(3) [debian man page]

Check Out this Related Man Page