From patchwork Tue Jan 17 08:59:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vladimir Oltean X-Patchwork-Id: 44582 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp1645508wrn; Tue, 17 Jan 2023 01:04:21 -0800 (PST) X-Google-Smtp-Source: AMrXdXuP/eK41Umhdpvum8CuC/aSHTsm3dh3n0zLJqY0aK0vwwOcvftmIRlBCnCmz7u6+zpcviDG X-Received: by 2002:a17:90a:eb03:b0:225:cc25:3947 with SMTP id j3-20020a17090aeb0300b00225cc253947mr1780397pjz.13.1673946261415; Tue, 17 Jan 2023 01:04:21 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1673946261; cv=pass; d=google.com; s=arc-20160816; b=GiAewCBCpExVciJ4abTndifIVRtLOhYzlaDCd1U/tgnlCnRDAfxgxMct6gcRqWKp1b CCubSk+J11ah4B/vjbPYefQBKFq6UsIE3EaPM7IDfrbwGLqa275pUScm5V2j6FSLGRVo 8Z48omMuaEbfC3gLlsIkE3plmQU+zds2MBbvBrh+g799d6KG4REmriNLvJKJ4NSh3Ien XqTOgSXC5RUxlPjmOCew7s1lUxTB/W+alr0fo5yiSUHC5GcTyOwAXuDbTtnU4av4KEZu V+vGhud82B2fiofbQ6KgI1HQ9H3va9qyPuvcPfMhzbg8xDcpLyj6aDkOQL/ZGVYXbett Tk0Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=upH1joA+5/L2/D4IJOUrmNnEzTo9jfQgvYrtCG15Ros=; b=YuoFdl/tnVBDJGNDB/zz4RnNV8pKsG1g+3ThlVe9x+jwBY7t+WTTTfJw5YOx7XeD99 3d0ShKilny4+q9r38Vr13iJg5a5ZcF0a4P2QC84YaFPT9s2fcLAbZcDz70ZccaNOKB3z eEmW7oslHzrsl5ZpDqVPftuvCjXhrqn7YoUKbiNB3XS01TkLkoAR4ZHioLjLsSh/4jgl Meig5GlvoFd9t19pYf73qF6gis0jpIGh9wBbYmbfoIgdZ8Eey9q87TvWW6h15AtO0xdN 9NyxgJQh4dE7zaHE0xGaE6mSEweasHilTZ2spyDLlA6s8QkkrerTN1OPJvGU2dzXxF4A 1pgQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@nxp.com header.s=selector2 header.b=F62EnQ5V; arc=pass (i=1 spf=pass spfdomain=nxp.com dkim=pass dkdomain=nxp.com dmarc=pass fromdomain=nxp.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id mi13-20020a17090b4b4d00b00226e2321ea3si5193859pjb.157.2023.01.17.01.04.09; Tue, 17 Jan 2023 01:04:21 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@nxp.com header.s=selector2 header.b=F62EnQ5V; arc=pass (i=1 spf=pass spfdomain=nxp.com dkim=pass dkdomain=nxp.com dmarc=pass fromdomain=nxp.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235924AbjAQJDu (ORCPT + 99 others); Tue, 17 Jan 2023 04:03:50 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58736 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235975AbjAQJB3 (ORCPT ); Tue, 17 Jan 2023 04:01:29 -0500 Received: from EUR04-VI1-obe.outbound.protection.outlook.com (mail-vi1eur04on2042.outbound.protection.outlook.com [40.107.8.42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 115592313C; Tue, 17 Jan 2023 01:00:10 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NbwC/ayUUdCssRl76NQpoDpBXF8/HyisfRdeu36c7tUayuWJU5fKt2aNfScPTWpuwYm/NBHoftIeNtKUiUi8+gbiH6wp7PdlUas1/C3S9ewIMU7yAIi8INH+37QWdJZxwQZzya7W3CI/D2T7eAWPSaCxMPCmd8g1fRBBSi7JwRICs3h4KBWdFfdBNp5Yws4NsJd1ToCcnPMFWhgwKfchdJekd/L6gHgHxxtDtyaAUBdqv2oYmD3WRscb8fxow6Wws3wKollRVKUiT3ylSYS8+meBxU11UluVlIckIU155d9Ppai6i5YQORxWt7N8/59AmyxtCX5ECduTSldCiNGqDw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=upH1joA+5/L2/D4IJOUrmNnEzTo9jfQgvYrtCG15Ros=; b=K5roGUJU3JzT4HEoi3b23nPMtkffuk8Tk3KjhgRxXc7WcGAEoFbs5nkP6kNMWo+YhHTzMLmHrfLOtma5t1ik1MlSoK3qwHFHmN/NEb+XukRSKMlN20JkTEx8aNuueHQUCnpVVYUGeDygkKDbAzj355ZwPOEH8pDdTjF5ywzZDRnHq0fDrhMRZHXetchzgHXxK9qlvI6EHvEymd8rsiKd+H3/VNbCYrKG9mkuoLwFEt3Uz7ZVQF3qBiqKgGeoYefSTUZUiNTv5icDWrCTQwaV+OnnZp4D55F7LJNoQ8ipxZZefWn23YoDkEybYB1cbFl4BjAn+ysX8CbvUDwBdR+FmA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=upH1joA+5/L2/D4IJOUrmNnEzTo9jfQgvYrtCG15Ros=; b=F62EnQ5VVnrp41Xkx9PFgK1y7nVCXji1VmTEUo3KGFjQd4yyiRzFxBrJfxfZpeR5CweQVO+38xlLJLadrM75E3bEe4oJTb1ocF12V/dX2PDeDlXNQrhEMIm6IvQfj/jPmShLqo0mLdPil903r8U2LPj6CN1bdVvfil8dU83NNvE= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from VI1PR04MB5136.eurprd04.prod.outlook.com (2603:10a6:803:55::19) by GV1PR04MB9182.eurprd04.prod.outlook.com (2603:10a6:150:26::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5986.19; Tue, 17 Jan 2023 09:00:07 +0000 Received: from VI1PR04MB5136.eurprd04.prod.outlook.com ([fe80::3cfb:3ae7:1686:a68b]) by VI1PR04MB5136.eurprd04.prod.outlook.com ([fe80::3cfb:3ae7:1686:a68b%4]) with mapi id 15.20.5986.023; Tue, 17 Jan 2023 09:00:07 +0000 From: Vladimir Oltean To: netdev@vger.kernel.org Cc: linux-kernel@vger.kernel.org, "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Michal Kubecek , Claudiu Manoil , Vinicius Costa Gomes , Xiaoliang Yang , Kurt Kanzenbach , Rui Sousa , Ferenc Fejes , Pranavi Somisetty , Harini Katakam , Colin Foster , UNGLinuxDriver@microchip.com, Alexandre Belloni , Andrew Lunn , Florian Fainelli Subject: [PATCH v3 net-next 05/12] docs: ethtool: document ETHTOOL_A_STATS_SRC and ETHTOOL_A_PAUSE_STATS_SRC Date: Tue, 17 Jan 2023 10:59:40 +0200 Message-Id: <20230117085947.2176464-6-vladimir.oltean@nxp.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230117085947.2176464-1-vladimir.oltean@nxp.com> References: <20230117085947.2176464-1-vladimir.oltean@nxp.com> X-ClientProxiedBy: BE1P281CA0115.DEUP281.PROD.OUTLOOK.COM (2603:10a6:b10:7b::9) To VI1PR04MB5136.eurprd04.prod.outlook.com (2603:10a6:803:55::19) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: VI1PR04MB5136:EE_|GV1PR04MB9182:EE_ X-MS-Office365-Filtering-Correlation-Id: 95b3f9f8-df05-4a4a-598a-08daf8693ab3 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: I5jLonPxaj17ecRTSPW2GX0rEmre2NjgwBq7p0rkpykJL14IXsNkhGxoBXGdU66Ajyt7TmcIaxPBuZZIADDS6ye9+qkSKU1hqTRGJwZYsCiKso9mIwK89A5IQ2VR1UK+HBUKOxYW5VThvfJD+pJIakCbuH2p1rLg+Wkd5AlEzgcAW96GXGHXrdHxtSyhJnKOfeourVEvK+m8D8/yqZ0efEGEsyYamXmfAEJWyI2BGH+o2+iGx7lRRjfbBpQ+myLzsAJJJwVaJ2k3gxuWQwe88ME1o5F5JE+brpzQ5o3BSqFrWJL3tLIFki+ONxBrUJBeoiRMkmkdnFtRsbrWwylDqPLEfpW+8iscFnLvm1ZpV+2mUpjEwZbPpr2H+K3ctf3VtXrw4ZnwS1lcW/8ik8Sro8zt7bFrveQ3nBB8juV9yn3kw06mxrxtYgFG2ubIEJs9w2ziEn2nR+Cmy08I5ApMDQQllNXlP02ji98bIFwQgKyV1aoBzcGv60Xmz6UjsIJomMmpoi5dsADUG8V2OU2AwqRf8VMP0oU5ulVZkJJJKPWq8m/MQ5TlB0jZqQ16XlfNGrR8OXbIRLYuCniRjY1Eid5LM/hjyALvGQhp6WXSMhPrJ8s/29HTZN8j9rxieVlqXp1J/6Ns3SOJN4cO8WPfmgIs7IAvp6bpMjsVQ52wb9l+JvQgoy2H4Id8xgtgTvEL/EGjNUEDg8N135ejiZyMZA== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:VI1PR04MB5136.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(4636009)(136003)(376002)(39860400002)(396003)(366004)(346002)(451199015)(52116002)(26005)(6512007)(186003)(478600001)(6486002)(66556008)(66476007)(316002)(19627235002)(1076003)(6666004)(54906003)(66946007)(2616005)(8676002)(6506007)(6916009)(4326008)(38350700002)(8936002)(38100700002)(5660300002)(7416002)(41300700001)(83380400001)(44832011)(86362001)(36756003)(2906002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: FF/ot5cTjQV5DwBfxP8Tl0hQWZh6jh9A5VEx+aMy98biQ9I1uF4AfylzA+KxM3AfhMhMa1rTrWShQqvTrc6YJYxn5u8zNoqlBhn6qC6EvDExM1N+ts3Oxx0MaloGVUjn2lG60xYTvZ36dlxfvhLEOwtqc2GwZ3YUC6VMmh9C6gsv78uGLmoLQUbZf5FajcJlFLTwPxvIPAJ12EmL2bhH66D4YPGLgVaBeIRfmllK9CxChPS54eYGjsga9zIA1dNh+iSASwtJXXuBOrKu8nptk+so18xQtOuEi6NstfcMuG1a5BFP9wUmV+ngNR3UXQtkR/DSLTFG1gwu/5i9tJzpFW3nJuaxV6AyzG+841vUCHGTDDAicFIECUxx/IvFT1OrhexMaYVy3K6PtC+g3MGKp3c1n+doNzWpHfVOuf+46sqwyXJBayYGnvrVZkculSz3nJHXYCPo9nP8oSnOQzBaFhGjLwj0jPcUA+s1xG92sSNjq3v+ZtlhBRaQF9jrMS0iuAgrkzL4+0dcAKKHNBgm9CPPl3lxjFtMpV7ucCEMk1gjt59J9ZKbdp1tsBP+2dGYUUe5g5aeo5Yw0uM9aax3pW0XDSM8cW+ozp0N169a2EvA27KXFpgpL61T4QgnwKYxsf54qlQO0fJWTmOyycs6R58L7Pmafj/EA47SD2PWgJy7JLw8r7zEprEpElEhszsU3hw68k/9GZvF1yJLSiieoeJX3XB+r/9jMGZ7ALv2pxNXK32ybau3rV3WDxzqKmGfOvO+YGOP6/heKFGhadL5WTBPeBMc0xNtc/VrFwlnkhy9nbM/UjjF/ULHcY/Pp7+SJMLbb+gWKlBOhAB5zKWMYrkrLhhTvj2oXlbG06nHy3DxMMOL5iLE+coCUinB9atVb/10QAwvi0COkw4sk9T//RKCTkXsIXNJ/X8CJJCQ5sulHu1SOYVmSPDMtQz9CLnUefKkMJoyZCE4Rv2X0/mM4Ut49VQNhodgzsqOZIJiwhq+v6aL0EeAQv7fHT9V5m9d7rFbdY1fdtXzTPVvdj3wyGOzd6E9vGJPl2096za99eH9vjdxWlPsCHfGKBLYSJLa/uCHMmoDXf6llMrPjphCfebx+DWhbTsDfqyoB5YOwhm4X+5QRPdyFxM3+2fVMJAe9NbyCi7Czz5olwn7AyyjI3qf5CFB8BKwPi5l/etLh3f7kCuuUzijoa4hF9caExdyyNrXFjzs1tg90ts8SWSfx6F+pd3pXbHSOWXCMuPLe65mUH4wdjZMOBSq7C1Lj/hPLz9DHuomTpxokovNgx5wQuKuqHJnnexPsWw0pRTWoXCugvxAc/cBn7IWAdpj1WAAjkdhZqdPOzZxTSgKWY4a8ZY2OUvBLuhXhZpDBQA+Np2YVsSYRt9n1lY5XWBXCrTQi/azU7IyHga7k3Q8A4oj7ijszOXSLEPugrXFcC8xSW5SyFKHg537IwkTsEABh6w0+9ej+X+ejAsYvp7eqzfTfICyE+jokH30glJNRAvOR45LOM+lixu8gWwpt+4y8iyZsX/UNT7qmgUnydyxn4c1K/mw0uhy+ytJQXklmWVeSTpOE4w/GmyUVq3igVkQOm8y1/2E6L8/63ijxWbYQ0ERkQ== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 95b3f9f8-df05-4a4a-598a-08daf8693ab3 X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB5136.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jan 2023 09:00:06.8777 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 2FS9NKXTenZIX4WxNL+WGI80oBSl9C4KMWiWk3U5ZTY2GWELfTHdbdbslY7MbZStIrVxB6aGkpVpQ6dl7XAhwA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: GV1PR04MB9182 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1755259874782116498?= X-GMAIL-MSGID: =?utf-8?q?1755259874782116498?= Two new netlink attributes were added to PAUSE_GET and STATS_GET and their replies. Document them. Signed-off-by: Vladimir Oltean --- v2->v3: - adapt to renaming of constants - add a single kernel-doc reference to enum ethtool_mac_stats_src (second one gives warning apparently) v1->v2: patch is new Documentation/networking/ethtool-netlink.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Documentation/networking/ethtool-netlink.rst b/Documentation/networking/ethtool-netlink.rst index 31413535dce5..1626e863eec9 100644 --- a/Documentation/networking/ethtool-netlink.rst +++ b/Documentation/networking/ethtool-netlink.rst @@ -1092,8 +1092,18 @@ Request contents: ===================================== ====== ========================== ``ETHTOOL_A_PAUSE_HEADER`` nested request header + ``ETHTOOL_A_PAUSE_STATS_SRC`` u32 source of statistics ===================================== ====== ========================== +``ETHTOOL_A_PAUSE_STATS_SRC`` is optional. It takes values from: + +.. kernel-doc:: include/uapi/linux/ethtool.h + :identifiers: ethtool_mac_stats_src + +If absent from the request, stats will be provided with +an ``ETHTOOL_A_PAUSE_STATS_SRC`` attribute in the response equal to +``ETHTOOL_MAC_STATS_SRC_AGGREGATE``. + Kernel response contents: ===================================== ====== ========================== @@ -1508,6 +1518,7 @@ Request contents: ======================================= ====== ========================== ``ETHTOOL_A_STATS_HEADER`` nested request header + ``ETHTOOL_A_STATS_SRC`` u32 source of statistics ``ETHTOOL_A_STATS_GROUPS`` bitset requested groups of stats ======================================= ====== ========================== @@ -1516,6 +1527,8 @@ Kernel response contents: +-----------------------------------+--------+--------------------------------+ | ``ETHTOOL_A_STATS_HEADER`` | nested | reply header | +-----------------------------------+--------+--------------------------------+ + | ``ETHTOOL_A_STATS_SRC`` | u32 | source of statistics | + +-----------------------------------+--------+--------------------------------+ | ``ETHTOOL_A_STATS_GRP`` | nested | one or more group of stats | +-+---------------------------------+--------+--------------------------------+ | | ``ETHTOOL_A_STATS_GRP_ID`` | u32 | group ID - ``ETHTOOL_STATS_*`` | @@ -1577,6 +1590,11 @@ Low and high bounds are inclusive, for example: etherStatsPkts512to1023Octets 512 1023 ============================= ==== ==== +``ETHTOOL_A_STATS_SRC`` is optional. Similar to ``PAUSE_GET``, it takes values +from ``enum ethtool_mac_stats_src``. If absent from the request, stats will be +provided with an ``ETHTOOL_A_STATS_SRC`` attribute in the response equal to +``ETHTOOL_MAC_STATS_SRC_AGGREGATE``. + PHC_VCLOCKS_GET ===============