Received: by 2002:a05:6a10:413:0:0:0:0 with SMTP id 19csp925057pxp; Wed, 16 Mar 2022 21:31:08 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyjHffmbCpMxjLVla+7NnfnpELQJAh/+lEmQb3ViPWUOYtGdfrJwUL+Lwx8qiu0RyrbFZEo X-Received: by 2002:a17:90a:541:b0:1c6:68cc:8b68 with SMTP id h1-20020a17090a054100b001c668cc8b68mr3224208pjf.172.1647491467948; Wed, 16 Mar 2022 21:31:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1647491467; cv=none; d=google.com; s=arc-20160816; b=H8vOE7opQEg11ip/kK2pRVo9vrtB+OZzXTFsBAEQUPm5rtVnqApR4QQlnAOwsnYu0C vFWCcQxMsSM857rqwrASMhLvyqstx+Lva9J7n3jGUb3PKwpl1BI31Iyh4EehupOBRCX4 KrEX6uZFRpBsyF5m3q3SKyQ21C5gOj9lfDreya0GpSqHKyNoQGga0tfUgWRIR15NdD5A lEfrdTDSnHwYjzqb+O68i9haAwthHdqZ8BdkL4vJjgyiYNWVFq3byKsxn9lt0ElgO/O/ lkpWjEwd65IFgFLJddL8vrY7tzfKsN/LomYcgwqzneGhYI/tMM9XFV9VMpmVCgKcJ9+y ACTw== 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=fA5y0pENOZQzojgycZyrDoiPEEm57+gLXQJi+Ecs8Xw=; b=OZmq/ikW5eXuPactxCF6cjN8b8VI389bOE0ty6CwPjf1StJy2lnZtTu9T6fwQrtwxr NWas0ZgSc526vBOwZSMIjfhlEr+ef/K4mgQhkrvYmtrjAuyTTTsiA8MtQZZNZQy2LLDR YFPdNMs8SoXuA6PtxGj6Ctp8VmbdDOv8qvujbllLsiKXBe+NsqSM5XrockLqi7CbkdtP AsB9XWUauKM9FBdA6fkt/uSOQWm+u8l4zcIldQ+hxX519EJrxloLa50c/wkoWZy0ohFC kI0RBYaiOy7D5OOKmTRXr2QBGTVnj55wIWBhZpeJtWkyLUhbv2o15ZFiD6vixZWvMzWN yiBw== 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:18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [2620:137:e000::1:18]) by mx.google.com with ESMTPS id y10-20020a637d0a000000b003816043efbfsi995466pgc.436.2022.03.16.21.31.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Mar 2022 21:31:07 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 as permitted sender) client-ip=2620:137:e000::1:18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:18 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id A92F24832D; Wed, 16 Mar 2022 21:00:22 -0700 (PDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1355806AbiCPMyu (ORCPT + 99 others); Wed, 16 Mar 2022 08:54:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49700 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1354040AbiCPMys (ORCPT ); Wed, 16 Mar 2022 08:54:48 -0400 Received: from out30-56.freemail.mail.aliyun.com (out30-56.freemail.mail.aliyun.com [115.124.30.56]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6EF8BAE57; Wed, 16 Mar 2022 05:53:33 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R151e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=e01e04423;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=8;SR=0;TI=SMTPD_---0V7Mec2u_1647435209; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0V7Mec2u_1647435209) by smtp.aliyun-inc.com(127.0.0.1); Wed, 16 Mar 2022 20:53:30 +0800 From: Yang Li To: paolo.valente@linaro.org Cc: tj@kernel.org, axboe@kernel.dk, cgroups@vger.kernel.org, linux-block@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] block: Add parameter description in kernel-doc comment Date: Wed, 16 Mar 2022 20:53:27 +0800 Message-Id: <20220316125327.126996-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RDNS_NONE, SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=no 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 Add the description of @ioprio_class in bfq_reparent_leaf_entity() and bfq_reparent_active_queues() kernel-doc comment to remove warning found by running scripts/kernel-doc, which is caused by using 'make W=1'. block/bfq-cgroup.c:848: warning: Function parameter or member 'ioprio_class' not described in 'bfq_reparent_leaf_entity' block/bfq-cgroup.c:878: warning: Function parameter or member 'ioprio_class' not described in 'bfq_reparent_active_queues' Reported-by: Abaci Robot Signed-off-by: Yang Li --- block/bfq-cgroup.c | 2 ++ 1 file changed, 2 insertions(+) diff --git a/block/bfq-cgroup.c b/block/bfq-cgroup.c index 420eda2589c0..af92c2e5fd98 100644 --- a/block/bfq-cgroup.c +++ b/block/bfq-cgroup.c @@ -841,6 +841,7 @@ static void bfq_flush_idle_tree(struct bfq_service_tree *st) * @bfqd: the device data structure with the root group. * @entity: the entity to move, if entity is a leaf; or the parent entity * of an active leaf entity to move, if entity is not a leaf. + * @ioprio_class: the offset used to manipulate the service_tree */ static void bfq_reparent_leaf_entity(struct bfq_data *bfqd, struct bfq_entity *entity, @@ -870,6 +871,7 @@ static void bfq_reparent_leaf_entity(struct bfq_data *bfqd, * @bfqd: the device data structure with the root group. * @bfqg: the group to move from. * @st: the service tree to start the search from. + * @ioprio_class: the offset used to manipulate the service_tree */ static void bfq_reparent_active_queues(struct bfq_data *bfqd, struct bfq_group *bfqg, -- 2.20.1.7.g153144c