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;
From:   Vladimir Oltean <vladimir.oltean@nxp.com>
To:     netdev@vger.kernel.org
Cc:     linux-kernel@vger.kernel.org,
        "David S. Miller" <davem@davemloft.net>,
        Eric Dumazet <edumazet@google.com>,
        Jakub Kicinski <kuba@kernel.org>,
        Paolo Abeni <pabeni@redhat.com>,
        Michal Kubecek <mkubecek@suse.cz>,
        Claudiu Manoil <claudiu.manoil@nxp.com>,
        Vinicius Costa Gomes <vinicius.gomes@intel.com>,
        Xiaoliang Yang <xiaoliang.yang_1@nxp.com>,
        Kurt Kanzenbach <kurt@linutronix.de>,
        Rui Sousa <rui.sousa@nxp.com>,
        Ferenc Fejes <ferenc.fejes@ericsson.com>,
        Pranavi Somisetty <pranavi.somisetty@amd.com>,
        Harini Katakam <harini.katakam@amd.com>,
        Colin Foster <colin.foster@in-advantage.com>,
        UNGLinuxDriver@microchip.com,
        Alexandre Belloni <alexandre.belloni@bootlin.com>,
        Andrew Lunn <andrew@lunn.ch>,
        Florian Fainelli <f.fainelli@gmail.com>
Subject: [PATCH v2 net-next 05/12] docs: ethtool: document ETHTOOL_A_STATS_SRC and ETHTOOL_A_PAUSE_STATS_SRC
Date:   Wed, 11 Jan 2023 18:16:59 +0200
Message-Id: <20230111161706.1465242-6-vladimir.oltean@nxp.com>
In-Reply-To: <20230111161706.1465242-1-vladimir.oltean@nxp.com>
References: <20230111161706.1465242-1-vladimir.oltean@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?RuDgozuwyDZns+uCSkQdJnZcFx+xrKN/LAp7nJa664cGl8bAgdk2n1OH/Oov?=
 =?us-ascii?Q?Bwav9gfpovqYu6gqATlF8s9PWwcCGrtHghdWEMGX5FflLgotkYNXqILs0HW5?=
 =?us-ascii?Q?AV2qkIQ8wLt8nt57bK0M5iWozgEdcUzhsS5UOGdVYLKQh1JA3SGx8MnRiaRF?=
 =?us-ascii?Q?brcISxXbeeALxvq0aU//Fa/2UKe6Pk/tBtKhO/zoZQPZZMNB90AvVdhLxO+p?=
 =?us-ascii?Q?CngXeT9RSO1pFeS/O/3xxmsSnNa1tmhWlko8DKHUF4matnR/yJ9WbcL6d21G?=
 =?us-ascii?Q?sh2fZkithJlcZHurhOeeqk/2AMmu+xTkPebx9/U4vE7GE/IPRkQO6+rvtjrM?=
 =?us-ascii?Q?RqqvE5fthcscFaZJhw+HRG3nsjefJ7MTbOdkAum/OmNuzt2o4W5f1P7ZeNRv?=
 =?us-ascii?Q?4yht9bluQ83PTjXiX8soJgnGY6PNhaK5thlvWENd7bioikeSqza/BozdXj09?=
 =?us-ascii?Q?9wvYfxSzIIH5z0JffzXjyJEGBQ5Irux1Gslidy3HW8/WtZMRpps9aUVFNBCW?=
 =?us-ascii?Q?j70Nx4nfuEb66Bsk87empuUBqmRJvm6NFnB380WivVbbqUbE4v351GMHa4U0?=
 =?us-ascii?Q?F0ZKoK9HoTSC+CIFz3uG6c/kp+7wr9s4Oj+m67fFMumLeppxHOMx6pLUs3FP?=
 =?us-ascii?Q?OiTZkbEQVjw10Z5PkfXwgAPEFvFAlpyjmAq0lr2WDLkqTVYjXMdeYv7Ib2U8?=
 =?us-ascii?Q?5C1sGENA7FaHQPKiz/slnOZzUM+A8YkllukESW2eco8uSi3j7iZsgbBzII+i?=
 =?us-ascii?Q?fCR+6puNonqx0s95E0J0zRZUkqNjjPyN5KacndPL2Hl1dHzPCGjXTMI43nAo?=
 =?us-ascii?Q?O1QiZoPeRZSBumT9Mnz3T/IbeahRZ5VplKRFWDHfo1BZJea0VqNMF8HM8Spd?=
 =?us-ascii?Q?OuiUH60gxK8FMl2oc5/Qb6JEbj4hBcXXELA7FWpOUwDND6FPo/EAUOAeQNUz?=
 =?us-ascii?Q?vbeBJ9Ba3sU0JdShynHqKULyE1vtVqbpYN3JU+18bjxApn807VMmlx4tBiwH?=
 =?us-ascii?Q?WdGY6GavEJNsZLTfTyDxsYF0j+T2BGayjpTvyjLEpv5BiC/AmelNuhfrmLsC?=
 =?us-ascii?Q?w5i1Ynnb4pgfd61wJPYoM7dPXZv1FWBWuEzY29TCuN1Aeol765QZyHtoDcvJ?=
 =?us-ascii?Q?l7N89aTGdKGXPeUeb3z6Qcr7DmkStL/AjKD4d15lbmEQWwQ94JIQ8HKJChvT?=
 =?us-ascii?Q?q2c9B5H0xBGdC3RKPKflpilorwNTiRl2n0828wNoNqhZ9OVDV4dzhbDZ9Nz7?=
 =?us-ascii?Q?CK8qOq5ajnhvGQhoikSayj9nAG6WOhdfdWblRSTw4l/OcN/YoBR44Ounwet4?=
 =?us-ascii?Q?giXGK5+7nwIomH1HUxfkhxNYKhNQVqa8/T0XWlW4f3JLy0YCPp1sZ6wrPmky?=
 =?us-ascii?Q?m/c7IXFthgm3+ZsVB+TT5nHKX8rbQ5GPfPibXjgUAGyMWQY9IhJ2LLMMAPwg?=
 =?us-ascii?Q?/r4+KGLkuZf1cn94127gN7EbLyPDnH1Ol1clJ+secG/TBJHIY/1X69vNa8+M?=
 =?us-ascii?Q?T6QfXqoyokkapgMaDM4iJI8BSDFF/jOsIAOsKENtn6Pngpvd+5RHrG+yfBXv?=
 =?us-ascii?Q?43AKKFg/kOq1P0TAXkZLqR5bELJ4e5reO8ZU7OKeg7HAINO++CUaPWTw3BKj?=
 =?us-ascii?Q?uw=3D=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 18130050-9d84-472b-110e-08daf3ef52c9
