summaryrefslogtreecommitdiffstats
path: root/src/plugins/vrrp/vrrp.api
diff options
context:
space:
mode:
authorMatthew Smith <mgsmith@netgate.com>2020-02-11 11:25:32 -0600
committerDave Barach <openvpp@barachs.net>2020-02-13 19:46:30 +0000
commit39e9428b90bc74d1bb15fc17759c8ef6ad712418 (patch)
treede9317a906a7df43bf2140a654d3b7675cab8d86 /src/plugins/vrrp/vrrp.api
parentf75defa7676759fa81ae75e7edd492572c6b8fd6 (diff)
vrrp: add plugin providing vrrp support
Type: feature Add a new plugin to support HA using VRRPv3 (RFC 5798). Change-Id: Iaa2c37e6172f8f41e9165f178f44d481f6e247b9 Signed-off-by: Matthew Smith <mgsmith@netgate.com>
Diffstat (limited to 'src/plugins/vrrp/vrrp.api')
-rw-r--r--src/plugins/vrrp/vrrp.api245
1 files changed, 245 insertions, 0 deletions
diff --git a/src/plugins/vrrp/vrrp.api b/src/plugins/vrrp/vrrp.api
new file mode 100644
index 00000000000..1894d1ccd5d
--- /dev/null
+++ b/src/plugins/vrrp/vrrp.api
@@ -0,0 +1,245 @@
+/*
+ * Copyright 2019-2020 Rubicon Communications, LLC (Netgate)
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ */
+
+option version = "1.0.0";
+
+import "vnet/interface_types.api";
+import "vnet/ip/ip_types.api";
+import "vnet/ethernet/ethernet_types.api";
+
+typedef vrrp_vr_key
+{
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 is_ipv6;
+};
+
+enum vrrp_vr_flags
+{
+ VRRP_API_VR_PREEMPT = 0x1,
+ VRRP_API_VR_ACCEPT = 0x2,
+ VRRP_API_VR_UNICAST = 0x4,
+ VRRP_API_VR_IPV6 = 0x8,
+};
+
+typedef vrrp_vr_conf
+{
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 priority;
+ u16 interval;
+ vl_api_vrrp_vr_flags_t flags;
+};
+
+/** \brief VRRP: Add or delete a VRRP virtual router
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param is_add - 0 if deleting, != 0 if adding
+ @param sw_if_index - interface backed up by this vr
+ @param vr_id - the VR ID advertised by this vr
+ @param priority - the priority advertised for this vr
+ @param interval - interval between advertisements in centiseconds
+ @param flags - bit flags for booleans - preempt, accept, unicast, ipv6
+ @param n_addrs - number of addresses being backed up by this vr
+ @param addrs - the addresses backed up by this vr
+*/
+autoreply define vrrp_vr_add_del {
+ u32 client_index;
+ u32 context;
+ u8 is_add;
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 priority;
+ u16 interval;
+ vl_api_vrrp_vr_flags_t flags;
+ u8 n_addrs;
+ vl_api_address_t addrs[n_addrs];
+};
+
+/** \brief VRRP: dump virtual router data
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param sw_if_index - interface to use as filter (0,~0 == "all")
+*/
+define vrrp_vr_dump {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+};
+
+enum vrrp_vr_state
+{
+ VRRP_API_VR_STATE_INIT = 0,
+ VRRP_API_VR_STATE_BACKUP,
+ VRRP_API_VR_STATE_MASTER,
+ VRRP_API_VR_STATE_INTF_DOWN,
+};
+
+typedef vrrp_vr_tracking
+{
+ u32 interfaces_dec;
+ u8 priority;
+};
+
+typedef vrrp_vr_runtime
+{
+ vl_api_vrrp_vr_state_t state;
+ u16 master_adv_int;
+ u16 skew;
+ u16 master_down_int;
+ vl_api_mac_address_t mac;
+ vl_api_vrrp_vr_tracking_t tracking;
+};
+
+/** \brief VRRP: VR dump response
+ @param context - sender context which was passed in the request
+ @param conf - configuration parameters for the VR
+ @param runtime - runtime state for the VR
+*/
+define vrrp_vr_details {
+ u32 context;
+ vl_api_vrrp_vr_conf_t config;
+ vl_api_vrrp_vr_runtime_t runtime;
+ u8 n_addrs;
+ vl_api_address_t addrs[n_addrs];
+};
+
+/** \brief VRRP: start or shutdown the VRRP protocol for a virtual router
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param sw_if_index - interface ID that VR is backing up
+ @param vr_id - VR ID
+ @param is_ipv6 - 1 for IPv6, 0 for IPv4
+ @param is_start - 1 to start VRRP proto on this VR, 0 to shutdown
+*/
+autoreply define vrrp_vr_start_stop {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 is_ipv6;
+ u8 is_start;
+};
+
+/** \brief VRRP: set unicast peers for a VR
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param sw_if_index - interface ID that VR is backing up
+ @param vr_id - VR ID
+ @param is_ipv6 - 1 for IPv6, 0 for IPv4
+ @param n_addrs - number of peer addresses
+ @param addrs - peer addresses
+*/
+autoreply define vrrp_vr_set_peers {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 is_ipv6;
+ u8 n_addrs;
+ vl_api_address_t addrs[n_addrs];
+};
+
+/** \brief VRRP: dump virtual router peer address data
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param sw_if_index - interface (0,~0 == "all" -> ignore is_ipv6 & vr_id))
+ @param is_ipv6 - 0 -> IPv4, 1 -> IPv6
+ @param vr_id - ID of VR to dump
+*/
+define vrrp_vr_peer_dump {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 is_ipv6;
+ u8 vr_id;
+};
+
+/** \brief VRRP: VR peer dump response
+ @param context - sender context which was passed in the request
+ @param sw_if_index - interface index
+ @param is_ipv6 - 0 -> IPv4, 1 -> IPv6
+ @param vr_id - ID of VR
+ @param n_peer_addrs - number of peer addresses
+ @param peer_addrs - peer addresses
+*/
+autoreply define vrrp_vr_peer_details {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 is_ipv6;
+ u8 n_peer_addrs;
+ vl_api_address_t peer_addrs[n_peer_addrs];
+};
+
+/** \brief VR interface tracking
+ @param sw_if_index - the interface index to track (not the VR sw_if_index)
+ @param priority - the adjustment to VR priority if intf is down
+*/
+typedef vrrp_vr_track_if
+{
+ vl_api_interface_index_t sw_if_index;
+ u8 priority;
+};
+
+/** \brief VRRP: Add/delete VR priority tracking of interface status
+ @param context - sender context which was passed in the request
+ @param sw_if_index - interface index
+ @param is_ipv6 - 0 -> IPv4, 1 -> IPv6
+ @param vr_id - ID of VR
+ @param is_add - 0 -> delete, 1 -> add
+ @param n_ifs - number of interface tracking records
+ @param ifs - array of interface tracking records
+*/
+autoreply define vrrp_vr_track_if_add_del
+{
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 is_ipv6;
+ u8 vr_id;
+ u8 is_add;
+ u8 n_ifs;
+ vl_api_vrrp_vr_track_if_t ifs[n_ifs];
+};
+
+/** \brief VRRP: dump virtual router interface tracking data
+ @param client_index - opaque cookie to identify the sender
+ @param context - sender context, to match reply w/ request
+ @param sw_if_index - interface
+ @param is_ipv6 - 0 -> IPv4, 1 -> IPv6
+ @param vr_id - ID of VR to dump
+ @param dump_all - dump all VR interface tracking, ignore other fields
+*/
+define vrrp_vr_track_if_dump {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 is_ipv6;
+ u8 vr_id;
+ u8 dump_all;
+};
+
+/** \brief VRRP: VR interface tracking dump response
+ @param context - sender context which was passed in the request
+ @param sw_if_index - interface index
+ @param is_ipv6 - 0 -> IPv4, 1 -> IPv6
+ @param vr_id - ID of VR
+ @param n_ifs - number of tracked interfaces
+ @param ifs - array of tracked interface data
+*/
+autoreply define vrrp_vr_track_if_details {
+ u32 client_index;
+ u32 context;
+ vl_api_interface_index_t sw_if_index;
+ u8 vr_id;
+ u8 is_ipv6;
+ u8 n_ifs;
+ vl_api_vrrp_vr_track_if_t ifs[n_ifs];
+};
+