Skip to content

ktext: update AppleIGB to Tahoe-compatible fork (v5.11.5)#495

Open
ayushere wants to merge 1 commit into
dortania:masterfrom
ayushere:fix/appleigb-tahoe-fork
Open

ktext: update AppleIGB to Tahoe-compatible fork (v5.11.5)#495
ayushere wants to merge 1 commit into
dortania:masterfrom
ayushere:fix/appleigb-tahoe-fork

Conversation

@ayushere
Copy link
Copy Markdown

What

Updates the AppleIGB link from the deprecated donatengit/AppleIGB (last commit Nov 2022) to ayushere/AppleIGB v5.11.5, which fixes two kernel panic bugs that affect macOS Tahoe 26.x.

Also updates the description to remove the outdated "might have instability issues / stay on Big Sur" note and adds a Tahoe-specific callout.

Why

donatengit/AppleIGB is self-described as deprecated. The upstream Shaneee/AppleIGB (v5.11.4) causes repeated kernel panics on macOS Tahoe 26.x due to two bugs in the Apple-specific driver code:

Bug 1 — TX path mbuf out-of-bounds (panics on Tahoe 26.4 and 26.5)

tcp6_hdr() and igb_tx_csum() walked IPv6 extension headers using ip6++ — a stride of sizeof(struct ip6_hdr) = 40 bytes. Real extension headers have variable lengths; correct stride is (cursor[1] + 1) * 8. No bounds check existed.

macOS Tahoe introduced Probabilistic GZAlloc (PGZ) which places guard pages after mbuf zone elements. The wrong-stride read hits the guard page → type=14 page fault panic:

Zone: mbuf, Kind: out-of-bounds (high confidence), Access: 29 byte(s) past
Kernel Extensions in backtrace: com.amdosx.driver.AppleIGB(5.11.4)

Bug 2 — RX path silent mbuf corruption (panic: mbuf len -3)

igb_add_rx_frag() called mbuf_copyback(MBUF_WAITOK) in interrupt context and silently passed a partially-written, corrupted mbuf to the network stack on failure. Tahoe's stricter mbuf validity check panics on it.

Fix

Both bugs are fixed in ayushere/AppleIGB v5.11.5, built against the macOS 26.5 SDK. Pre-built kext available in releases — drop-in replacement, no config.plist changes needed.

Changes

-* [AppleIGB](https://github.com/donatengit/AppleIGB/releases)
-  * Required for I211 NICs running on macOS Monterey and above
-  * Might have instability issues on some NICs, recommended to stay on Big Sur and use SmallTree
+* [AppleIGB](https://github.com/ayushere/AppleIGB/releases)
+  * Required for I210/I211 NICs running on macOS Monterey and above
+  * Use the ayushere fork (v5.11.5+) for macOS Tahoe 26.x — fixes kernel panics caused by mbuf out-of-bounds bugs caught by Probabilistic GZAlloc introduced in Tahoe

The donatengit/AppleIGB repo is deprecated (last commit Nov 2022) and
v5.11.4 causes kernel panics on macOS Tahoe 26.x due to two bugs in
the Apple-specific code:

1. tcp6_hdr() and igb_tx_csum() used ip6++ (stride=40) to walk IPv6
   extension headers — wrong stride, no bounds check. Tahoe's
   Probabilistic GZAlloc places guard pages after mbuf zone elements,
   turning the silent OOB read into a hard page fault panic.

2. igb_add_rx_frag() called mbuf_copyback(MBUF_WAITOK) in interrupt
   context and silently passed corrupted mbufs to the stack on failure.
   Tahoe's stricter mbuf validity check catches this as 'len -3' panic.

ayushere/AppleIGB v5.11.5 fixes both bugs, built against macOS 26.5 SDK.
Copilot AI review requested due to automatic review settings May 15, 2026 19:35
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the main kext documentation to recommend the Tahoe-compatible AppleIGB fork and clarify I210/I211 support for Monterey and newer macOS versions.

Changes:

  • Repoints the AppleIGB releases link from donatengit to ayushere.
  • Updates supported NIC wording from I211 to I210/I211.
  • Adds a Tahoe 26.x note about using v5.11.5+ to avoid kernel panics.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread ktext.md
* [AppleIGB](https://github.com/donatengit/AppleIGB/releases)
* Required for I211 NICs running on macOS Monterey and above
* Might have instability issues on some NICs, recommended to stay on Big Sur and use SmallTree
* [AppleIGB](https://github.com/ayushere/AppleIGB/releases)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants