summaryrefslogtreecommitdiffstats
path: root/tools/man1/qsgrep.1
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-09-17 03:51:28 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-09-17 03:51:28 +0000
commit2b07c041cb218eca6e548bac9c4347f8a90c474c (patch)
tree679142f3916fa927903c6f245896f5c0325a3254 /tools/man1/qsgrep.1
parentInitial commit. (diff)
downloadlibapache2-mod-qos-2b07c041cb218eca6e548bac9c4347f8a90c474c.tar.xz
libapache2-mod-qos-2b07c041cb218eca6e548bac9c4347f8a90c474c.zip
Adding upstream version 11.74.upstream/11.74upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'tools/man1/qsgrep.1')
-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/