lib/srv6.h

   1 /*
   2  * SRv6 definitions
   3  * Copyright (C) 2020  Hiroki Shirokura, LINE Corporation
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License as published by the Free
   7  * Software Foundation; either version 2 of the License, or (at your option)
   8  * any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful, but WITHOUT
  11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  13  * more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; see the file COPYING; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  18  */
  19
  20 #ifndef _FRR_SRV6_H
  21 #define _FRR_SRV6_H
  22
  23 #include <zebra.h>
  24 #include "prefix.h"
  25 #include "json.h"
  26
  27 #include <arpa/inet.h>
  28 #include <netinet/in.h>
  29
  30 #define SRV6_MAX_SIDS 16
  31 #define SRV6_LOCNAME_SIZE 256
  32
  33 #ifdef __cplusplus
  34 extern "C" {
  35 #endif
  36
  37 #define sid2str(sid, str, size) \
  38         inet_ntop(AF_INET6, sid, str, size)
  39
  40 enum seg6_mode_t {
  41         INLINE,
  42         ENCAP,
  43         L2ENCAP,
  44 };
  45
  46 enum seg6local_action_t {
  47         ZEBRA_SEG6_LOCAL_ACTION_UNSPEC       = 0,
  48         ZEBRA_SEG6_LOCAL_ACTION_END          = 1,
  49         ZEBRA_SEG6_LOCAL_ACTION_END_X        = 2,
  50         ZEBRA_SEG6_LOCAL_ACTION_END_T        = 3,
  51         ZEBRA_SEG6_LOCAL_ACTION_END_DX2      = 4,
  52         ZEBRA_SEG6_LOCAL_ACTION_END_DX6      = 5,
  53         ZEBRA_SEG6_LOCAL_ACTION_END_DX4      = 6,
  54         ZEBRA_SEG6_LOCAL_ACTION_END_DT6      = 7,
  55         ZEBRA_SEG6_LOCAL_ACTION_END_DT4      = 8,
  56         ZEBRA_SEG6_LOCAL_ACTION_END_B6       = 9,
  57         ZEBRA_SEG6_LOCAL_ACTION_END_B6_ENCAP = 10,
  58         ZEBRA_SEG6_LOCAL_ACTION_END_BM       = 11,
  59         ZEBRA_SEG6_LOCAL_ACTION_END_S        = 12,
  60         ZEBRA_SEG6_LOCAL_ACTION_END_AS       = 13,
  61         ZEBRA_SEG6_LOCAL_ACTION_END_AM       = 14,
  62         ZEBRA_SEG6_LOCAL_ACTION_END_BPF      = 15,
  63         ZEBRA_SEG6_LOCAL_ACTION_END_DT46     = 16,
  64 };
  65
  66 struct seg6_segs {
  67         size_t num_segs;
  68         struct in6_addr segs[256];
  69 };
  70
  71 struct seg6local_context {
  72         struct in_addr nh4;
  73         struct in6_addr nh6;
  74         uint32_t table;
  75 };
  76
  77 struct srv6_locator {
  78         char name[SRV6_LOCNAME_SIZE];
  79         struct prefix_ipv6 prefix;
  80
  81         /*
  82          * Bit length of SRv6 locator described in
  83          * draft-ietf-bess-srv6-services-05#section-3.2.1
  84          */
  85         uint8_t block_bits_length;
  86         uint8_t node_bits_length;
  87         uint8_t function_bits_length;
  88         uint8_t argument_bits_length;
  89
  90         int algonum;
  91         uint64_t current;
  92         bool status_up;
  93         struct list *chunks;
  94
  95         uint8_t flags;
  96 #define SRV6_LOCATOR_USID (1 << 0) /* The SRv6 Locator is a uSID Locator */
  97
  98         QOBJ_FIELDS;
  99 };
 100 DECLARE_QOBJ_TYPE(srv6_locator);
 101
 102 struct srv6_locator_chunk {
 103         char locator_name[SRV6_LOCNAME_SIZE];
 104         struct prefix_ipv6 prefix;
 105
 106         /*
 107          * Bit length of SRv6 locator described in
 108          * draft-ietf-bess-srv6-services-05#section-3.2.1
 109          */
 110         uint8_t block_bits_length;
 111         uint8_t node_bits_length;
 112         uint8_t function_bits_length;
 113         uint8_t argument_bits_length;
 114
 115         /*
 116          * For Zclient communication values
 117          */
 118         uint8_t keep;
 119         uint8_t proto;
 120         uint16_t instance;
 121         uint32_t session_id;
 122
 123         uint8_t flags;
 124 };
 125
 126 struct nexthop_srv6 {
 127         /* SRv6 localsid info for Endpoint-behaviour */
 128         enum seg6local_action_t seg6local_action;
 129         struct seg6local_context seg6local_ctx;
 130
 131         /* SRv6 Headend-behaviour */
 132         struct in6_addr seg6_segs;
 133 };
 134
 135 static inline const char *seg6_mode2str(enum seg6_mode_t mode)
 136 {
 137         switch (mode) {
 138         case INLINE:
 139                 return "INLINE";
 140         case ENCAP:
 141                 return "ENCAP";
 142         case L2ENCAP:
 143                 return "L2ENCAP";
 144         default:
 145                 return "unknown";
 146         }
 147 }
 148
 149 static inline bool sid_same(
 150                 const struct in6_addr *a,
 151                 const struct in6_addr *b)
 152 {
 153         if (!a && !b)
 154                 return true;
 155         else if (!(a && b))
 156                 return false;
 157         else
 158                 return memcmp(a, b, sizeof(struct in6_addr)) == 0;
 159 }
 160
 161 static inline bool sid_diff(
 162                 const struct in6_addr *a,
 163                 const struct in6_addr *b)
 164 {
 165         return !sid_same(a, b);
 166 }
 167
 168 static inline bool sid_zero(
 169                 const struct in6_addr *a)
 170 {
 171         struct in6_addr zero = {};
 172
 173         return sid_same(a, &zero);
 174 }
 175
 176 static inline void *sid_copy(struct in6_addr *dst,
 177                 const struct in6_addr *src)
 178 {
 179         return memcpy(dst, src, sizeof(struct in6_addr));
 180 }
 181
 182 const char *
 183 seg6local_action2str(uint32_t action);
 184
 185 const char *seg6local_context2str(char *str, size_t size,
 186                                   const struct seg6local_context *ctx,
 187                                   uint32_t action);
 188
 189 int snprintf_seg6_segs(char *str,
 190                 size_t size, const struct seg6_segs *segs);
 191
 192 extern struct srv6_locator *srv6_locator_alloc(const char *name);
 193 extern struct srv6_locator_chunk *srv6_locator_chunk_alloc(void);
 194 extern void srv6_locator_free(struct srv6_locator *locator);
 195 extern void srv6_locator_chunk_free(struct srv6_locator_chunk *chunk);
 196 json_object *srv6_locator_chunk_json(const struct srv6_locator_chunk *chunk);
 197 json_object *srv6_locator_json(const struct srv6_locator *loc);
 198 json_object *srv6_locator_detailed_json(const struct srv6_locator *loc);
 199 json_object *
 200 srv6_locator_chunk_detailed_json(const struct srv6_locator_chunk *chunk);
 201
 202 #ifdef __cplusplus
 203 }
 204 #endif
 205
 206 #endif