summaryrefslogtreecommitdiffstats
path: root/src/plugins/stn/stn.api
diff options
context:
space:
mode:
authorPierre Pfister <ppfister@cisco.com>2017-09-27 16:17:31 +0200
committerFlorin Coras <florin.coras@gmail.com>2017-10-18 19:27:58 +0000
commit0906c5cfed162e6581d7652acab023d3cd0805a4 (patch)
tree8ffce0775eb69c2513490aeabed495f962441370 /src/plugins/stn/stn.api
parent0091611c3cc9e7d7291beec7932468f1e1b551eb (diff)
Plugin for IP-Address to Interface Punting
This plugin provides per-ip address to interface punting. When at least one rule is defined, the plugin receives all packets which destination is one of VPP's address but which was not processed by VPP (e.g., a TCP packet on a port that is not open, or a packet for a protocol which is not attached). Based on the set of configured rules, the destination address of each packet is used to send the packet on the associated interface. This plugin allows multiple containers to use VPP's TCP stack (or other features provided by VPP) while still being able to receive additional packets. Change-Id: I3e69bb7d98183bf5163cb9ecb564cb482de252ce Signed-off-by: Pierre Pfister <ppfister@cisco.com>
Diffstat (limited to 'src/plugins/stn/stn.api')
-rw-r--r--src/plugins/stn/stn.api61
1 files changed, 61 insertions, 0 deletions
diff --git a/src/plugins/stn/stn.api b/src/plugins/stn/stn.api
new file mode 100644
index 00000000000..07d214d852a
--- /dev/null
+++ b/src/plugins/stn/stn.api
@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2017 Cisco and/or its affiliates.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @file stn.api
+ * @brief VPP control-plane API messages for STN plugin.
+ *
+ */
+
+
+/** \brief Add/del STN rules
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param is_ip4 - 1 if address type is IPv4
+ @param ip_address - STN rule IP address
+ @param sw_if_index - Interface index
+ @param is_add - 1 if add, 0 if delete
+*/
+autoreply manual_print define stn_add_del_rule {
+ u32 client_index;
+ u32 context;
+ u8 is_ip4;
+ u8 ip_address[16];
+ u32 sw_if_index;
+ u8 is_add;
+};
+
+/** \brief Dump STN rules
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+*/
+define stn_rules_dump {
+ u32 client_index;
+ u32 context;
+};
+
+/** \brief STN response to rules request
+ @param context - sender context, to match reply w/ request
+ @param is_ip4 - 1 if address type is IPv4
+ @param ip_address - IP address
+ @param sw_if_index - Interface index
+*/
+define stn_rule_details {
+ u32 context;
+ u8 is_ip4;
+ u8 ip_address[16];
+ u32 sw_if_index;
+};
+