Page MenuHomeFreeBSD

rss, iflib: document that RX queue counts are not power-of-two
Needs ReviewPublic

Authored by nick_spun.io on May 26 2026, 5:04 PM.
Tags
Referenced Files
Unknown Object (File)
Thu, Aug 13, 1:15 AM
Unknown Object (File)
Wed, Aug 12, 11:56 PM
Unknown Object (File)
Mon, Aug 10, 11:38 AM
Unknown Object (File)
Sun, Aug 9, 7:58 PM
Unknown Object (File)
Sat, Aug 8, 5:15 AM
Unknown Object (File)
Fri, Aug 7, 8:18 PM
Unknown Object (File)
Tue, Aug 4, 7:47 AM
Unknown Object (File)
Wed, Jul 29, 7:11 PM

Details

Reviewers
adrian
Summary

Drivers that build an RSS indirection table sometimes assume the RX queue count is a power of two and reduce buckets to queues with an AND mask, which starves queues when the count is not one (iflib does not guarantee a power-of-two queue count). Record the constraint at the two places a driver author is likely to look:

  • rss_get_indirection_to_bucket() in the RSS framework
  • the ifdi_rx_queues_alloc() KPI in iflibdd(9)

Documentation only; no functional change.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 73454
Build 70337: arc lint + arc unit