HP-UX Reference (11i v2 04/09) - 4 File Formats (vol 8)

n
named.conf(4) named.conf(4)
trace. The global debug level can be set to zero, and debugging mode turned off, by running
rndc
notrace. All debugging messages in the server have a debug level, and higher debug levels give more
detailed output. For example:
channel "specific_debug_level" {
file "foo";
severity debug 3;
};
In the above example, channels that specify a particular debug severity will get debugging output of level
3 or less any time the server is in debugging mode, regardless of the global debugging level. Channels
with
dynamic severity use the server’s global level to determine what messages to print.
If
print-time has been turned on, then the date and time will be logged.
print-time may be
specified for a syslog channel, but is usually pointless since
syslog also prints the date and time. If
print-category
is requested, then the category of the message will be logged as well. Finally, if
print-severity
is ON, then the severity level of the message will be logged. The
print- options
may be used in any combination, and will always be printed in the order: time, category, severity. Here
is an example where all three
print- options are ON:
28-Feb-2000 15:05:32.863 general: notice: running
There are four pre-defined channels that are used for named’s default logging as follows:
channel "default_syslog" {
syslog daemon; // send to syslog’s daemon
// facility
severity info; // only send priority info
// and higher
};
channel "default_debug" {
file "named.run"; // write to named.run in
// the working directory
// Note: stderr is used instead
// of "named.run"
// if the server is started
// with the ’-f’ option.
severity dynamic; // log at the server’s
// current debug level
};
channel "default_stderr" { // writes to stderr
stderr;
severity info; // only send priority info
// and higher
};
channel "null" {
null; // toss anything sent to
// this channel
};
The
default_debug channel has the special property that it only produces output when the server’s
debug level is a non-zero value. It normally writes to a file named.run in the server’s working directory.
For security reasons, when the
-u command line option is used, the named.run file is created only after
named has changed to the new UID, and any debug output is generated while named is starting up and
still running as root is discarded. If you need to capture this output, you must run the server with the -g
option and redirect standard error to a file.
Once a channel is defined, it cannot be redefined. Thus you cannot alter the built-in channels directly,
but you can modify the default logging by pointing categories at channels you have defined.
The category Phrase
Pre-defined categories allow the administrator to fine-tune what messages they want to log and where
they want to log those messages to. If a list of channels is not specified for a category, then log messages
HP-UX 11i Version 2: September 2004 − 6 − Hewlett-Packard Company Section 4−−181