|
|
/* asmdebug.h -- include file for microsoft 80x86 assembler
**** microsoft (r) macro assembler** copyright (c) microsoft corp 1986. all rights reserved**** randy nevin*/
/*** Output debugging information
* Ross Garmoe * Copyright Microsoft Corporation, 1983 * September 27, 9 1983 * * This package was developed using concepts originally developed by * Mark Zibokowski for the C version of the z editor. * * The following set of macros output debugging information to the * debugging file 'd_df'. Output of debugging information is controlled * by compile time conditionals and flags set by execution time switches. * If the symbol DEBUG is defined at compile time, the macros are * compiled to generate debugging information. If DEBUG is not defined, * then the macros are not compiled. At execution time, the value of * the variable 'd_debug' is compared with the value of the defined symbol * DEBFLAG and if any bits match, debugging information is written. * If debugging information is to be written, the information level * specified in the macro is checked against the level specified at run * time and information is written only if the compile level is less than * the level specified at run time. * * The macros are used as follows: * * Define the global variables 'd_debug', 'd_dlevel', 'd_indent' and 'd_sindent' * as integers and 'd_df' as a pointer to FILE. In the argument processing * routine set the value of 'd_debug' and 'd_dlevel' and open the trace output * file and point to it with the variable 'd_df'. 'd_debug' , 'd_dlevel' and * 'd_indent' must be intialized to zero. * * In any file of the program which is to produce debugging output, * include this file 'debug.h' and define the selection symbol DEBFLAG. * * #include debug.h * #define DEBFLAG value * * Then for any function which is to produce debug output include the * following sets of macro calls. * * At fuction entry: * * INDEBUG; * DEBOUT (level, ( fprintf argument string )); * * At all function exits: * * DEBOUT (level, ( fprintf argument string )); * OUTDEBUG; * * At other points of interest: * * DEBOUT (level, ( fprintf argument string )); * * Note: For the entry and exit points, the DEBOUT ((...)); string * is optional. The INDEBUG and OUTDEBUG macros control the * indentation of the debug output to show the nesting levels of * function calls * Note: The fprintf argument string is of the form: * d_df, "format", arg1, arg2,..., argn */
#ifdef DEBUG
# define INDEBUG if(d_debug&DEBFLAG)d_indent++
# define DEBOUT(l,z) if(d_debug&DEBFLAG&&l<=d_dlevel)\
{for(d_sindent=d_indent;d_sindent;d_sindent--)fprintf(d_df," ");\ fprintf z ;}else# define OUTDEBUG if(d_debug&DEBFLAG)d_indent--
extern long d_debug, d_dlevel, d_indent; /* debugging flags */ extern long d_sindent; /* indentation printing temporary */ extern FILE *d_df; /* pointer to debug output file */#else
# define INDEBUG
# define DEBOUT(l,z)
# define OUTDEBUG
#endif
|
