Back to Talos

EthernetConfig

website/content/v1.13/reference/configuration/network/ethernetconfig.md

1.13.02.7 KB
Original Source
<!-- markdownlint-disable -->

{{< highlight yaml >}} apiVersion: v1alpha1 kind: EthernetConfig name: enp0s2 # Name of the link (interface).

Configuration for Ethernet features.

features: tx-tcp-segmentation: false

Configuration for Ethernet link rings.

rings: rx: 256 # Number of RX rings.

Configuration for Ethernet link channels.

channels: rx: 4 # Number of RX channels.

# Wake-on-LAN modes to enable.

wakeOnLan:

- unicast

- magic

{{< /highlight >}}

FieldTypeDescriptionValue(s)
namestringName of the link (interface).
featuresmap[string]boolConfiguration for Ethernet features.

Set of features available and whether they can be enabled or disabled is driver specific. Use talosctl get ethernetstatus <link> -o yaml to get the list of available features and their current status. | | |rings |<a href="#EthernetConfig.rings">EthernetRingsConfig</a> |Configuration for Ethernet link rings.

This is similar to ethtool -G command. | | |channels |<a href="#EthernetConfig.channels">EthernetChannelsConfig</a> |Configuration for Ethernet link channels.

This is similar to ethtool -L command. | | |wakeOnLan |[]WOLMode |Wake-on-LAN modes to enable.

If this field is omitted, Wake-on-LAN configuration is not changed. An empty list disables Wake-on-LAN.

This is similar to ethtool -s <link> wol <options> command. <details><summary>Show example(s)</summary>{{< highlight yaml >}} wakeOnLan: - unicast - magic {{< /highlight >}}</details> |phy unicast multicast broadcast arp magic magicsecure filter |

rings {#EthernetConfig.rings}

EthernetRingsConfig is a configuration for Ethernet link rings.

FieldTypeDescriptionValue(s)
rxuint32Number of RX rings.
txuint32Number of TX rings.
rx-miniuint32Number of RX mini rings.
rx-jumbouint32Number of RX jumbo rings.
rx-buf-lenuint32RX buffer length.
cqe-sizeuint32CQE size.
tx-pushboolTX push enabled.
rx-pushboolRX push enabled.
tx-push-buf-lenuint32TX push buffer length.
tcp-data-splitboolTCP data split enabled.

channels {#EthernetConfig.channels}

EthernetChannelsConfig is a configuration for Ethernet link channels.

FieldTypeDescriptionValue(s)
rxuint32Number of RX channels.
txuint32Number of TX channels.
otheruint32Number of other channels.
combineduint32Number of combined channels.