public inbox for linux-scsi@vger.kernel.org
 help / color / mirror / Atom feed
From: Christoph Hellwig <hch@lst.de>
To: Jens Axboe <axboe@kernel.dk>
Cc: Damien Le Moal <dlemoal@kernel.org>,
	Ming Lei <ming.lei@redhat.com>,
	Nilay Shroff <nilay@linux.ibm.com>,
	linux-block@vger.kernel.org, linux-nvme@lists.infradead.org,
	nbd@other.debian.org, linux-scsi@vger.kernel.org,
	usb-storage@lists.one-eyed-alien.net
Subject: [PATCH 1/8] block: fix docs for freezing of queue limits updates
Date: Tue,  7 Jan 2025 07:30:33 +0100	[thread overview]
Message-ID: <20250107063120.1011593-2-hch@lst.de> (raw)
In-Reply-To: <20250107063120.1011593-1-hch@lst.de>

queue_limits_commit_update is the function that needs to operate on a
frozen queue, not queue_limits_start_update.  Update the kerneldoc
comments to reflect that.

Signed-off-by: Christoph Hellwig <hch@lst.de>
---
 block/blk-settings.c   | 3 ++-
 include/linux/blkdev.h | 3 +--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/block/blk-settings.c b/block/blk-settings.c
index 8f09e33f41f6..b6b8c580d018 100644
--- a/block/blk-settings.c
+++ b/block/blk-settings.c
@@ -413,7 +413,8 @@ int blk_set_default_limits(struct queue_limits *lim)
  * @lim:	limits to apply
  *
  * Apply the limits in @lim that were obtained from queue_limits_start_update()
- * and updated by the caller to @q.
+ * and updated by the caller to @q.  The caller must have frozen the queue or
+ * ensure that there are outstanding I/Os by other means.
  *
  * Returns 0 if successful, else a negative error code.
  */
diff --git a/include/linux/blkdev.h b/include/linux/blkdev.h
index 5d40af2ef971..e781d4e6f92d 100644
--- a/include/linux/blkdev.h
+++ b/include/linux/blkdev.h
@@ -944,8 +944,7 @@ static inline unsigned int blk_boundary_sectors_left(sector_t offset,
  * the caller can modify.  The caller must call queue_limits_commit_update()
  * to finish the update.
  *
- * Context: process context.  The caller must have frozen the queue or ensured
- * that there is outstanding I/O by other means.
+ * Context: process context.
  */
 static inline struct queue_limits
 queue_limits_start_update(struct request_queue *q)
-- 
2.45.2


  reply	other threads:[~2025-01-07  6:31 UTC|newest]

Thread overview: 43+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-01-07  6:30 fix queue freeze and limit locking order Christoph Hellwig
2025-01-07  6:30 ` Christoph Hellwig [this message]
2025-01-07  7:01   ` [PATCH 1/8] block: fix docs for freezing of queue limits updates Nilay Shroff
2025-01-07 18:05     ` Nilay Shroff
2025-01-07 10:03   ` Damien Le Moal
2025-01-09 11:19   ` John Garry
2025-01-09 11:24     ` Nilay Shroff
2025-01-09 11:26       ` John Garry
2025-01-07  6:30 ` [PATCH 2/8] block: add a queue_limits_commit_update_frozen helper Christoph Hellwig
2025-01-07 10:05   ` Damien Le Moal
2025-01-07 17:58   ` Nilay Shroff
2025-01-07  6:30 ` [PATCH 3/8] block: don't update BLK_FEAT_POLL in __blk_mq_update_nr_hw_queues Christoph Hellwig
2025-01-07  6:57   ` Nilay Shroff
2025-01-07  8:21     ` Christoph Hellwig
2025-01-07  9:23       ` Nilay Shroff
2025-01-07 13:51         ` Christoph Hellwig
2025-01-07 17:55           ` Nilay Shroff
2025-01-07  6:30 ` [PATCH 4/8] block: add a store_limit operations for sysfs entries Christoph Hellwig
2025-01-07  7:25   ` Ming Lei
2025-01-07  7:51     ` Nilay Shroff
2025-01-07  8:26       ` Christoph Hellwig
2025-01-07 10:25       ` Ming Lei
2025-01-07 13:49         ` Christoph Hellwig
2025-01-07  8:23     ` Christoph Hellwig
2025-01-07 10:05   ` Damien Le Moal
2025-01-07 17:58   ` Nilay Shroff
2025-01-07  6:30 ` [PATCH 5/8] block: fix queue freeze vs limits lock order in sysfs store methods Christoph Hellwig
2025-01-07 17:59   ` Nilay Shroff
2025-01-07  6:30 ` [PATCH 6/8] nvme: fix queue freeze vs limits lock order Christoph Hellwig
2025-01-07  6:58   ` Nilay Shroff
2025-01-07  8:22     ` Christoph Hellwig
2025-01-07  8:45       ` Nilay Shroff
2025-01-07  8:58         ` Christoph Hellwig
2025-01-07  9:29           ` Nilay Shroff
2025-01-07  9:58   ` Damien Le Moal
2025-01-07 18:00   ` Nilay Shroff
2025-01-07  6:30 ` [PATCH 7/8] nbd: " Christoph Hellwig
2025-01-07 10:00   ` Damien Le Moal
2025-01-07 18:01   ` Nilay Shroff
2025-01-07  6:30 ` [PATCH 8/8] usb-storage:fix " Christoph Hellwig
2025-01-07 10:00   ` Damien Le Moal
2025-01-07 18:01   ` Nilay Shroff
2025-01-08  2:21 ` fix queue freeze and limit locking order Ming Lei

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20250107063120.1011593-2-hch@lst.de \
    --to=hch@lst.de \
    --cc=axboe@kernel.dk \
    --cc=dlemoal@kernel.org \
    --cc=linux-block@vger.kernel.org \
    --cc=linux-nvme@lists.infradead.org \
    --cc=linux-scsi@vger.kernel.org \
    --cc=ming.lei@redhat.com \
    --cc=nbd@other.debian.org \
    --cc=nilay@linux.ibm.com \
    --cc=usb-storage@lists.one-eyed-alien.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox