diff mbox series

[v2,1/2] blk-wbt: Fix some comments

Message ID 20250213100611.209997-2-yizhou.tang@shopee.com (mailing list archive)
State New
Headers show
Series Fix and cleanup some comments in blk-wbt | expand

Commit Message

Tang Yizhou Feb. 13, 2025, 10:06 a.m. UTC
From: Tang Yizhou <yizhou.tang@shopee.com>

wbt_wait() no longer uses a spinlock as a parameter. Update the function
comments accordingly.

RWB_UNKNOWN_BUMP is used when we gradually adjust scale_steps toward the
center state, which is a value of 0.

Signed-off-by: Tang Yizhou <yizhou.tang@shopee.com>
---
 block/blk-wbt.c | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

Comments

Yu Kuai Feb. 13, 2025, 11:04 a.m. UTC | #1
Hi,

在 2025/02/13 18:06, Tang Yizhou 写道:
> From: Tang Yizhou <yizhou.tang@shopee.com>
> 
> wbt_wait() no longer uses a spinlock as a parameter. Update the function
> comments accordingly.
> 
> RWB_UNKNOWN_BUMP is used when we gradually adjust scale_steps toward the
> center state, which is a value of 0.
> 
> Signed-off-by: Tang Yizhou <yizhou.tang@shopee.com>
> ---
>   block/blk-wbt.c | 11 ++++-------
>   1 file changed, 4 insertions(+), 7 deletions(-)
> 

LGTM
Reviewed-by: Yu Kuai <yukuai3@huawei.com>

> diff --git a/block/blk-wbt.c b/block/blk-wbt.c
> index 6dfc659d22e2..8b73c0c11aec 100644
> --- a/block/blk-wbt.c
> +++ b/block/blk-wbt.c
> @@ -136,8 +136,9 @@ enum {
>   	RWB_MIN_WRITE_SAMPLES	= 3,
>   
>   	/*
> -	 * If we have this number of consecutive windows with not enough
> -	 * information to scale up or down, scale up.
> +	 * If we have this number of consecutive windows without enough
> +	 * information to scale up or down, slowly return to center state
> +	 * (step == 0).
>   	 */
>   	RWB_UNKNOWN_BUMP	= 5,
>   };
> @@ -638,11 +639,7 @@ static void wbt_cleanup(struct rq_qos *rqos, struct bio *bio)
>   	__wbt_done(rqos, flags);
>   }
>   
> -/*
> - * May sleep, if we have exceeded the writeback limits. Caller can pass
> - * in an irq held spinlock, if it holds one when calling this function.
> - * If we do sleep, we'll release and re-grab it.
> - */
> +/* May sleep, if we have exceeded the writeback limits. */
>   static void wbt_wait(struct rq_qos *rqos, struct bio *bio)
>   {
>   	struct rq_wb *rwb = RQWB(rqos);
>
diff mbox series

Patch

diff --git a/block/blk-wbt.c b/block/blk-wbt.c
index 6dfc659d22e2..8b73c0c11aec 100644
--- a/block/blk-wbt.c
+++ b/block/blk-wbt.c
@@ -136,8 +136,9 @@  enum {
 	RWB_MIN_WRITE_SAMPLES	= 3,
 
 	/*
-	 * If we have this number of consecutive windows with not enough
-	 * information to scale up or down, scale up.
+	 * If we have this number of consecutive windows without enough
+	 * information to scale up or down, slowly return to center state
+	 * (step == 0).
 	 */
 	RWB_UNKNOWN_BUMP	= 5,
 };
@@ -638,11 +639,7 @@  static void wbt_cleanup(struct rq_qos *rqos, struct bio *bio)
 	__wbt_done(rqos, flags);
 }
 
-/*
- * May sleep, if we have exceeded the writeback limits. Caller can pass
- * in an irq held spinlock, if it holds one when calling this function.
- * If we do sleep, we'll release and re-grab it.
- */
+/* May sleep, if we have exceeded the writeback limits. */
 static void wbt_wait(struct rq_qos *rqos, struct bio *bio)
 {
 	struct rq_wb *rwb = RQWB(rqos);