src/plugins/nat/nat_ha.h

   1 /*
   2  * Copyright (c) 2019 Cisco and/or its affiliates.
   3  * Licensed under the Apache License, Version 2.0 (the "License");
   4  * you may not use this file except in compliance with the License.
   5  * You may obtain a copy of the License at:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15 /**
  16  * @file
  17  * @brief NAT active-passive HA
  18  */
  19
  20 #ifndef __included_nat_ha_h__
  21 #define __included_nat_ha_h__
  22
  23 #include <vnet/vnet.h>
  24 #include <vnet/ip/ip.h>
  25
  26 /* Call back functions for received HA events on passive/failover */
  27 typedef void (*nat_ha_sadd_cb_t) (ip4_address_t * in_addr, u16 in_port,
  28                                   ip4_address_t * out_addr, u16 out_port,
  29                                   ip4_address_t * eh_addr, u16 eh_port,
  30                                   ip4_address_t * ehn_addr, u16 ehn_port,
  31                                   u8 proto, u32 fib_index, u16 flags,
  32                                   u32 thread_index);
  33 typedef void (*nat_ha_sdel_cb_t) (ip4_address_t * out_addr, u16 out_port,
  34                                   ip4_address_t * eh_addr, u16 eh_port,
  35                                   u8 proto, u32 fib_index, u32 thread_index);
  36 typedef void (*nat_ha_sref_cb_t) (ip4_address_t * out_addr, u16 out_port,
  37                                   ip4_address_t * eh_addr, u16 eh_port,
  38                                   u8 proto, u32 fib_index, u32 total_pkts,
  39                                   u64 total_bytes, u32 thread_index);
  40
  41 /**
  42  * @brief Enable NAT HA, set callbacks
  43  */
  44 void nat_ha_enable (nat_ha_sadd_cb_t sadd_cb, nat_ha_sdel_cb_t sdel_cb,
  45                     nat_ha_sref_cb_t sref_cb);
  46
  47 /**
  48  * @brief Disable NAT HA
  49  */
  50 void nat_ha_disable ();
  51
  52 /**
  53  * @brief Initialize NAT HA
  54  */
  55 void nat_ha_init (vlib_main_t * vm, u32 num_workers, u32 num_threads);
  56
  57 /**
  58  * @brief Set HA listener (local settings)
  59  *
  60  * @param addr local IP4 address
  61  * @param port local UDP port number
  62  * @param path_mtu path MTU between local and failover
  63  *
  64  * @returns 0 on success, non-zero value otherwise.
  65  */
  66 int nat_ha_set_listener (ip4_address_t * addr, u16 port, u32 path_mtu);
  67
  68 /**
  69  * @brief Get HA listener/local configuration
  70  */
  71 void nat_ha_get_listener (ip4_address_t * addr, u16 * port, u32 * path_mtu);
  72
  73 /**
  74  * @brief Set HA failover (remote settings)
  75  *
  76  * @param addr failover IP4 address
  77  * @param port failvoer UDP port number
  78  * @param session_refresh_interval number of seconds after which to send
  79  *                                 session counters refresh
  80  *
  81  * @returns 0 on success, non-zero value otherwise.
  82  */
  83 int nat_ha_set_failover (ip4_address_t * addr, u16 port,
  84                          u32 session_refresh_interval);
  85
  86 /**
  87  * @brief Get HA failover/remote settings
  88  */
  89 void nat_ha_get_failover (ip4_address_t * addr, u16 * port,
  90                           u32 * session_refresh_interval);
  91
  92 /**
  93  * @brief Create session add HA event
  94  *
  95  * @param in_addr inside IPv4 address
  96  * @param in_port inside L4 port number
  97  * @param out_addr outside IPv4 address
  98  * @param out_port outside L4 port number
  99  * @param eh_addr external host IPv4 address
 100  * @param eh_port external host L4 port number
 101  * @param ehn_addr external host IPv4 address after translation
 102  * @param ehn_port external host L4 port number after translation
 103  * @param proto L4 protocol
 104  * @param fib_index fib index
 105  * @param flags session flags
 106  * @param thread_index thread index
 107  * @param is_resync 1 if HA resync
 108  */
 109 void nat_ha_sadd (ip4_address_t * in_addr, u16 in_port,
 110                   ip4_address_t * out_addr, u16 out_port,
 111                   ip4_address_t * eh_addr, u16 eh_port,
 112                   ip4_address_t * ehn_addr, u16 ehn_port, u8 proto,
 113                   u32 fib_index, u16 flags, u32 thread_index, u8 is_resync);
 114
 115 /**
 116  * @brief Create session delete HA event
 117  *
 118  * @param out_addr outside IPv4 address
 119  * @param out_port outside L4 port number
 120  * @param eh_addr external host IPv4 address
 121  * @param eh_port external host L4 port number
 122  * @param proto L4 protocol
 123  * @param fib_index fib index
 124  * @param thread_index thread index
 125  */
 126 void nat_ha_sdel (ip4_address_t * out_addr, u16 out_port,
 127                   ip4_address_t * eh_addr, u16 eh_port, u8 proto,
 128                   u32 fib_index, u32 thread_index);
 129
 130 /**
 131  * @brief Create session refresh HA event
 132  *
 133  * @param out_addr outside IPv4 address
 134  * @param out_port outside L4 port number
 135  * @param eh_addr external host IPv4 address
 136  * @param eh_port external host L4 port number
 137  * @param proto L4 protocol
 138  * @param fib_index fib index
 139  * @param total_pkts total packets processed
 140  * @param total_bytes total bytes processed
 141  * @param thread_index thread index
 142  * @param last_refreshed last session refresh time
 143  * @param now current time
 144  */
 145 void nat_ha_sref (ip4_address_t * out_addr, u16 out_port,
 146                   ip4_address_t * eh_addr, u16 eh_port, u8 proto,
 147                   u32 fib_index, u32 total_pkts, u64 total_bytes,
 148                   u32 thread_index, f64 * last_refreshed, f64 now);
 149
 150 /**
 151  * @brief Flush the current HA data (for testing)
 152  */
 153 void nat_ha_flush (u8 is_resync);
 154
 155 typedef void (*nat_ha_resync_event_cb_t) (u32 client_index, u32 pid,
 156                                           u32 missed_count);
 157
 158 /**
 159  * @brief Resync HA (resend existing sessions to new failover)
 160  */
 161 int nat_ha_resync (u32 client_index, u32 pid,
 162                    nat_ha_resync_event_cb_t event_callback);
 163
 164 /**
 165  * @brief Get resync status
 166  *
 167  * @param in_resync 1 if resync in progress
 168  * @param resync_ack_missed number of missed (not ACKed) messages
 169  */
 170 void nat_ha_get_resync_status (u8 * in_resync, u32 * resync_ack_missed);
 171
 172 #endif /* __included_nat_ha_h__ */
 173
 174 /*
 175  * fd.io coding-style-patch-verification: ON
 176  *
 177  * Local Variables:
 178  * eval: (c-set-style "gnu")
 179  * End:
 180  */