tail head cat sleep
QR code linking to this page

Manual Pages  — AXP

NAME

axp – Advanced Micro Devices 10G Ethernet driver

CONTENTS

SYNOPSIS

To compile this driver into the kernel, place the following lines in your kernel configuration file: device iflib device axp

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

if_axp_load="YES"

DESCRIPTION

The axp driver enables PCI-E based 10G Ethernet controller inbuilt in the AMD EPYC processors.

The following features are supported.

All the above mentioned features are enabled by default.

For hardware related questions, please refer the documentation supplied along with AMD EPYC processors.

SYSCTL VARIABLES

The following variables are available as sysctl(8) variables:
dev.ax.X.mac_stats
  Dumps the transmit and receive statistics counter values for the controller. This includes statistics specific to each transmit and receive queue.
dev.ax.X.channels_info
  Dumps the permissible and default configured transmit and receive channel information.
dev.ax.X.ringparam_info
  Dumps the permissible and default configured descriptor information for the transmit and receive queue.
dev.ax.X.link_ksettings_info
  Dumps the current link setting like link mode, speed, duplex settings.
dev.ax.X.pauseparam_info
  Dumps the current flow-control settings.
dev.ax.X.coalesce_info
  Dumps the current interrupt coalescing settings.
dev.ax.X.link_info
  Dumps the current state of the Link.
dev.ax.X.drv_info
  Dumps the driver and controller firmware version information.
dev.ax.X.YYYY_register
dev.ax.X.YYYY_register_values
  Sysctl to dump a specific register from a specific block of the controller. YYYY specifies the block. The following blocks are supported.
  • xpcs
  • xgmac
  • xprop
  • xi2c

Set the offset of the register to the first variable, and then read the value of the register by reading the second variable.

dev.ax.X.axgbe_debug_level
  Configure the log-level for the driver. Default is 0. Supports 0-3.
dev.ax.X.single_fl
  This variable must be set before loading the driver, either via loader.conf(5) or through the use of kenv(1). This cannot be modified when driver is loaded.

Setting this variable in loader.conf(5) needs the system to be restarted to take effect. When using kenv(1), use the wrapper variable dev.ax.single_flamp;, which will configure all AMD interfaces with single freelist per receive queue. Default is 2 freelist per receive queue.

This variable is to configure the interface when single freelist is needed. (For Eg. netmap). Basically, this will control the software behavior of how the receive descriptors are used.

Setting this variable to 1, will use 1 Freelist per receive queue.

Setting this variable to 0, will use 2 Freelist per receive queue.

Based on the setting, the receive buffers are programmed accordingly on the received descriptors.

By default, this variable will be set to 0, meaning the interfaces will be configured for regular data traffic (not netmap traffic).

dev.ax.X.sph_enabled
  This variable must be set before loading the driver, either via loader.conf(5) or through the use of kenv(1). This cannot be modified when driver is loaded.

Setting this variable in loader.conf(5) needs the system to be restarted to take effect. When using kenv(1), use the wrapper variable dev.ax.sph_enableamp;, which will configure(enable/disable) split header support in all AMD interfaces.

This variable is to control enable/disable of the split header feature in the interface.

Setting this variable to 1, will enable split header feature.

Setting this variable to 0, will disable split header feature.

By default, this variable will be set to 1, meaning the Split header support be enabled.

NOTE: It is recommended to use this variable only when single_flamp; is configured. Otherwise let it be default value.

SEE ALSO

arp(4), iflib(4), netmap(4), vlan(4), ifconfig(8)

HISTORY

The axp device driver first appeared in FreeBSD 13.0 .

Another version of the driver is already present in FreeBSD . This driver was named as "axgbe" earlier, which is renamed as "axa" now. This driver is for the ACPI based Ethernet controllers in the previous/older version of the hardware. This driver is authored by <Mt andrew@FreeBSD.org>.

AUTHORS

The axp device driver was written by Advanced Micro Devices Inc.

For any issues and support requirements, email the details to <Mt rajesh1.kumar@amd.com>.


AXP (4) January 24, 2021

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.