src/vnet/dhcp/dhcp_proxy.h

   1 /*
   2  * dhcp_proxy.h: DHCP v4 & v6 proxy common functions/types
   3  *
   4  * Copyright (c) 2013 Cisco and/or its affiliates.
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at:
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 #ifndef included_dhcp_proxy_h
  19 #define included_dhcp_proxy_h
  20
  21 #include <vnet/vnet.h>
  22 #include <vnet/dhcp/dhcp4_packet.h>
  23 #include <vnet/ethernet/ethernet.h>
  24 #include <vnet/ip/ip.h>
  25 #include <vnet/ip/ip4.h>
  26 #include <vnet/ip/ip4_packet.h>
  27 #include <vnet/pg/pg.h>
  28 #include <vnet/ip/format.h>
  29 #include <vnet/udp/udp.h>
  30
  31 typedef enum
  32 {
  33 #define dhcp_proxy_error(n,s) DHCP_PROXY_ERROR_##n,
  34 #include <vnet/dhcp/dhcp4_proxy_error.def>
  35 #undef dhcp_proxy_error
  36   DHCP_PROXY_N_ERROR,
  37 } dhcp_proxy_error_t;
  38
  39 typedef enum
  40 {
  41 #define dhcpv6_proxy_error(n,s) DHCPV6_PROXY_ERROR_##n,
  42 #include <vnet/dhcp/dhcp6_proxy_error.def>
  43 #undef dhcpv6_proxy_error
  44   DHCPV6_PROXY_N_ERROR,
  45 } dhcpv6_proxy_error_t;
  46
  47
  48 /**
  49  * @brief The Virtual Sub-net Selection information for a given RX FIB
  50  */
  51 typedef struct dhcp_vss_t_
  52 {
  53     /**
  54      * @brief VSS type as defined in RFC 6607:
  55      *   0 for NVT ASCII VPN Identifier
  56      *   1 for RFC 2685 VPN-ID of 7 octects - 3 bytes OUI & 4 bytes VPN index
  57      *   255 for global default VPN
  58      */
  59   u8 vss_type;
  60 #define VSS_TYPE_ASCII 0
  61 #define VSS_TYPE_VPN_ID 1
  62 #define VSS_TYPE_INVALID 123
  63 #define VSS_TYPE_DEFAULT 255
  64     /**
  65      * @brief Type 1 VPN-ID
  66      */
  67   u8 vpn_id[7];
  68     /**
  69      * @brief Type 0 ASCII VPN Identifier
  70      */
  71   u8 *vpn_ascii_id;
  72 } dhcp_vss_t;
  73
  74 /**
  75  * @brief A representation of a single DHCP Server within a given VRF config
  76  */
  77 typedef struct dhcp_server_t_
  78 {
  79     /**
  80      * @brief The address of the DHCP server to which to relay the client's
  81      *        messages
  82      */
  83   ip46_address_t dhcp_server;
  84
  85     /**
  86      * @brief The FIB index (not the external Table-ID) in which the server
  87      *        is reachable.
  88      */
  89   u32 server_fib_index;
  90 } dhcp_server_t;
  91
  92 /**
  93  * @brief A DHCP proxy represenation fpr per-client VRF config
  94  */
  95 typedef struct dhcp_proxy_t_
  96 {
  97     /**
  98      * @brief The set of DHCP servers to which messages are relayed.
  99      *  If multiple servers are configured then discover/solict messages
 100      * are relayed to each. A cookie is maintained for the relay, and only
 101      * one message is replayed to the client, based on the presence of the
 102      * cookie.
 103      * The expectation is there are only 1 or 2 servers, hence no fancy DB.
 104      */
 105   dhcp_server_t *dhcp_servers;
 106
 107     /**
 108      * @brief Hash table of pending requets key'd on the clients MAC address
 109      */
 110   uword *dhcp_pending;
 111
 112     /**
 113      * @brief A lock for the pending request DB.
 114      */
 115   int lock;
 116
 117     /**
 118      * @brief The source address to use in relayed messaes
 119      */
 120   ip46_address_t dhcp_src_address;
 121
 122     /**
 123      * @brief The FIB index (not the external Table-ID) in which the client
 124      *        is resides.
 125      */
 126   u32 rx_fib_index;
 127 } dhcp_proxy_t;
 128
 129 #define DHCP_N_PROTOS (FIB_PROTOCOL_IP6 + 1)
 130
 131 /**
 132  * @brief Collection of global DHCP proxy data
 133  */
 134 typedef struct
 135 {
 136   /* Pool of DHCP servers */
 137   dhcp_proxy_t *dhcp_servers[DHCP_N_PROTOS];
 138
 139   /* Pool of selected DHCP server. Zero is the default server */
 140   u32 *dhcp_server_index_by_rx_fib_index[DHCP_N_PROTOS];
 141
 142   /* to drop pkts in server-to-client direction */
 143   u32 error_drop_node_index;
 144
 145   dhcp_vss_t *vss[DHCP_N_PROTOS];
 146
 147   /* hash lookup specific vrf_id -> option 82 vss suboption  */
 148   u32 *vss_index_by_rx_fib_index[DHCP_N_PROTOS];
 149 } dhcp_proxy_main_t;
 150
 151 extern dhcp_proxy_main_t dhcp_proxy_main;
 152
 153 /**
 154  * @brief Send the details of a proxy session to the API client during a dump
 155  */
 156 void dhcp_send_details (fib_protocol_t proto,
 157                         void *opaque, u32 context, dhcp_proxy_t * proxy);
 158
 159 /**
 160  * @brief Show (on CLI) a VSS config during a show walk
 161  */
 162 int dhcp_vss_show_walk (dhcp_vss_t * vss, u32 rx_table_id, void *ctx);
 163
 164 /**
 165  * @brief Configure/set a new VSS info
 166  */
 167 int dhcp_proxy_set_vss (fib_protocol_t proto,
 168                         u32 tbl_id,
 169                         u8 vss_type,
 170                         u8 * vpn_ascii_id, u32 oui, u32 vpn_index, u8 is_del);
 171
 172 /**
 173  * @brief Dump the proxy configs to the API
 174  */
 175 void dhcp_proxy_dump (fib_protocol_t proto, void *opaque, u32 context);
 176
 177 /**
 178  * @brief Add a new DHCP proxy server configuration.
 179  * @return 1 is the config is new,
 180  *         0 otherwise (implying a modify of an existing)
 181  */
 182 int dhcp_proxy_server_add (fib_protocol_t proto,
 183                            ip46_address_t * addr,
 184                            ip46_address_t * src_address,
 185                            u32 rx_fib_iindex, u32 server_table_id);
 186
 187 /**
 188  * @brief Delete a DHCP proxy config
 189  * @return 1 if the proxy is deleted, 0 otherwise
 190  */
 191 int dhcp_proxy_server_del (fib_protocol_t proto,
 192                            u32 rx_fib_index,
 193                            ip46_address_t * addr, u32 server_table_id);
 194
 195 u32 dhcp_proxy_rx_table_get_table_id (fib_protocol_t proto, u32 fib_index);
 196
 197 /**
 198  * @brief Callback function invoked for each DHCP proxy entry
 199  *  return 0 to break the walk, non-zero otherwise.
 200  */
 201 typedef int (*dhcp_proxy_walk_fn_t) (dhcp_proxy_t * server, void *ctx);
 202
 203 /**
 204  * @brief Walk/Visit each DHCP proxy server
 205  */
 206 void dhcp_proxy_walk (fib_protocol_t proto,
 207                       dhcp_proxy_walk_fn_t fn, void *ctx);
 208
 209 /**
 210  * @brief Callback function invoked for each DHCP VSS entry
 211  *  return 0 to break the walk, non-zero otherwise.
 212  */
 213 typedef int (*dhcp_vss_walk_fn_t) (dhcp_vss_t * server,
 214                                    u32 rx_table_id, void *ctx);
 215
 216 /**
 217  * @brief Walk/Visit each DHCP proxy VSS
 218  */
 219 void dhcp_vss_walk (fib_protocol_t proto, dhcp_vss_walk_fn_t fn, void *ctx);
 220
 221 /**
 222  * @brief Lock a proxy object to prevent simultaneous access of its
 223  *  pending store
 224  */
 225 void dhcp_proxy_lock (dhcp_proxy_t * server);
 226
 227 /**
 228  * @brief Lock a proxy object to prevent simultaneous access of its
 229  *  pending store
 230  */
 231 void dhcp_proxy_unlock (dhcp_proxy_t * server);
 232
 233 /**
 234  * @brief Get the VSS data for the FIB index
 235  */
 236 static inline dhcp_vss_t *
 237 dhcp_get_vss_info (dhcp_proxy_main_t * dm,
 238                    u32 rx_fib_index, fib_protocol_t proto)
 239 {
 240   dhcp_vss_t *v = NULL;
 241
 242   if (vec_len (dm->vss_index_by_rx_fib_index[proto]) > rx_fib_index &&
 243       dm->vss_index_by_rx_fib_index[proto][rx_fib_index] != ~0)
 244     {
 245       v = pool_elt_at_index (dm->vss[proto],
 246                              dm->vss_index_by_rx_fib_index[proto]
 247                              [rx_fib_index]);
 248     }
 249
 250   return (v);
 251 }
 252
 253 /**
 254  * @brief Get the DHCP proxy server data for the FIB index
 255  */
 256 static inline dhcp_proxy_t *
 257 dhcp_get_proxy (dhcp_proxy_main_t * dm,
 258                 u32 rx_fib_index, fib_protocol_t proto)
 259 {
 260   dhcp_proxy_t *s = NULL;
 261
 262   if (vec_len (dm->dhcp_server_index_by_rx_fib_index[proto]) > rx_fib_index &&
 263       dm->dhcp_server_index_by_rx_fib_index[proto][rx_fib_index] != ~0)
 264     {
 265       s = pool_elt_at_index (dm->dhcp_servers[proto],
 266                              dm->dhcp_server_index_by_rx_fib_index[proto]
 267                              [rx_fib_index]);
 268     }
 269
 270   return (s);
 271 }
 272
 273 int dhcp6_proxy_set_server (ip46_address_t * addr,
 274                             ip46_address_t * src_addr,
 275                             u32 rx_table_id, u32 server_table_id, int is_del);
 276 int dhcp4_proxy_set_server (ip46_address_t * addr,
 277                             ip46_address_t * src_addr,
 278                             u32 rx_table_id, u32 server_table_id, int is_del);
 279
 280 #endif /* included_dhcp_proxy_h */
 281
 282 /*
 283  * fd.io coding-style-patch-verification: ON
 284  *
 285  * Local Variables:
 286  * eval: (c-set-style "gnu")
 287  * End:
 288  */