aboutsummaryrefslogtreecommitdiffstats
path: root/src/plugins/ip_session_redirect/ip_session_redirect_doc.rst
blob: aad87166f8ffad18f13a9a2860e189f5729d79d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
IP session redirect
===================

This plugin allows to steer packet via different paths based on the
classifier.
It leverages the VPP classifier ACL infrastructure (classifier, in_out_acl
etc), extending its capabilities to redirect traffic without having to
resort on additional VRFs.
It also allows to steer punted packets using the same mechanism.

Maturity level
--------------

Under development: it should work, but has not been thoroughly tested.

Features
--------

- steer regular or/and punt traffic using the classifier
- API

Quickstart
----------

1. configure punting

::

   ~# vppctl set punt ipv4 udp all

2. create the classifier table and uses it for punt ACL

::

   ~# vppctl classify table miss-next drop mask l3 ip4 src l4 udp src_port buckets 100000
   ~# vppctl set interface input acl intfc local0 ip4-punt-table 0

3. add session to steer punted packets

::

   ~# vppctl ip session redirect table 0 match l3 ip4 src 10.10.10.10 l4 src_port 1234 via 10.10.0.10 pg1