| Q D E V D E B U G ( )
| | | | | SOURCE: qdev_macros.txt 1.16 (12/09/2014) English PORTA - PUBLIC
----------------------------------------------------------------------------
NAME
QDEVDEBUG() - Library own built-in serial port debug
output.
SYNOPSIS
QDEVDEBUG(fmt, va...);
QDEVDEBUG(UBYTE *, [char *]);
FUNCTION
Family of these macros are tied to 'qdev' debug support
module which makes it possible to visually track program
flow at any stage and virtually in any state(interrupt,
private exception, kernel hooks, etc).
INPUTS
fmt - Standard 'txt_vcbpsnprintf()' formating options or
plain text.
va - Arguments that accompany '%' preceeded options in
'fmt'.
RETURNS
No output.
BASES
None.
NOTES
Please note, that the debug support subsystem transfers
all messages to Amiga's built-in serial port @ 9600 bps!
Redirection is possible though, via either 'sashimi' or
'sushi'.
Even though no BASES were given it does reference 'exec'
in a private way, but no need to worry about SysBase!
Macros 'QDEVDEBUG_R()' and 'QDEVDEBUG_RR()' can be used
in conjunction with 'QDEVDEBUGIO()' debug inliner macro.
They basically switch output relevance at some point and
in case of double R sustain it until the end of program.
To enable the debug facility #define ___QDEV_DEBUGINFO 1
SEE ALSO
QDEVDEBUGIO()
EXAMPLE
...
QDEVDEBUG(QDEVDBSPACE "About to poke the hardware!\n");
...
BUGS
You should not be using this debug facility in resident
binaries who cause interrupts or have children and such,
since globals who are A4 relative may not be available!
----------------------------------------------------------------------------
| |
| |