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
88 /*
89 * Add your fresh new feature above and remember to update
90 * netdev_features_strings[] in net/ethtool/common.c and maybe
91 * some feature mask #defines below. Please also describe it
92 * in Documentation/networking/netdev-features.rst.
93 */
94
95 /**/NETDEV_FEATURE_COUNT
96 };
97
98 /* copy'n'paste compression ;) */
99 #define __NETIF_F_BIT(bit) ((netdev_features_t)1 << (bit))
100 #define __NETIF_F(name) __NETIF_F_BIT(NETIF_F_##name##_BIT)
101
102 #define NETIF_F_FCOE_CRC __NETIF_F(FCOE_CRC)
103 #define NETIF_F_FCOE_MTU __NETIF_F(FCOE_MTU)
104 #define NETIF_F_FRAGLIST __NETIF_F(FRAGLIST)
105 #define NETIF_F_FSO __NETIF_F(FSO)
106 #define NETIF_F_GRO __NETIF_F(GRO)
107 #define NETIF_F_GRO_HW __NETIF_F(GRO_HW)
108 #define NETIF_F_GSO __NETIF_F(GSO)
109 #define NETIF_F_GSO_ROBUST __NETIF_F(GSO_ROBUST)
110 #define NETIF_F_HIGHDMA __NETIF_F(HIGHDMA)
111 #define NETIF_F_HW_CSUM __NETIF_F(HW_CSUM)
112 #define NETIF_F_HW_VLAN_CTAG_FILTER __NETIF_F(HW_VLAN_CTAG_FILTER)
113 #define NETIF_F_HW_VLAN_CTAG_RX __NETIF_F(HW_VLAN_CTAG_RX)
114 #define NETIF_F_HW_VLAN_CTAG_TX __NETIF_F(HW_VLAN_CTAG_TX)
115 #define NETIF_F_IP_CSUM __NETIF_F(IP_CSUM)
116 #define NETIF_F_IPV6_CSUM __NETIF_F(IPV6_CSUM)
117 #define NETIF_F_LLTX __NETIF_F(LLTX)
118 #define NETIF_F_LOOPBACK __NETIF_F(LOOPBACK)
119 #define NETIF_F_LRO __NETIF_F(LRO)
120 #define NETIF_F_NETNS_LOCAL __NETIF_F(NETNS_LOCAL)
121 #define NETIF_F_NOCACHE_COPY __NETIF_F(NOCACHE_COPY)
122 #define NETIF_F_NTUPLE __NETIF_F(NTUPLE)
123 #define NETIF_F_RXCSUM __NETIF_F(RXCSUM)
124 #define NETIF_F_RXHASH __NETIF_F(RXHASH)
125 #define NETIF_F_SCTP_CRC __NETIF_F(SCTP_CRC)
126 #define NETIF_F_SG __NETIF_F(SG)
127 #define NETIF_F_TSO6 __NETIF_F(TSO6)
128 #define NETIF_F_TSO_ECN __NETIF_F(TSO_ECN)
129 #define NETIF_F_TSO __NETIF_F(TSO)
130 #define NETIF_F_VLAN_CHALLENGED __NETIF_F(VLAN_CHALLENGED)
131 #define NETIF_F_RXFCS __NETIF_F(RXFCS)
132 #define NETIF_F_RXALL __NETIF_F(RXALL)
133 #define NETIF_F_GSO_GRE __NETIF_F(GSO_GRE)
134 #define NETIF_F_GSO_GRE_CSUM __NETIF_F(GSO_GRE_CSUM)
135 #define NETIF_F_GSO_IPXIP4 __NETIF_F(GSO_IPXIP4)
136 #define NETIF_F_GSO_IPXIP6 __NETIF_F(GSO_IPXIP6)
137 #define NETIF_F_GSO_UDP_TUNNEL __NETIF_F(GSO_UDP_TUNNEL)
138 #define NETIF_F_GSO_UDP_TUNNEL_CSUM __NETIF_F(GSO_UDP_TUNNEL_CSUM)
139 #define NETIF_F_TSO_MANGLEID __NETIF_F(TSO_MANGLEID)
140 #define NETIF_F_GSO_PARTIAL __NETIF_F(GSO_PARTIAL)
141 #define NETIF_F_GSO_TUNNEL_REMCSUM __NETIF_F(GSO_TUNNEL_REMCSUM)
142 #define NETIF_F_GSO_SCTP __NETIF_F(GSO_SCTP)
143 #define NETIF_F_GSO_ESP __NETIF_F(GSO_ESP)
144 #define NETIF_F_GSO_UDP __NETIF_F(GSO_UDP)
145 #define NETIF_F_HW_VLAN_STAG_FILTER __NETIF_F(HW_VLAN_STAG_FILTER)
146 #define NETIF_F_HW_VLAN_STAG_RX __NETIF_F(HW_VLAN_STAG_RX)
147 #define NETIF_F_HW_VLAN_STAG_TX __NETIF_F(HW_VLAN_STAG_TX)
148 #define NETIF_F_HW_L2FW_DOFFLOAD __NETIF_F(HW_L2FW_DOFFLOAD)
149 #define NETIF_F_HW_TC __NETIF_F(HW_TC)
150 #define NETIF_F_HW_ESP __NETIF_F(HW_ESP)
151 #define NETIF_F_HW_ESP_TX_CSUM __NETIF_F(HW_ESP_TX_CSUM)
152 #define NETIF_F_RX_UDP_TUNNEL_PORT __NETIF_F(RX_UDP_TUNNEL_PORT)
153 #define NETIF_F_HW_TLS_RECORD __NETIF_F(HW_TLS_RECORD)
154 #define NETIF_F_GSO_UDP_L4 __NETIF_F(GSO_UDP_L4)
155 #define NETIF_F_HW_TLS_TX __NETIF_F(HW_TLS_TX)
156 #define NETIF_F_HW_TLS_RX __NETIF_F(HW_TLS_RX)
157 #define NETIF_F_GRO_FRAGLIST __NETIF_F(GRO_FRAGLIST)
158 #define NETIF_F_GSO_FRAGLIST __NETIF_F(GSO_FRAGLIST)
159 #define NETIF_F_HW_MACSEC __NETIF_F(HW_MACSEC)
160
161 /* Finds the next feature with the highest number of the range of start-1 till 0.
162 */
find_next_netdev_feature(u64 feature,unsigned long start)163 static inline int find_next_netdev_feature(u64 feature, unsigned long start)
164 {
165 /* like BITMAP_LAST_WORD_MASK() for u64
166 * this sets the most significant 64 - start to 0.
167 */
168 feature &= ~0ULL >> (-start & ((sizeof(feature) * 8) - 1));
169
170 return fls64(feature) - 1;
171 }
172
173 /* This goes for the MSB to the LSB through the set feature bits,
174 * mask_addr should be a u64 and bit an int
175 */
176 #define for_each_netdev_feature(mask_addr, bit) \
177 for ((bit) = find_next_netdev_feature((mask_addr), \
178 NETDEV_FEATURE_COUNT); \
179 (bit) >= 0; \
180 (bit) = find_next_netdev_feature((mask_addr), (bit)))
181
182 /* Features valid for ethtool to change */
183 /* = all defined minus driver/device-class-related */
184 #define NETIF_F_NEVER_CHANGE (NETIF_F_VLAN_CHALLENGED | \
185 NETIF_F_LLTX | NETIF_F_NETNS_LOCAL)
186
187 /* remember that ((t)1 << t_BITS) is undefined in C99 */
188 #define NETIF_F_ETHTOOL_BITS ((__NETIF_F_BIT(NETDEV_FEATURE_COUNT - 1) | \
189 (__NETIF_F_BIT(NETDEV_FEATURE_COUNT - 1) - 1)) & \
190 ~NETIF_F_NEVER_CHANGE)
191
192 /* Segmentation offload feature mask */
193 #define NETIF_F_GSO_MASK (__NETIF_F_BIT(NETIF_F_GSO_LAST + 1) - \
194 __NETIF_F_BIT(NETIF_F_GSO_SHIFT))
195
196 /* List of IP checksum features. Note that NETIF_F_HW_CSUM should not be
197 * set in features when NETIF_F_IP_CSUM or NETIF_F_IPV6_CSUM are set--
198 * this would be contradictory
199 */
200 #define NETIF_F_CSUM_MASK (NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \
201 NETIF_F_HW_CSUM)
202
203 #define NETIF_F_ALL_TSO (NETIF_F_TSO | NETIF_F_TSO6 | \
204 NETIF_F_TSO_ECN | NETIF_F_TSO_MANGLEID)
205
206 #define NETIF_F_ALL_FCOE (NETIF_F_FCOE_CRC | NETIF_F_FCOE_MTU | \
207 NETIF_F_FSO)
208
209 /* List of features with software fallbacks. */
210 #define NETIF_F_GSO_SOFTWARE (NETIF_F_ALL_TSO | \
211 NETIF_F_GSO_SCTP)
212
213 /*
214 * If one device supports one of these features, then enable them
215 * for all in netdev_increment_features.
216 */
217 #define NETIF_F_ONE_FOR_ALL (NETIF_F_GSO_SOFTWARE | NETIF_F_GSO_ROBUST | \
218 NETIF_F_SG | NETIF_F_HIGHDMA | \
219 NETIF_F_FRAGLIST | NETIF_F_VLAN_CHALLENGED)
220
221 /*
222 * If one device doesn't support one of these features, then disable it
223 * for all in netdev_increment_features.
224 */
225 #define NETIF_F_ALL_FOR_ALL (NETIF_F_NOCACHE_COPY | NETIF_F_FSO)
226
227 /*
228 * If upper/master device has these features disabled, they must be disabled
229 * on all lower/slave devices as well.
230 */
231 #define NETIF_F_UPPER_DISABLES NETIF_F_LRO
232
233 /* changeable features with no special hardware requirements */
234 #define NETIF_F_SOFT_FEATURES (NETIF_F_GSO | NETIF_F_GRO)
235
236 /* Changeable features with no special hardware requirements that defaults to off. */
237 #define NETIF_F_SOFT_FEATURES_OFF NETIF_F_GRO_FRAGLIST
238
239 #define NETIF_F_VLAN_FEATURES (NETIF_F_HW_VLAN_CTAG_FILTER | \
240 NETIF_F_HW_VLAN_CTAG_RX | \
241 NETIF_F_HW_VLAN_CTAG_TX | \
242 NETIF_F_HW_VLAN_STAG_FILTER | \
243 NETIF_F_HW_VLAN_STAG_RX | \
244 NETIF_F_HW_VLAN_STAG_TX)
245
246 #define NETIF_F_GSO_ENCAP_ALL (NETIF_F_GSO_GRE | \
247 NETIF_F_GSO_GRE_CSUM | \
248 NETIF_F_GSO_IPXIP4 | \
249 NETIF_F_GSO_IPXIP6 | \
250 NETIF_F_GSO_UDP_TUNNEL | \
251 NETIF_F_GSO_UDP_TUNNEL_CSUM)
252
253 #endif /* _LINUX_NETDEV_FEATURES_H */
254