1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Network device features.
4  */
5 #ifndef _LINUX_NETDEV_FEATURES_H
6 #define _LINUX_NETDEV_FEATURES_H
7 
8 #include <linux/types.h>
9 #include <linux/bitops.h>
10 #include <asm/byteorder.h>
11 
12 typedef u64 netdev_features_t;
13 
14 enum {
15 	NETIF_F_SG_BIT,			/* Scatter/gather IO. */
16 	NETIF_F_IP_CSUM_BIT,		/* Can checksum TCP/UDP over IPv4. */
17 	__UNUSED_NETIF_F_1,
18 	NETIF_F_HW_CSUM_BIT,		/* Can checksum all the packets. */
19 	NETIF_F_IPV6_CSUM_BIT,		/* Can checksum TCP/UDP over IPV6 */
20 	NETIF_F_HIGHDMA_BIT,		/* Can DMA to high memory. */
21 	NETIF_F_FRAGLIST_BIT,		/* Scatter/gather IO. */
22 	NETIF_F_HW_VLAN_CTAG_TX_BIT,	/* Transmit VLAN CTAG HW acceleration */
23 	NETIF_F_HW_VLAN_CTAG_RX_BIT,	/* Receive VLAN CTAG HW acceleration */
24 	NETIF_F_HW_VLAN_CTAG_FILTER_BIT,/* Receive filtering on VLAN CTAGs */
25 	NETIF_F_VLAN_CHALLENGED_BIT,	/* Device cannot handle VLAN packets */
26 	NETIF_F_GSO_BIT,		/* Enable software GSO. */
27 	NETIF_F_LLTX_BIT,		/* LockLess TX - deprecated. Please */
28 					/* do not use LLTX in new drivers */
29 	NETIF_F_NETNS_LOCAL_BIT,	/* Does not change network namespaces */
30 	NETIF_F_GRO_BIT,		/* Generic receive offload */
31 	NETIF_F_LRO_BIT,		/* large receive offload */
32 
33 	/**/NETIF_F_GSO_SHIFT,		/* keep the order of SKB_GSO_* bits */
34 	NETIF_F_TSO_BIT			/* ... TCPv4 segmentation */
35 		= NETIF_F_GSO_SHIFT,
36 	NETIF_F_GSO_ROBUST_BIT,		/* ... ->SKB_GSO_DODGY */
37 	NETIF_F_TSO_ECN_BIT,		/* ... TCP ECN support */
38 	NETIF_F_TSO_MANGLEID_BIT,	/* ... IPV4 ID mangling allowed */
39 	NETIF_F_TSO6_BIT,		/* ... TCPv6 segmentation */
40 	NETIF_F_FSO_BIT,		/* ... FCoE segmentation */
41 	NETIF_F_GSO_GRE_BIT,		/* ... GRE with TSO */
42 	NETIF_F_GSO_GRE_CSUM_BIT,	/* ... GRE with csum with TSO */
43 	NETIF_F_GSO_IPXIP4_BIT,		/* ... IP4 or IP6 over IP4 with TSO */
44 	NETIF_F_GSO_IPXIP6_BIT,		/* ... IP4 or IP6 over IP6 with TSO */
45 	NETIF_F_GSO_UDP_TUNNEL_BIT,	/* ... UDP TUNNEL with TSO */
46 	NETIF_F_GSO_UDP_TUNNEL_CSUM_BIT,/* ... UDP TUNNEL with TSO & CSUM */
47 	NETIF_F_GSO_PARTIAL_BIT,	/* ... Only segment inner-most L4
48 					 *     in hardware and all other
49 					 *     headers in software.
50 					 */
51 	NETIF_F_GSO_TUNNEL_REMCSUM_BIT, /* ... TUNNEL with TSO & REMCSUM */
52 	NETIF_F_GSO_SCTP_BIT,		/* ... SCTP fragmentation */
53 	NETIF_F_GSO_ESP_BIT,		/* ... ESP with TSO */
54 	NETIF_F_GSO_UDP_BIT,		/* ... UFO, deprecated except tuntap */
55 	NETIF_F_GSO_UDP_L4_BIT,		/* ... UDP payload GSO (not UFO) */
56 	NETIF_F_GSO_FRAGLIST_BIT,		/* ... Fraglist GSO */
57 	/**/NETIF_F_GSO_LAST =		/* last bit, see GSO_MASK */
58 		NETIF_F_GSO_FRAGLIST_BIT,
59 
60 	NETIF_F_FCOE_CRC_BIT,		/* FCoE CRC32 */
61 	NETIF_F_SCTP_CRC_BIT,		/* SCTP checksum offload */
62 	NETIF_F_FCOE_MTU_BIT,		/* Supports max FCoE MTU, 2158 bytes*/
63 	NETIF_F_NTUPLE_BIT,		/* N-tuple filters supported */
64 	NETIF_F_RXHASH_BIT,		/* Receive hashing offload */
65 	NETIF_F_RXCSUM_BIT,		/* Receive checksumming offload */
66 	NETIF_F_NOCACHE_COPY_BIT,	/* Use no-cache copyfromuser */
67 	NETIF_F_LOOPBACK_BIT,		/* Enable loopback */
68 	NETIF_F_RXFCS_BIT,		/* Append FCS to skb pkt data */
69 	NETIF_F_RXALL_BIT,		/* Receive errored frames too */
70 	NETIF_F_HW_VLAN_STAG_TX_BIT,	/* Transmit VLAN STAG HW acceleration */
71 	NETIF_F_HW_VLAN_STAG_RX_BIT,	/* Receive VLAN STAG HW acceleration */
72 	NETIF_F_HW_VLAN_STAG_FILTER_BIT,/* Receive filtering on VLAN STAGs */
73 	NETIF_F_HW_L2FW_DOFFLOAD_BIT,	/* Allow L2 Forwarding in Hardware */
74 
75 	NETIF_F_HW_TC_BIT,		/* Offload TC infrastructure */
76 	NETIF_F_HW_ESP_BIT,		/* Hardware ESP transformation offload */
77 	NETIF_F_HW_ESP_TX_CSUM_BIT,	/* ESP with TX checksum offload */
78 	NETIF_F_RX_UDP_TUNNEL_PORT_BIT, /* Offload of RX port for UDP tunnels */
79 	NETIF_F_HW_TLS_TX_BIT,		/* Hardware TLS TX offload */
80 	NETIF_F_HW_TLS_RX_BIT,		/* Hardware TLS RX offload */
81 
82 	NETIF_F_GRO_HW_BIT,		/* Hardware Generic receive offload */
83 	NETIF_F_HW_TLS_RECORD_BIT,	/* Offload TLS record */
84 	NETIF_F_GRO_FRAGLIST_BIT,	/* Fraglist GRO */
85 
86 	NETIF_F_HW_MACSEC_BIT,		/* Offload MACsec operations */
87 	NETIF_F_GRO_UDP_FWD_BIT,	/* Allow UDP GRO for forwarding */
88 
89 	/*
90 	 * Add your fresh new feature above and remember to update
91 	 * netdev_features_strings[] in net/core/ethtool.c and maybe
92 	 * some feature mask #defines below. Please also describe it
93 	 * in Documentation/networking/netdev-features.rst.
94 	 */
95 
96 	/**/NETDEV_FEATURE_COUNT
97 };
98 
99 /* copy'n'paste compression ;) */
100 #define __NETIF_F_BIT(bit)	((netdev_features_t)1 << (bit))
101 #define __NETIF_F(name)		__NETIF_F_BIT(NETIF_F_##name##_BIT)
102 
103 #define NETIF_F_FCOE_CRC	__NETIF_F(FCOE_CRC)
104 #define NETIF_F_FCOE_MTU	__NETIF_F(FCOE_MTU)
105 #define NETIF_F_FRAGLIST	__NETIF_F(FRAGLIST)
106 #define NETIF_F_FSO		__NETIF_F(FSO)
107 #define NETIF_F_GRO		__NETIF_F(GRO)
108 #define NETIF_F_GRO_HW		__NETIF_F(GRO_HW)
109 #define NETIF_F_GSO		__NETIF_F(GSO)
110 #define NETIF_F_GSO_ROBUST	__NETIF_F(GSO_ROBUST)
111 #define NETIF_F_HIGHDMA		__NETIF_F(HIGHDMA)
112 #define NETIF_F_HW_CSUM		__NETIF_F(HW_CSUM)
113 #define NETIF_F_HW_VLAN_CTAG_FILTER __NETIF_F(HW_VLAN_CTAG_FILTER)
114 #define NETIF_F_HW_VLAN_CTAG_RX	__NETIF_F(HW_VLAN_CTAG_RX)
115 #define NETIF_F_HW_VLAN_CTAG_TX	__NETIF_F(HW_VLAN_CTAG_TX)
116 #define NETIF_F_IP_CSUM		__NETIF_F(IP_CSUM)
117 #define NETIF_F_IPV6_CSUM	__NETIF_F(IPV6_CSUM)
118 #define NETIF_F_LLTX		__NETIF_F(LLTX)
119 #define NETIF_F_LOOPBACK	__NETIF_F(LOOPBACK)
120 #define NETIF_F_LRO		__NETIF_F(LRO)
121 #define NETIF_F_NETNS_LOCAL	__NETIF_F(NETNS_LOCAL)
122 #define NETIF_F_NOCACHE_COPY	__NETIF_F(NOCACHE_COPY)
123 #define NETIF_F_NTUPLE		__NETIF_F(NTUPLE)
124 #define NETIF_F_RXCSUM		__NETIF_F(RXCSUM)
125 #define NETIF_F_RXHASH		__NETIF_F(RXHASH)
126 #define NETIF_F_SCTP_CRC	__NETIF_F(SCTP_CRC)
127 #define NETIF_F_SG		__NETIF_F(SG)
128 #define NETIF_F_TSO6		__NETIF_F(TSO6)
129 #define NETIF_F_TSO_ECN		__NETIF_F(TSO_ECN)
130 #define NETIF_F_TSO		__NETIF_F(TSO)
131 #define NETIF_F_VLAN_CHALLENGED	__NETIF_F(VLAN_CHALLENGED)
132 #define NETIF_F_RXFCS		__NETIF_F(RXFCS)
133 #define NETIF_F_RXALL		__NETIF_F(RXALL)
134 #define NETIF_F_GSO_GRE		__NETIF_F(GSO_GRE)
135 #define NETIF_F_GSO_GRE_CSUM	__NETIF_F(GSO_GRE_CSUM)
136 #define NETIF_F_GSO_IPXIP4	__NETIF_F(GSO_IPXIP4)
137 #define NETIF_F_GSO_IPXIP6	__NETIF_F(GSO_IPXIP6)
138 #define NETIF_F_GSO_UDP_TUNNEL	__NETIF_F(GSO_UDP_TUNNEL)
139 #define NETIF_F_GSO_UDP_TUNNEL_CSUM __NETIF_F(GSO_UDP_TUNNEL_CSUM)
140 #define NETIF_F_TSO_MANGLEID	__NETIF_F(TSO_MANGLEID)
141 #define NETIF_F_GSO_PARTIAL	 __NETIF_F(GSO_PARTIAL)
142 #define NETIF_F_GSO_TUNNEL_REMCSUM __NETIF_F(GSO_TUNNEL_REMCSUM)
143 #define NETIF_F_GSO_SCTP	__NETIF_F(GSO_SCTP)
144 #define NETIF_F_GSO_ESP		__NETIF_F(GSO_ESP)
145 #define NETIF_F_GSO_UDP		__NETIF_F(GSO_UDP)
146 #define NETIF_F_HW_VLAN_STAG_FILTER __NETIF_F(HW_VLAN_STAG_FILTER)
147 #define NETIF_F_HW_VLAN_STAG_RX	__NETIF_F(HW_VLAN_STAG_RX)
148 #define NETIF_F_HW_VLAN_STAG_TX	__NETIF_F(HW_VLAN_STAG_TX)
149 #define NETIF_F_HW_L2FW_DOFFLOAD	__NETIF_F(HW_L2FW_DOFFLOAD)
150 #define NETIF_F_HW_TC		__NETIF_F(HW_TC)
151 #define NETIF_F_HW_ESP		__NETIF_F(HW_ESP)
152 #define NETIF_F_HW_ESP_TX_CSUM	__NETIF_F(HW_ESP_TX_CSUM)
153 #define	NETIF_F_RX_UDP_TUNNEL_PORT  __NETIF_F(RX_UDP_TUNNEL_PORT)
154 #define NETIF_F_HW_TLS_RECORD	__NETIF_F(HW_TLS_RECORD)
155 #define NETIF_F_GSO_UDP_L4	__NETIF_F(GSO_UDP_L4)
156 #define NETIF_F_HW_TLS_TX	__NETIF_F(HW_TLS_TX)
157 #define NETIF_F_HW_TLS_RX	__NETIF_F(HW_TLS_RX)
158 #define NETIF_F_GRO_FRAGLIST	__NETIF_F(GRO_FRAGLIST)
159 #define NETIF_F_GSO_FRAGLIST	__NETIF_F(GSO_FRAGLIST)
160 #define NETIF_F_HW_MACSEC	__NETIF_F(HW_MACSEC)
161 #define NETIF_F_GRO_UDP_FWD	__NETIF_F(GRO_UDP_FWD)
162 
163 /* Finds the next feature with the highest number of the range of start till 0.
164  */
165 static inline int find_next_netdev_feature(u64 feature, unsigned long start)
166 {
167 	/* like BITMAP_LAST_WORD_MASK() for u64
168 	 * this sets the most significant 64 - start to 0.
169 	 */
170 	feature &= ~0ULL >> (-start & ((sizeof(feature) * 8) - 1));
171 
172 	return fls64(feature) - 1;
173 }
174 
175 /* This goes for the MSB to the LSB through the set feature bits,
176  * mask_addr should be a u64 and bit an int
177  */
178 #define for_each_netdev_feature(mask_addr, bit)				\
179 	for ((bit) = find_next_netdev_feature((mask_addr),		\
180 					      NETDEV_FEATURE_COUNT);	\
181 	     (bit) >= 0;						\
182 	     (bit) = find_next_netdev_feature((mask_addr), (bit) - 1))
183 
184 /* Features valid for ethtool to change */
185 /* = all defined minus driver/device-class-related */
186 #define NETIF_F_NEVER_CHANGE	(NETIF_F_VLAN_CHALLENGED | \
187 				 NETIF_F_LLTX | NETIF_F_NETNS_LOCAL)
188 
189 /* remember that ((t)1 << t_BITS) is undefined in C99 */
190 #define NETIF_F_ETHTOOL_BITS	((__NETIF_F_BIT(NETDEV_FEATURE_COUNT - 1) | \
191 		(__NETIF_F_BIT(NETDEV_FEATURE_COUNT - 1) - 1)) & \
192 		~NETIF_F_NEVER_CHANGE)
193 
194 /* Segmentation offload feature mask */
195 #define NETIF_F_GSO_MASK	(__NETIF_F_BIT(NETIF_F_GSO_LAST + 1) - \
196 		__NETIF_F_BIT(NETIF_F_GSO_SHIFT))
197 
198 /* List of IP checksum features. Note that NETIF_F_HW_CSUM should not be
199  * set in features when NETIF_F_IP_CSUM or NETIF_F_IPV6_CSUM are set--
200  * this would be contradictory
201  */
202 #define NETIF_F_CSUM_MASK	(NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \
203 				 NETIF_F_HW_CSUM)
204 
205 #define NETIF_F_ALL_TSO 	(NETIF_F_TSO | NETIF_F_TSO6 | \
206 				 NETIF_F_TSO_ECN | NETIF_F_TSO_MANGLEID)
207 
208 #define NETIF_F_ALL_FCOE	(NETIF_F_FCOE_CRC | NETIF_F_FCOE_MTU | \
209 				 NETIF_F_FSO)
210 
211 /* List of features with software fallbacks. */
212 #define NETIF_F_GSO_SOFTWARE	(NETIF_F_ALL_TSO | NETIF_F_GSO_SCTP |	     \
213 				 NETIF_F_GSO_UDP_L4 | NETIF_F_GSO_FRAGLIST)
214 
215 /*
216  * If one device supports one of these features, then enable them
217  * for all in netdev_increment_features.
218  */
219 #define NETIF_F_ONE_FOR_ALL	(NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \
220 				 NETIF_F_SG | NETIF_F_HIGHDMA |		\
221 				 NETIF_F_FRAGLIST | NETIF_F_VLAN_CHALLENGED)
222 
223 /*
224  * If one device doesn't support one of these features, then disable it
225  * for all in netdev_increment_features.
226  */
227 #define NETIF_F_ALL_FOR_ALL	(NETIF_F_NOCACHE_COPY | NETIF_F_FSO)
228 
229 /*
230  * If upper/master device has these features disabled, they must be disabled
231  * on all lower/slave devices as well.
232  */
233 #define NETIF_F_UPPER_DISABLES	NETIF_F_LRO
234 
235 /* changeable features with no special hardware requirements */
236 #define NETIF_F_SOFT_FEATURES	(NETIF_F_GSO | NETIF_F_GRO)
237 
238 /* Changeable features with no special hardware requirements that defaults to off. */
239 #define NETIF_F_SOFT_FEATURES_OFF	(NETIF_F_GRO_FRAGLIST | NETIF_F_GRO_UDP_FWD)
240 
241 #define NETIF_F_VLAN_FEATURES	(NETIF_F_HW_VLAN_CTAG_FILTER | \
242 				 NETIF_F_HW_VLAN_CTAG_RX | \
243 				 NETIF_F_HW_VLAN_CTAG_TX | \
244 				 NETIF_F_HW_VLAN_STAG_FILTER | \
245 				 NETIF_F_HW_VLAN_STAG_RX | \
246 				 NETIF_F_HW_VLAN_STAG_TX)
247 
248 #define NETIF_F_GSO_ENCAP_ALL	(NETIF_F_GSO_GRE |			\
249 				 NETIF_F_GSO_GRE_CSUM |			\
250 				 NETIF_F_GSO_IPXIP4 |			\
251 				 NETIF_F_GSO_IPXIP6 |			\
252 				 NETIF_F_GSO_UDP_TUNNEL |		\
253 				 NETIF_F_GSO_UDP_TUNNEL_CSUM)
254 
255 #endif	/* _LINUX_NETDEV_FEATURES_H */
256