src/vnet/bfd/bfd_udp.h

   1 /* * Copyright (c) 2011-2016 Cisco and/or its affiliates.
   2  * Licensed under the Apache License, Version 2.0 (the "License");
   3  * you may not use this file except in compliance with the License.
   4  * You may obtain a copy of the License at:
   5  *
   6  *     http://www.apache.org/licenses/LICENSE-2.0
   7  *
   8  * Unless required by applicable law or agreed to in writing, software
   9  * distributed under the License is distributed on an "AS IS" BASIS,
  10  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  11  * See the License for the specific language governing permissions and
  12  * limitations under the License.
  13  */
  14 /**
  15  * @file
  16  * @brief BFD UDP transport layer declarations
  17  */
  18
  19 #ifndef __included_bfd_udp_h__
  20 #define __included_bfd_udp_h__
  21
  22 #include <vppinfra/clib.h>
  23 #include <vnet/adj/adj_types.h>
  24 #include <vnet/ip/ip6_packet.h>
  25 #include <vnet/bfd/bfd_api.h>
  26
  27 /** identifier of BFD session based on UDP transport only */
  28 typedef CLIB_PACKED (struct {
  29   union {
  30     /** interface to which the session is tied - single-hop */
  31     u32 sw_if_index;
  32     /** the FIB index the peer is in - multi-hop*/
  33     u32 fib_index;
  34   };
  35   /** local address */
  36   ip46_address_t local_addr;
  37   /** peer address */
  38   ip46_address_t peer_addr;
  39 }) bfd_udp_key_t;
  40
  41 /** UDP transport specific data embedded in bfd_session's union */
  42 typedef struct
  43 {
  44   /** key identifying this session */
  45   bfd_udp_key_t key;
  46   /** adjacency index returned from adj lock call */
  47   adj_index_t adj_index;
  48 } bfd_udp_session_t;
  49
  50 /** bfd udp echo packet trace capture */
  51 typedef struct
  52 {
  53   u32 len;
  54   u8 data[400];
  55 } bfd_udp_echo_input_trace_t;
  56
  57 struct bfd_session_s;
  58
  59 /**
  60  * @brief add the necessary transport layer by prepending it to existing data
  61  *
  62  *
  63  * @param is_echo 1 if this is echo packet, 0 if control frame
  64  *
  65  * @return 1 on success, 0 on failure
  66  */
  67 int bfd_add_udp4_transport (vlib_main_t * vm, u32 bi,
  68                             const struct bfd_session_s *bs, int is_echo);
  69
  70 /**
  71  * @brief add the necessary transport layer by prepending it to existing data
  72  *
  73  * @param is_echo 1 if this is echo packet, 0 if control frame
  74  *
  75  * @return 1 on success, 0 on failure
  76  */
  77 int bfd_add_udp6_transport (vlib_main_t * vm, u32 bi,
  78                             const struct bfd_session_s *bs, int is_echo);
  79
  80 /**
  81  * @brief transport packet over udpv4
  82  *
  83  * @return 1 on success, 0 on failure
  84  */
  85 int bfd_transport_udp4 (vlib_main_t *vm, vlib_node_runtime_t *rt, u32 bi,
  86                         const struct bfd_session_s *bs, int is_echo);
  87
  88 /**
  89  * @brief transport packet over udpv6
  90  *
  91  * @return 1 on success, 0 on failure
  92  */
  93 int bfd_transport_udp6 (vlib_main_t *vm, vlib_node_runtime_t *rt, u32 bi,
  94                         const struct bfd_session_s *bs, int is_echo);
  95
  96 /**
  97  * @brief check if the bfd udp layer is echo-capable at this time
  98  *
  99  * @return 1 if available, 0 otherwise
 100  */
 101 int bfd_udp_is_echo_available (bfd_transport_e transport);
 102
 103 /**
 104  * @brief get echo source information - used by CLI
 105  */
 106 void bfd_udp_get_echo_source (int *is_set, u32 * sw_if_index,
 107                               int *have_usable_ip4, ip4_address_t * ip4,
 108                               int *have_usable_ip6, ip6_address_t * ip6);
 109
 110 #endif /* __included_bfd_udp_h__ */
 111
 112 /*
 113  * fd.io coding-style-patch-verification: ON
 114  *
 115  * Local Variables:
 116  * eval: (c-set-style "gnu")
 117  * End:
 118  */