<log>
The log option indicates whether to log events such as errors that occur in c-tree. This feature might be helpful for diagnostics purposes.
Attributes
Attribute
Description
Synonyms
file
Specifies the log file name. If omitted the log messages are redirected to the standard error stream (stderr).
n/a
Accepted Values
Value
Effect
Synonyms
yes
Turns on logging of errors and generic information.
y, true, on, 1
no
Turns off logging. This is the default value.
n, false, off, 0
Additionally the log option may accept the following sub-options to specify which event to log:
Option
Description
<debug>
Indicates to log debug information.
The following children elements are supported:
<config>: include explicit configuration in the log
<config full=”yes”>: include full configuration in the log
<error>
Indicates to log errors.
The following children elements are supported:
<atend>: log EOF errors
<notfound>: log NOTFOUND errors
<duplicate>: log DUPLICATE errors
<info>
Indicates to log generic information.
<profile>
Indicates to log performance profiling information.
<warning>
Indicates to insert a warning into the log file.
Examples
The following example turns on implicit logging of errors and generic information to standard error stream:
<log>yes</log>
The following example turns on explicit logging of errors and generic information to file mylog.txt:
<log file="mylog.txt">
   <error>yes</error>
   <info>yes</info>
</log>