{"id":2219501,"url":"http://patchwork.ozlabs.org/api/patches/2219501/?format=json","web_url":"http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20260403054321.3791392-1-aleksandr.loktionov@intel.com/","project":{"id":46,"url":"http://patchwork.ozlabs.org/api/projects/46/?format=json","name":"Intel Wired Ethernet development","link_name":"intel-wired-lan","list_id":"intel-wired-lan.osuosl.org","list_email":"intel-wired-lan@osuosl.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260403054321.3791392-1-aleksandr.loktionov@intel.com>","list_archive_url":null,"date":"2026-04-03T05:43:21","name":"[net-next] iavf: fix kernel-doc comment style in ethtool ops","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"26d6932503174d1bc532a57abd4fe87df07a75cf","submitter":{"id":75597,"url":"http://patchwork.ozlabs.org/api/people/75597/?format=json","name":"Loktionov, Aleksandr","email":"aleksandr.loktionov@intel.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20260403054321.3791392-1-aleksandr.loktionov@intel.com/mbox/","series":[{"id":498591,"url":"http://patchwork.ozlabs.org/api/series/498591/?format=json","web_url":"http://patchwork.ozlabs.org/project/intel-wired-lan/list/?series=498591","date":"2026-04-03T05:43:21","name":"[net-next] iavf: fix kernel-doc comment style in ethtool ops","version":1,"mbox":"http://patchwork.ozlabs.org/series/498591/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2219501/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2219501/checks/","tags":{},"related":[],"headers":{"Return-Path":"<intel-wired-lan-bounces@osuosl.org>","X-Original-To":["incoming@patchwork.ozlabs.org","intel-wired-lan@lists.osuosl.org"],"Delivered-To":["patchwork-incoming@legolas.ozlabs.org","intel-wired-lan@lists.osuosl.org"],"Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=osuosl.org header.i=@osuosl.org header.a=rsa-sha256\n header.s=default header.b=9CSXR0td;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=osuosl.org\n (client-ip=140.211.166.137; helo=smtp4.osuosl.org;\n envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=patchwork.ozlabs.org)"],"Received":["from smtp4.osuosl.org (smtp4.osuosl.org [140.211.166.137])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fn71Y66hbz1yD3\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 03 Apr 2026 16:43:29 +1100 (AEDT)","from localhost (localhost [127.0.0.1])\n\tby smtp4.osuosl.org (Postfix) with ESMTP id EFE4F40EC6;\n\tFri,  3 Apr 2026 05:43:27 +0000 (UTC)","from smtp4.osuosl.org ([127.0.0.1])\n by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id xC_iLUtPZAIG; Fri,  3 Apr 2026 05:43:25 +0000 (UTC)","from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp4.osuosl.org (Postfix) with ESMTP id C194940E8F;\n\tFri,  3 Apr 2026 05:43:25 +0000 (UTC)","from smtp2.osuosl.org (smtp2.osuosl.org [140.211.166.133])\n by lists1.osuosl.org (Postfix) with ESMTP id A445D1F3\n for <intel-wired-lan@lists.osuosl.org>; Fri,  3 Apr 2026 05:43:24 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp2.osuosl.org (Postfix) with ESMTP id 90D424008E\n for <intel-wired-lan@lists.osuosl.org>; Fri,  3 Apr 2026 05:43:24 +0000 (UTC)","from smtp2.osuosl.org ([127.0.0.1])\n by localhost (smtp2.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id RnO17vl3fs4n for <intel-wired-lan@lists.osuosl.org>;\n Fri,  3 Apr 2026 05:43:24 +0000 (UTC)","from mgamail.intel.com (mgamail.intel.com [198.175.65.12])\n by smtp2.osuosl.org (Postfix) with ESMTPS id E96A840071\n for <intel-wired-lan@lists.osuosl.org>; Fri,  3 Apr 2026 05:43:23 +0000 (UTC)","from fmviesa009.fm.intel.com ([10.60.135.149])\n by orvoesa104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 02 Apr 2026 22:43:23 -0700","from amlin-019-225.igk.intel.com ([10.102.19.225])\n by fmviesa009.fm.intel.com with ESMTP; 02 Apr 2026 22:43:21 -0700"],"X-Virus-Scanned":["amavis at osuosl.org","amavis at osuosl.org"],"X-Comment":"SPF check N/A for local connections - client-ip=140.211.166.142;\n helo=lists1.osuosl.org; envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=<UNKNOWN> ","DKIM-Filter":["OpenDKIM Filter v2.11.0 smtp4.osuosl.org C194940E8F","OpenDKIM Filter v2.11.0 smtp2.osuosl.org E96A840071"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1775195005;\n\tbh=HnVr2f0QmI6pfCrN2SXzFyJYYh/JjFhz6Byi9MDeDEI=;\n\th=From:To:Cc:Date:Subject:List-Id:List-Unsubscribe:List-Archive:\n\t List-Post:List-Help:List-Subscribe:From;\n\tb=9CSXR0tdw3Hx3zvx4NrlUUZmXUvBAYaPVPIG6GNJMXx+MBUbBUttuMhFfshEynXXB\n\t THQGiUw85pR8Ph7b0p3zoNEaiTRrdDy+2Ywkok+q+fSlhU2QwGS9XImwyIfdACcFF2\n\t LS+2gVQzlSp1s3SsnlFG9sULwMqrvnVsUYdj5UB3LlGYn9808jFCEfTET/v6ixpBSQ\n\t 83nzGh4uPE4RfRu70HL6E9MJ5nh4o7CCuKJBdBx1ZCEAP7EL/ihO1jHzbm9/pCle/Z\n\t WOVq+qUtUC+GWAXKtku+VxUzeMKneK5BDIAI2h3nG/3lJdtJlfjLVZzGO+dcY4pIgr\n\t Du0fT/r2jOLBQ==","Received-SPF":"Pass (mailfrom) identity=mailfrom; client-ip=198.175.65.12;\n helo=mgamail.intel.com; envelope-from=aleksandr.loktionov@intel.com;\n receiver=<UNKNOWN>","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp2.osuosl.org E96A840071","X-CSE-ConnectionGUID":["c8+wBJ4LQ1uxsi572wtpYA==","wX1So50NRyCynhQQao17iw=="],"X-CSE-MsgGUID":["45BKSvWaT464DC6BkXjhew==","dCf2kjxcQXel/bXyIweq5w=="],"X-IronPort-AV":["E=McAfee;i=\"6800,10657,11747\"; a=\"87713712\"","E=Sophos;i=\"6.23,157,1770624000\"; d=\"scan'208\";a=\"87713712\"","E=Sophos;i=\"6.23,157,1770624000\"; d=\"scan'208\";a=\"220534463\""],"X-ExtLoop1":"1","From":"Aleksandr Loktionov <aleksandr.loktionov@intel.com>","To":"intel-wired-lan@lists.osuosl.org, anthony.l.nguyen@intel.com,\n aleksandr.loktionov@intel.com","Cc":"netdev@vger.kernel.org,\n\tLeszek Pepiak <leszek.pepiak@intel.com>","Date":"Fri,  3 Apr 2026 07:43:21 +0200","Message-ID":"<20260403054321.3791392-1-aleksandr.loktionov@intel.com>","X-Mailer":"git-send-email 2.52.0","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-Mailman-Original-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1775195004; x=1806731004;\n h=from:to:cc:subject:date:message-id:mime-version:\n content-transfer-encoding;\n bh=F7mmVxPGICqRnePglmcXewjWAjCpBMiS2f/TuIVGVQc=;\n b=XPvnVMkRITxknbJvYsjWDllarad+DzOPUK1F6UdUERtVNER2HGr11b6B\n Ky2Htt34oMXCuB7o2aCgK00tx8HijNxcENMRWZqtqtcTqH1R0DodkdLa9\n Qtuw+PoQ66Esggkefs+3hlF8wx1LO0yAyrZJr/tFMEm6sGjlnom61FEuU\n h6l9vxlbKCFSTqfDJ9FJvWOSDHQLypaTL81PMsmUdvscCwBEJRDJJS+5k\n /JS8yI+vkMWbQ68Ba5C41Eq6F6pUSop7RZJmMfzdiSFOb0cOT5vBUgfGt\n I3wFNNerTErjsjUEZ77749gXhfW3deD3hHrG7yIYGXm1QUr2T3aPp+/8L\n g==;","X-Mailman-Original-Authentication-Results":["smtp2.osuosl.org;\n dmarc=pass (p=none dis=none)\n header.from=intel.com","smtp2.osuosl.org;\n dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com\n header.a=rsa-sha256 header.s=Intel header.b=XPvnVMkR"],"Subject":"[Intel-wired-lan] [PATCH net-next] iavf: fix kernel-doc comment\n style in ethtool ops","X-BeenThere":"intel-wired-lan@osuosl.org","X-Mailman-Version":"2.1.30","Precedence":"list","List-Id":"Intel Wired Ethernet Linux Kernel Driver Development\n <intel-wired-lan.osuosl.org>","List-Unsubscribe":"<https://lists.osuosl.org/mailman/options/intel-wired-lan>,\n <mailto:intel-wired-lan-request@osuosl.org?subject=unsubscribe>","List-Archive":"<http://lists.osuosl.org/pipermail/intel-wired-lan/>","List-Post":"<mailto:intel-wired-lan@osuosl.org>","List-Help":"<mailto:intel-wired-lan-request@osuosl.org?subject=help>","List-Subscribe":"<https://lists.osuosl.org/mailman/listinfo/intel-wired-lan>,\n <mailto:intel-wired-lan-request@osuosl.org?subject=subscribe>","Errors-To":"intel-wired-lan-bounces@osuosl.org","Sender":"\"Intel-wired-lan\" <intel-wired-lan-bounces@osuosl.org>"},"content":"From: Leszek Pepiak <leszek.pepiak@intel.com>\n\niavf_get_channels() and iavf_set_channels() use the legacy `**/`\ncomment terminator and embed the return description in the body text.\nConvert to proper kernel-doc style: single `*/` terminator and an\nexplicit `Return:` section.\n\nSigned-off-by: Leszek Pepiak <leszek.pepiak@intel.com>\nSigned-off-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>\n\n---\n drivers/net/ethernet/intel/iavf/iavf_ethtool.c | 13 +++++++------\n 1 file changed, 7 insertions(+), 6 deletions(-)","diff":"diff --git a/drivers/net/ethernet/intel/iavf/iavf_ethtool.c b/drivers/net/ethernet/intel/iavf/iavf_ethtool.c\nindex 8188dd4..425acbb 100644\n--- a/drivers/net/ethernet/intel/iavf/iavf_ethtool.c\n+++ b/drivers/net/ethernet/intel/iavf/iavf_ethtool.c\n@@ -1846,13 +1846,13 @@ static int iavf_get_rxnfc(struct net_device *netdev, struct ethtool_rxnfc *cmd,\n \treturn ret;\n }\n /**\n- * iavf_get_channels: get the number of channels supported by the device\n+ * iavf_get_channels - get the number of channels supported by the device\n  * @netdev: network interface device structure\n  * @ch: channel information structure\n  *\n  * For the purposes of our device, we only use combined channels, i.e. a tx/rx\n  * queue pair. Report one extra channel to match our \"other\" MSI-X vector.\n- **/\n+ */\n static void iavf_get_channels(struct net_device *netdev,\n \t\t\t      struct ethtool_channels *ch)\n {\n@@ -1873,14 +1873,15 @@ static void iavf_get_channels(struct net_device *netdev,\n }\n \n /**\n- * iavf_set_channels: set the new channel count\n+ * iavf_set_channels - set the new channel count\n  * @netdev: network interface device structure\n  * @ch: channel information structure\n  *\n  * Negotiate a new number of channels with the PF then do a reset.  During\n- * reset we'll realloc queues and fix the RSS table.  Returns 0 on success,\n- * negative on failure.\n- **/\n+ * reset we'll realloc queues and fix the RSS table.\n+ *\n+ * Return: 0 on success, negative on failure.\n+ */\n static int iavf_set_channels(struct net_device *netdev,\n \t\t\t     struct ethtool_channels *ch)\n {\n","prefixes":["net-next"]}