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)
Sat, Sep 12, 3:12 AM
Unknown Object (File)
Sat, Sep 5, 1:04 AM
Unknown Object (File)
Sat, Sep 5, 12:04 AM
Unknown Object (File)
Mon, Aug 31, 7:42 AM
Unknown Object (File)
Sat, Aug 29, 10:40 AM
Unknown Object (File)
Thu, Aug 27, 9:56 PM
Unknown Object (File)
Tue, Aug 25, 4:03 PM
Unknown Object (File)
Aug 13 2026, 1:15 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