2 *------------------------------------------------------------------
3 * Copyright (c) 2016 Cisco and/or its affiliates.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 *------------------------------------------------------------------
19 #include <sys/ioctl.h>
22 #include <vlib/vlib.h>
23 #include <vlib/unix/unix.h>
24 #include <vnet/ethernet/ethernet.h>
25 #include <vnet/ip/ip4_packet.h>
26 #include <vnet/ip/ip6_packet.h>
27 #include <vnet/ip/format.h>
28 #include <vnet/devices/virtio/virtio.h>
29 #include <vnet/devices/tap/tap.h>
32 tap_create_command_fn (vlib_main_t * vm, unformat_input_t * input,
33 vlib_cli_command_t * cmd)
35 unformat_input_t _line_input, *line_input = &_line_input;
36 tap_create_if_args_t args = { 0 };
43 args.num_rx_queues = 1;
44 args.num_tx_queues = 1;
46 /* Get a line of input. */
47 if (unformat_user (input, unformat_line_input, line_input))
49 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
51 if (unformat (line_input, "id %u", &args.id))
54 if (unformat (line_input, "host-if-name %s", &args.host_if_name))
56 else if (unformat (line_input, "host-ns %s", &args.host_namespace))
58 else if (unformat (line_input, "host-mac-addr %U",
59 unformat_ethernet_address,
60 args.host_mac_addr.bytes))
62 else if (unformat (line_input, "host-bridge %s", &args.host_bridge))
64 else if (unformat (line_input, "host-ip4-addr %U/%d",
65 unformat_ip4_address, &args.host_ip4_addr,
66 &args.host_ip4_prefix_len))
68 else if (unformat (line_input, "host-ip4-gw %U",
69 unformat_ip4_address, &args.host_ip4_gw))
70 args.host_ip4_gw_set = 1;
71 else if (unformat (line_input, "host-ip6-addr %U/%d",
72 unformat_ip6_address, &args.host_ip6_addr,
73 &args.host_ip6_prefix_len))
75 else if (unformat (line_input, "host-ip6-gw %U",
76 unformat_ip6_address, &args.host_ip6_gw))
77 args.host_ip6_gw_set = 1;
78 else if (unformat (line_input, "num-rx-queues %d", &tmp))
79 args.num_rx_queues = tmp;
80 else if (unformat (line_input, "num-tx-queues %d", &tmp))
81 args.num_tx_queues = tmp;
82 else if (unformat (line_input, "rx-ring-size %d", &tmp))
83 args.rx_ring_sz = tmp;
84 else if (unformat (line_input, "tx-ring-size %d", &tmp))
85 args.tx_ring_sz = tmp;
88 (line_input, "host-mtu-size %d", &args.host_mtu_size))
89 args.host_mtu_set = 1;
90 else if (unformat (line_input, "no-gso"))
91 args.tap_flags &= ~TAP_FLAG_GSO;
92 else if (unformat (line_input, "gso"))
93 args.tap_flags |= TAP_FLAG_GSO;
94 else if (unformat (line_input, "gro-coalesce"))
95 args.tap_flags |= TAP_FLAG_GRO_COALESCE;
96 else if (unformat (line_input, "csum-offload"))
97 args.tap_flags |= TAP_FLAG_CSUM_OFFLOAD;
98 else if (unformat (line_input, "persist"))
99 args.tap_flags |= TAP_FLAG_PERSIST;
100 else if (unformat (line_input, "attach"))
101 args.tap_flags |= TAP_FLAG_ATTACH;
102 else if (unformat (line_input, "tun"))
103 args.tap_flags |= TAP_FLAG_TUN;
104 else if (unformat (line_input, "packed"))
105 args.tap_flags |= TAP_FLAG_PACKED;
106 else if (unformat (line_input, "in-order"))
107 args.tap_flags |= TAP_FLAG_IN_ORDER;
108 else if (unformat (line_input, "hw-addr %U",
109 unformat_ethernet_address, args.mac_addr.bytes))
110 args.mac_addr_set = 1;
113 unformat_free (line_input);
114 return clib_error_return (0, "unknown input `%U'",
115 format_unformat_error, input);
118 unformat_free (line_input);
121 if (ip_addr_set && args.host_bridge)
122 return clib_error_return (0, "Please specify either host ip address or "
125 tap_create_if (vm, &args);
128 vlib_cli_output (vm, "%U\n", format_vnet_sw_if_index_name,
129 vnet_get_main (), args.sw_if_index);
131 vec_free (args.host_if_name);
132 vec_free (args.host_namespace);
133 vec_free (args.host_bridge);
140 VLIB_CLI_COMMAND (tap_create_command, static) = {
141 .path = "create tap",
143 "create tap {id <if-id>} [hw-addr <mac-address>] "
144 "[num-rx-queues <n>] [num-tx-queues <n>] [rx-ring-size <size>] "
145 "[tx-ring-size <size>] [host-ns <netns>] [host-bridge <bridge-name>] "
146 "[host-ip4-addr <ip4addr/mask>] [host-ip6-addr <ip6-addr>] "
147 "[host-ip4-gw <ip4-addr>] [host-ip6-gw <ip6-addr>] "
148 "[host-mac-addr <host-mac-address>] [host-if-name <name>] "
149 "[host-mtu-size <size>] [no-gso|gso [gro-coalesce]|csum-offload] "
150 "[persist] [attach] [tun] [packed] [in-order]",
151 .function = tap_create_command_fn,
155 static clib_error_t *
156 tap_delete_command_fn (vlib_main_t * vm, unformat_input_t * input,
157 vlib_cli_command_t * cmd)
159 unformat_input_t _line_input, *line_input = &_line_input;
160 u32 sw_if_index = ~0;
161 vnet_main_t *vnm = vnet_get_main ();
164 /* Get a line of input. */
165 if (!unformat_user (input, unformat_line_input, line_input))
166 return clib_error_return (0, "Missing <interface>");
168 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
170 if (unformat (line_input, "sw_if_index %d", &sw_if_index))
172 else if (unformat (line_input, "%U", unformat_vnet_sw_interface,
176 return clib_error_return (0, "unknown input `%U'",
177 format_unformat_error, input);
179 unformat_free (line_input);
181 if (sw_if_index == ~0)
182 return clib_error_return (0,
183 "please specify interface name or sw_if_index");
185 rv = tap_delete_if (vm, sw_if_index);
186 if (rv == VNET_API_ERROR_INVALID_SW_IF_INDEX)
187 return clib_error_return (0, "not a tap interface");
189 return clib_error_return (0, "error on deleting tap interface");
195 VLIB_CLI_COMMAND (tap_delete__command, static) =
197 .path = "delete tap",
198 .short_help = "delete tap {<interface> | sw_if_index <sw_idx>}",
199 .function = tap_delete_command_fn,
203 static clib_error_t *
204 tap_offload_command_fn (vlib_main_t * vm, unformat_input_t * input,
205 vlib_cli_command_t * cmd)
207 unformat_input_t _line_input, *line_input = &_line_input;
208 u32 sw_if_index = ~0;
209 vnet_main_t *vnm = vnet_get_main ();
210 int gso_enable = 0, gso_disable = 0, is_gro_coalesce = 0;
211 int csum_offload_enable = 0, csum_offload_disable = 0;
214 /* Get a line of input. */
215 if (!unformat_user (input, unformat_line_input, line_input))
216 return clib_error_return (0, "Missing <interface>");
218 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
220 if (unformat (line_input, "sw_if_index %d", &sw_if_index))
222 else if (unformat (line_input, "%U", unformat_vnet_sw_interface,
225 else if (unformat (line_input, "gso-enable"))
228 if (unformat (line_input, "gro-coalesce"))
231 else if (unformat (line_input, "gso-disable"))
233 else if (unformat (line_input, "csum-offload-enable"))
234 csum_offload_enable = 1;
235 else if (unformat (line_input, "csum-offload-disable"))
236 csum_offload_disable = 1;
238 return clib_error_return (0, "unknown input `%U'",
239 format_unformat_error, input);
241 unformat_free (line_input);
243 if (sw_if_index == ~0)
244 return clib_error_return (0,
245 "please specify interface name or sw_if_index");
248 rv = tap_gso_enable_disable (vm, sw_if_index, 1, is_gro_coalesce);
249 else if (csum_offload_enable)
250 rv = tap_csum_offload_enable_disable (vm, sw_if_index, 1);
251 else if (gso_disable)
252 rv = tap_gso_enable_disable (vm, sw_if_index, 0, 0);
253 else if (csum_offload_disable)
254 rv = tap_csum_offload_enable_disable (vm, sw_if_index, 0);
256 if (rv == VNET_API_ERROR_INVALID_SW_IF_INDEX)
257 return clib_error_return (0, "not a tap interface");
259 return clib_error_return (0, "error on configuring GSO on tap interface");
265 VLIB_CLI_COMMAND (tap_offload_command, static) =
267 .path = "set tap offload",
268 .short_help = "set tap offload {<interface> | sw_if_index <sw_idx>}"
269 " <gso-enable [gro-coalesce] | gso-disable | csum-offload-enable |"
270 "csum-offload-disable>",
271 .function = tap_offload_command_fn,
275 static clib_error_t *
276 tap_show_command_fn (vlib_main_t * vm, unformat_input_t * input,
277 vlib_cli_command_t * cmd)
279 virtio_main_t *mm = &virtio_main;
281 vnet_main_t *vnm = vnet_get_main ();
283 clib_error_t *error = 0;
284 u32 hw_if_index, *hw_if_indices = 0;
286 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
289 (input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
290 vec_add1 (hw_if_indices, hw_if_index);
291 else if (unformat (input, "descriptors"))
295 error = clib_error_return (0, "unknown input `%U'",
296 format_unformat_error, input);
301 if (vec_len (hw_if_indices) == 0)
304 pool_foreach (vif, mm->interfaces)
305 vec_add1 (hw_if_indices, vif->hw_if_index);
309 virtio_show (vm, hw_if_indices, show_descr, VIRTIO_IF_TYPE_TAP);
312 vec_free (hw_if_indices);
317 VLIB_CLI_COMMAND (tap_show_command, static) = {
319 .short_help = "show tap {<interface>] [descriptors]",
320 .function = tap_show_command_fn,
324 static clib_error_t *
325 tun_show_command_fn (vlib_main_t * vm, unformat_input_t * input,
326 vlib_cli_command_t * cmd)
328 virtio_main_t *mm = &virtio_main;
330 vnet_main_t *vnm = vnet_get_main ();
332 clib_error_t *error = 0;
333 u32 hw_if_index, *hw_if_indices = 0;
335 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
338 (input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
339 vec_add1 (hw_if_indices, hw_if_index);
340 else if (unformat (input, "descriptors"))
344 error = clib_error_return (0, "unknown input `%U'",
345 format_unformat_error, input);
350 if (vec_len (hw_if_indices) == 0)
353 pool_foreach (vif, mm->interfaces)
354 vec_add1 (hw_if_indices, vif->hw_if_index);
358 virtio_show (vm, hw_if_indices, show_descr, VIRTIO_IF_TYPE_TUN);
361 vec_free (hw_if_indices);
366 VLIB_CLI_COMMAND (tun_show_command, static) = {
368 .short_help = "show tun {<interface>] [descriptors]",
369 .function = tun_show_command_fn,
374 tap_cli_init (vlib_main_t * vm)
379 VLIB_INIT_FUNCTION (tap_cli_init);
382 * fd.io coding-style-patch-verification: ON
385 * eval: (c-set-style "gnu")