PGADebugPrint(3)

PGADebugPrint3

Write debugging information

Usage

#include "pgapack.h"
void  PGADebugPrint(ctx, level, funcname, msg, datatype, data)
PGAContext *ctx
int level
char *funcname
char *msg
int datatype
void *data

Input parameters

ctx

- context variable

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.

funcname

- the name of the function that called this routine

msg

- message to print

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).

data

- a pointer, whose contents will be interpreted based upon the datatype parameter (or NULL, if PGA_VOID).

Output parameters

none

Location

debug.c

Examples

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);

Releases

12 releases since Debian 1.1 (Buzz); the text changed 2 times.

  1. 1.1
  2. 1.2–3.1
  3. 5.0–8

From pgapack 1.1.1-3 in Debian 8 (Jessie). Parsed by carta from the page's man source.