Oracle 5.0 Reference Manual page 2848

You use the debug package by invoking a program with the
Most MySQL programs have a default debug string that is used if you don't specify an option
to --debug. The default trace file is usually
\program_name.trace
The debug control string is a sequence of colon-separated fields as follows:
<field_1>:<field_2>:...:<field_N>
Each field consists of a mandatory flag character followed by an optional "," and comma-separated list
of modifiers:
flag[,modifier,modifier,...,modifier]
The following table shows the currently recognized flag characters.
Flag Description
Enable output from DBUG_<N> macros for the current state. May be followed by a list of
d
keywords which selects output only for the DBUG macros with that keyword. An empty list of
keywords implies output for all macros.
Delay after each debugger output line. The argument is the number of tenths of seconds to
D
delay, subject to machine capabilities. For example,
Limit debugging, tracing, and profiling to the list of named functions. Note that a null list disables
f
all functions. The appropriate
they are enabled.
Identify the source file name for each line of debug or trace output.
F
Identify the process with the PID or thread ID for each line of debug or trace output.
i
Enable profiling. Create a file called
g
to profile the program. May be followed by a list of keywords that select profiling only for the
functions in that list. A null list implies that all functions are considered.
Identify the source file line number for each line of debug or trace output.
L
Print the current function nesting depth for each line of debug or trace output.
n
Number each line of debug output.
N
Redirect the debugger output stream to the specified file. The default output is stderr.
o
Like o, but the file is really flushed between each write. When needed, the file is closed and
O
reopened between each write.
Limit debugger actions to specified processes. A process must be identified with the
p
DBUG_PROCESS
Print the current process name for each line of debug or trace output.
P
When pushing a new state, do not inherit the previous state's function nesting level. Useful when
r
the output is to start at the left margin.
Do function
S _sanity(_file_,_line_)
something that differs from 0. (Mostly used with
Enable function call/exit trace lines. May be followed by a list (containing only one modifier)
t
giving a numeric maximum trace level, beyond which no output occurs for either debugging or
tracing macros. The default is a compile time option.
Some examples of debug control strings that might appear on a shell command line (the
used to introduce a control string to an application program) are:
-#d:t
-#d:f,main,subr1:F:L:t,20
-#d,input,output,files:n
The DBUG Package
/tmp/program_name.trace
on Windows.
or flags must still be given; this flag only limits their actions if
d t
dbugmon.out
macro and match one in the list for debugger actions to occur.
2828
--debug="..."
specifies a delay of two seconds.
-#D,20
containing information that can be used
at each debugged function until
to find memory leaks)
safemalloc
or the option.
-#...
on Unix and
returns
_sanity()
is typically
-#