conf: Document new filelog configuration
This commit is contained in:
parent
f6b4ba2a65
commit
bd61236b4a
|
@ -2,37 +2,38 @@ charon.filelog {}
|
||||||
Section to define file loggers, see LOGGER CONFIGURATION in
|
Section to define file loggers, see LOGGER CONFIGURATION in
|
||||||
**strongswan.conf**(5).
|
**strongswan.conf**(5).
|
||||||
|
|
||||||
charon.filelog.<filename> { # }
|
charon.filelog.<name> { # }
|
||||||
<filename> is the full path to the log file.
|
<name> may be the full path to the log file if it only contains
|
||||||
|
characters permitted in section names. Is ignored if _path_ is specified.
|
||||||
|
|
||||||
charon.filelog.<filename>.path =
|
charon.filelog.<name>.path =
|
||||||
Optional path to the log file. Overrides the section name, may be used
|
Optional path to the log file. Overrides the section name. Must be used
|
||||||
if the path contains characters that aren't allowed in section names.
|
if the path contains characters that aren't allowed in section names.
|
||||||
|
|
||||||
charon.filelog.<filename>.default = 1
|
charon.filelog.<name>.default = 1
|
||||||
Default loglevel.
|
Default loglevel.
|
||||||
|
|
||||||
Specifies the default loglevel to be used for subsystems for which no
|
Specifies the default loglevel to be used for subsystems for which no
|
||||||
specific loglevel is defined.
|
specific loglevel is defined.
|
||||||
|
|
||||||
charon.filelog.<filename>.<subsystem> = <default>
|
charon.filelog.<name>.<subsystem> = <default>
|
||||||
Loglevel for a specific subsystem.
|
Loglevel for a specific subsystem.
|
||||||
|
|
||||||
charon.filelog.<filename>.append = yes
|
charon.filelog.<name>.append = yes
|
||||||
If this option is enabled log entries are appended to the existing file.
|
If this option is enabled log entries are appended to the existing file.
|
||||||
|
|
||||||
charon.filelog.<filename>.flush_line = no
|
charon.filelog.<name>.flush_line = no
|
||||||
Enabling this option disables block buffering and enables line buffering.
|
Enabling this option disables block buffering and enables line buffering.
|
||||||
|
|
||||||
charon.filelog.<filename>.ike_name = no
|
charon.filelog.<name>.ike_name = no
|
||||||
Prefix each log entry with the connection name and a unique numerical
|
Prefix each log entry with the connection name and a unique numerical
|
||||||
identifier for each IKE_SA.
|
identifier for each IKE_SA.
|
||||||
|
|
||||||
charon.filelog.<filename>.time_format
|
charon.filelog.<name>.time_format
|
||||||
Prefix each log entry with a timestamp. The option accepts a format string
|
Prefix each log entry with a timestamp. The option accepts a format string
|
||||||
as passed to **strftime**(3).
|
as passed to **strftime**(3).
|
||||||
|
|
||||||
charon.filelog.<filename>.time_add_ms = no
|
charon.filelog.<name>.time_add_ms = no
|
||||||
Adds the milliseconds within the current second after the timestamp
|
Adds the milliseconds within the current second after the timestamp
|
||||||
(separated by a dot, so _time_format_ should end with %S or %T).
|
(separated by a dot, so _time_format_ should end with %S or %T).
|
||||||
|
|
||||||
|
|
|
@ -15,12 +15,15 @@ does not have any effect.
|
||||||
There are currently two types of loggers:
|
There are currently two types of loggers:
|
||||||
.TP
|
.TP
|
||||||
.B File loggers
|
.B File loggers
|
||||||
Log directly to a file and are defined by specifying the full path to the
|
Log directly to a file and are defined by specifying an arbitrarily named
|
||||||
file as subsection in the
|
subsection in the
|
||||||
.B charon.filelog
|
.B charon.filelog
|
||||||
section. To log to the console the two special filenames
|
section. The full path to the file is configured in the \fIpath\fR setting of
|
||||||
|
that subsection, however, if it only contains characters permitted in section
|
||||||
|
names, the setting may also be omitted and the path specified as name of the
|
||||||
|
subsection. To log to the console the two special filenames
|
||||||
.BR stdout " and " stderr
|
.BR stdout " and " stderr
|
||||||
can be used.
|
may be used.
|
||||||
.TP
|
.TP
|
||||||
.B Syslog loggers
|
.B Syslog loggers
|
||||||
Log into a syslog facility and are defined by specifying the facility to log to
|
Log into a syslog facility and are defined by specifying the facility to log to
|
||||||
|
@ -108,7 +111,8 @@ Also include sensitive material in dumps, e.g. keys
|
||||||
.EX
|
.EX
|
||||||
charon {
|
charon {
|
||||||
filelog {
|
filelog {
|
||||||
/var/log/charon.log {
|
charon {
|
||||||
|
path = /var/log/charon.log
|
||||||
time_format = %b %e %T
|
time_format = %b %e %T
|
||||||
append = no
|
append = no
|
||||||
default = 1
|
default = 1
|
||||||
|
|
Loading…
Reference in New Issue