DEBUGMSG

If you want to add Debugging output statements to your own code, you can use the following conventions:

DEBUGMSGTL

Note the double (( ))s in these statements!

DEBUGMSGTL(("token", "statement of some kind: %s\n", "with printf arguments"));

This actually outputs two lines:

• A "trace" line showing where in the source it came from (that's what the T stands for)
• Your debugging line (when -Dtoken is turned on)

This should be the most common debugging statement used. It should be used for complete debugging lines.

DEBUGMSG

For creating lines a piece at a time, start with DEBUGMSGTL followed by DEBUGMSG macros until you hit the newline ("\n"). This is a stupid example but shows how it works:

 int total = 0;
 DEBUGMSGTL(("token", "Calculating running total: "));
 for(int i = 0; i < 5; i++) {
    total = total + i;
    DEBUGMSG(("token", " %d", total));
 }
 DEBUGMSG(("token", "\n"));

DEBUGMSGOID

For printing OIDs you can use the DEBUGOID macro:

 oid my_oid[] = { 1, 3, 6, 1}
 size_t my_oid_len = 4;
 
 DEBUGMSGTL(("token", "this is my oid: "));
 DEBUGMSGOID(("token", my_oid, my_oid_len));
 DEBUGMSG(("token", "\n"));