2 *------------------------------------------------------------------
3 * af_packet.c - linux kernel packet interface
5 * Copyright (c) 2016 Cisco and/or its affiliates.
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at:
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 *------------------------------------------------------------------
20 #include <fcntl.h> /* for open */
21 #include <sys/ioctl.h>
22 #include <sys/socket.h>
24 #include <sys/types.h>
25 #include <sys/uio.h> /* for iovec */
26 #include <netinet/in.h>
28 #include <vlib/vlib.h>
29 #include <vlib/unix/unix.h>
30 #include <vnet/ip/ip.h>
31 #include <vnet/ethernet/ethernet.h>
33 #include <vnet/devices/af_packet/af_packet.h>
37 * @brief CLI for Host Interface Device Driver.
39 * This file contains the source code for CLI for the host interface.
43 af_packet_create_command_fn (vlib_main_t * vm, unformat_input_t * input,
44 vlib_cli_command_t * cmd)
46 unformat_input_t _line_input, *line_input = &_line_input;
47 u8 *host_if_name = NULL;
53 /* Get a line of input. */
54 if (!unformat_user (input, unformat_line_input, line_input))
57 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
59 if (unformat (line_input, "name %s", &host_if_name))
63 (line_input, "hw-addr %U", unformat_ethernet_address, hwaddr))
66 return clib_error_return (0, "unknown input `%U'",
67 format_unformat_error, input);
69 unformat_free (line_input);
71 if (host_if_name == NULL)
72 return clib_error_return (0, "missing host interface name");
74 r = af_packet_create_if (vm, host_if_name, hw_addr_ptr, &sw_if_index);
75 vec_free (host_if_name);
77 if (r == VNET_API_ERROR_SYSCALL_ERROR_1)
78 return clib_error_return (0, "%s (errno %d)", strerror (errno), errno);
80 if (r == VNET_API_ERROR_INVALID_INTERFACE)
81 return clib_error_return (0, "Invalid interface name");
83 if (r == VNET_API_ERROR_SUBIF_ALREADY_EXISTS)
84 return clib_error_return (0, "Interface elready exists");
86 vlib_cli_output (vm, "%U\n", format_vnet_sw_if_index_name, vnet_get_main (),
92 * Create a host interface that will attach to a linux AF_PACKET
93 * interface, one side of a veth pair. The veth pair must already
94 * exist. Once created, a new host interface will exist in VPP
95 * with the name '<em>host-<ifname></em>', where '<em><ifname></em>'
96 * is the name of the specified veth pair. Use the
97 * '<em>show interfaces</em>' command to display host interface details.
100 * Example of how to create a host interface tied to one side of an
101 * existing linux veth pair named vpp1:
102 * @cliexstart{create host-interface name vpp1}
105 * Once the host interface is created, enable the interface using:
106 * @cliexcmd{set interface state host-vpp1 up}
109 VLIB_CLI_COMMAND (af_packet_create_command, static) = {
110 .path = "create host-interface",
111 .short_help = "create host-interface name <ifname> [hw-addr <mac-addr>]",
112 .function = af_packet_create_command_fn,
116 static clib_error_t *
117 af_packet_delete_command_fn (vlib_main_t * vm, unformat_input_t * input,
118 vlib_cli_command_t * cmd)
120 unformat_input_t _line_input, *line_input = &_line_input;
121 u8 *host_if_name = NULL;
123 /* Get a line of input. */
124 if (!unformat_user (input, unformat_line_input, line_input))
127 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
129 if (unformat (line_input, "name %s", &host_if_name))
132 return clib_error_return (0, "unknown input `%U'",
133 format_unformat_error, input);
135 unformat_free (line_input);
137 if (host_if_name == NULL)
138 return clib_error_return (0, "missing host interface name");
140 af_packet_delete_if (vm, host_if_name);
141 vec_free (host_if_name);
147 * Delete a host interface. Use the linux interface name to identify
148 * the host interface to be deleted. In VPP, host interfaces are
149 * named as '<em>host-<ifname></em>', where '<em><ifname></em>'
150 * is the name of the linux interface.
153 * Example of how to delete a host interface named host-vpp1:
154 * @cliexcmd{delete host-interface name vpp1}
157 VLIB_CLI_COMMAND (af_packet_delete_command, static) = {
158 .path = "delete host-interface",
159 .short_help = "delete host-interface name <ifname>",
160 .function = af_packet_delete_command_fn,
165 af_packet_cli_init (vlib_main_t * vm)
170 VLIB_INIT_FUNCTION (af_packet_cli_init);
173 * fd.io coding-style-patch-verification: ON
176 * eval: (c-set-style "gnu")