lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  PHC 
Open Source and information security mailing list archives
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date:   Wed,  1 Jul 2020 03:07:42 +0200
From:   Andrew Lunn <>
To:     Michal Kubecek <>
Cc:     netdev <>, Chris Healy <>,
        Andrew Lunn <>
Subject: [PATCH ethtool v4 5/6] Document the cable test commands

Extend the man page with --cable-test and --cable-test-tdr commands.

Reviewed-by: Chris Healy <>
Signed-off-by: Andrew Lunn <>

v2: Fixup some grammar/English errors.
v3: More grammar/English errors fixed.
--- | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/ b/
index 9c5f45c..60ca37c 100644
--- a/
+++ b/
@@ -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
+pairs can be reported, along with pairs being O.K. When a fault is detected
+the approximate distance to the fault may 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
+reflection, for a given distance, is reported. A break in the cable
+returns a big reflection. Minor damage to the cable returns a small
+reflection. 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
+implemented. 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

Powered by blists - more mailing lists