From patchwork Wed Sep 13 03:50:32 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chengming Zhou X-Patchwork-Id: 138739 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:9ecd:0:b0:3f2:4152:657d with SMTP id t13csp982090vqx; Wed, 13 Sep 2023 03:22:55 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHNySG12WJ9iC8NsIOYiAXA6ra0WFMkq5uwGNSLvgchSkq0wNabsFtGKvs7evGkcs6W7j+t X-Received: by 2002:a17:90b:3149:b0:268:3b8b:140d with SMTP id ip9-20020a17090b314900b002683b8b140dmr1452792pjb.35.1694600575316; Wed, 13 Sep 2023 03:22:55 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1694600575; cv=none; d=google.com; s=arc-20160816; b=ETB/Qp23I3rCE3mpHRA9IdrXl5BhYXoPmtAfvROQs1LEw/TLAK8TRIlGmXzoGWHYy/ 9gQAUa7fBS3uftdhneE8X5JyjM/Q9++GWWHNzaJxw0K56yibf1upgedwzFlIm2bYzDys diYmvA2IjPEb58gXFThBaDwicMa0JG0e2JV7yB8PCIIyX8pde2yDkNFxZsbVxjGwRmVp ptFyNbq3pXsszDRX6TWAMR8QUadp5uwPdpDpWy9hvuVEY0VvjHiPGvdbYdkYs6l2vKvr rixPyK4uWq+HEgoYsa+h8BkUwynLmncK/m5sBQVubiKk8cd3nsrNVGjI2LZECf0K5h/u 87vA== 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 :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=tr2y1RXEAqFREuCr8X/bFxj1HZWX82tlPsNorh3+Y6g=; fh=0kSCNnJ+Dz7/k19JqdLGTHBnZxdhAtg5C+lF7soNwhs=; b=wLe1I5hQ4A+OSSjNrdocHBoCACPzy+d7dKGqcfaRf9xgaBrMs3rEJJFYpiyms8iitX VBQF+JrSpcqyv4kRafNtIUvlPaXpt0Kpc4qUw7dgRqykg0uUu46pnhZ5Q4gIwAt4wNX1 PmjQDNGCruTbzHEPvmyNqsa1l1YXkqG2lzOsj4RP8hJbQHqpZLN5QMKooiWhbemP4MKN ADq1P1ivcwxMhVmTg8MjLinwv6sFaMlrO/cI4TSaGwtfUUlu9oAdZXzy8pKFIjiNyDl6 LEygscCXWCIcfjRx1RQqSEqrrmenxlZlr+POPp0NznR5hdp3BsndhCVGNCJQD645AjFk 7dww== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linux.dev header.s=key1 header.b=Xe3QWvFE; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:4 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linux.dev Received: from howler.vger.email (howler.vger.email. [2620:137:e000::3:4]) by mx.google.com with ESMTPS id np9-20020a17090b4c4900b00273fde2471esi1386000pjb.88.2023.09.13.03.22.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Sep 2023 03:22:55 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:4 as permitted sender) client-ip=2620:137:e000::3:4; Authentication-Results: mx.google.com; dkim=pass header.i=@linux.dev header.s=key1 header.b=Xe3QWvFE; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:4 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linux.dev Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by howler.vger.email (Postfix) with ESMTP id EC74C822D569; Tue, 12 Sep 2023 20:51:27 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at howler.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S238271AbjIMDv0 (ORCPT + 36 others); Tue, 12 Sep 2023 23:51:26 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53930 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S238262AbjIMDvV (ORCPT ); Tue, 12 Sep 2023 23:51:21 -0400 Received: from out-229.mta0.migadu.com (out-229.mta0.migadu.com [91.218.175.229]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 62DED1989 for ; Tue, 12 Sep 2023 20:51:13 -0700 (PDT) X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.dev; s=key1; t=1694577071; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=tr2y1RXEAqFREuCr8X/bFxj1HZWX82tlPsNorh3+Y6g=; b=Xe3QWvFEiv03j7kyGYShuLqk4W1WQG3vHr92YijOPzUaq7YxU1tUwyw9DmPQezs3eof0bh E34dtvSBWS32CG0ZaJksOasz19sNwffkVYrI93uAIBd84MAf1IngkYa6V+k2ozcV2Tv3sS iTQz9OSB6VFt6yjtLXLfcgKbRgH0+9A= From: chengming.zhou@linux.dev To: axboe@kernel.dk, ming.lei@redhat.com, bvanassche@acm.org, hch@lst.de Cc: linux-block@vger.kernel.org, linux-kernel@vger.kernel.org, chengming.zhou@linux.dev, Chengming Zhou Subject: [PATCH v4 5/6] blk-mq-tag: fix functions documentation Date: Wed, 13 Sep 2023 03:50:32 +0000 Message-Id: <20230913035033.1549277-6-chengming.zhou@linux.dev> In-Reply-To: <20230913035033.1549277-1-chengming.zhou@linux.dev> References: <20230913035033.1549277-1-chengming.zhou@linux.dev> MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (howler.vger.email [0.0.0.0]); Tue, 12 Sep 2023 20:51:28 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1776917492646297063 X-GMAIL-MSGID: 1776917492646297063 From: Chengming Zhou There are some stale functions documentation in blk-mq-tag, since the prototype of busy_tag_iter_fn() has changed. Fix it as we're here. Fixes: 2dd6532e9591 ("blk-mq: Drop 'reserved' arg of busy_tag_iter_fn") Reviewed-by: Bart Van Assche Signed-off-by: Chengming Zhou --- block/blk-mq-tag.c | 28 ++++++++++++---------------- 1 file changed, 12 insertions(+), 16 deletions(-) diff --git a/block/blk-mq-tag.c b/block/blk-mq-tag.c index 3ddc0c7b7f7e..0d42f3c4d76e 100644 --- a/block/blk-mq-tag.c +++ b/block/blk-mq-tag.c @@ -307,9 +307,9 @@ static bool bt_tags_iter(struct sbitmap *bitmap, unsigned int bitnr, void *data) * @bt: sbitmap to examine. This is either the breserved_tags member * or the bitmap_tags member of struct blk_mq_tags. * @fn: Pointer to the function that will be called for each started - * request. @fn will be called as follows: @fn(rq, @data, - * @reserved) where rq is a pointer to a request. Return true - * to continue iterating tags, false to stop. + * request. @fn will be called as follows: @fn(rq, @data) where + * rq is a pointer to a request. Return true to continue iterating + * tags, false to stop. * @data: Will be passed as second argument to @fn. * @flags: BT_TAG_ITER_* * @q: Only iterate over requests of this queue. @@ -346,10 +346,9 @@ static void __blk_mq_all_tag_iter(struct blk_mq_tags *tags, * blk_mq_all_tag_iter - iterate over all requests in a tag map * @tags: Tag map to iterate over. * @fn: Pointer to the function that will be called for each - * request. @fn will be called as follows: @fn(rq, @priv, - * reserved) where rq is a pointer to a request. 'reserved' - * indicates whether or not @rq is a reserved request. Return - * true to continue iterating tags, false to stop. + * request. @fn will be called as follows: @fn(rq, @priv) + * where rq is a pointer to a request. Return true to + * continue iterating tags, false to stop. * @priv: Will be passed as second argument to @fn. * * Caller has to pass the tag map from which requests are allocated. @@ -380,10 +379,9 @@ static void __blk_mq_tagset_busy_iter(struct blk_mq_tag_set *tagset, * blk_mq_tagset_busy_iter - iterate over all started requests in a tag set * @tagset: Tag set to iterate over. * @fn: Pointer to the function that will be called for each started - * request. @fn will be called as follows: @fn(rq, @priv, - * reserved) where rq is a pointer to a request. 'reserved' - * indicates whether or not @rq is a reserved request. Return - * true to continue iterating tags, false to stop. + * request. @fn will be called as follows: @fn(rq, @priv) + * where rq is a pointer to a request. Return true to + * continue iterating tags, false to stop. * @priv: Will be passed as second argument to @fn. * * We grab one request reference before calling @fn and release it after @@ -430,11 +428,9 @@ EXPORT_SYMBOL(blk_mq_tagset_wait_completed_request); * blk_mq_queue_tag_busy_iter - iterate over all requests with a driver tag * @q: Request queue to examine. * @fn: Pointer to the function that will be called for each request - * on @q. @fn will be called as follows: @fn(hctx, rq, @priv, - * reserved) where rq is a pointer to a request and hctx points - * to the hardware queue associated with the request. 'reserved' - * indicates whether or not @rq is a reserved request. - * @priv: Will be passed as third argument to @fn. + * on @q. @fn will be called as follows: @fn(rq, @priv) where rq + * is a pointer to a request. + * @priv: Will be passed as second argument to @fn. * * Note: if @q->tag_set is shared with other request queues then @fn will be * called for all requests on all queues that share that tag set and not only