devices: tap API cleanup
[vpp.git] / src / vnet / devices / tap / tap.h
1 /*
2  *------------------------------------------------------------------
3  * Copyright (c) 2017 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:
7  *
8  *     http://www.apache.org/licenses/LICENSE-2.0
9  *
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  *------------------------------------------------------------------
16  */
17
18 #ifndef _VNET_DEVICES_VIRTIO_TAP_H_
19 #define _VNET_DEVICES_VIRTIO_TAP_H_
20
21 #ifndef MIN
22 #define MIN(x,y) (((x)<(y))?(x):(y))
23 #endif
24
25 typedef struct
26 {
27   u32 id;
28   u8 mac_addr_set;
29   mac_address_t mac_addr;
30   u8 num_rx_queues;
31   u16 rx_ring_sz;
32   u16 tx_ring_sz;
33   u32 tap_flags;
34 #define TAP_FLAG_GSO (1 << 0)
35   u8 *host_namespace;
36   u8 *host_if_name;
37   mac_address_t host_mac_addr;
38   u8 *host_bridge;
39   ip4_address_t host_ip4_addr;
40   u8 host_ip4_prefix_len;
41   ip4_address_t host_ip4_gw;
42   u8 host_ip4_gw_set;
43   ip6_address_t host_ip6_addr;
44   u8 host_ip6_prefix_len;
45   ip6_address_t host_ip6_gw;
46   u8 host_ip6_gw_set;
47   u8 host_mtu_set;
48   u32 host_mtu_size;
49   /* return */
50   u32 sw_if_index;
51   int rv;
52   clib_error_t *error;
53 } tap_create_if_args_t;
54
55 /** TAP interface details struct */
56 typedef struct
57 {
58   u32 id;
59   u32 sw_if_index;
60   u32 tap_flags;
61   u8 dev_name[64];
62   u16 tx_ring_sz;
63   u16 rx_ring_sz;
64   mac_address_t host_mac_addr;
65   u8 host_if_name[64];
66   u8 host_namespace[64];
67   u8 host_bridge[64];
68   ip4_address_t host_ip4_addr;
69   u8 host_ip4_prefix_len;
70   ip6_address_t host_ip6_addr;
71   u8 host_ip6_prefix_len;
72   u32 host_mtu_size;
73 } tap_interface_details_t;
74
75 typedef struct
76 {
77   /* logging */
78   vlib_log_class_t log_default;
79
80   /* bit-map of in-use IDs */
81   uword *tap_ids;
82
83   /* host mtu size, configurable through startup.conf */
84   int host_mtu_size;
85 } tap_main_t;
86
87 void tap_create_if (vlib_main_t * vm, tap_create_if_args_t * args);
88 int tap_delete_if (vlib_main_t * vm, u32 sw_if_index);
89 int tap_gso_enable_disable (vlib_main_t * vm, u32 sw_if_index,
90                             int enable_disable);
91 int tap_dump_ifs (tap_interface_details_t ** out_tapids);
92
93 #endif /* _VNET_DEVICES_VIRTIO_TAP_H_ */
94
95 /*
96  * fd.io coding-style-patch-verification: ON
97  *
98  * Local Variables:
99  * eval: (c-set-style "gnu")
100  * End:
101  */