openvpn3-admin-log-service8
Openvpn 3 linux administration - log service management
Usage
openvpn3-admin log-service
[OPTIONS]
openvpn3-admin {log-service
-h | --help}
Overview
This manages a few adjustable knobs available in the openvpn3-service-log when run as a D-Bus service. The access control for this command is managed in the D-Bus policy, which by default is only allowed for the root and _openvpn user accounts.
Options
-
-h, --help -
Print usage and help details to the terminal
-
--config-show -
Shows the contents of the configuration file used by openvpn3-service-log(8).
-
--config-set -
Modifies a configuration setting in the configuration file. Changing the configuration file will require the openvpn3-service-log(8) process to be restarted before they become active. This option requires two arguments: CONFIG-NAME and CONFIG-VALUE. Valid CONFIG-NAMEs are:
log-file-
Sets the log destination for log events. See the
--log-fileoption in the man page to openvpn3-service-log(8) for details.This cannot be set if
journaldorsysloghas been set.
colour-
Enables using colours in logged lines when logging to file. This can only be used when a log file configured.
idle-exit-
Sets the automatic idle shut down time-out. See the
--idle-exitoption in the man page for openvpn3-service-log(8) for details.
journald-
Configures openvpn3-service-log(8) to send log events to the systemd-journald(8) service. See the openvpn3-service-log(8) man page for more details.
This option cannot be combined with
syslog,log-fileorcolour.
syslog-
Configures openvpn3-service-log(8) to send log events to the locally running syslog service.
This option cannot be combined with
journald,log-fileorcolour.
syslog-facility-
Configures which syslog facility to use when logging via syslog. Default is LOG_DAEMON. This has only effect when logging via
sysloghas been enabled.
-
--config-unset -
Similar to
--config-setbut removes a setting from the configuration file.
--log-levelLEVEL-
Sets the system wide log verbosity for the log events being logged to file or any other log destination
openvpn3-service-logis configured to use. Valid values are0to6. The higher value, the more verbose the log events will be. Log level6will contain all debug events.
--timestampBOOL-
Some of the log destinations supported by
openvpn3-service-logmay allow one to log with or without timestamps. This option enables or disables timestamps attached to log events. Valid arguments:true,false.
--dbus-detailsBOOL-
Each log event contains some more detailed meta-data of the sender of the log event. This is disabled by default, but when enabled it will add a line on the log destination before the log event itself with this meta-data. This is mostly only useful when debugging and not recommended for normal production. Valid arguments:
true,false
--enable-log-prefixBOOL-
This setting is only available if openvpn3-service-log(8) is configured to use
journald. If enabled, each log line (MESSAGE=) in the journal will be prefixed with a log tag. The log tag is always logged as a journald meta data variable (O3_LOGTAG). See journalctl(1) and the--outputand--output-fieldsoptions for details. Valid arguments:true,false.
-
--list-subscriptions -
Lists all the services the log service has subscribed to.