Module Parameters - UG1739

AMD Solarflare X4 Series Ethernet Adapter User Guide (UG1739)

Document ID
UG1739
Release Date
2025-10-24
Revision
1.0 English

The following table lists the available parameters in the AMD Solarflare Linux driver module.

Important: The availability of module parameters and their effectiveness depends on which driver version and AMD Solarflare adapter you have installed.

You can list the parameters available on your server with the following command:

modinfo sfc
Parameter Description Possible Value Default Value
efx_allow_nvconfig_writes Allow access to static config and backup firmware. bool 1
max_vfs

Specify the number of VFs initialized by the driver:

  • When specified as a single integer the VF count is applied to all PFs.
  • When specified as a comma separated list, the VF counts are applied to the PFs in order of their MAC address, starting with the lowest.
array of int 0
vf_count Duplicate of the max_vfs parameter. array of int 0
enable_vswitch Force allocation of a VEB vswitch on supported adapters. bool 0
vfs_vlan_restrict Restrict VLANs usage on VFs. VF driver must use HW VLAN filtering to get VLAN tagged traffic. bool 0
mcdi_logging_default Enable MCDI logging on newly-probed functions. bool 0
mcdi_log_commands Specify which MCDI commands to log when logging is enabled. Comma or space separated list of hex values, for example. 'b,4c'. An empty string logs all commands. string <empty>
rx_refill_threshold RX descriptor ring fast/slow fill threshold (%). uint 90
rx_recycle_ring_size Maximum number of RX buffers to recycle pages for. uint 256 buffers per 10 Gb/s maximum adapter speed
underreport_skb_truesize Give false skb truesizes. Debug option to restore previous driver behavior. bool 0
rx_copybreak Size of headers copied into skb linear data area. uint 192
lro_table_size 1 Size of the LRO hash table. Must be a power of 2. uint 128
lro_chain_max 1 Maximum length of chains in the LRO hash table. uint 20
lro_idle_jiffies 1 Time (in jiffies) after which an idle connection's LRO state is discarded. uint 101
lro_slow_start_packets 1 Number of packets that must pass in-order before starting LRO. uint 20000
lro_loss_packets 1 Number of packets that must pass in-order following loss before restarting LRO. uint 20
tx_copybreak Maximum size of packet that can be copied to a new buffer on transmit, minimum is 16 bytes or 0 to disable. uint 128
piobuf_size

Maximum size of packet that can be copied to a PIO buffer on transmit.

Setting this to zero effectively disables PIO.

Only effective on adapters with PIO.

uint 256 bytes
tx_push_max_fill Only use TX push when the queue is below this fill level:
  • 0⇒never push.
  • 1⇒push when empty.
  • Default is always to push.
uint 0xffffffff
tx_coalesce_doorbell Coalesce notification to NIC of pending TX data. When set this option sets tx_push_max_fill=0. bool 0
multicast_chaining Enabled multicast filter chaining in firmware. bool 1
monitor_hw_available Check hardware availability during periodic monitor. bool 0
tx_non_csum_queue Allocate dedicated TX queues for traffic not requiring checksum offload. bool 0
num_vis The number of extra VIs to allocate for Onload. int -1
rss_use_fixed_key Use a fixed RSS hash key, tested for reliable spreading across channels. bool 1
rss_cpus Number of CPUs to use for Receive-Side Scaling, or 'packages', 'cores', 'hyperthreads', 'numa_local_cores', or 'numa_local_hyperthreads'. string <empty>
rss_numa_local

Restrict RSS to use CPU cores on the NUMA node local to the X4 series adapter.

Set to 1 to restrict, 0 otherwise.

bool 1
irq_adapt_low_thresh Threshold score for reducing IRQ moderation. uint 10000
irq_adapt_high_thresh Threshold score for increasing IRQ moderation. uint 20000
irq_adapt_irqs Number of IRQs per IRQ moderation adaptation. uint 1000
napi_weight NAPI weighting. int 64
auto_config_xps Toggle automatic XPS configuration. bool 1
irq_set_affinity Set SMP affinity of IRQs to support RSS (N⇒disabled, Y⇒enabled (default)). bool 1
debug Bitmapped debugging message enable value. uint (NETIF_MSG_DRV | NETIF_MSG_PROBE | NETIF_MSG_LINK | NETIF_MSG_IFDOWN | NETIF_MSG_IFUP | NETIF_MSG_RX_ERR | NETIF_MSG_TX_ERR | NETIF_MSG_HW)
monitor_interval_ms Bus state test interval in ms. uint 200
phy_power_follows_link Power down phy when interface is administratively down. bool 0
link_down_on_reset Signal the link down and up on resets. bool 0
xdp_alloc_tx_resources [EXPERIMENTAL] Allocate resources for XDP TX. bool 0
lro Large receive offload acceleration. bool 1
irq_adapt_enable Enable adaptive interrupt moderation. bool 1
rx_ring Maximum number of descriptors in a receive ring. uint 1024
tx_ring Maximum number of descriptors in a transmit ring. uint 1024
performance_profile Tune settings for different performance profiles: 'throughput', 'latency' or 'auto'. string auto
rx_irq_mod_usec Receive interrupt moderation (microseconds). uint 60
  1. Check OS documentation for availability.