DragonFly On-Line Manual Pages

DL(3)                 DragonFly 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, e.g. support is provided for
       sending log messages to a circular buffer.

       param - a parameter to be passed off to the handler, e.g. a file
       descriptor.

       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>

                                                                         DL(3)