From: Heiner Kallweit <hkallweit1@gmail.com>
To: John Linville <linville@tuxdriver.com>,
Andrew Lunn <andrew@lunn.ch>,
Florian Fainelli <f.fainelli@gmail.com>
Cc: "netdev@vger.kernel.org" <netdev@vger.kernel.org>
Subject: [PATCH v2 4/4] ethtool: add PHY Fast Link Down tunable to man page
Date: Fri, 29 Mar 2019 20:17:06 +0100 [thread overview]
Message-ID: <4c88a109-d71d-78e4-4d0b-1a6e1b71feba@gmail.com> (raw)
In-Reply-To: <86b1ab67-fd7e-2789-1218-8c14e8198a60@gmail.com>
Add description of new PHY tunable Fast Link Down to ethtool man page.
v2:
- improve wording
Signed-off-by: Heiner Kallweit <hkallweit1@gmail.com>
---
ethtool.8.in | 28 ++++++++++++++++++++++++++--
1 file changed, 26 insertions(+), 2 deletions(-)
diff --git a/ethtool.8.in b/ethtool.8.in
index b878521..868af35 100644
--- a/ethtool.8.in
+++ b/ethtool.8.in
@@ -355,10 +355,16 @@ ethtool \- query or control network driver and hardware settings
.A1 on off
.BN count
.RB ]
+.RB [
+.B fast\-link\-down
+.A1 on off
+.BN msecs
+.RB ]
.HP
.B ethtool \-\-get\-phy\-tunable
.I devname
.RB [ downshift ]
+.RB [ fast-link-down ]
.HP
.B ethtool \-\-reset
.I devname
@@ -1069,12 +1075,22 @@ Sets the PHY tunable parameters.
.RS 4
.TP
.A2 downshift on off
-Specifies whether downshift should be enabled
+Specifies whether downshift should be enabled.
.TS
nokeep;
lB l.
.BI count \ N
-Sets the PHY downshift re-tries count.
+ Sets the PHY downshift re-tries count.
+.TE
+.TP
+.A2 fast-link-down on off
+Specifies whether Fast Link Down should be enabled and time until link down (if supported).
+.TS
+nokeep;
+lB l.
+.BI msecs \ N
+ Sets the period after which the link is reported as down. Note that the PHY may choose
+ the closest supported value. Only on reading back the tunable do you get the actual value.
.TE
.PD
.RE
@@ -1090,6 +1106,14 @@ Link speed downshift after N failed 1000BASE-T auto-negotiation attempts.
Downshift is useful where cable does not have the 4 pairs instance.
Gets the PHY downshift count/status.
+.TP
+.B fast\-link\-down
+Depending on the mode it may take 0.5s - 1s until a broken link is reported as down.
+In certain use cases a link-down event needs to be reported as soon as possible.
+Some PHYs support a Fast Link Down Feature and may allow configuration of the delay
+before a broken link is reported as being down.
+
+Gets the PHY Fast Link Down status / period.
.RE
.TP
.B \-\-reset
--
2.21.0
next prev parent reply other threads:[~2019-03-29 19:17 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-03-29 19:13 [PATCH v2 0/4] ethtool: add support for new PHY tunable Fast Link Down Heiner Kallweit
2019-03-29 19:14 ` [PATCH v2 1/4] ethtool: sync ethtool-copy.h with linux-next from 03/28/2019 Heiner Kallweit
2019-03-29 21:24 ` Florian Fainelli
2019-03-29 19:15 ` [PATCH v2 2/4] ethtool: simplify handling of PHY tunable downshift Heiner Kallweit
2019-03-29 21:24 ` Florian Fainelli
2019-03-29 19:15 ` [PATCH v2 3/4] ethtool: add support for PHY tunable Fast Link Down Heiner Kallweit
2019-03-29 21:25 ` Florian Fainelli
2019-03-29 19:17 ` Heiner Kallweit [this message]
2019-03-29 21:26 ` [PATCH v2 4/4] ethtool: add PHY Fast Link Down tunable to man page Florian Fainelli
2019-03-30 8:39 ` Andrew Lunn
2019-04-09 18:43 ` [PATCH v2 0/4] ethtool: add support for new PHY tunable Fast Link Down John W. Linville
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4c88a109-d71d-78e4-4d0b-1a6e1b71feba@gmail.com \
--to=hkallweit1@gmail.com \
--cc=andrew@lunn.ch \
--cc=f.fainelli@gmail.com \
--cc=linville@tuxdriver.com \
--cc=netdev@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).