HomeFreeBSD

Move ifconfig SFP status functionality into libifconfig

Description

Move ifconfig SFP status functionality into libifconfig

libifconfig_sfp.h provides an API in libifconfig for querying SFP module
properties, operational status, and vendor strings, as well as descriptions
of the various fields, string conversions, and other useful helpers for
implementing user interfaces.

SFP module status is obtained by reading registers via an I2C interface.
Descriptions of these registers and the values therein have been collected
in a Lua table which is used to generate all the boilerplace C headers and
source files for accessing these values, their names, and descriptions.
The generated code is fully commented and readable.

This is the first use of libifconfig in ifconfig itself. For now, the
scope remains very limited. Over time, more of ifconfig will be replaced
with libifconfig.

Some minor changes to the formatting of ifconfig output have been made:

  • Module memory hex dumps are indented one extra space as a result of using

hexdump(3) instead of a bespoke hex dump function.

  • Media descriptions have an added two-character short-name in parenthesis.
  • QSFP modules were incorrectly displaying TX bias current as power. Now TX channels display bias current, and this change has been made for both SFP and QSFP modules for consistency.

A Lua binding for libifconfig including this functionality is implemented
but has not been included in this commit. The plan is for it to be
committed after dynamic module loading has been enabled in flua.

Reviewed by: kp, melifaro
Relnotes: yes
Differential Revision: https://reviews.freebsd.org/D25494

Details

Provenance
freqlabsAuthored on
Reviewer
kp
Differential Revision
D25494: libifconfig: Add functionality for querying SFP modules
Parents
rS364057: Correct date for Nagasaki bombing.
Branches
Unknown
Tags
Unknown