From: Linus Walleij linus.walleij@linaro.org
[ Upstream commit 6a07e3af4973402fa199a80036c10060b922c92c ]
It is desireable to push the hardware accelerator to also process non-segmented TCP frames: we pass the skb->len to the "TOE/TSO" offloader and it will handle them.
Without this quirk the driver becomes unstable and lock up and and crash.
I do not know exactly why, but it is probably due to the TOE (TCP offload engine) feature that is coupled with the segmentation feature - it is not possible to turn one part off and not the other, either both TOE and TSO are active, or neither of them.
Not having the TOE part active seems detrimental, as if that hardware feature is not really supposed to be turned off.
The datasheet says:
"Based on packet parsing and TCP connection/NAT table lookup results, the NetEngine puts the packets belonging to the same TCP connection to the same queue for the software to process. The NetEngine puts incoming packets to the buffer or series of buffers for a jumbo packet. With this hardware acceleration, IP/TCP header parsing, checksum validation and connection lookup are offloaded from the software processing."
After numerous tests with the hardware locking up after something between minutes and hours depending on load using iperf3 I have concluded this is necessary to stabilize the hardware.
Signed-off-by: Linus Walleij linus.walleij@linaro.org Link: https://patch.msgid.link/20250408-gemini-ethernet-tso-always-v1-1-e669f93235... Signed-off-by: Jakub Kicinski kuba@kernel.org Signed-off-by: Sasha Levin sashal@kernel.org ---
**YES** This commit should be backported to stable kernel trees based on the following analysis: ## Critical Stability Fix This commit addresses a critical hardware stability issue where the Cortina Gemini ethernet driver would "lock up and crash" after minutes to hours of operation under load. The commit message explicitly states: > "Without this quirk the driver becomes unstable and lock up and and crash." > "After numerous tests with the hardware locking up after something between minutes and hours depending on load using iperf3 I have concluded this is necessary to stabilize the hardware." ## Code Analysis of Changes The changes are minimal and contained within the `gmac_map_tx_bufs` function in `drivers/net/ethernet/cortina/gemini.c`: 1. **TCP Detection Logic**: The code adds early TCP protocol detection: ```c bool tcp = false; if (skb->protocol == htons(ETH_P_IP)) tcp = (ip_hdr(skb)->protocol == IPPROTO_TCP); else tcp = (ipv6_hdr(skb)->nexthdr == IPPROTO_TCP); ``` 2. **TOE/TSO Activation for All TCP**: For non-GSO TCP frames, it now activates the hardware TOE/TSO engine: ```c } else if (tcp) { mss = netdev->mtu + skb_tcp_all_headers(skb); mss = min(mss, skb->len); word1 |= TSS_MTU_ENABLE_BIT; word3 |= mss; ``` 3. **Simplified Checksum Logic**: The checksum handling is simplified by reusing the already- determined `tcp` boolean instead of recalculating it. ## Hardware Architecture Justification The commit explains this is necessary due to the coupled nature of the hardware's TOE (TCP Offload Engine) and TSO features: > "it is probably due to the TOE (TCP offload engine) feature that is coupled with the segmentation feature - it is not possible to turn one part off and not the other" This aligns with the datasheet description that the NetEngine performs "IP/TCP header parsing, checksum validation and connection lookup" as integrated hardware acceleration. ## Pattern Match with Historical Commits Looking at the provided similar commits: - **Similar Commit #2**: "net: ethernet: cortina: Restore TSO support" (Status: YES) - This is the direct predecessor that restored TSO but didn't address the stability issue for non-segmented TCP frames - **Similar Commit #3**: "net: ethernet: cortina: Locking fixes" (Status: YES) - Another stability fix for the same driver Both historical commits addressing Cortina Gemini stability issues were marked as backport-worthy, establishing a pattern. ## Backport Criteria Assessment ✅ **Fixes important bugs**: Prevents driver crashes and hardware lockups ✅ **Small and contained**: Changes are localized to one function with clear logic ✅ **Minimal risk**: Only affects TCP frame handling, doesn't change architectural behavior ✅ **No new features**: Uses existing hardware capabilities more appropriately ✅ **Critical subsystem**: Network drivers are essential for system stability ## Risk Assessment The risk is very low because: - The changes only affect how TCP frames are processed by existing hardware features - The TOE/TSO hardware engine was already in use for segmented frames - The modification ensures consistent hardware state rather than leaving it partially enabled - The fix has been tested extensively by the author under load conditions This commit follows the stable tree criteria perfectly: it's an important bug fix that prevents system crashes, has minimal risk of regression, and doesn't introduce new features.
drivers/net/ethernet/cortina/gemini.c | 37 +++++++++++++++++++++------ 1 file changed, 29 insertions(+), 8 deletions(-)
diff --git a/drivers/net/ethernet/cortina/gemini.c b/drivers/net/ethernet/cortina/gemini.c index 991e3839858b5..3735a02e2f977 100644 --- a/drivers/net/ethernet/cortina/gemini.c +++ b/drivers/net/ethernet/cortina/gemini.c @@ -1143,6 +1143,7 @@ static int gmac_map_tx_bufs(struct net_device *netdev, struct sk_buff *skb, struct gmac_txdesc *txd; skb_frag_t *skb_frag; dma_addr_t mapping; + bool tcp = false; void *buffer; u16 mss; int ret; @@ -1150,6 +1151,13 @@ static int gmac_map_tx_bufs(struct net_device *netdev, struct sk_buff *skb, word1 = skb->len; word3 = SOF_BIT;
+ /* Determine if we are doing TCP */ + if (skb->protocol == htons(ETH_P_IP)) + tcp = (ip_hdr(skb)->protocol == IPPROTO_TCP); + else + /* IPv6 */ + tcp = (ipv6_hdr(skb)->nexthdr == IPPROTO_TCP); + mss = skb_shinfo(skb)->gso_size; if (mss) { /* This means we are dealing with TCP and skb->len is the @@ -1162,8 +1170,26 @@ static int gmac_map_tx_bufs(struct net_device *netdev, struct sk_buff *skb, mss, skb->len); word1 |= TSS_MTU_ENABLE_BIT; word3 |= mss; + } else if (tcp) { + /* Even if we are not using TSO, use the hardware offloader + * for transferring the TCP frame: this hardware has partial + * TCP awareness (called TOE - TCP Offload Engine) and will + * according to the datasheet put packets belonging to the + * same TCP connection in the same queue for the TOE/TSO + * engine to process. The engine will deal with chopping + * up frames that exceed ETH_DATA_LEN which the + * checksumming engine cannot handle (see below) into + * manageable chunks. It flawlessly deals with quite big + * frames and frames containing custom DSA EtherTypes. + */ + mss = netdev->mtu + skb_tcp_all_headers(skb); + mss = min(mss, skb->len); + netdev_dbg(netdev, "TOE/TSO len %04x mtu %04x mss %04x\n", + skb->len, netdev->mtu, mss); + word1 |= TSS_MTU_ENABLE_BIT; + word3 |= mss; } else if (skb->len >= ETH_FRAME_LEN) { - /* Hardware offloaded checksumming isn't working on frames + /* Hardware offloaded checksumming isn't working on non-TCP frames * bigger than 1514 bytes. A hypothesis about this is that the * checksum buffer is only 1518 bytes, so when the frames get * bigger they get truncated, or the last few bytes get @@ -1180,21 +1206,16 @@ static int gmac_map_tx_bufs(struct net_device *netdev, struct sk_buff *skb, }
if (skb->ip_summed == CHECKSUM_PARTIAL) { - int tcp = 0; - /* We do not switch off the checksumming on non TCP/UDP * frames: as is shown from tests, the checksumming engine * is smart enough to see that a frame is not actually TCP * or UDP and then just pass it through without any changes * to the frame. */ - if (skb->protocol == htons(ETH_P_IP)) { + if (skb->protocol == htons(ETH_P_IP)) word1 |= TSS_IP_CHKSUM_BIT; - tcp = ip_hdr(skb)->protocol == IPPROTO_TCP; - } else { /* IPv6 */ + else word1 |= TSS_IPV6_ENABLE_BIT; - tcp = ipv6_hdr(skb)->nexthdr == IPPROTO_TCP; - }
word1 |= tcp ? TSS_TCP_CHKSUM_BIT : TSS_UDP_CHKSUM_BIT; }