| .TH PGADebugPrint 3 "05/01/95" " " "PGAPack" |
| .SH NAME |
| PGADebugPrint \- Write debugging information |
| .SH INPUT PARAMETERS |
| .PD 0 |
| .TP |
| ctx |
| - context variable |
| .PD 0 |
| .TP |
| level |
| - a symbolic constant that maps to the type of print requested |
| (e.g., an entry or exit print). Valid values are |
| PGA_DEBUG_ENTERED, PGA_DEBUG_EXIT, PGA_DEBUG_MALLOC, |
| PGA_DEBUG_PRINTVAR, PGA_DEBUG_SEND, and PGA_DEBUG_RECV. |
| .PD 0 |
| .TP |
| funcname |
| - the name of the function that called this routine |
| .PD 0 |
| .TP |
| msg |
| - message to print |
| .PD 0 |
| .TP |
| datatype |
| - a symbolic constant that maps to the data type of the |
| parameter data. Valid choices are PGA_INT, PGA_DOUBLE, |
| PGA_CHAR and PGA_VOID (no data). |
| .PD 0 |
| .TP |
| data |
| - a pointer, whose contents will be interpreted based upon the |
| datatype parameter (or NULL, if PGA_VOID). |
| .PD 1 |
| .SH OUTPUT PARAMETERS |
| .PD 0 |
| .TP |
| none |
| |
| .PD 1 |
| .SH SYNOPSIS |
| .nf |
| #include "pgapack.h" |
| void PGADebugPrint(ctx, level, funcname, msg, datatype, data) |
| PGAContext *ctx |
| int level |
| char *funcname |
| char *msg |
| int datatype |
| void *data |
| .fi |
| .SH LOCATION |
| debug.c |
| .SH EXAMPLE |
| .nf |
| Example: |
| If the debugging level includes printing variables (level 82), print the |
| value of the integer variable num as a debugging tool in the routine |
| Add2Nums |
| |
| PGAContext *ctx; |
| int num; |
| : |
| PGADebugPrint(ctx, PGA_DEBUG_PRINTVAR, "Add2Nums", "num = ", PGA_INT, |
| (void *) &num); |
| |
| .fi |