NAS-139477 / 27.0.0-BETA.1 / Add FEC mode configuration to network interfaces

[creatorcary]

Summary

Exposes Forward Error Correction (FEC) mode as a configurable property on physical network interfaces. Operators can query which FEC modes a NIC supports, set a preferred mode, and observe the active mode the hardware is using — all via the existing interface.* API.

Feature requested by support for the purpose of fixing interface connectivity when FEC negotiation with the switch fails. This provides the customer with a cleaner way to correct the issue than setting up a custom boot-time script.

API usage

Check what modes the NIC supports

midclt call interface.available_fec_modes eno8np2
["AUTO", "RS"]

Configure RS-FEC

midclt call interface.update eno8np2 '{"fec_mode": "RS"}'
midclt call interface.commit '{"rollback": true, "checkin_timeout": 60}'
midclt call interface.checkin

Query configured vs active mode

midclt call interface.query '[["id","=","eno8np2"]]' | jq '.[0] | {configured: .fec_mode, active: .state.fec_mode}'
{
  "configured": "RS",
  "active": "RS"
}

Depends on

truenas/truenas_pynetif#58 — provides get_fec, set_fec, get_fec_modes, and FecModeName

[bugclerk]

Jira URL: https://ixsystems.atlassian.net/browse/NAS-139477