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 | 162 | Structures |
| 163 | 163 | ---------- |
| 164 | 164 | |
| 165 | −Legacy families can define C structures both to be used as the contents | |
| 166 | −of an attribute and as a fixed message header. The plan is to define | |
| 167 | −the structs in ``definitions`` and link the appropriate attrs. | |
| 165 | +Legacy families can define C structures both to be used as the contents of | |
| 166 | +an attribute and as a fixed message header. Structures are defined in | |
| 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 | 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 | 254 | The validation policy in the kernel is formed by combining the type |
| 255 | 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 | 267 | operations |
| 258 | 268 | ---------- |
| 259 | 269 | |