lib/cfm.h

   1 /* Copyright (c) 2010, 2011 Nicira Networks.
   2  *
   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 #ifndef CFM_H
  17 #define CFM_H 1
  18
  19 #include <stdint.h>
  20
  21 #include "hmap.h"
  22 #include "openvswitch/types.h"
  23
  24 struct flow;
  25 struct ofpbuf;
  26
  27 #define CFM_FAULT_REASONS                  \
  28     CFM_FAULT_REASON(RECV, recv)           \
  29     CFM_FAULT_REASON(RDI, rdi)             \
  30     CFM_FAULT_REASON(MAID, maid)           \
  31     CFM_FAULT_REASON(LOOPBACK, loopback)   \
  32     CFM_FAULT_REASON(OVERFLOW, overflow)   \
  33     CFM_FAULT_REASON(OVERRIDE, override)
  34
  35 enum cfm_fault_bit_index {
  36 #define CFM_FAULT_REASON(NAME, STR) CFM_FAULT_INDEX_##NAME,
  37     CFM_FAULT_REASONS
  38 #undef CFM_FAULT_REASON
  39     CFM_FAULT_N_REASONS
  40 };
  41
  42 enum cfm_fault_reason {
  43 #define CFM_FAULT_REASON(NAME, STR) \
  44     CFM_FAULT_##NAME = 1 << CFM_FAULT_INDEX_##NAME,
  45     CFM_FAULT_REASONS
  46 #undef CFM_FAULT_REASON
  47 };
  48
  49 struct cfm_settings {
  50     uint64_t mpid;              /* The MPID of this CFM. */
  51     int interval;               /* The requested transmission interval. */
  52     bool extended;              /* Run in extended mode. */
  53     bool opup;                  /* Operational State. */
  54     uint16_t ccm_vlan;          /* CCM Vlan tag. Zero if none. */
  55     uint8_t ccm_pcp;            /* CCM Priority. Zero if none. */
  56 };
  57
  58 void cfm_init(void);
  59 struct cfm *cfm_create(const char *name);
  60 void cfm_destroy(struct cfm *);
  61 void cfm_run(struct cfm *);
  62 bool cfm_should_send_ccm(struct cfm *);
  63 void cfm_compose_ccm(struct cfm *, struct ofpbuf *packet, uint8_t eth_src[6]);
  64 void cfm_wait(struct cfm *);
  65 bool cfm_configure(struct cfm *, const struct cfm_settings *);
  66 bool cfm_should_process_flow(const struct cfm *cfm, const struct flow *);
  67 void cfm_process_heartbeat(struct cfm *, const struct ofpbuf *packet);
  68 int cfm_get_fault(const struct cfm *);
  69 bool cfm_get_opup(const struct cfm *);
  70 void cfm_get_remote_mpids(const struct cfm *, const uint64_t **rmps,
  71                           size_t *n_rmps);
  72 const char *cfm_fault_reason_to_str(int fault);
  73
  74 #endif /* cfm.h */