From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id D2E78C43381 for ; Fri, 29 Mar 2019 19:17:30 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 99EF3218A3 for ; Fri, 29 Mar 2019 19:17:30 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="oEaJvKFw" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729870AbfC2TR2 (ORCPT ); Fri, 29 Mar 2019 15:17:28 -0400 Received: from mail-wm1-f68.google.com ([209.85.128.68]:54215 "EHLO mail-wm1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729483AbfC2TR1 (ORCPT ); Fri, 29 Mar 2019 15:17:27 -0400 Received: by mail-wm1-f68.google.com with SMTP id q16so3610398wmj.3 for ; Fri, 29 Mar 2019 12:17:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:from:to:cc:references:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=Pq1wRjfC0xGpnJuKFPp+Y8uCmlZ/meA1UMGESMXzkEI=; b=oEaJvKFw4xscrcPB5wjEtpAFuVukSO0s0I6pb5VuOOVVX4MYz2TAWcfGisCPsc07er 4DhFE2GERlhKH1iN/cW8PB93+9liSFEfMbKkZAh3wjGLo7yeVpcxy3CGd56Ypttj15+5 VyW2n72+FXrG35QODGwROFrCBZ03gL4ffQvD8SDHTzCNxsib2EUuqmlBekMzqQ6td2TJ uwkMq8wvrSRCzChRjSpg7xEmQpPcynznW5o6ngbJKsNQZ9tW8lsmt2NMarhVF2XgMqCg AiL+EmsWd/rX+FM+tGyV/O5bDalOh6bdMOmpT7bpYzaR/KdEMp5zrkqb2Nw7Bp1i4yV3 oCzQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:from:to:cc:references:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=Pq1wRjfC0xGpnJuKFPp+Y8uCmlZ/meA1UMGESMXzkEI=; b=qIHJrE6SY2m8pXEI5Hot6gxqZE9At2H3YuTwe28vawEjBbtoEwv6VLLGQXtvzKC+wM DjDKlKHwgxdx4hB7qANGUQpTG+AA0MLN83fsx0gjdgqEh9j6ty1rdDcQsjQmAEM8/qY6 V8yc8iih2K2iHy+cBK6tx/aAnWMMW9CmtElcs/F5UtRdfT3Kki1hxEdJ71LYyeLd9SXK V48EkeW+0ZDD4Emmf+DAyS8Sk/59XTzT8+IQOg/MGm4UCRiLS0Am+bpiuc7ZVXms6GKb sxcD4a600oBMqYF8eIl48kczHRNOm1uLVjdsGNvOP7jmw1cU0yglstVAivE3I23T0ez5 vMMQ== X-Gm-Message-State: APjAAAVIY1LB/aJqvW6eFcenauR5hytEn5YYuGrWJ+id1LI28lpNXNIz u9s/Blw4B1bKIwzxs4BSBa7MEF23 X-Google-Smtp-Source: APXvYqzwXF/lSv1rSHyzOx3gaQZc/A9aMzVGhGRV5GzYrsU2R9biq0eu9rJ1P6nuNrRB1g/F+TT/3w== X-Received: by 2002:a7b:c743:: with SMTP id w3mr4778482wmk.75.1553887045411; Fri, 29 Mar 2019 12:17:25 -0700 (PDT) Received: from ?IPv6:2003:ea:8be1:dd00:a991:cc44:5157:9e5? (p200300EA8BE1DD00A991CC44515709E5.dip0.t-ipconnect.de. [2003:ea:8be1:dd00:a991:cc44:5157:9e5]) by smtp.googlemail.com with ESMTPSA id 7sm9828785wrc.81.2019.03.29.12.17.24 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 29 Mar 2019 12:17:24 -0700 (PDT) Subject: [PATCH v2 4/4] ethtool: add PHY Fast Link Down tunable to man page From: Heiner Kallweit To: John Linville , Andrew Lunn , Florian Fainelli Cc: "netdev@vger.kernel.org" References: <86b1ab67-fd7e-2789-1218-8c14e8198a60@gmail.com> Message-ID: <4c88a109-d71d-78e4-4d0b-1a6e1b71feba@gmail.com> Date: Fri, 29 Mar 2019 20:17:06 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1 MIME-Version: 1.0 In-Reply-To: <86b1ab67-fd7e-2789-1218-8c14e8198a60@gmail.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Add description of new PHY tunable Fast Link Down to ethtool man page. v2: - improve wording Signed-off-by: Heiner Kallweit --- 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