summaryrefslogtreecommitdiffstats
path: root/tools/man1/qslogger.1
diff options
context:
space:
mode:
Diffstat (limited to 'tools/man1/qslogger.1')
-rw-r--r--tools/man1/qslogger.141
1 files changed, 41 insertions, 0 deletions
diff --git a/tools/man1/qslogger.1 b/tools/man1/qslogger.1
new file mode 100644
index 0000000..8c8961f
--- /dev/null
+++ b/tools/man1/qslogger.1
@@ -0,0 +1,41 @@
+.TH QSLOGGER 1 "May 2023" "mod_qos utilities 11.74" "qslogger man page"
+
+.SH NAME
+qslogger \- another shell command interface to the system log module (syslog).
+.SH SYNOPSIS
+qslogger [\-t <tag>] [\-f <facility>] [\-l <level>] [\-x <prefix>] [\-r <expression>] [\-d <level>] [\-u <name>] [\-p]
+.SH DESCRIPTION
+Use this utility to forward log messages to the systems syslog facility, e.g., to forward the messages to a remote host. It reads data from stdin.
+.SH OPTIONS
+
+.TP
+\-t <tag>
+Defines the tag name which shall be used to define the origin of the messages, e.g. 'httpd'.
+.TP
+\-f <facility>
+Defines the syslog facility. Default is 'daemon'.
+.TP
+\-u <name>
+Becomes another user, e.g. www\-data.
+.TP
+\-l <level>
+Defines the minimal severity a message must have in order to be forwarded. Default is 'DEBUG' (forwarding everything).
+.TP
+\-x <prefix>
+Allows you to add a prefix (literal string) to every message.
+.TP
+\-r <expression>
+Specifies a regular expression which shall be used to determine the severity (syslog level) for each log line. The default pattern '^\\[[0\-9a\-zA\-Z :]+\\] \\[([a\-z]+)\\] ' can be used for Apache error log messages but you may configure your own pattern matching other log formats. Use brackets to define the pattern enclosing the severity string. Default level (if severity can't be determined) is defined by the option '\-d' (see below).
+.TP
+\-d <level>
+The default severity if the specified pattern (\-r) does not match and the message's severity can't be determined. Default is 'NOTICE'.
+.TP
+\-p
+Writes data also to stdout (for piped logging).
+.SH EXAMPLE
+ ErrorLog "|/usr/bin/qslogger \-t apache \-f local7"
+
+.SH SEE ALSO
+qsdt(1), qsexec(1), qsfilter2(1), qsgeo(1), qsgrep(1), qshead(1), qslog(1), qspng(1), qsre(1), qsrespeed(1), qsrotate(1), qssign(1), qstail(1)
+.SH AUTHOR
+Pascal Buchbinder, http://mod-qos.sourceforge.net/