Controlling Access to RX Queues on X3522

Onload User Guide (UG1586)

Document ID
UG1586
Release Date
2023-07-31
Revision
1.2 English

Onload 8.1 introduces a new mechanism for enabling users to reserve a hardware receive queue for a given singular application. This mechanism is currently only supported on X3522 network adapters.

This is via a new filter flag (EF_FILTER_FLAG_EXCLUSIVE_RXQ) that is applied via ef_filter_spec_init(). With this change, users can ensure the following properties for their application.

  • Other applications will be unable to snoop on traffic filtered to this application.
  • This application can guarantee that it will not receive any packets for which it did not explicitly add a filter.

In addition, this version of Onload introduces a new function, ef_filter_spec_set_dest(). This API enables the user to specify which hardware receive queue an application can listen on.

Due to the additional granularity afforded by the above granular controls, this version has necessitated the deprecation of the following broader ef_vi application flags:
  • EF_VI_EFCT_UNIQUEUE
  • EF_VI_RX_EXCLUSIVE

Further details of specific exclusivity conditions can be found under the EF_FILTER_FLAG_EXCLUSIVE_RXQ documentation in the ef_vi User Guide (SF-114063-CD).