FD.io VPP  v17.04.2-2-ga8f93f8
Vector Packet Processing
cli.c
Go to the documentation of this file.
1 /*
2  *------------------------------------------------------------------
3  * af_packet.c - linux kernel packet interface
4  *
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:
9  *
10  * http://www.apache.org/licenses/LICENSE-2.0
11  *
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  *------------------------------------------------------------------
18  */
19 
20 #include <fcntl.h> /* for open */
21 #include <sys/ioctl.h>
22 #include <sys/socket.h>
23 #include <sys/stat.h>
24 #include <sys/types.h>
25 #include <sys/uio.h> /* for iovec */
26 #include <netinet/in.h>
27 
28 #include <vlib/vlib.h>
29 #include <vlib/unix/unix.h>
30 #include <vnet/ip/ip.h>
31 #include <vnet/ethernet/ethernet.h>
32 
34 
35 /**
36  * @file
37  * @brief CLI for Host Interface Device Driver.
38  *
39  * This file contains the source code for CLI for the host interface.
40  */
41 
42 static clib_error_t *
44  vlib_cli_command_t * cmd)
45 {
46  unformat_input_t _line_input, *line_input = &_line_input;
47  u8 *host_if_name = NULL;
48  u8 hwaddr[6];
49  u8 *hw_addr_ptr = 0;
50  u32 sw_if_index;
51  int r;
52  clib_error_t *error = NULL;
53 
54  /* Get a line of input. */
55  if (!unformat_user (input, unformat_line_input, line_input))
56  return 0;
57 
58  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
59  {
60  if (unformat (line_input, "name %s", &host_if_name))
61  ;
62  else
63  if (unformat
64  (line_input, "hw-addr %U", unformat_ethernet_address, hwaddr))
65  hw_addr_ptr = hwaddr;
66  else
67  {
68  error = clib_error_return (0, "unknown input `%U'",
69  format_unformat_error, line_input);
70  goto done;
71  }
72  }
73 
74  if (host_if_name == NULL)
75  {
76  error = clib_error_return (0, "missing host interface name");
77  goto done;
78  }
79 
80  r = af_packet_create_if (vm, host_if_name, hw_addr_ptr, &sw_if_index);
81 
82  if (r == VNET_API_ERROR_SYSCALL_ERROR_1)
83  {
84  error = clib_error_return (0, "%s (errno %d)", strerror (errno), errno);
85  goto done;
86  }
87 
88  if (r == VNET_API_ERROR_INVALID_INTERFACE)
89  {
90  error = clib_error_return (0, "Invalid interface name");
91  goto done;
92  }
93 
94  if (r == VNET_API_ERROR_SUBIF_ALREADY_EXISTS)
95  {
96  error = clib_error_return (0, "Interface elready exists");
97  goto done;
98  }
99 
101  sw_if_index);
102 
103 done:
104  vec_free (host_if_name);
105  unformat_free (line_input);
106 
107  return error;
108 }
109 
110 /*?
111  * Create a host interface that will attach to a linux AF_PACKET
112  * interface, one side of a veth pair. The veth pair must already
113  * exist. Once created, a new host interface will exist in VPP
114  * with the name '<em>host-<ifname></em>', where '<em><ifname></em>'
115  * is the name of the specified veth pair. Use the
116  * '<em>show interface</em>' command to display host interface details.
117  *
118  * This command has the following optional parameters:
119  *
120  * - <b>hw-addr <mac-addr></b> - Optional ethernet address, can be in either
121  * X:X:X:X:X:X unix or X.X.X cisco format.
122  *
123  * @cliexpar
124  * Example of how to create a host interface tied to one side of an
125  * existing linux veth pair named vpp1:
126  * @cliexstart{create host-interface name vpp1}
127  * host-vpp1
128  * @cliexend
129  * Once the host interface is created, enable the interface using:
130  * @cliexcmd{set interface state host-vpp1 up}
131 ?*/
132 /* *INDENT-OFF* */
133 VLIB_CLI_COMMAND (af_packet_create_command, static) = {
134  .path = "create host-interface",
135  .short_help = "create host-interface name <ifname> [hw-addr <mac-addr>]",
136  .function = af_packet_create_command_fn,
137 };
138 /* *INDENT-ON* */
139 
140 static clib_error_t *
142  vlib_cli_command_t * cmd)
143 {
144  unformat_input_t _line_input, *line_input = &_line_input;
145  u8 *host_if_name = NULL;
146  clib_error_t *error = NULL;
147 
148  /* Get a line of input. */
149  if (!unformat_user (input, unformat_line_input, line_input))
150  return 0;
151 
152  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
153  {
154  if (unformat (line_input, "name %s", &host_if_name))
155  ;
156  else
157  {
158  error = clib_error_return (0, "unknown input `%U'",
159  format_unformat_error, line_input);
160  goto done;
161  }
162  }
163 
164  if (host_if_name == NULL)
165  {
166  error = clib_error_return (0, "missing host interface name");
167  goto done;
168  }
169 
170  af_packet_delete_if (vm, host_if_name);
171 
172 done:
173  vec_free (host_if_name);
174  unformat_free (line_input);
175 
176  return error;
177 }
178 
179 /*?
180  * Delete a host interface. Use the linux interface name to identify
181  * the host interface to be deleted. In VPP, host interfaces are
182  * named as '<em>host-<ifname></em>', where '<em><ifname></em>'
183  * is the name of the linux interface.
184  *
185  * @cliexpar
186  * Example of how to delete a host interface named host-vpp1:
187  * @cliexcmd{delete host-interface name vpp1}
188 ?*/
189 /* *INDENT-OFF* */
190 VLIB_CLI_COMMAND (af_packet_delete_command, static) = {
191  .path = "delete host-interface",
192  .short_help = "delete host-interface name <ifname>",
193  .function = af_packet_delete_command_fn,
194 };
195 /* *INDENT-ON* */
196 
197 clib_error_t *
199 {
200  return 0;
201 }
202 
204 
205 /*
206  * fd.io coding-style-patch-verification: ON
207  *
208  * Local Variables:
209  * eval: (c-set-style "gnu")
210  * End:
211  */
vnet_main_t * vnet_get_main(void)
Definition: misc.c:46
#define NULL
Definition: clib.h:55
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:982
format_function_t format_vnet_sw_if_index_name
#define VLIB_INIT_FUNCTION(x)
Definition: init.h:111
#define clib_error_return(e, args...)
Definition: error.h:111
unformat_function_t unformat_line_input
Definition: format.h:281
static clib_error_t * af_packet_create_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:43
struct _unformat_input_t unformat_input_t
clib_error_t * af_packet_cli_init(vlib_main_t *vm)
Definition: cli.c:198
#define UNFORMAT_END_OF_INPUT
Definition: format.h:143
vlib_main_t * vm
Definition: buffer.c:276
#define vec_free(V)
Free vector&#39;s memory (no header).
Definition: vec.h:340
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:154
uword unformat_ethernet_address(unformat_input_t *input, va_list *args)
Definition: format.c:227
unsigned int u32
Definition: types.h:88
unsigned char u8
Definition: types.h:56
static void unformat_free(unformat_input_t *i)
Definition: format.h:161
static clib_error_t * af_packet_delete_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:141
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
int af_packet_create_if(vlib_main_t *vm, u8 *host_if_name, u8 *hw_addr_set, u32 *sw_if_index)
Definition: af_packet.c:176
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:577
uword unformat(unformat_input_t *i, const char *fmt,...)
Definition: unformat.c:971
static uword unformat_check_input(unformat_input_t *i)
Definition: format.h:169
int af_packet_delete_if(vlib_main_t *vm, u8 *host_if_name)
Definition: af_packet.c:299