1 /*
2  * Network device features.
3  *
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU General Public License
7  * as published by the Free Software Foundation; either version
8  * 2 of the License, or (at your option) any later version.
9  */
10 #ifndef _LINUX_NETDEV_FEATURES_H
11 #define _LINUX_NETDEV_FEATURES_H
12 
13 #include <linux/types.h>
14 
15 typedef u64 netdev_features_t;
16 
17 enum {
18 	NETIF_F_SG_BIT,			/* Scatter/gather IO. */
19 	NETIF_F_IP_CSUM_BIT,		/* Can checksum TCP/UDP over IPv4. */
20 	__UNUSED_NETIF_F_1,
21 	NETIF_F_HW_CSUM_BIT,		/* Can checksum all the packets. */
22 	NETIF_F_IPV6_CSUM_BIT,		/* Can checksum TCP/UDP over IPV6 */
23 	NETIF_F_HIGHDMA_BIT,		/* Can DMA to high memory. */
24 	NETIF_F_FRAGLIST_BIT,		/* Scatter/gather IO. */
25 	NETIF_F_HW_VLAN_CTAG_TX_BIT,	/* Transmit VLAN CTAG HW acceleration */
26 	NETIF_F_HW_VLAN_CTAG_RX_BIT,	/* Receive VLAN CTAG HW acceleration */
27 	NETIF_F_HW_VLAN_CTAG_FILTER_BIT,/* Receive filtering on VLAN CTAGs */
28 	NETIF_F_VLAN_CHALLENGED_BIT,	/* Device cannot handle VLAN packets */
29 	NETIF_F_GSO_BIT,		/* Enable software GSO. */
30 	NETIF_F_LLTX_BIT,		/* LockLess TX - deprecated. Please */
31 					/* do not use LLTX in new drivers */
32 	NETIF_F_NETNS_LOCAL_BIT,	/* Does not change network namespaces */
33 	NETIF_F_GRO_BIT,		/* Generic receive offload */
34 	NETIF_F_LRO_BIT,		/* large receive offload */
35 
36 	/**/NETIF_F_GSO_SHIFT,		/* keep the order of SKB_GSO_* bits */
37 	NETIF_F_TSO_BIT			/* ... TCPv4 segmentation */
38 		= NETIF_F_GSO_SHIFT,
39 	NETIF_F_UFO_BIT,		/* ... UDPv4 fragmentation */
40 	NETIF_F_GSO_ROBUST_BIT,		/* ... ->SKB_GSO_DODGY */
41 	NETIF_F_TSO_ECN_BIT,		/* ... TCP ECN support */
42 	NETIF_F_TSO6_BIT,		/* ... TCPv6 segmentation */
43 	NETIF_F_FSO_BIT,		/* ... FCoE segmentation */
44 	NETIF_F_GSO_GRE_BIT,		/* ... GRE with TSO */
45 	NETIF_F_GSO_GRE_CSUM_BIT,	/* ... GRE with csum with TSO */
46 	NETIF_F_GSO_IPIP_BIT,		/* ... IPIP tunnel with TSO */
47 	NETIF_F_GSO_SIT_BIT,		/* ... SIT tunnel with TSO */
48 	NETIF_F_GSO_UDP_TUNNEL_BIT,	/* ... UDP TUNNEL with TSO */
49 	NETIF_F_GSO_UDP_TUNNEL_CSUM_BIT,/* ... UDP TUNNEL with TSO & CSUM */
50 	NETIF_F_GSO_TUNNEL_REMCSUM_BIT, /* ... TUNNEL with TSO & REMCSUM */
51 	/**/NETIF_F_GSO_LAST =		/* last bit, see GSO_MASK */
52 		NETIF_F_GSO_TUNNEL_REMCSUM_BIT,
53 
54 	NETIF_F_FCOE_CRC_BIT,		/* FCoE CRC32 */
55 	NETIF_F_SCTP_CRC_BIT,		/* SCTP checksum offload */
56 	NETIF_F_FCOE_MTU_BIT,		/* Supports max FCoE MTU, 2158 bytes*/
57 	NETIF_F_NTUPLE_BIT,		/* N-tuple filters supported */
58 	NETIF_F_RXHASH_BIT,		/* Receive hashing offload */
59 	NETIF_F_RXCSUM_BIT,		/* Receive checksumming offload */
60 	NETIF_F_NOCACHE_COPY_BIT,	/* Use no-cache copyfromuser */
61 	NETIF_F_LOOPBACK_BIT,		/* Enable loopback */
62 	NETIF_F_RXFCS_BIT,		/* Append FCS to skb pkt data */
63 	NETIF_F_RXALL_BIT,		/* Receive errored frames too */
64 	NETIF_F_HW_VLAN_STAG_TX_BIT,	/* Transmit VLAN STAG HW acceleration */
65 	NETIF_F_HW_VLAN_STAG_RX_BIT,	/* Receive VLAN STAG HW acceleration */
66 	NETIF_F_HW_VLAN_STAG_FILTER_BIT,/* Receive filtering on VLAN STAGs */
67 	NETIF_F_HW_L2FW_DOFFLOAD_BIT,	/* Allow L2 Forwarding in Hardware */
68 	NETIF_F_BUSY_POLL_BIT,		/* Busy poll */
69 
70 	NETIF_F_HW_TC_BIT,		/* Offload TC infrastructure */
71 
72 	/*
73 	 * Add your fresh new feature above and remember to update
74 	 * netdev_features_strings[] in net/core/ethtool.c and maybe
75 	 * some feature mask #defines below. Please also describe it
76 	 * in Documentation/networking/netdev-features.txt.
77 	 */
78 
79 	/**/NETDEV_FEATURE_COUNT
80 };
81 
82 /* copy'n'paste compression ;) */
83 #define __NETIF_F_BIT(bit)	((netdev_features_t)1 << (bit))
84 #define __NETIF_F(name)		__NETIF_F_BIT(NETIF_F_##name##_BIT)
85 
86 #define NETIF_F_FCOE_CRC	__NETIF_F(FCOE_CRC)
87 #define NETIF_F_FCOE_MTU	__NETIF_F(FCOE_MTU)
88 #define NETIF_F_FRAGLIST	__NETIF_F(FRAGLIST)
89 #define NETIF_F_FSO		__NETIF_F(FSO)
90 #define NETIF_F_GRO		__NETIF_F(GRO)
91 #define NETIF_F_GSO		__NETIF_F(GSO)
92 #define NETIF_F_GSO_ROBUST	__NETIF_F(GSO_ROBUST)
93 #define NETIF_F_HIGHDMA		__NETIF_F(HIGHDMA)
94 #define NETIF_F_HW_CSUM		__NETIF_F(HW_CSUM)
95 #define NETIF_F_HW_VLAN_CTAG_FILTER __NETIF_F(HW_VLAN_CTAG_FILTER)
96 #define NETIF_F_HW_VLAN_CTAG_RX	__NETIF_F(HW_VLAN_CTAG_RX)
97 #define NETIF_F_HW_VLAN_CTAG_TX	__NETIF_F(HW_VLAN_CTAG_TX)
98 #define NETIF_F_IP_CSUM		__NETIF_F(IP_CSUM)
99 #define NETIF_F_IPV6_CSUM	__NETIF_F(IPV6_CSUM)
100 #define NETIF_F_LLTX		__NETIF_F(LLTX)
101 #define NETIF_F_LOOPBACK	__NETIF_F(LOOPBACK)
102 #define NETIF_F_LRO		__NETIF_F(LRO)
103 #define NETIF_F_NETNS_LOCAL	__NETIF_F(NETNS_LOCAL)
104 #define NETIF_F_NOCACHE_COPY	__NETIF_F(NOCACHE_COPY)
105 #define NETIF_F_NTUPLE		__NETIF_F(NTUPLE)
106 #define NETIF_F_RXCSUM		__NETIF_F(RXCSUM)
107 #define NETIF_F_RXHASH		__NETIF_F(RXHASH)
108 #define NETIF_F_SCTP_CRC	__NETIF_F(SCTP_CRC)
109 #define NETIF_F_SG		__NETIF_F(SG)
110 #define NETIF_F_TSO6		__NETIF_F(TSO6)
111 #define NETIF_F_TSO_ECN		__NETIF_F(TSO_ECN)
112 #define NETIF_F_TSO		__NETIF_F(TSO)
113 #define NETIF_F_UFO		__NETIF_F(UFO)
114 #define NETIF_F_VLAN_CHALLENGED	__NETIF_F(VLAN_CHALLENGED)
115 #define NETIF_F_RXFCS		__NETIF_F(RXFCS)
116 #define NETIF_F_RXALL		__NETIF_F(RXALL)
117 #define NETIF_F_GSO_GRE		__NETIF_F(GSO_GRE)
118 #define NETIF_F_GSO_GRE_CSUM	__NETIF_F(GSO_GRE_CSUM)
119 #define NETIF_F_GSO_IPIP	__NETIF_F(GSO_IPIP)
120 #define NETIF_F_GSO_SIT		__NETIF_F(GSO_SIT)
121 #define NETIF_F_GSO_UDP_TUNNEL	__NETIF_F(GSO_UDP_TUNNEL)
122 #define NETIF_F_GSO_UDP_TUNNEL_CSUM __NETIF_F(GSO_UDP_TUNNEL_CSUM)
123 #define NETIF_F_GSO_TUNNEL_REMCSUM __NETIF_F(GSO_TUNNEL_REMCSUM)
124 #define NETIF_F_HW_VLAN_STAG_FILTER __NETIF_F(HW_VLAN_STAG_FILTER)
125 #define NETIF_F_HW_VLAN_STAG_RX	__NETIF_F(HW_VLAN_STAG_RX)
126 #define NETIF_F_HW_VLAN_STAG_TX	__NETIF_F(HW_VLAN_STAG_TX)
127 #define NETIF_F_HW_L2FW_DOFFLOAD	__NETIF_F(HW_L2FW_DOFFLOAD)
128 #define NETIF_F_BUSY_POLL	__NETIF_F(BUSY_POLL)
129 #define NETIF_F_HW_TC		__NETIF_F(HW_TC)
130 
131 #define for_each_netdev_feature(mask_addr, bit)	\
132 	for_each_set_bit(bit, (unsigned long *)mask_addr, NETDEV_FEATURE_COUNT)
133 
134 /* Features valid for ethtool to change */
135 /* = all defined minus driver/device-class-related */
136 #define NETIF_F_NEVER_CHANGE	(NETIF_F_VLAN_CHALLENGED | \
137 				 NETIF_F_LLTX | NETIF_F_NETNS_LOCAL)
138 
139 /* remember that ((t)1 << t_BITS) is undefined in C99 */
140 #define NETIF_F_ETHTOOL_BITS	((__NETIF_F_BIT(NETDEV_FEATURE_COUNT - 1) | \
141 		(__NETIF_F_BIT(NETDEV_FEATURE_COUNT - 1) - 1)) & \
142 		~NETIF_F_NEVER_CHANGE)
143 
144 /* Segmentation offload feature mask */
145 #define NETIF_F_GSO_MASK	(__NETIF_F_BIT(NETIF_F_GSO_LAST + 1) - \
146 		__NETIF_F_BIT(NETIF_F_GSO_SHIFT))
147 
148 /* List of features with software fallbacks. */
149 #define NETIF_F_GSO_SOFTWARE	(NETIF_F_TSO | NETIF_F_TSO_ECN | \
150 				 NETIF_F_TSO6 | NETIF_F_UFO)
151 
152 /* List of IP checksum features. Note that NETIF_F_ HW_CSUM should not be
153  * set in features when NETIF_F_IP_CSUM or NETIF_F_IPV6_CSUM are set--
154  * this would be contradictory
155  */
156 #define NETIF_F_CSUM_MASK	(NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \
157 				 NETIF_F_HW_CSUM)
158 
159 #define NETIF_F_ALL_TSO 	(NETIF_F_TSO | NETIF_F_TSO6 | NETIF_F_TSO_ECN)
160 
161 #define NETIF_F_ALL_FCOE	(NETIF_F_FCOE_CRC | NETIF_F_FCOE_MTU | \
162 				 NETIF_F_FSO)
163 
164 /*
165  * If one device supports one of these features, then enable them
166  * for all in netdev_increment_features.
167  */
168 #define NETIF_F_ONE_FOR_ALL	(NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \
169 				 NETIF_F_SG | NETIF_F_HIGHDMA |		\
170 				 NETIF_F_FRAGLIST | NETIF_F_VLAN_CHALLENGED)
171 
172 /*
173  * If one device doesn't support one of these features, then disable it
174  * for all in netdev_increment_features.
175  */
176 #define NETIF_F_ALL_FOR_ALL	(NETIF_F_NOCACHE_COPY | NETIF_F_FSO)
177 
178 /*
179  * If upper/master device has these features disabled, they must be disabled
180  * on all lower/slave devices as well.
181  */
182 #define NETIF_F_UPPER_DISABLES	NETIF_F_LRO
183 
184 /* changeable features with no special hardware requirements */
185 #define NETIF_F_SOFT_FEATURES	(NETIF_F_GSO | NETIF_F_GRO)
186 
187 #define NETIF_F_VLAN_FEATURES	(NETIF_F_HW_VLAN_CTAG_FILTER | \
188 				 NETIF_F_HW_VLAN_CTAG_RX | \
189 				 NETIF_F_HW_VLAN_CTAG_TX | \
190 				 NETIF_F_HW_VLAN_STAG_FILTER | \
191 				 NETIF_F_HW_VLAN_STAG_RX | \
192 				 NETIF_F_HW_VLAN_STAG_TX)
193 
194 #define NETIF_F_GSO_ENCAP_ALL	(NETIF_F_GSO_GRE |			\
195 				 NETIF_F_GSO_GRE_CSUM |			\
196 				 NETIF_F_GSO_IPIP |			\
197 				 NETIF_F_GSO_SIT |			\
198 				 NETIF_F_GSO_UDP_TUNNEL |		\
199 				 NETIF_F_GSO_UDP_TUNNEL_CSUM)
200 
201 #endif	/* _LINUX_NETDEV_FEATURES_H */
202