diff options
author | Andrew Lunn <andrew@lunn.ch> | 2020-07-05 19:54:51 +0200 |
---|---|---|
committer | Michal Kubecek <mkubecek@suse.cz> | 2020-07-05 23:51:16 +0200 |
commit | 4a5301884397e2c7c3ae22ef87fbef5b3df2812f (patch) | |
tree | a57997c275bc91b71f700df7b270cefb71f545ea | |
parent | f306df3b175966613dd76d2653b06d815b06165e (diff) | |
download | ethtool-4a5301884397e2c7c3ae22ef87fbef5b3df2812f.tar.gz |
ethtool.8.in: Document the cable test commands
Extend the man page with --cable-test and --cable-test-tdr commands.
Reviewed-by: Chris Healy <cphealy@gmail.com>
Signed-off-by: Andrew Lunn <andrew@lunn.ch>
Signed-off-by: Michal Kubecek <mkubecek@suse.cz>
-rw-r--r-- | ethtool.8.in | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/ethtool.8.in b/ethtool.8.in index 9c5f45c..60ca37c 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 ... . +.HP +.B ethtool \-\-cable\-test +.I devname +.HP +.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. .ad @@ -1277,6 +1287,41 @@ Sub command to apply. The supported sub commands include --show-coalesce and --coalesce. .RE .TP +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. +.TP +.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 +.TP +.B first \ N +Distance along the cable, in meters, where the first measurement +should be made. +.TP +.B last \ N +Distance along the cable, in meters, where the last measurement should +be made. +.TP +.B step \ N +Distance, in meters, between each measurement. +.TP +.B pair \ N +Which pair should be measured. Typically a cable has 4 pairs. 0 = Pair A, 1 = Pair B, ... +.RE +.TP .B \-\-monitor Listens to netlink notification and displays them. .RS 4 |