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
F162703188: D57256.diff
Wed, Jul 15, 11:15 PM
Unknown Object (File)
Wed, Jul 1, 7:17 PM
Unknown Object (File)
Wed, Jun 17, 4:41 PM
Unknown Object (File)
Jun 13 2026, 1:33 PM
Unknown Object (File)
Jun 13 2026, 10:21 AM
Unknown Object (File)
Jun 10 2026, 5:20 PM
Unknown Object (File)
Jun 5 2026, 12:17 PM
Unknown Object (File)
Jun 4 2026, 3:51 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