aboutsummaryrefslogtreecommitdiffstats
path: root/doxygen/user_doc.md
blob: 5f139c74f225c4da985c83bfc366fbd2abdf4784 (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

User Documentation    {#user_doc}
==================

Several modules provide operational, dataplane-user focused documentation.

- [GUI guided user demo](https://wiki.fd.io/view/VPP_Sandbox/vpp-userdemo)
- @subpage avf_plugin_doc
- @subpage bfd_doc
- @subpage dpdk_crypto_ipsec_doc
- @subpage flowprobe_plugin_doc
- @subpage ioam_plugin_doc
- @subpage ipsec_gre_doc
- @subpage kp_plugin_doc
- @subpage lacp_plugin_doc
- @subpage lb_plugin_doc
- @subpage lldp_doc
- @subpage map_doc
- @subpage marvel_plugin_doc
- @subpage nat64_doc
- @subpage qos_doc
- @subpage selinux_doc
- @subpage span_doc
- @subpage srmpls_doc
- @subpage srv6_doc
- @subpage vcl_ldpreload_doc
* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */ } 
/* Hey Emacs use -*- mode: C -*- */
/*
 * Copyright (c) 2016 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
    This file defines the vpp control-plane API messages
    used to control the ABF plugin
*/

option version = "0.2.0";
import "vnet/ip/ip_types.api";
import "vnet/fib/fib_types.api";
import "vnet/interface_types.api";

enum cnat_translation_flags:u8
{
  CNAT_TRANSLATION_ALLOC_PORT = 1,
};

enum cnat_endpoint_tuple_flags:u8
{
  /* Dont translate said endpoint tuple but
   * still forward */
  CNAT_EPT_NO_NAT = 1,
};


enum cnat_lb_type:u8
{
  CNAT_LB_TYPE_DEFAULT = 0,
  CNAT_LB_TYPE_MAGLEV = 1,
};

/* An enpoint is either
 * An IP & a port
 * An interface, an address familiy and a port */
typedef cnat_endpoint
{
  vl_api_address_t addr;
  vl_api_interface_index_t sw_if_index;
  vl_api_address_family_t if_af;
  u16 port;
};

typedef cnat_endpoint_tuple
{
  vl_api_cnat_endpoint_t dst_ep;
  vl_api_cnat_endpoint_t src_ep;
  u8 flags;
};

typedef cnat_translation
{
  vl_api_cnat_endpoint_t vip;
  u32 id;
  vl_api_ip_proto_t ip_proto;
  u8 is_real_ip;
  u8 flags;
  vl_api_cnat_lb_type_t lb_type;
  u32 n_paths;
  vl_api_cnat_endpoint_tuple_t paths[n_paths];
};

define cnat_translation_update
{
  u32 client_index;
  u32 context;
  vl_api_cnat_translation_t translation;
};

define cnat_translation_update_reply
{
  u32 context;
  i32 retval;
  u32 id;
};

autoreply define cnat_translation_del
{
  u32 client_index;
  u32 context;
  u32 id;
};

define cnat_translation_details
{
  u32 context;
  vl_api_cnat_translation_t translation;
};

define cnat_translation_dump
{
  u32 client_index;
  u32 context;
};

autoreply define cnat_session_purge
{
  u32 client_index;
  u32 context;
};

typedef cnat_session
{
  vl_api_cnat_endpoint_t src;
  vl_api_cnat_endpoint_t dst;
  vl_api_cnat_endpoint_t new;
  vl_api_ip_proto_t ip_proto;
  u8 location;
  f64 timestamp;
};

define cnat_session_details
{
  u32 context;
  vl_api_cnat_session_t session;
};

define cnat_session_dump
{
  u32 client_index;
  u32 context;
};

autoreply define cnat_set_snat_addresses
{
  u32 client_index;
  u32 context;
  vl_api_ip4_address_t snat_ip4;
  vl_api_ip6_address_t snat_ip6;
  vl_api_interface_index_t sw_if_index;
};

define cnat_get_snat_addresses
{
  u32 client_index;
  u32 context;
};

define cnat_get_snat_addresses_reply
{
  u32 context;
  i32 retval;
  u32 id;
  vl_api_ip4_address_t snat_ip4;
  vl_api_ip6_address_t snat_ip6;
  vl_api_interface_index_t sw_if_index;
};

autoreply define cnat_snat_policy_add_del_exclude_pfx
{
  u32 client_index;
  u32 context;
  u8 is_add;
  vl_api_prefix_t prefix;
};

enum cnat_snat_policy_table:u8
{
  CNAT_POLICY_INCLUDE_V4 = 0,
  CNAT_POLICY_INCLUDE_V6 = 1,
  CNAT_POLICY_POD = 2,
};

autoreply define cnat_snat_policy_add_del_if
{
  u32 client_index;
  u32 context;
  vl_api_interface_index_t sw_if_index;
  u8 is_add;
  vl_api_cnat_snat_policy_table_t table;
};

/* A snat policy controls what traffic is srcNATed */
enum cnat_snat_policies:u8
{
  /* No filter applied, srcNAT everything */
  CNAT_POLICY_NONE = 0,
  /* Filter by interface list : snat_policy_add_del_if
   * and prefix list : snat_policy_add_del_if */
  CNAT_POLICY_IF_PFX = 1,
  /* Kubernetes specific policy */
  CNAT_POLICY_K8S = 2,
};

autoreply define cnat_set_snat_policy
{
  u32 client_index;
  u32 context;
  vl_api_cnat_snat_policies_t policy;
};

/*
 * fd.io coding-style-patch-verification: ON
 *
 * Local Variables:
 * eval: (c-set-style "gnu")
 * End:
 */