EF_SCALABLE_FILTERS

Onload User Guide (UG1586)

Document ID
UG1586
Release Date
2023-07-31
Revision
1.2 English
Name
scalable_filter_string
Default
0
Minimum
none
Maximum
none
Scope
per-stack

Specifies the interface on which to enable support for scalable filters, and configures the scalable filter mode(s) to use. Scalable filters allow Onload to use a single hardware MAC-address filter to avoid hardware limitations and overheads. This removes restrictions on the number of simultaneous connections and increases performance of active connect calls, but kernel support on the selected interface is limited to ARP/DHCP/ICMP protocols and some Onload features that rely on unaccelerated traffic (such as receiving fragmented UDP datagrams) will not work. Please see the Onload user guide for full details.

Depending on the mode selected this option will enable support for:

  • scalable listening sockets
  • IP_TRANSPARENT socket option
  • scalable active open.

Format of EF_SCALABLE_FILTERS variable is as follows:

EF_SCALABLE_FILTERS=[<interface-name>[=mode[:mode]],]<interface-name>[=mode[:mode]]

The following modes and their combinations can be specified:

  • transparent_active
  • rss:transparent_active
  • passive
  • rss:passive
  • transparent_active:passive
  • active
  • rss:active
  • rss:passive:active

It is possible to specify both an active mode interface and a passive mode interface. If two interfaces are specified then both the active and passive interfaces must have the same rss qualifier. Furthermore, if the interface is the string “any”, scalable filters are installed on all interfaces.