From patchwork Fri Dec 2 02:42:49 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 28671 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp611749wrr; Thu, 1 Dec 2022 18:54:02 -0800 (PST) X-Google-Smtp-Source: AA0mqf5AZmy+UPiDevdApvFFbudCBvA10bz3y9RUE9ymeiqtGwvHD4PMvmdzuCGUnLXc4jADLsCJ X-Received: by 2002:a17:903:152:b0:189:6bad:3c61 with SMTP id r18-20020a170903015200b001896bad3c61mr34312120plc.41.1669949642264; Thu, 01 Dec 2022 18:54:02 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1669949642; cv=none; d=google.com; s=arc-20160816; b=mxt4So3R/lM++/Tw464ZODq6M/0kc7UcUyqwSeLD0ijKOGNp9RRQVk9IZoj/Q3H7uo Dbxn4fAeoxHzy2mQTNAHK0Cd2HfaB++4cIlHK6fsFMd7Vc3Qbu7B8nsAQr9x0xgq2wi7 PGmwYoRWZ5gCZ9G6O9XAR2Xxu0t/yEwNkObx1V6u5nh6XK86RT3IzItL8ESd6k65LRGq 5hmWTQl15MSEO0NZxcp0ws4GmGlKwsznX62YPQH9QVWRnGqB7/uiYi+LQ29tQ3KNCx+a gxkVgzhnaiEWwi1fPuJ1iRLW+dySITkvdj/sbs2hKMAftUxA6kq7equ+PmPXbr8WoPz/ K16w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=05g4OE36vdJ7baYLTWmllvdTc9KBGt2oGHehp0XDCXE=; b=1HXOHuBiPwSB8tm4wUlexPl/TFrtuPXkxWt1A8tie7HpNUOIKS49gguWVGMyh/Dw/0 kv7GjaoBzTBGumB9DxBuG8bT6Geb8wvl4t0bKKKqnmFVjcl5D/6JHT9Ws5rfRpBfnkaP QoNHws+P3jJ9u7Bz1N3zm6g88ECCAc5eCobBaLbGQVnh/1XGu7IO9pf9bDTBs7GGzsUc PjXkYOkOGr3Bwywe/9Y/C1QL7+NDBfP8DhSrdQtIuGW135CCtvBXFurWd/S652ldSx6d 0jsrFjdzm+gzR4syZloBXhpDBOyEQdndhb7oj9LpiblYCliTOdA54e5TbnYE/PEex674 7TQw== ARC-Authentication-Results: i=1; mx.google.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=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id m17-20020a63ed51000000b004782ca58117si6042272pgk.611.2022.12.01.18.53.49; Thu, 01 Dec 2022 18:54:02 -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; 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=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232090AbiLBCm4 (ORCPT + 99 others); Thu, 1 Dec 2022 21:42:56 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58404 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230193AbiLBCmz (ORCPT ); Thu, 1 Dec 2022 21:42:55 -0500 Received: from out30-7.freemail.mail.aliyun.com (out30-7.freemail.mail.aliyun.com [115.124.30.7]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A5189D15BA; Thu, 1 Dec 2022 18:42:53 -0800 (PST) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R981e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045170;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=8;SR=0;TI=SMTPD_---0VWAkoq4_1669948970; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VWAkoq4_1669948970) by smtp.aliyun-inc.com; Fri, 02 Dec 2022 10:42:51 +0800 From: Yang Li To: axboe@kernel.dk Cc: tj@kernel.org, josef@toxicpanda.com, cgroups@vger.kernel.org, linux-block@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next v2] blk-cgroup: Fix some kernel-doc comments Date: Fri, 2 Dec 2022 10:42:49 +0800 Message-Id: <20221202024249.12884-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, ENV_AND_HDR_SPF_MATCH,SPF_HELO_NONE,SPF_PASS,UNPARSEABLE_RELAY, USER_IN_DEF_SPF_WL 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?1751069116333913039?= X-GMAIL-MSGID: =?utf-8?q?1751069116333913039?= Make the description of @gendisk to @disk in blkcg_schedule_throttle() to clear the below warnings: block/blk-cgroup.c:1850: warning: Function parameter or member 'disk' not described in 'blkcg_schedule_throttle' block/blk-cgroup.c:1850: warning: Excess function parameter 'gendisk' description in 'blkcg_schedule_throttle' Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=3338 Fixes: de185b56e8a6 ("blk-cgroup: pass a gendisk to blkcg_schedule_throttle") Reported-by: Abaci Robot Signed-off-by: Yang Li --- change in v2: --According to Jens's suggestion, add a fixes line. block/blk-cgroup.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/block/blk-cgroup.c b/block/blk-cgroup.c index 1bb939d3b793..77f44472b41e 100644 --- a/block/blk-cgroup.c +++ b/block/blk-cgroup.c @@ -1831,7 +1831,7 @@ void blkcg_maybe_throttle_current(void) /** * blkcg_schedule_throttle - this task needs to check for throttling - * @gendisk: disk to throttle + * @disk: disk to throttle * @use_memdelay: do we charge this to memory delay for PSI * * This is called by the IO controller when we know there's delay accumulated