src/vnet/vxlan-gbp/vxlan_gbp_packet.h

   1 /*
   2  * Copyright (c) 2018 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 #ifndef __included_vxlan_gbp_packet_h__
  16 #define __included_vxlan_gbp_packet_h__ 1
  17
  18 #include <vlib/vlib.h>
  19
  20 /*
  21  * From draft-smith-vxlan-group-policy-04.txt
  22  *
  23  *  0                   1                   2                   3
  24  *  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  25  * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  26  * |G|R|R|R|I|R|R|R|R|D|E|S|A|R|R|R|        Group Policy ID        |
  27  * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  28  * |                VXLAN Network Identifier (VNI) |   Reserved    |
  29  * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  30  *
  31  * G bit: Bit 0 of the initial word is defined as the G (Group Based
  32  *   Policy Extension) bit.
  33  *
  34  * I bit: where the I flag MUST be set to 1 for a valid
  35  *   VXLAN Network ID (VNI).
  36  *
  37  * D bit: Bit 9 of the initial word is defined as the Don't Learn bit.
  38  *   When set, this bit indicates that the egress VTEP MUST NOT learn the
  39  *   source address of the encapsulated frame.
  40  *
  41  * E bit: Bit 10 of the initial word is defined as the bounce packet.
  42  *   When set, this bit indicates that packet is bounced and must be
  43  *   dropped.
  44  *
  45  * S bit: Bit 11 of the initial word is defined as the source policy
  46  *   applied bit.
  47  *
  48  * A bit: Bit 12 of the initial word is defined as the A (Policy
  49  *   Applied) bit.  This bit is only defined as the A bit when the G bit
  50  *   is set to 1.
  51  *
  52  *    A = 1 indicates that the group policy has already been applied to
  53  *    this packet.  Policies MUST NOT be applied by devices when the A
  54  *    bit is set.
  55  *
  56  *    A = 0 indicates that the group policy has not been applied to this
  57  *    packet.  Group policies MUST be applied by devices when the A bit
  58  *    is set to 0 and the destination Group has been determined.
  59  *    Devices that apply the Group policy MUST set the A bit to 1 after
  60  *    the policy has been applied.
  61  *
  62  * Group Policy ID: 16 bit identifier that indicates the source TSI
  63  *   Group membership being encapsulated by VXLAN. Its value is source
  64  *   class id.
  65  *
  66  */
  67
  68 typedef struct
  69 {
  70   union
  71   {
  72     struct
  73     {
  74       union
  75       {
  76         struct
  77         {
  78           u8 flag_g_i;
  79           u8 gpflags;
  80         };
  81         u16 flags;
  82       };
  83       u16 sclass;
  84     };
  85     u32 flags_sclass_as_u32;
  86   };
  87   u32 vni_reserved;
  88 } vxlan_gbp_header_t;
  89
  90 #define foreach_vxlan_gbp_flags    \
  91   _ (0x80, G)                      \
  92   _ (0x08, I)
  93
  94 typedef enum
  95 {
  96   VXLAN_GBP_FLAGS_NONE = 0,
  97 #define _(n,f) VXLAN_GBP_FLAGS_##f = n,
  98   foreach_vxlan_gbp_flags
  99 #undef _
 100 } __attribute__ ((packed)) vxlan_gbp_flags_t;
 101
 102 #define foreach_vxlan_gbp_gpflags \
 103 _ (0x40, D)                       \
 104 _ (0x20, E)                       \
 105 _ (0x10, S)                       \
 106 _ (0x08, A)
 107
 108 typedef enum
 109 {
 110   VXLAN_GBP_GPFLAGS_NONE = 0,
 111 #define _(n,f) VXLAN_GBP_GPFLAGS_##f = n,
 112   foreach_vxlan_gbp_gpflags
 113 #undef _
 114 } __attribute__ ((packed)) vxlan_gbp_gpflags_t;
 115
 116 static inline u32
 117 vxlan_gbp_get_vni (vxlan_gbp_header_t * h)
 118 {
 119   u32 vni_reserved_host_byte_order;
 120
 121   vni_reserved_host_byte_order = clib_net_to_host_u32 (h->vni_reserved);
 122   return vni_reserved_host_byte_order >> 8;
 123 }
 124
 125 static inline u16
 126 vxlan_gbp_get_sclass (vxlan_gbp_header_t * h)
 127 {
 128   u16 sclass_host_byte_order;
 129
 130   sclass_host_byte_order = clib_net_to_host_u16 (h->sclass);
 131   return sclass_host_byte_order;
 132 }
 133
 134 static inline vxlan_gbp_gpflags_t
 135 vxlan_gbp_get_gpflags (vxlan_gbp_header_t * h)
 136 {
 137   return h->gpflags;
 138 }
 139
 140 static inline vxlan_gbp_flags_t
 141 vxlan_gbp_get_flags (vxlan_gbp_header_t * h)
 142 {
 143   return h->flag_g_i;
 144 }
 145
 146 static inline void
 147 vxlan_gbp_set_header (vxlan_gbp_header_t * h, u32 vni)
 148 {
 149   h->vni_reserved = clib_host_to_net_u32 (vni << 8);
 150   h->flags_sclass_as_u32 = 0;
 151   h->flag_g_i = VXLAN_GBP_FLAGS_I | VXLAN_GBP_FLAGS_G;
 152 }
 153
 154 extern u8 *format_vxlan_gbp_header_flags (u8 * s, va_list * args);
 155 extern u8 *format_vxlan_gbp_header_gpflags (u8 * s, va_list * args);
 156
 157 #endif /* __included_vxlan_gbp_packet_h__ */
 158
 159 /*
 160  * fd.io coding-style-patch-verification: ON
 161  *
 162  * Local Variables:
 163  * eval: (c-set-style "gnu")
 164  * End:
 165  */