BEH_DEBUG(3) BHL functions BEH_DEBUG(3) NAME beh_debug - BEH structures displayer-debugger SYNOPSIS 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 "be- fig", "beout", "bereg", "bemsg", "bepor", "begen", "berin", "be- bus", "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 mak- ing any action. To display the structure, beh_debug() prints a line per field. Fields con- taining immediate value (integer, character, string, ...) are displayed in the following form: name_of_the_field : value_of_the_field Fields containing a pointer are marked by the symbol ->. If the field con- tains 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 displayed 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 current 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 : "_dis- play 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) ASIM/LIP6 October 1, 1997 BEH_DEBUG(3)
NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | EXAMPLE | NOTES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=beh_debug&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>