DPDK  20.05.0
Data Structures | Enumerations | Functions
rte_pmd_ixgbe.h File Reference
#include <rte_ethdev_driver.h>

Go to the source code of this file.

Data Structures

struct  rte_pmd_ixgbe_mb_event_param
 

Enumerations

enum  rte_pmd_ixgbe_mb_event_rsp { RTE_PMD_IXGBE_MB_EVENT_NOOP_ACK, RTE_PMD_IXGBE_MB_EVENT_NOOP_NACK, RTE_PMD_IXGBE_MB_EVENT_PROCEED, RTE_PMD_IXGBE_MB_EVENT_MAX }
 

Functions

int rte_pmd_ixgbe_ping_vf (uint16_t port, uint16_t vf)
 
int rte_pmd_ixgbe_set_vf_mac_addr (uint16_t port, uint16_t vf, struct rte_ether_addr *mac_addr)
 
int rte_pmd_ixgbe_set_vf_vlan_anti_spoof (uint16_t port, uint16_t vf, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_mac_anti_spoof (uint16_t port, uint16_t vf, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_vlan_insert (uint16_t port, uint16_t vf, uint16_t vlan_id)
 
int rte_pmd_ixgbe_set_tx_loopback (uint16_t port, uint8_t on)
 
int rte_pmd_ixgbe_set_all_queues_drop_en (uint16_t port, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_split_drop_en (uint16_t port, uint16_t vf, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_vlan_stripq (uint16_t port, uint16_t vf, uint8_t on)
 
int rte_pmd_ixgbe_macsec_enable (uint16_t port, uint8_t en, uint8_t rp)
 
int rte_pmd_ixgbe_macsec_disable (uint16_t port)
 
int rte_pmd_ixgbe_macsec_config_txsc (uint16_t port, uint8_t *mac)
 
int rte_pmd_ixgbe_macsec_config_rxsc (uint16_t port, uint8_t *mac, uint16_t pi)
 
int rte_pmd_ixgbe_macsec_select_txsa (uint16_t port, uint8_t idx, uint8_t an, uint32_t pn, uint8_t *key)
 
int rte_pmd_ixgbe_macsec_select_rxsa (uint16_t port, uint8_t idx, uint8_t an, uint32_t pn, uint8_t *key)
 
int rte_pmd_ixgbe_set_vf_rxmode (uint16_t port, uint16_t vf, uint16_t rx_mask, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_rx (uint16_t port, uint16_t vf, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_tx (uint16_t port, uint16_t vf, uint8_t on)
 
int rte_pmd_ixgbe_set_vf_vlan_filter (uint16_t port, uint16_t vlan, uint64_t vf_mask, uint8_t vlan_on)
 
int rte_pmd_ixgbe_set_vf_rate_limit (uint16_t port, uint16_t vf, uint16_t tx_rate, uint64_t q_msk)
 
int rte_pmd_ixgbe_set_tc_bw_alloc (uint16_t port, uint8_t tc_num, uint8_t *bw_weight)
 
int rte_pmd_ixgbe_bypass_init (uint16_t port)
 
int rte_pmd_ixgbe_bypass_state_show (uint16_t port, uint32_t *state)
 
int rte_pmd_ixgbe_bypass_state_set (uint16_t port, uint32_t *new_state)
 
int rte_pmd_ixgbe_bypass_event_show (uint16_t port, uint32_t event, uint32_t *state)
 
int rte_pmd_ixgbe_bypass_event_store (uint16_t port, uint32_t event, uint32_t state)
 
int rte_pmd_ixgbe_bypass_wd_timeout_store (uint16_t port, uint32_t timeout)
 
int rte_pmd_ixgbe_bypass_ver_show (uint16_t port, uint32_t *ver)
 
int rte_pmd_ixgbe_bypass_wd_timeout_show (uint16_t port, uint32_t *wd_timeout)
 
int rte_pmd_ixgbe_bypass_wd_reset (uint16_t port)
 
__rte_experimental int rte_pmd_ixgbe_mdio_lock (uint16_t port)
 
__rte_experimental int rte_pmd_ixgbe_mdio_unlock (uint16_t port)
 
__rte_experimental int rte_pmd_ixgbe_mdio_unlocked_read (uint16_t port, uint32_t reg_addr, uint32_t dev_type, uint16_t *phy_data)
 
__rte_experimental int rte_pmd_ixgbe_mdio_unlocked_write (uint16_t port, uint32_t reg_addr, uint32_t dev_type, uint16_t phy_data)
 
__rte_experimental int rte_pmd_ixgbe_upd_fctrl_sbp (uint16_t port, int enable)
 

Detailed Description

ixgbe PMD specific functions.

Definition in file rte_pmd_ixgbe.h.

Enumeration Type Documentation

Response sent back to ixgbe driver from user app after callback

Enumerator
RTE_PMD_IXGBE_MB_EVENT_NOOP_ACK 

skip mbox request and ACK

RTE_PMD_IXGBE_MB_EVENT_NOOP_NACK 

skip mbox request and NACK

RTE_PMD_IXGBE_MB_EVENT_PROCEED 

proceed with mbox request

RTE_PMD_IXGBE_MB_EVENT_MAX 

max value of this enum

Definition at line 655 of file rte_pmd_ixgbe.h.

Function Documentation

int rte_pmd_ixgbe_ping_vf ( uint16_t  port,
uint16_t  vf 
)

Notify VF when PF link status changes.

Parameters
portThe port identifier of the Ethernet device.
vfVF id.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if vf invalid.
int rte_pmd_ixgbe_set_vf_mac_addr ( uint16_t  port,
uint16_t  vf,
struct rte_ether_addr mac_addr 
)

Set the VF MAC address.

Parameters
portThe port identifier of the Ethernet device.
vfVF id.
mac_addrVF MAC address.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if vf or mac_addr is invalid.
Examples:
examples/vm_power_manager/main.c.
int rte_pmd_ixgbe_set_vf_vlan_anti_spoof ( uint16_t  port,
uint16_t  vf,
uint8_t  on 
)

Enable/Disable VF VLAN anti spoofing.

Parameters
portThe port identifier of the Ethernet device.
vfVF on which to set VLAN anti spoofing.
on1 - Enable VFs VLAN anti spoofing. 0 - Disable VFs VLAN anti spoofing.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_mac_anti_spoof ( uint16_t  port,
uint16_t  vf,
uint8_t  on 
)

Enable/Disable VF MAC anti spoofing.

Parameters
portThe port identifier of the Ethernet device.
vfVF on which to set MAC anti spoofing.
on1 - Enable VFs MAC anti spoofing. 0 - Disable VFs MAC anti spoofing.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_vlan_insert ( uint16_t  port,
uint16_t  vf,
uint16_t  vlan_id 
)

Enable/Disable vf vlan insert

Parameters
portThe port identifier of the Ethernet device.
vfID specifying VF.
vlan_id0 - Disable VF's vlan insert. n - Enable; n is inserted as the vlan id.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_tx_loopback ( uint16_t  port,
uint8_t  on 
)

Enable/Disable tx loopback

Parameters
portThe port identifier of the Ethernet device.
on1 - Enable tx loopback. 0 - Disable tx loopback.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_all_queues_drop_en ( uint16_t  port,
uint8_t  on 
)

set all queues drop enable bit

Parameters
portThe port identifier of the Ethernet device.
on1 - set the queue drop enable bit for all pools. 0 - reset the queue drop enable bit for all pools.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_split_drop_en ( uint16_t  port,
uint16_t  vf,
uint8_t  on 
)

set drop enable bit in the VF split rx control register

Parameters
portThe port identifier of the Ethernet device.
vfID specifying VF.
on1 - set the drop enable bit in the split rx control register. 0 - reset the drop enable bit in the split rx control register.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_vlan_stripq ( uint16_t  port,
uint16_t  vf,
uint8_t  on 
)

Enable/Disable vf vlan strip for all queues in a pool

Parameters
portThe port identifier of the Ethernet device.
vfID specifying VF.
on1 - Enable VF's vlan strip on RX queues. 0 - Disable VF's vlan strip on RX queues.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support this feature.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_macsec_enable ( uint16_t  port,
uint8_t  en,
uint8_t  rp 
)

Enable MACsec offload.

Parameters
portThe port identifier of the Ethernet device.
en1 - Enable encryption (encrypt and add integrity signature). 0 - Disable encryption (only add integrity signature).
rp1 - Enable replay protection. 0 - Disable replay protection.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.
int rte_pmd_ixgbe_macsec_disable ( uint16_t  port)

Disable MACsec offload.

Parameters
portThe port identifier of the Ethernet device.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.
int rte_pmd_ixgbe_macsec_config_txsc ( uint16_t  port,
uint8_t *  mac 
)

Configure Tx SC (Secure Connection).

Parameters
portThe port identifier of the Ethernet device.
macThe MAC address on the local side.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.
int rte_pmd_ixgbe_macsec_config_rxsc ( uint16_t  port,
uint8_t *  mac,
uint16_t  pi 
)

Configure Rx SC (Secure Connection).

Parameters
portThe port identifier of the Ethernet device.
macThe MAC address on the remote side.
piThe PI (port identifier) on the remote side.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.
int rte_pmd_ixgbe_macsec_select_txsa ( uint16_t  port,
uint8_t  idx,
uint8_t  an,
uint32_t  pn,
uint8_t *  key 
)

Enable Tx SA (Secure Association).

Parameters
portThe port identifier of the Ethernet device.
idxThe SA to be enabled (0 or 1).
anThe association number on the local side.
pnThe packet number on the local side.
keyThe key on the local side.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_macsec_select_rxsa ( uint16_t  port,
uint8_t  idx,
uint8_t  an,
uint32_t  pn,
uint8_t *  key 
)

Enable Rx SA (Secure Association).

Parameters
portThe port identifier of the Ethernet device.
idxThe SA to be enabled (0 or 1)
anThe association number on the remote side.
pnThe packet number on the remote side.
keyThe key on the remote side.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_rxmode ( uint16_t  port,
uint16_t  vf,
uint16_t  rx_mask,
uint8_t  on 
)

Set RX L2 Filtering mode of a VF of an Ethernet device.

Parameters
portThe port identifier of the Ethernet device.
vfVF id.
rx_maskThe RX mode mask, which is one or more of accepting Untagged Packets, packets that match the PFUTA table, Broadcast and Multicast Promiscuous. ETH_VMDQ_ACCEPT_UNTAG,ETH_VMDQ_ACCEPT_HASH_UC, ETH_VMDQ_ACCEPT_BROADCAST and ETH_VMDQ_ACCEPT_MULTICAST will be used in rx_mode.
on1 - Enable a VF RX mode. 0 - Disable a VF RX mode.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port_id invalid.
  • (-EINVAL) if bad parameter.
Examples:
examples/ethtool/lib/rte_ethtool.c.
int rte_pmd_ixgbe_set_vf_rx ( uint16_t  port,
uint16_t  vf,
uint8_t  on 
)

Enable or disable a VF traffic receive of an Ethernet device.

Parameters
portThe port identifier of the Ethernet device.
vfVF id.
on1 - Enable a VF traffic receive. 0 - Disable a VF traffic receive.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port_id invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_tx ( uint16_t  port,
uint16_t  vf,
uint8_t  on 
)

Enable or disable a VF traffic transmit of the Ethernet device.

Parameters
portThe port identifier of the Ethernet device.
vfVF id.
on1 - Enable a VF traffic transmit. 0 - Disable a VF traffic transmit.
Returns
  • (0) if successful.
  • (-ENODEV) if port_id invalid.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_vlan_filter ( uint16_t  port,
uint16_t  vlan,
uint64_t  vf_mask,
uint8_t  vlan_on 
)

Enable/Disable hardware VF VLAN filtering by an Ethernet device of received VLAN packets tagged with a given VLAN Tag Identifier.

Parameters
portThe port identifier of the Ethernet device.
vlanThe VLAN Tag Identifier whose filtering must be enabled or disabled.
vf_maskBitmap listing which VFs participate in the VLAN filtering.
vlan_on1 - Enable VFs VLAN filtering. 0 - Disable VFs VLAN filtering.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port_id invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_vf_rate_limit ( uint16_t  port,
uint16_t  vf,
uint16_t  tx_rate,
uint64_t  q_msk 
)

Set the rate limitation for a vf on an Ethernet device.

Parameters
portThe port identifier of the Ethernet device.
vfVF id.
tx_rateThe tx rate allocated from the total link speed for this VF id.
q_mskThe queue mask which need to set the rate.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support this feature.
  • (-ENODEV) if port_id invalid.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_set_tc_bw_alloc ( uint16_t  port,
uint8_t  tc_num,
uint8_t *  bw_weight 
)

Set all the TCs' bandwidth weight.

The bw_weight means the percentage occupied by the TC. It can be taken as the relative min bandwidth setting.

Parameters
portThe port identifier of the Ethernet device.
tc_numNumber of TCs.
bw_weightAn array of relative bandwidth weight for all the TCs. The summary of the bw_weight should be 100.
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-EINVAL) if bad parameter.
  • (-ENOTSUP) not supported by firmware.
int rte_pmd_ixgbe_bypass_init ( uint16_t  port)

Initialize bypass logic. This function needs to be called before executing any other bypass API.

Parameters
portThe port identifier of the Ethernet device.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_state_show ( uint16_t  port,
uint32_t *  state 
)

Return bypass state.

Parameters
portThe port identifier of the Ethernet device.
stateThe return bypass state.
  • (1) Normal mode
  • (2) Bypass mode
  • (3) Isolate mode
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_state_set ( uint16_t  port,
uint32_t *  new_state 
)

Set bypass state

Parameters
portThe port identifier of the Ethernet device.
new_stateThe current bypass state.
  • (1) Normal mode
  • (2) Bypass mode
  • (3) Isolate mode
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_event_show ( uint16_t  port,
uint32_t  event,
uint32_t *  state 
)

Return bypass state when given event occurs.

Parameters
portThe port identifier of the Ethernet device.
eventThe bypass event
  • (1) Main power on (power button is pushed)
  • (2) Auxiliary power on (power supply is being plugged)
  • (3) Main power off (system shutdown and power supply is left plugged in)
  • (4) Auxiliary power off (power supply is being unplugged)
  • (5) Display or set the watchdog timer
stateThe bypass state when given event occurred.
  • (1) Normal mode
  • (2) Bypass mode
  • (3) Isolate mode
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_event_store ( uint16_t  port,
uint32_t  event,
uint32_t  state 
)

Set bypass state when given event occurs.

Parameters
portThe port identifier of the Ethernet device.
eventThe bypass event
  • (1) Main power on (power button is pushed)
  • (2) Auxiliary power on (power supply is being plugged)
  • (3) Main power off (system shutdown and power supply is left plugged in)
  • (4) Auxiliary power off (power supply is being unplugged)
  • (5) Display or set the watchdog timer
stateThe assigned state when given event occurs.
  • (1) Normal mode
  • (2) Bypass mode
  • (3) Isolate mode
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_wd_timeout_store ( uint16_t  port,
uint32_t  timeout 
)

Set bypass watchdog timeout count.

Parameters
portThe port identifier of the Ethernet device.
timeoutThe timeout to be set.
  • (0) 0 seconds (timer is off)
  • (1) 1.5 seconds
  • (2) 2 seconds
  • (3) 3 seconds
  • (4) 4 seconds
  • (5) 8 seconds
  • (6) 16 seconds
  • (7) 32 seconds
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_ver_show ( uint16_t  port,
uint32_t *  ver 
)

Get bypass firmware version.

Parameters
portThe port identifier of the Ethernet device.
verThe firmware version
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_wd_timeout_show ( uint16_t  port,
uint32_t *  wd_timeout 
)

Return bypass watchdog timeout in seconds

Parameters
portThe port identifier of the Ethernet device.
wd_timeoutThe return watchdog timeout. "0" represents timer expired
  • (0) 0 seconds (timer is off)
  • (1) 1.5 seconds
  • (2) 2 seconds
  • (3) 3 seconds
  • (4) 4 seconds
  • (5) 8 seconds
  • (6) 16 seconds
  • (7) 32 seconds
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
int rte_pmd_ixgbe_bypass_wd_reset ( uint16_t  port)

Reset bypass watchdog timer

Parameters
portThe port identifier of the Ethernet device.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-EINVAL) if bad parameter.
__rte_experimental int rte_pmd_ixgbe_mdio_lock ( uint16_t  port)

Acquire swfw semaphore lock for MDIO access

Parameters
portThe port identifier of the Ethernet device.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port invalid.
  • (IXGBE_ERR_SWFW_SYNC) If sw/fw semaphore acquisition failed
__rte_experimental int rte_pmd_ixgbe_mdio_unlock ( uint16_t  port)

Release swfw semaphore lock used for MDIO access

Parameters
portThe port identifier of the Ethernet device.
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port invalid.
__rte_experimental int rte_pmd_ixgbe_mdio_unlocked_read ( uint16_t  port,
uint32_t  reg_addr,
uint32_t  dev_type,
uint16_t *  phy_data 
)

Read PHY register using MDIO without MDIO lock The lock must be taken separately before calling this API

Parameters
portThe port identifier of the Ethernet device.
reg_addr32 bit PHY Register
dev_typeUsed to define device base address
phy_dataPointer for reading PHY register data
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port invalid.
  • (IXGBE_ERR_PHY) If PHY read command failed
__rte_experimental int rte_pmd_ixgbe_mdio_unlocked_write ( uint16_t  port,
uint32_t  reg_addr,
uint32_t  dev_type,
uint16_t  phy_data 
)

Write data to PHY register using without MDIO lock The lock must be taken separately before calling this API

Parameters
portThe port identifier of the Ethernet device.
reg_addr32 bit PHY Register
dev_typeUsed to define device base address
phy_dataData to write to PHY register
Returns
  • (0) if successful.
  • (-ENOTSUP) if hardware doesn't support.
  • (-ENODEV) if port invalid.
  • (IXGBE_ERR_PHY) If PHY read command failed
__rte_experimental int rte_pmd_ixgbe_upd_fctrl_sbp ( uint16_t  port,
int  enable 
)
Parameters
portThe port identifier of the Ethernet device.
enable0 to disable and nonzero to enable 'SBP' bit in FCTRL register to receive all packets
Returns
  • (0) if successful.
  • (-ENODEV) if port invalid.
  • (-ENOTSUP) if hardware doesn't support this feature.