Pull networking updates from Paolo Abeni: "Core: - Introduce a config option to tweak MAX_SKB_FRAGS. Increasing the default value allows for better BIG TCP performances - Reduce compound page head access for zero-copy data transfers - RPS/RFS improvements, avoiding unneeded NET_RX_SOFTIRQ when possible - Threaded NAPI improvements, adding defer skb free support and unneeded softirq avoidance - Address dst_entry reference count scalability issues, via false sharing avoidance and optimize refcount tracking - Add lockless accesses annotation to sk_err[_soft] - Optimize again the skb struct layout - Extends the skb drop reasons to make it usable by multiple subsystems - Better const qualifier awareness for socket casts BPF: - Add skb and XDP typed dynptrs which allow BPF programs for more ergonomic and less brittle iteration through data and variable-sized accesses - Add a new BPF netfilter program type and minimal support to hook BPF programs to netfilter hooks such as prerouting or forward - Add more precise memory usage reporting for all BPF map types - Adds support for using {FOU,GUE} encap with an ipip device operating in collect_md mode and add a set of BPF kfuncs for controlling encap params - Allow BPF programs to detect at load time whether a particular kfunc exists or not, and also add support for this in light skeleton - Bigger batch of BPF verifier improvements to prepare for upcoming BPF open-coded iterators allowing for less restrictive looping capabilities - Rework RCU enforcement in the verifier, add kptr_rcu and enforce BPF programs to NULL-check before passing such pointers into kfunc - Add support for kptrs in percpu hashmaps, percpu LRU hashmaps and in local storage maps - Enable RCU semantics for task BPF kptrs and allow referenced kptr tasks to be stored in BPF maps - Add support for refcounted local kptrs to the verifier for allowing shared ownership, useful for adding a node to both the BPF list and rbtree - Add BPF verifier support for ST instructions in convert_ctx_access() which will help new -mcpu=v4 clang flag to start emitting them - Add ARM32 USDT support to libbpf - Improve bpftool's visual program dump which produces the control flow graph in a DOT format by adding C source inline annotations Protocols: - IPv4: Allow adding to IPv4 address a 'protocol' tag. Such value indicates the provenance of the IP address - IPv6: optimize route lookup, dropping unneeded R/W lock acquisition - Add the handshake upcall mechanism, allowing the user-space to implement generic TLS handshake on kernel's behalf - Bridge: support per-{Port, VLAN} neighbor suppression, increasing resilience to nodes failures - SCTP: add support for Fair Capacity and Weighted Fair Queueing schedulers - MPTCP: delay first subflow allocation up to its first usage. This will allow for later better LSM interaction - xfrm: Remove inner/outer modes from input/output path. These are not needed anymore - WiFi: - reduced neighbor report (RNR) handling for AP mode - HW timestamping support - support for randomized auth/deauth TA for PASN privacy - per-link debugfs for multi-link - TC offload support for mac80211 drivers - mac80211 mesh fast-xmit and fast-rx support - enable Wi-Fi 7 (EHT) mesh support Netfilter: - Add nf_tables 'brouting' support, to force a packet to be routed instead of being bridged - Update bridge netfilter and ovs conntrack helpers to handle IPv6 Jumbo packets properly, i.e. fetch the packet length from hop-by-hop extension header. This is needed for BIT TCP support - The iptables 32bit compat interface isn't compiled in by default anymore - Move ip(6)tables builtin icmp matches to the udptcp one. This has the advantage that icmp/icmpv6 match doesn't load the iptables/ip6tables modules anymore when iptables-nft is used - Extended netlink error report for netdevice in flowtables and netdev/chains. Allow for incrementally add/delete devices to netdev basechain. Allow to create netdev chain without device Driver API: - Remove redundant Device Control Error Reporting Enable, as PCI core has already error reporting enabled at enumeration time - Move Multicast DB netlink handlers to core, allowing devices other then bridge to use them - Allow the page_pool to directly recycle the pages from safely localized NAPI - Implement lockless TX queue stop/wake combo macros, allowing for further code de-duplication and sanitization - Add YNL support for user headers and struct attrs - Add partial YNL specification for devlink - Add partial YNL specification for ethtool - Add tc-mqprio and tc-taprio support for preemptible traffic classes - Add tx push buf len param to ethtool, specifies the maximum number of bytes of a transmitted packet a driver can push directly to the underlying device - Add basic LED support for switch/phy - Add NAPI documentation, stop relaying on external links - Convert dsa_master_ioctl() to netdev notifier. This is a preparatory work to make the hardware timestamping layer selectable by user space - Add transceiver support and improve the error messages for CAN-FD controllers New hardware / drivers: - Ethernet: - AMD/Pensando core device support - MediaTek MT7981 SoC - MediaTek MT7988 SoC - Broadcom BCM53134 embedded switch - Texas Instruments CPSW9G ethernet switch - Qualcomm EMAC3 DWMAC ethernet - StarFive JH7110 SoC - NXP CBTX ethernet PHY - WiFi: - Apple M1 Pro/Max devices - RealTek rtl8710bu/rtl8188gu - RealTek rtl8822bs, rtl8822cs and rtl8821cs SDIO chipset - Bluetooth: - Realtek RTL8821CS, RTL8851B, RTL8852BS - Mediatek MT7663, MT7922 - NXP w8997 - Actions Semi ATS2851 - QTI WCN6855 - Marvell 88W8997 - Can: - STMicroelectronics bxcan stm32f429 Drivers: - Ethernet NICs: - Intel (1G, icg): - add tracking and reporting of QBV config errors - add support for configuring max SDU for each Tx queue - Intel (100G, ice): - refactor mailbox overflow detection to support Scalable IOV - GNSS interface optimization - Intel (i40e): - support XDP multi-buffer - nVidia/Mellanox: - add the support for linux bridge multicast offload - enable TC offload for egress and engress MACVLAN over bond - add support for VxLAN GBP encap/decap flows offload - extend packet offload to fully support libreswan - support tunnel mode in mlx5 IPsec packet offload - extend XDP multi-buffer support - support MACsec VLAN offload - add support for dynamic msix vectors allocation - drop RX page_cache and fully use page_pool - implement thermal zone to report NIC temperature - Netronome/Corigine: - add support for multi-zone conntrack offload - Solarflare/Xilinx: - support offloading TC VLAN push/pop actions to the MAE - support TC decap rules - support unicast PTP - Other NICs: - Broadcom (bnxt): enforce software based freq adjustments only on shared PHC NIC - RealTek (r8169): refactor to addess ASPM issues during NAPI poll - Micrel (lan8841): add support for PTP_PF_PEROUT - Cadence (macb): enable PTP unicast - Engleder (tsnep): add XDP socket zero-copy support - virtio-net: implement exact header length guest feature - veth: add page_pool support for page recycling - vxlan: add MDB data path support - gve: add XDP support for GQI-QPL format - geneve: accept every ethertype - macvlan: allow some packets to bypass broadcast queue - mana: add support for jumbo frame - Ethernet high-speed switches: - Microchip (sparx5): Add support for TC flower templates - Ethernet embedded switches: - Broadcom (b54): - configure 6318 and 63268 RGMII ports - Marvell (mv88e6xxx): - faster C45 bus scan - Microchip: - lan966x: - add support for IS1 VCAP - better TX/RX from/to CPU performances - ksz9477: add ETS Qdisc support - ksz8: enhance static MAC table operations and error handling - sama7g5: add PTP capability - NXP (ocelot): - add support for external ports - add support for preemptible traffic classes - Texas Instruments: - add CPSWxG SGMII support for J7200 and J721E - Intel WiFi (iwlwifi): - preparation for Wi-Fi 7 EHT and multi-link support - EHT (Wi-Fi 7) sniffer support - hardware timestamping support for some devices/firwmares - TX beacon protection on newer hardware - Qualcomm 802.11ax WiFi (ath11k): - MU-MIMO parameters support - ack signal support for management packets - RealTek WiFi (rtw88): - SDIO bus support - better support for some SDIO devices (e.g. MAC address from efuse) - RealTek WiFi (rtw89): - HW scan support for 8852b - better support for 6 GHz scanning - support for various newer firmware APIs - framework firmware backwards compatibility - MediaTek WiFi (mt76): - P2P support - mesh A-MSDU support - EHT (Wi-Fi 7) support - coredump support" * tag 'net-next-6.4' of git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net-next: (2078 commits) net: phy: hide the PHYLIB_LEDS knob net: phy: marvell-88x2222: remove unnecessary (void*) conversions tcp/udp: Fix memleaks of sk and zerocopy skbs with TX timestamp. net: amd: Fix link leak when verifying config failed net: phy: marvell: Fix inconsistent indenting in led_blink_set lan966x: Don't use xdp_frame when action is XDP_TX tsnep: Add XDP socket zero-copy TX support tsnep: Add XDP socket zero-copy RX support tsnep: Move skb receive action to separate function tsnep: Add functions for queue enable/disable tsnep: Rework TX/RX queue initialization tsnep: Replace modulo operation with mask net: phy: dp83867: Add led_brightness_set support net: phy: Fix reading LED reg property drivers: nfc: nfcsim: remove return value check of `dev_dir` net: phy: dp83867: Remove unnecessary (void*) conversions net: ethtool: coalesce: try to make user settings stick twice net: mana: Check if netdev/napi_alloc_frag returns single page net: mana: Rename mana_refill_rxoob and remove some empty lines net: veth: add page_pool stats ...
Showing the changes to Documentation/userspace-api (2 of 1925 files). Show all
Unified · Split
| @@ -162,9 +162,91 @@ Other quirks (todo) · 161 unmodified lines | |||
| 162 | Structures | 162 | Structures |
| 163 | ---------- | 163 | ---------- |
| 164 | 164 | ||
| 165 | Legacy families can define C structures both to be used as the contents | 165 | Legacy families can define C structures both to be used as the contents of |
| 166 | of an attribute and as a fixed message header. The plan is to define | 166 | an attribute and as a fixed message header. Structures are defined in |
| 167 | the structs in ``definitions`` and link the appropriate attrs. | 167 | ``definitions`` and referenced in operations or attributes. Note that |
| 168 | structures defined in YAML are implicitly packed according to C | ||
| 169 | conventions. For example, the following struct is 4 bytes, not 6 bytes: | ||
| 170 | |||
| 171 | .. code-block:: c | ||
| 172 | |||
| 173 | struct { | ||
| 174 | u8 a; | ||
| 175 | u16 b; | ||
| 176 | u8 c; | ||
| 177 | } | ||
| 178 | |||
| 179 | Any padding must be explicitly added and C-like languages should infer the | ||
| 180 | need for explicit padding from whether the members are naturally aligned. | ||
| 181 | |||
| 182 | Here is the struct definition from above, declared in YAML: | ||
| 183 | |||
| 184 | .. code-block:: yaml | ||
| 185 | |||
| 186 | definitions: | ||
| 187 | - | ||
| 188 | name: message-header | ||
| 189 | type: struct | ||
| 190 | members: | ||
| 191 | - | ||
| 192 | name: a | ||
| 193 | type: u8 | ||
| 194 | - | ||
| 195 | name: b | ||
| 196 | type: u16 | ||
| 197 | - | ||
| 198 | name: c | ||
| 199 | type: u8 | ||
| 200 | |||
| 201 | Fixed Headers | ||
| 202 | ~~~~~~~~~~~~~ | ||
| 203 | |||
| 204 | Fixed message headers can be added to operations using ``fixed-header``. | ||
| 205 | The default ``fixed-header`` can be set in ``operations`` and it can be set | ||
| 206 | or overridden for each operation. | ||
| 207 | |||
| 208 | .. code-block:: yaml | ||
| 209 | |||
| 210 | operations: | ||
| 211 | fixed-header: message-header | ||
| 212 | list: | ||
| 213 | - | ||
| 214 | name: get | ||
| 215 | fixed-header: custom-header | ||
| 216 | attribute-set: message-attrs | ||
| 217 | |||
| 218 | Attributes | ||
| 219 | ~~~~~~~~~~ | ||
| 220 | |||
| 221 | A ``binary`` attribute can be interpreted as a C structure using a | ||
| 222 | ``struct`` property with the name of the structure definition. The | ||
| 223 | ``struct`` property implies ``sub-type: struct`` so it is not necessary to | ||
| 224 | specify a sub-type. | ||
| 225 | |||
| 226 | .. code-block:: yaml | ||
| 227 | |||
| 228 | attribute-sets: | ||
| 229 | - | ||
| 230 | name: stats-attrs | ||
| 231 | attributes: | ||
| 232 | - | ||
| 233 | name: stats | ||
| 234 | type: binary | ||
| 235 | struct: vport-stats | ||
| 236 | |||
| 237 | C Arrays | ||
| 238 | -------- | ||
| 239 | |||
| 240 | Legacy families also use ``binary`` attributes to encapsulate C arrays. The | ||
| 241 | ``sub-type`` is used to identify the type of scalar to extract. | ||
| 242 | |||
| 243 | .. code-block:: yaml | ||
| 244 | |||
| 245 | attributes: | ||
| 246 | - | ||
| 247 | name: ports | ||
| 248 | type: binary | ||
| 249 | sub-type: u32 | ||
| 168 | 250 | ||
| 169 | Multi-message DO | 251 | Multi-message DO |
| 170 | ---------------- | 252 | ---------------- |
| @@ -254,6 +254,16 @@ rather than depend on what is specified in the spec file. · 253 unmodified lines | |||
| 254 | The validation policy in the kernel is formed by combining the type | 254 | The validation policy in the kernel is formed by combining the type |
| 255 | definition (``type`` and ``nested-attributes``) and the ``checks``. | 255 | definition (``type`` and ``nested-attributes``) and the ``checks``. |
| 256 | 256 | ||
| 257 | sub-type | ||
| 258 | ~~~~~~~~ | ||
| 259 | |||
| 260 | Legacy families have special ways of expressing arrays. ``sub-type`` can be | ||
| 261 | used to define the type of array members in case array members are not | ||
| 262 | fully defined as attributes (in a bona fide attribute space). For instance | ||
| 263 | a C array of u32 values can be specified with ``type: binary`` and | ||
| 264 | ``sub-type: u32``. Binary types and legacy array formats are described in | ||
| 265 | more detail in :doc:`genetlink-legacy`. | ||
| 266 | |||
| 257 | operations | 267 | operations |
| 258 | ---------- | 268 | ---------- |
| 259 | 269 | ||