2 * dhcp_proxy.h: DHCP v4 & v6 proxy common functions/types
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:
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
18 #ifndef included_dhcp_proxy_h
19 #define included_dhcp_proxy_h
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>
33 #define dhcp_proxy_error(n,s) DHCP_PROXY_ERROR_##n,
34 #include <vnet/dhcp/dhcp4_proxy_error.def>
35 #undef dhcp_proxy_error
41 #define dhcpv6_proxy_error(n,s) DHCPV6_PROXY_ERROR_##n,
42 #include <vnet/dhcp/dhcp6_proxy_error.def>
43 #undef dhcpv6_proxy_error
45 } dhcpv6_proxy_error_t;
49 * @brief The Virtual Sub-net Selection information for a given RX FIB
51 typedef struct dhcp_vss_t_
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
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
65 * @brief Type 1 VPN-ID
69 * @brief Type 0 ASCII VPN Identifier
75 * @brief A representation of a single DHCP Server within a given VRF config
77 typedef struct dhcp_server_t_
80 * @brief The address of the DHCP server to which to relay the client's
83 ip46_address_t dhcp_server;
86 * @brief The FIB index (not the external Table-ID) in which the server
93 * @brief A DHCP proxy represenation fpr per-client VRF config
95 typedef struct dhcp_proxy_t_
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
103 * The expectation is there are only 1 or 2 servers, hence no fancy DB.
105 dhcp_server_t *dhcp_servers;
108 * @brief Hash table of pending requets key'd on the clients MAC address
113 * @brief A lock for the pending request DB.
118 * @brief The source address to use in relayed messaes
120 ip46_address_t dhcp_src_address;
123 * @brief The FIB index (not the external Table-ID) in which the client
129 #define DHCP_N_PROTOS (FIB_PROTOCOL_IP6 + 1)
132 * @brief Collection of global DHCP proxy data
136 /* Pool of DHCP servers */
137 dhcp_proxy_t *dhcp_servers[DHCP_N_PROTOS];
139 /* Pool of selected DHCP server. Zero is the default server */
140 u32 *dhcp_server_index_by_rx_fib_index[DHCP_N_PROTOS];
142 /* to drop pkts in server-to-client direction */
143 u32 error_drop_node_index;
145 dhcp_vss_t *vss[DHCP_N_PROTOS];
147 /* hash lookup specific vrf_id -> option 82 vss suboption */
148 u32 *vss_index_by_rx_fib_index[DHCP_N_PROTOS];
150 /* udp ports have been registered */
151 int udp_ports_registered;
154 vlib_main_t *vlib_main;
158 extern dhcp_proxy_main_t dhcp_proxy_main;
161 * @brief Register the dhcp client and server ports, if not already done
163 void dhcp_maybe_register_udp_ports (void);
166 * @brief Send the details of a proxy session to the API client during a dump
168 void dhcp_send_details (fib_protocol_t proto,
169 void *opaque, u32 context, dhcp_proxy_t * proxy);
172 * @brief Show (on CLI) a VSS config during a show walk
174 int dhcp_vss_show_walk (dhcp_vss_t * vss, u32 rx_table_id, void *ctx);
177 * @brief Configure/set a new VSS info
179 int dhcp_proxy_set_vss (fib_protocol_t proto,
182 u8 * vpn_ascii_id, u32 oui, u32 vpn_index, u8 is_del);
185 * @brief Dump the proxy configs to the API
187 void dhcp_proxy_dump (fib_protocol_t proto, void *opaque, u32 context);
190 * @brief Add a new DHCP proxy server configuration.
191 * @return 1 is the config is new,
192 * 0 otherwise (implying a modify of an existing)
194 int dhcp_proxy_server_add (fib_protocol_t proto,
195 ip46_address_t * addr,
196 ip46_address_t * src_address,
197 u32 rx_fib_iindex, u32 server_table_id);
200 * @brief Delete a DHCP proxy config
201 * @return 1 if the proxy is deleted, 0 otherwise
203 int dhcp_proxy_server_del (fib_protocol_t proto,
205 ip46_address_t * addr, u32 server_table_id);
207 u32 dhcp_proxy_rx_table_get_table_id (fib_protocol_t proto, u32 fib_index);
210 * @brief Callback function invoked for each DHCP proxy entry
211 * return 0 to break the walk, non-zero otherwise.
213 typedef int (*dhcp_proxy_walk_fn_t) (dhcp_proxy_t * server, void *ctx);
216 * @brief Walk/Visit each DHCP proxy server
218 void dhcp_proxy_walk (fib_protocol_t proto,
219 dhcp_proxy_walk_fn_t fn, void *ctx);
222 * @brief Callback function invoked for each DHCP VSS entry
223 * return 0 to break the walk, non-zero otherwise.
225 typedef int (*dhcp_vss_walk_fn_t) (dhcp_vss_t * server,
226 u32 rx_table_id, void *ctx);
229 * @brief Walk/Visit each DHCP proxy VSS
231 void dhcp_vss_walk (fib_protocol_t proto, dhcp_vss_walk_fn_t fn, void *ctx);
234 * @brief Lock a proxy object to prevent simultaneous access of its
237 void dhcp_proxy_lock (dhcp_proxy_t * server);
240 * @brief Lock a proxy object to prevent simultaneous access of its
243 void dhcp_proxy_unlock (dhcp_proxy_t * server);
246 * @brief Get the VSS data for the FIB index
248 static inline dhcp_vss_t *
249 dhcp_get_vss_info (dhcp_proxy_main_t * dm,
250 u32 rx_fib_index, fib_protocol_t proto)
252 dhcp_vss_t *v = NULL;
254 if (vec_len (dm->vss_index_by_rx_fib_index[proto]) > rx_fib_index &&
255 dm->vss_index_by_rx_fib_index[proto][rx_fib_index] != ~0)
257 v = pool_elt_at_index (dm->vss[proto],
258 dm->vss_index_by_rx_fib_index[proto]
266 * @brief Get the DHCP proxy server data for the FIB index
268 static inline dhcp_proxy_t *
269 dhcp_get_proxy (dhcp_proxy_main_t * dm,
270 u32 rx_fib_index, fib_protocol_t proto)
272 dhcp_proxy_t *s = NULL;
274 if (vec_len (dm->dhcp_server_index_by_rx_fib_index[proto]) > rx_fib_index &&
275 dm->dhcp_server_index_by_rx_fib_index[proto][rx_fib_index] != ~0)
277 s = pool_elt_at_index (dm->dhcp_servers[proto],
278 dm->dhcp_server_index_by_rx_fib_index[proto]
285 int dhcp6_proxy_set_server (ip46_address_t * addr,
286 ip46_address_t * src_addr,
287 u32 rx_table_id, u32 server_table_id, int is_del);
288 int dhcp4_proxy_set_server (ip46_address_t * addr,
289 ip46_address_t * src_addr,
290 u32 rx_table_id, u32 server_table_id, int is_del);
292 #endif /* included_dhcp_proxy_h */
295 * fd.io coding-style-patch-verification: ON
298 * eval: (c-set-style "gnu")