summaryrefslogtreecommitdiffstats
path: root/tools/man1/qsgrep.1
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--tools/man1/qsgrep.128
1 files changed, 28 insertions, 0 deletions
diff --git a/tools/man1/qsgrep.1 b/tools/man1/qsgrep.1
new file mode 100644
index 0000000..5bba3d9
--- /dev/null
+++ b/tools/man1/qsgrep.1
@@ -0,0 +1,28 @@
+.TH QSGREP 1 "May 2023" "mod_qos utilities 11.74" "qsgrep man page"
+
+.SH NAME
+qsgrep \- prints matching patterns within a file.
+.SH SYNOPSIS
+qsgrep \-e <pattern> \-o <sub string> [<path>]
+.SH DESCRIPTION
+qsgrep is a simple tool to search patterns within files. It uses regular expressions to find patterns and prints the submatches within a pre\-defined format string.
+.SH OPTIONS
+.TP
+\-e <pattern>
+Specifies the search pattern.
+.TP
+\-o <string>
+Defines the output string where $0\-$9 are substituted by the submatches of the regular expression.
+.TP
+<path>
+Defines the input file to process. qsgrep reads from from standard input if this parameter is omitted.
+
+.SH EXAMPLE
+Shows the IP addresses of clients causing mod_qos(031) messages):
+
+ qsgrep \-e 'mod_qos\\(031\\).*, c=([a\-zA\-Z0\-9:.]*)' \-o 'ip=$1' error_log
+
+.SH SEE ALSO
+qsdt(1), qsexec(1), qsfilter2(1), qsgeo(1), qshead(1), qslog(1), qslogger(1), qspng(1), qsre(1), qsrespeed(1), qsrotate(1), qssign(1), qstail(1)
+.SH AUTHOR
+Pascal Buchbinder, http://mod-qos.sourceforge.net/