summaryrefslogtreecommitdiffstats
path: root/utils/ipset_list/README.md
diff options
context:
space:
mode:
authorJozsef Kadlecsik <kadlec@blackhole.kfki.hu>2014-03-07 13:10:01 +0100
committerJozsef Kadlecsik <kadlec@blackhole.kfki.hu>2014-03-07 13:10:01 +0100
commit9ba98c2018733a692bdcd503195064881192fb76 (patch)
tree32743d4312993ca77e07e066b57a24f3ea30f388 /utils/ipset_list/README.md
parenta72a12ae098987b900c38c3ff1715b669d0385c0 (diff)
The bash utilities are updated
Diffstat (limited to 'utils/ipset_list/README.md')
-rw-r--r--utils/ipset_list/README.md11
1 files changed, 10 insertions, 1 deletions
diff --git a/utils/ipset_list/README.md b/utils/ipset_list/README.md
index 4806252..579d3bf 100644
--- a/utils/ipset_list/README.md
+++ b/utils/ipset_list/README.md
@@ -1,7 +1,8 @@
ipset_list
==========
-ipset set listing wrapper script
+ipset set listing wrapper script written for the bash shell.
+It allows you to match and display sets, headers and elements in various ways.
Features:
@@ -12,10 +13,13 @@ Features:
- Choose a delimiter character for separating members.
- Show only sets containing a specific (glob matching) header.
- Arithmetic comparison on headers with an integer value.
+- Arithmetic comparison on flags of the headers 'Header' field.
+- Arithmetic comparison on member options with an integer value.
- Match members using a globbing or regex pattern.
- Suppress listing of (glob matching) sets.
- Suppress listing of (glob matching) headers.
- Suppress listing of members matching a glob or regex pattern.
+- Suppress listing of members options.
- Calculate the total size in memory of all matching sets.
- Calculate the amount of matching, excluded and traversed sets.
- Colorize the output.
@@ -62,5 +66,10 @@ Examples:
- `ipset_list -c -t -Cs -Ts -Xh "@(Size*|Re*|Header):*" -Ht "!(bitmap:*)"` - find all sets not of any bitmap type, count their members sum, display only the 'Type' header, count amount of matching and traversed sets.
- `ipset_list -Co -c -Ts -Tm` - show all set names, count their members, count total amount of sets, show total memory usage of all sets, colorize the output
- `ipset_list -m -r -To 0` - show members of all sets, try to resolve hosts, set the timeout to 0 (effectivly disabling it).
+- `ipset_list -m -Xo setA` - show members of setA, but suppress displaying of the elements options.
+- `ipset_list -m -Oi packets:0` - show members of all sets which have a packet count of 0.
+- `ipset_list -m -Oi "packets:>100" -Oi "bytes:>1024"` - show members of all sets which have a packet count greater than 100 and a byte count greater than 1024.
+- `ipset_list -n -Ca "foo*"` - show only set names matching the glob "foo*" and enable all counters.
+- `ipset_list -Hi "markmask:>=0x0000beef" -Hi timeout:\!10000` - show only sets with the header 'Header' fields containing a markmask greater or equal to 0x0000beef and a timeout which is not 10000.