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)
Wed, Jul 1, 7:17 PM
Unknown Object (File)
Wed, Jun 17, 4:41 PM
Unknown Object (File)
Sat, Jun 13, 1:33 PM
Unknown Object (File)
Sat, Jun 13, 10:21 AM
Unknown Object (File)
Wed, Jun 10, 5:20 PM
Unknown Object (File)
Fri, Jun 5, 12:17 PM
Unknown Object (File)
Thu, Jun 4, 3:51 PM
Unknown Object (File)
Thu, Jun 4, 11:11 AM

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