summaryrefslogtreecommitdiff
path: root/doc/bird.sgml
diff options
context:
space:
mode:
authorOndrej Zajicek (work) <santiago@crfreenet.org>2018-12-04 16:55:25 +0100
committerOndrej Zajicek (work) <santiago@crfreenet.org>2018-12-04 16:55:25 +0100
commit3fda08e40532245ba69e14cdac0623a138b939f9 (patch)
tree0332e47c73ab22c92df09518de90fefa89453b2a /doc/bird.sgml
parent0642fb4d456fe12e1bbeb2ffc2149433f228c02e (diff)
Unix: Change debugging options
The old behavior was that enabling debugging did many nontrivial changes in BIRD behavior. The patch changes it that these changes are generally independent. Compiling with --enable-debug now just enables compile-time debug macros, but do not automatically activate debug mode (-d) nor local mode (-l). Debug mode with output to file (-D) do not force foreground mode (-f), therefore there is no need for backgroud option (-b), which is removed. Also fixes a bug when the default log target in -D mode was stderr instead of given debug file.
Diffstat (limited to 'doc/bird.sgml')
-rw-r--r--doc/bird.sgml10
1 files changed, 6 insertions, 4 deletions
diff --git a/doc/bird.sgml b/doc/bird.sgml
index 62cf0768..386d3e8d 100644
--- a/doc/bird.sgml
+++ b/doc/bird.sgml
@@ -149,10 +149,10 @@ BIRD executable by configuring out routing protocols you don't use, and
use given configuration file instead of <it/prefix/<file>/etc/bird.conf</file>.
<tag><label id="argv-debug">-d</tag>
- enable debug messages and run bird in foreground.
+ enable debug messages to stderr, and run bird in foreground.
- <tag><label id="argv-log-file">-D <m/filename of debug log/</tag>
- log debugging information to given file instead of stderr.
+ <tag><label id="argv-debug-file">-D <m/filename of debug log/</tag>
+ enable debug messages to given file.
<tag><label id="argv-foreground">-f</tag>
run bird in foreground.
@@ -483,7 +483,9 @@ include "tablename.conf";;
<cf/auth/ about authentication failures,
<cf/bug/ for internal BIRD bugs.
You may specify more than one <cf/log/ line to establish logging to
- multiple destinations. Default: log everything to the system log.
+ multiple destinations. Default: log everything to the system log, or
+ to the debug output if debugging is enabled by <cf/-d//<cf/-D/
+ command-line option.
<tag><label id="opt-debug-protocols">debug protocols all|off|{ states|routes|filters|interfaces|events|packets [, <m/.../] }</tag>
Set global defaults of protocol debugging options. See <cf/debug/ in the