Scroll to navigation

DL(3) Library Functions Manual DL(3)

NAME

DL - generate logging messages in C and C++ using a debugger

SYNOPSIS

#include <DL.h>
 
DL(format,...)
 
DLG(guard,format,...)
 
DLH(handler,format,...)
 
DLP(param,format,...)
 
DLGH(guard,handler,format,...)
 
DLHP(handler,param,format,...)
 
DLGHP(guard,handler,param,format,...)
 

DESCRIPTION

The DL macro is used to print logging or debugging messages using a debugger. The nana(1) command generates a set of debugger commands which are then sourced into gdb(1) to implement the logging. If you don't run the executable under gdb(1) then no tracing will occur. The arguments are:
 
format,... - a printf(3) style argument list containing the message
 
guard - print only if the guard is true.
 
handler - the code that does the printing. Default: fprintf
 
param - a parameter to be passed off to the handler. Default: stdout
 
See nana.info for details on configuring the behaviour.
 

SEE ALSO

nana-clg(1), nana(1), nana(3), I(3), DI(3), L(3), DL(3), Q(3) and nana.info.
 
The nana.info file is the primary documentation for this library.

AUTHOR

Phil Maker <pjm@gnu.org>