2 * l2_bvi.c : layer 2 Bridged Virtual Interface
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 #include <vlib/vlib.h>
19 #include <vnet/vnet.h>
20 #include <vnet/l2/l2_fwd.h>
21 #include <vnet/l2/l2_flood.h>
22 #include <vnet/l2/l2_bvi.h>
24 /* Allocated BVI instances */
25 static uword *l2_bvi_instances;
27 /* Call the L2 nodes that need the ethertype mapping */
29 l2bvi_register_input_type (vlib_main_t * vm,
30 ethernet_type_t type, u32 node_index)
32 l2fwd_register_input_type (vm, type, node_index);
33 l2flood_register_input_type (vm, type, node_index);
37 format_bvi_name (u8 * s, va_list * args)
39 u32 dev_instance = va_arg (*args, u32);
40 return format (s, "bvi%d", dev_instance);
44 bvi_admin_up_down (vnet_main_t * vnm, u32 hw_if_index, u32 flags)
46 u32 hw_flags = (flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) ?
47 VNET_HW_INTERFACE_FLAG_LINK_UP : 0;
48 vnet_hw_interface_set_flags (vnm, hw_if_index, hw_flags);
53 bvi_mac_change (vnet_hw_interface_t * hi,
54 const u8 * old_address, const u8 * mac_address)
56 l2input_interface_mac_change (hi->sw_if_index, old_address, mac_address);
61 VNET_DEVICE_CLASS (bvi_device_class) = {
63 .format_device_name = format_bvi_name,
64 .admin_up_down_function = bvi_admin_up_down,
65 .mac_addr_change_function = bvi_mac_change,
69 * Maintain a bitmap of allocated bvi instance numbers.
71 #define BVI_MAX_INSTANCE (16 * 1024)
74 bvi_instance_alloc (u32 want)
77 * Check for dynamically allocated instance number.
83 bit = clib_bitmap_first_clear (l2_bvi_instances);
84 if (bit >= BVI_MAX_INSTANCE)
88 l2_bvi_instances = clib_bitmap_set (l2_bvi_instances, bit, 1);
95 if (want >= BVI_MAX_INSTANCE)
103 if (clib_bitmap_get (l2_bvi_instances, want))
109 * Grant allocation request.
111 l2_bvi_instances = clib_bitmap_set (l2_bvi_instances, want, 1);
117 bvi_instance_free (u32 instance)
119 if (instance >= BVI_MAX_INSTANCE)
124 if (clib_bitmap_get (l2_bvi_instances, instance) == 0)
129 l2_bvi_instances = clib_bitmap_set (l2_bvi_instances, instance, 0);
134 l2_bvi_create (u32 user_instance,
135 const mac_address_t * mac_in, u32 * sw_if_indexp)
137 vnet_main_t *vnm = vnet_get_main ();
138 vlib_main_t *vm = vlib_get_main ();
139 vnet_eth_interface_registration_t eir = {};
140 u32 instance, hw_if_index, slot;
141 vnet_hw_interface_t *hw_if;
144 ASSERT (sw_if_indexp);
146 *sw_if_indexp = (u32) ~ 0;
149 * Allocate a bvi instance. Either select on dynamically
150 * or try to use the desired user_instance number.
152 instance = bvi_instance_alloc (user_instance);
155 return VNET_API_ERROR_INVALID_REGISTRATION;
159 * Default MAC address (b0b0:0000:0000 + instance) is allocated
160 * if zero mac_address is configured. Otherwise, user-configurable MAC
161 * address is programmed on the bvi interface.
163 if (mac_address_is_zero (mac_in))
170 mac_address_from_bytes (&mac, bytes);
174 mac_address_copy (&mac, mac_in);
177 eir.dev_class_index = bvi_device_class.index;
178 eir.dev_instance = instance;
179 eir.address = mac.bytes;
180 hw_if_index = vnet_eth_register_interface (vnm, &eir);
182 hw_if = vnet_get_hw_interface (vnm, hw_if_index);
184 slot = vlib_node_add_named_next_with_slot (vm, hw_if->tx_node_index,
189 vnet_sw_interface_t *si = vnet_get_hw_sw_interface (vnm, hw_if_index);
190 *sw_if_indexp = si->sw_if_index;
192 si->flood_class = VNET_FLOOD_CLASS_BVI;
199 l2_bvi_delete (u32 sw_if_index)
201 vnet_main_t *vnm = vnet_get_main ();
203 if (pool_is_free_index (vnm->interface_main.sw_interfaces, sw_if_index))
204 return VNET_API_ERROR_INVALID_SW_IF_INDEX;
206 vnet_hw_interface_t *hw = vnet_get_sup_hw_interface (vnm, sw_if_index);
207 if (hw == 0 || hw->dev_class_index != bvi_device_class.index)
208 return VNET_API_ERROR_INVALID_SW_IF_INDEX;
210 if (bvi_instance_free (hw->dev_instance) < 0)
211 return VNET_API_ERROR_INVALID_SW_IF_INDEX;
213 ethernet_delete_interface (vnm, hw->hw_if_index);
218 static clib_error_t *
219 l2_bvi_create_cli (vlib_main_t * vm,
220 unformat_input_t * input, vlib_cli_command_t * cmd)
222 unformat_input_t _line_input, *line_input = &_line_input;
223 u32 instance, sw_if_index;
229 instance = sw_if_index = ~0;
230 mac_address_set_zero (&mac);
232 if (unformat_user (input, unformat_line_input, line_input))
234 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
236 if (unformat (line_input, "mac %U", unformat_mac_address_t, &mac))
238 else if (unformat (line_input, "instance %d", &instance))
242 error = clib_error_return (0, "unknown input: %U",
243 format_unformat_error, line_input);
248 unformat_free (line_input);
254 rv = l2_bvi_create (instance, &mac, &sw_if_index);
257 return clib_error_return (0, "BVI create failed");
259 vlib_cli_output (vm, "%U\n", format_vnet_sw_if_index_name, vnet_get_main (),
265 * Create a BVI interface. Optionally, a MAC Address can be
266 * provided. If not provided, 0b:0b::00:00:00:<instance> will be used.
269 * The following two command syntaxes are equivalent:
270 * @cliexcmd{bvi create [mac <mac-addr>] [instance <instance>]}
271 * Example of how to create a bvi interface:
272 * @cliexcmd{bvi create}
274 VLIB_CLI_COMMAND (l2_bvi_create_command, static) = {
275 .path = "bvi create",
276 .short_help = "bvi create [mac <mac-addr>] [instance <instance>]",
277 .function = l2_bvi_create_cli,
280 static clib_error_t *
281 l2_bvi_delete_cli (vlib_main_t * vm,
282 unformat_input_t * input, vlib_cli_command_t * cmd)
288 vnm = vnet_get_main ();
291 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
294 (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
300 if (~0 != sw_if_index)
302 rv = l2_bvi_delete (sw_if_index);
305 return clib_error_return (0, "BVI delete failed");
308 return clib_error_return (0, "no such interface: %U",
309 format_unformat_error, input);
315 * Delete a BVI interface.
318 * The following two command syntaxes are equivalent:
319 * @cliexcmd{bvi delete <interface>}
320 * Example of how to create a bvi interface:
321 * @cliexcmd{bvi delete bvi0}
323 VLIB_CLI_COMMAND (l2_bvi_delete_command, static) = {
324 .path = "bvi delete",
325 .short_help = "bvi delete <interface>",
326 .function = l2_bvi_delete_cli,
331 * fd.io coding-style-patch-verification: ON
334 * eval: (c-set-style "gnu")