src/vnet/lldp/lldp_node.h

   1 /*
   2  * Copyright (c) 2011-2016 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 LLDP global declarations
  18  */
  19 #ifndef __included_lldp_node_h__
  20 #define __included_lldp_node_h__
  21
  22 #include <vlib/vlib.h>
  23 #include <vlib/unix/unix.h>
  24 #include <vnet/snap/snap.h>
  25 #include <vppinfra/format.h>
  26 #include <vppinfra/hash.h>
  27
  28 #include <vnet/lldp/lldp_protocol.h>
  29
  30 typedef struct lldp_intf
  31 {
  32   /* hw interface index */
  33   u32 hw_if_index;
  34
  35   /* Timers */
  36   f64 last_heard;
  37   f64 last_sent;
  38
  39   /* Info received from peer */
  40   u8 *chassis_id;
  41   u8 *port_id;
  42   u16 ttl;
  43   lldp_port_id_subtype_t port_id_subtype;
  44   lldp_chassis_id_subtype_t chassis_id_subtype;
  45
  46 } lldp_intf_t;
  47
  48 typedef struct
  49 {
  50   /* pool of lldp-enabled interface context data */
  51   lldp_intf_t *intfs;
  52
  53   /* rapidly find an interface by vlib hw interface index */
  54   uword *intf_by_hw_if_index;
  55
  56   /* Background process node index */
  57   u32 lldp_process_node_index;
  58
  59   /* interface idxs (into intfs pool) in the order of timing out */
  60   u32 *intfs_timeouts;
  61
  62   /* index of the interface which will time out next */
  63   u32 intfs_timeouts_idx;
  64
  65   /* packet template for sending out packets */
  66   vlib_packet_template_t packet_template;
  67
  68   /* convenience variables */
  69   vlib_main_t *vlib_main;
  70   vnet_main_t *vnet_main;
  71
  72   /* system name advertised over LLDP (default is none) */
  73   u8 *sys_name;
  74
  75   /* IEEE Std 802.1AB-2009:
  76    * 9.2.5.6 msgTxHold
  77    * This variable is used, as a multiplier of msgTxInterval, to determine the
  78    * value of txTTL that is carried in LLDP frames transmitted by the LLDP
  79    * agent. The recommended default value of msgTxHold is 4; this value can
  80    * be changed by management to any value in the range 1 through 100.
  81    */
  82   u8 msg_tx_hold;
  83
  84   /* IEEE Std 802.1AB-2009:
  85    * 9.2.5.7 msgTxInterval
  86    * This variable defines the time interval in timer ticks between
  87    * transmissions during normal transmission periods (i.e., txFast is zero).
  88    * The recommended default value for msgTxInterval is 30 s; this value can
  89    * be changed by management to any value in the range 1 through 3600.
  90    */
  91   u16 msg_tx_interval;
  92 } lldp_main_t;
  93
  94 #define LLDP_MIN_TX_HOLD (1)
  95 #define LLDP_MAX_TX_HOLD (100)
  96 #define LLDP_MIN_TX_INTERVAL (1)
  97 #define LLDP_MAX_TX_INTERVAL (3600)
  98
  99 extern lldp_main_t lldp_main;
 100
 101 /* Packet counters */
 102 #define foreach_lldp_error(F)                     \
 103     F(NONE, "good lldp packets (processed)")      \
 104     F(CACHE_HIT, "good lldp packets (cache hit)") \
 105     F(BAD_TLV, "lldp packets with bad TLVs")      \
 106     F(DISABLED, "lldp packets received on disabled interfaces")
 107
 108 typedef enum
 109 {
 110 #define F(sym, str) LLDP_ERROR_##sym,
 111   foreach_lldp_error (F)
 112 #undef F
 113     LLDP_N_ERROR,
 114 } lldp_error_t;
 115
 116 /* lldp packet trace capture */
 117 typedef struct
 118 {
 119   u32 len;
 120   u8 data[400];
 121 } lldp_input_trace_t;
 122
 123 enum
 124 {
 125   LLDP_EVENT_RESCHEDULE = 1,
 126 } lldp_process_event_t;
 127
 128 lldp_intf_t *lldp_get_intf (lldp_main_t * lm, u32 hw_if_index);
 129 lldp_intf_t *lldp_create_intf (lldp_main_t * lm, u32 hw_if_index);
 130 void lldp_delete_intf (lldp_main_t * lm, lldp_intf_t * n);
 131 lldp_error_t lldp_input (vlib_main_t * vm, vlib_buffer_t * b0, u32 bi0);
 132 u8 *lldp_input_format_trace (u8 * s, va_list * args);
 133 void lldp_send_ethernet (lldp_main_t * lm, lldp_intf_t * n, int shutdown);
 134 void lldp_schedule_intf (lldp_main_t * lm, lldp_intf_t * n);
 135 void lldp_unschedule_intf (lldp_main_t * lm, lldp_intf_t * n);
 136
 137 #endif /* __included_lldp_node_h__ */
 138
 139 /*
 140  * fd.io coding-style-patch-verification: ON
 141  *
 142  * Local Variables:
 143  * eval: (c-set-style "gnu")
 144  * End:
 145  */