X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB5136.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Jan 2023 16:17:23.9551
 (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: 1i7ACDhV3aNYq5sxGEO7u6XnnNKnlYFig7f2MxZYrXyZWlUSC6VcyjatLn/MtGYzbsEzYUcxCf6vHeR/EoFnBA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR04MB8462
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: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Two new netlink attributes were added to PAUSE_GET and STATS_GET and
their replies. Document them.

Signed-off-by: Vladimir Oltean <vladimir.oltean@nxp.com>
---
v1->v2: patch is new

 Documentation/networking/ethtool-netlink.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/Documentation/networking/ethtool-netlink.rst b/Documentation/networking/ethtool-netlink.rst
index 490c2280ce4f..3805e57f9888 100644
--- a/Documentation/networking/ethtool-netlink.rst
+++ b/Documentation/networking/ethtool-netlink.rst
@@ -1075,8 +1075,17 @@ Request contents:
 
   =====================================  ======  ==========================
   ``ETHTOOL_A_PAUSE_HEADER``             nested  request header
+  ``ETHTOOL_A_PAUSE_STATS_SRC``          u32     source of statistics
   =====================================  ======  ==========================
 
+``ETHTOOL_A_STATS_SRC`` is optional. It takes values from:
+
+.. kernel-doc:: include/uapi/linux/ethtool.h
+    :identifiers: ethtool_stats_src
+
+If absent from the request, stats will be provided with
+``ETHTOOL_A_STATS_SRC_AGGREGATE`` in the response.
+
 Kernel response contents:
 
   =====================================  ======  ==========================
@@ -1491,6 +1500,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
   =======================================  ======  ==========================
 
@@ -1499,6 +1509,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_*`` |
@@ -1560,6 +1572,14 @@ Low and high bounds are inclusive, for example:
  etherStatsPkts512to1023Octets 512  1023
  ============================= ==== ====
 
+``ETHTOOL_A_STATS_SRC`` is optional. It takes values from:
+
+.. kernel-doc:: include/uapi/linux/ethtool.h
+    :identifiers: ethtool_stats_src
+
+If absent from the request, stats will be provided with
+``ETHTOOL_A_STATS_SRC_AGGREGATE`` in the response.
+
 PHC_VCLOCKS_GET
 ===============
 
-- 
2.34.1