Jerry/bird
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Doc: Document log rotation feature

Browse source
This commit is contained in:
Ondrej Zajicek (work) 2018-12-12 16:54:23 +01:00
parent 0f40405fc9
commit 6b5ad2066a
1 changed files with 13 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
doc/bird.sgml
View file

@ -471,17 +471,25 @@ ipv6 table
include "tablename.conf";; include "tablename.conf";;
</code> </code>
<tag><label id="opt-log">log "<m/filename/"|syslog [name <m/name/]|stderr all|{ <m/list of classes/ }</tag> <tag><label id="opt-log">log "<m/filename/" [<m/limit/ "<m/backup/"] | syslog [name <m/name/] | stderr all|{ <m/list of classes/ }</tag>
Set logging of messages having the given class (either <cf/all/ or Set logging of messages having the given class (either <cf/all/ or <cf>{
<cf/{ error|trace [, <m/.../] }/ etc.) into selected destination (a file specified error|trace [, <m/.../] }</cf> etc.) into selected destination - a file
as a filename string, syslog with optional name argument, or the stderr specified as a filename string (with optional log rotation information),
output). Classes are: syslog (with optional name argument), or the stderr output.
Classes are:
<cf/info/, <cf/warning/, <cf/error/ and <cf/fatal/ for messages about local problems, <cf/info/, <cf/warning/, <cf/error/ and <cf/fatal/ for messages about local problems,
<cf/debug/ for debugging messages, <cf/debug/ for debugging messages,
<cf/trace/ when you want to know what happens in the network, <cf/trace/ when you want to know what happens in the network,
<cf/remote/ for messages about misbehavior of remote machines, <cf/remote/ for messages about misbehavior of remote machines,
<cf/auth/ about authentication failures, <cf/auth/ about authentication failures,
<cf/bug/ for internal BIRD bugs. <cf/bug/ for internal BIRD bugs.
Logging directly to file supports basic log rotation -- there is an
optional log file limit and a backup filename, when log file reaches the
limit, the current log file is renamed to the backup filename and a new
log file is created.
You may specify more than one <cf/log/ line to establish logging to You may specify more than one <cf/log/ line to establish logging to
multiple destinations. Default: log everything to the system log, or multiple destinations. Default: log everything to the system log, or
to the debug output if debugging is enabled by <cf/-d//<cf/-D/ to the debug output if debugging is enabled by <cf/-d//<cf/-D/