[ethtool,v1,5/6] ethtool.8.in: Document the cable test commands

Message ID 20200624010155.464334-6-andrew@lunn.ch
State New
Headers show
  • ethtool(1) cable test support
Related show

Commit Message

Andrew Lunn June 24, 2020, 1:01 a.m.
Extend the man page with --cable-test and --cable-test-tdr commands.

Signed-off-by: Andrew Lunn <andrew@lunn.ch>
 ethtool.8.in | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)


diff --git a/ethtool.8.in b/ethtool.8.in
index 9c5f45c..9e2017d 100644
--- a/ethtool.8.in
+++ b/ethtool.8.in
@@ -434,6 +434,16 @@  ethtool \- query or control network driver and hardware settings
 .I sub_command
 .RB ...
+.B ethtool \-\-cable\-test
+.I devname
+.B ethtool \-\-cable\-test\-tdr
+.I devname
+.BN first N
+.BN last N
+.BN step N
+.BN pair N
 .\" Adjust lines (i.e. full justification) and hyphenate.
@@ -1277,6 +1287,41 @@  Sub command to apply. The supported sub commands include --show-coalesce and
+q.B \-\-cable\-test
+Perform a cable test and report the results. What results are returned depends
+on the capabilities of the network interface. Typically open pairs and shorted
+pair can be reported, along with pairs being O.K. When a fault is detected
+the approximate distance to the fault me be reported.
+.B \-\-cable\-test\-tdr
+Perform a cable test and report the raw Time Domain Reflectometer
+data.  A pulse is sent down a cable pair and the amplitude of the
+reflect, for a given distance is reported. A break in the cable
+returns a big reflection. Minor damage to the cable returns a small
+deflection. If the cable is shorted, the amplitude of the reflection
+can be negative. By default, data is returned for lengths between 0
+and 150m at 1m steps, for all pairs. However parameters can be passed
+to restrict the collection of data. It should be noted, that the
+interface will round the distances to whatever granularity is actually
+implements. This is often 0.8 of a meter. The results should include
+the actual rounded first and last distance and step size.
+.RS 4
+.B first \ N
+Distance along the cable, in meters, where the first measurement
+should be made.
+.B last \ N
+Distance along the cable, in meters, where the last measurement should
+be made.
+.B step \ N
+Distance, in meters, between each measurement.
+.B pair \ N
+Which pair should be measured. Typically a cable has 4 pairs. 0 = Pair A, 1 = Pair B, ...
 .B \-\-monitor
 Listens to netlink notification and displays them.
 .RS 4