From: Laurence J. Lane <ljlane@debian.org>
Date: Sat, 24 Aug 2013 21:37:55 +0000 (-0400)
Subject: iptables: libxt_string.man add examples
X-Git-Tag: v1.4.21~12
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f70e1d675ae70f607e28ea07d8e024ccf283374a;p=thirdparty%2Fiptables.git

iptables: libxt_string.man add examples

Add usage examples for string and hex string patterns.

References: http://bugs.debian.org/699904
Signed-off-by: Laurence J. Lane <ljlane@debian.org>
Signed-off-by: Florian Westphal <fw@strlen.de>
---

diff --git a/extensions/libxt_string.man b/extensions/libxt_string.man
index b6b271d1..adc9c180 100644
--- a/extensions/libxt_string.man
+++ b/extensions/libxt_string.man
@@ -16,3 +16,13 @@ Matches the given pattern.
 .TP
 [\fB!\fP] \fB\-\-hex\-string\fP \fIpattern\fP
 Matches the given pattern in hex notation.
+.TP
+Examples:
+.IP
+# The string pattern can be used for simple text characters.
+.br
+iptables \-A INPUT \-p tcp \-\-dport 80 \-m string \-\-algo bm \-\-string 'GET /index.html' \-j LOG
+.IP
+# The hex string pattern can be used for non-printable characters, like |0D 0A| or |0D0A|.
+.br
+iptables \-p udp \-\-dport 53 \-m string \-\-algo bm \-\-from 40 \-\-to 57 \-\-hex\-string '|03|www|09|netfilter|03|org|00|'