|
|
049c96 |
From 0ea28e2d5095b69850f1ac2ebe49880f8b0f81f8 Mon Sep 17 00:00:00 2001
|
|
|
049c96 |
From: Phil Sutter <psutter@redhat.com>
|
|
|
049c96 |
Date: Thu, 18 Feb 2016 15:45:21 +0100
|
|
|
049c96 |
Subject: [PATCH] tc: add a man page for route filter
|
|
|
049c96 |
|
|
|
049c96 |
Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1286711
|
|
|
049c96 |
Upstream Status: iproute2.git commit 02dddd6110309
|
|
|
049c96 |
|
|
|
049c96 |
commit 02dddd6110309ac37e72c418cfd96684dc763f3e
|
|
|
049c96 |
Author: Phil Sutter <phil@nwl.cc>
|
|
|
049c96 |
Date: Fri Oct 23 19:47:13 2015 +0200
|
|
|
049c96 |
|
|
|
049c96 |
tc: add a man page for route filter
|
|
|
049c96 |
|
|
|
049c96 |
Cc: Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>
|
|
|
049c96 |
Signed-off-by: Phil Sutter <phil@nwl.cc>
|
|
|
049c96 |
---
|
|
|
049c96 |
man/man8/tc-route.8 | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
049c96 |
1 file changed, 74 insertions(+)
|
|
|
049c96 |
create mode 100644 man/man8/tc-route.8
|
|
|
049c96 |
|
|
|
049c96 |
diff --git a/man/man8/tc-route.8 b/man/man8/tc-route.8
|
|
|
049c96 |
new file mode 100644
|
|
|
049c96 |
index 0000000..b865cd1
|
|
|
049c96 |
--- /dev/null
|
|
|
049c96 |
+++ b/man/man8/tc-route.8
|
|
|
049c96 |
@@ -0,0 +1,74 @@
|
|
|
049c96 |
+.TH "Route classifier in tc" 8 "21 Oct 2015" "iproute2" "Linux"
|
|
|
049c96 |
+
|
|
|
049c96 |
+.SH NAME
|
|
|
049c96 |
+route \- route traffic control filter
|
|
|
049c96 |
+.SH SYNOPSIS
|
|
|
049c96 |
+.in +8
|
|
|
049c96 |
+.ti -8
|
|
|
049c96 |
+.BR tc " " filter " ... " route " [ " from
|
|
|
049c96 |
+.IR REALM " | "
|
|
|
049c96 |
+.B fromif
|
|
|
049c96 |
+.IR TAG " ] [ "
|
|
|
049c96 |
+.B to
|
|
|
049c96 |
+.IR REALM " ] [ "
|
|
|
049c96 |
+.B classid
|
|
|
049c96 |
+.IR CLASSID " ] [ "
|
|
|
049c96 |
+.B action
|
|
|
049c96 |
+.IR ACTION_SPEC " ]"
|
|
|
049c96 |
+.SH DESCRIPTION
|
|
|
049c96 |
+Match packets based on routing table entries. This filter centers around the
|
|
|
049c96 |
+possibility to assign a
|
|
|
049c96 |
+.B realm
|
|
|
049c96 |
+to routing table entries. For any packet to be classified by this filter, a
|
|
|
049c96 |
+routing table lookup is performed and the returned
|
|
|
049c96 |
+.B realm
|
|
|
049c96 |
+is used to decide on whether the packet is a match or not.
|
|
|
049c96 |
+.SH OPTIONS
|
|
|
049c96 |
+.TP
|
|
|
049c96 |
+.BI action " ACTION_SPEC"
|
|
|
049c96 |
+Apply an action from the generic actions framework on matching packets.
|
|
|
049c96 |
+.TP
|
|
|
049c96 |
+.BI classid " CLASSID"
|
|
|
049c96 |
+Push matching packets into the class identified by
|
|
|
049c96 |
+.IR CLASSID .
|
|
|
049c96 |
+.TP
|
|
|
049c96 |
+.BI from " REALM"
|
|
|
049c96 |
+.TQ
|
|
|
049c96 |
+.BI fromif " TAG"
|
|
|
049c96 |
+Perform source route lookups.
|
|
|
049c96 |
+.I TAG
|
|
|
049c96 |
+is the name of an interface which must be present on the system at the time of
|
|
|
049c96 |
+.B tc
|
|
|
049c96 |
+invocation.
|
|
|
049c96 |
+.TP
|
|
|
049c96 |
+.BI to " REALM"
|
|
|
049c96 |
+Match if normal (i.e., destination) routing returns the given
|
|
|
049c96 |
+.IR REALM .
|
|
|
049c96 |
+.SH EXAMPLES
|
|
|
049c96 |
+Consider the subnet 192.168.2.0/24 being attached to eth0:
|
|
|
049c96 |
+
|
|
|
049c96 |
+.RS
|
|
|
049c96 |
+.EX
|
|
|
049c96 |
+ip route add 192.168.2.0/24 dev eth0 realm 2
|
|
|
049c96 |
+.EE
|
|
|
049c96 |
+.RE
|
|
|
049c96 |
+
|
|
|
049c96 |
+The following
|
|
|
049c96 |
+.B route
|
|
|
049c96 |
+filter will then match packets from that subnet:
|
|
|
049c96 |
+
|
|
|
049c96 |
+.RS
|
|
|
049c96 |
+.EX
|
|
|
049c96 |
+tc filter add ... route from 2 classid 1:2
|
|
|
049c96 |
+.EE
|
|
|
049c96 |
+.RE
|
|
|
049c96 |
+
|
|
|
049c96 |
+and pass packets on to class 1:2.
|
|
|
049c96 |
+.SH NOTES
|
|
|
049c96 |
+Due to implementation details,
|
|
|
049c96 |
+.B realm
|
|
|
049c96 |
+values must be in a range from 0 to 255, inclusive. Alternatively, a verbose
|
|
|
049c96 |
+name defined in /etc/iproute2/rt_realms may be given instead.
|
|
|
049c96 |
+.SH SEE ALSO
|
|
|
049c96 |
+.BR tc (8),
|
|
|
049c96 |
+.BR ip-route (8)
|
|
|
049c96 |
--
|
|
|
049c96 |
1.8.3.1
|
|
|
049c96 |
|