2 #include <linux/wait.h>
3 #include <linux/backing-dev.h>
4 #include <linux/kthread.h>
5 #include <linux/freezer.h>
7 #include <linux/pagemap.h>
9 #include <linux/sched.h>
10 #include <linux/module.h>
11 #include <linux/writeback.h>
12 #include <linux/device.h>
13 #include <trace/events/writeback.h>
15 static atomic_long_t bdi_seq
= ATOMIC_LONG_INIT(0);
17 struct backing_dev_info default_backing_dev_info
= {
19 .ra_pages
= VM_MAX_READAHEAD
* 1024 / PAGE_CACHE_SIZE
,
21 .capabilities
= BDI_CAP_MAP_COPY
,
23 EXPORT_SYMBOL_GPL(default_backing_dev_info
);
25 struct backing_dev_info noop_backing_dev_info
= {
27 .capabilities
= BDI_CAP_NO_ACCT_AND_WRITEBACK
,
29 EXPORT_SYMBOL_GPL(noop_backing_dev_info
);
31 static struct class *bdi_class
;
34 * bdi_lock protects updates to bdi_list and bdi_pending_list, as well as
35 * reader side protection for bdi_pending_list. bdi_list has RCU reader side
38 DEFINE_SPINLOCK(bdi_lock
);
40 LIST_HEAD(bdi_pending_list
);
42 static struct task_struct
*sync_supers_tsk
;
43 static struct timer_list sync_supers_timer
;
45 static int bdi_sync_supers(void *);
46 static void sync_supers_timer_fn(unsigned long);
48 void bdi_lock_two(struct bdi_writeback
*wb1
, struct bdi_writeback
*wb2
)
51 spin_lock(&wb1
->list_lock
);
52 spin_lock_nested(&wb2
->list_lock
, 1);
54 spin_lock(&wb2
->list_lock
);
55 spin_lock_nested(&wb1
->list_lock
, 1);
59 #ifdef CONFIG_DEBUG_FS
60 #include <linux/debugfs.h>
61 #include <linux/seq_file.h>
63 static struct dentry
*bdi_debug_root
;
65 static void bdi_debug_init(void)
67 bdi_debug_root
= debugfs_create_dir("bdi", NULL
);
70 static int bdi_debug_stats_show(struct seq_file
*m
, void *v
)
72 struct backing_dev_info
*bdi
= m
->private;
73 struct bdi_writeback
*wb
= &bdi
->wb
;
74 unsigned long background_thresh
;
75 unsigned long dirty_thresh
;
76 unsigned long bdi_thresh
;
77 unsigned long nr_dirty
, nr_io
, nr_more_io
;
80 nr_dirty
= nr_io
= nr_more_io
= 0;
81 spin_lock(&wb
->list_lock
);
82 list_for_each_entry(inode
, &wb
->b_dirty
, i_wb_list
)
84 list_for_each_entry(inode
, &wb
->b_io
, i_wb_list
)
86 list_for_each_entry(inode
, &wb
->b_more_io
, i_wb_list
)
88 spin_unlock(&wb
->list_lock
);
90 global_dirty_limits(&background_thresh
, &dirty_thresh
);
91 bdi_thresh
= bdi_dirty_limit(bdi
, dirty_thresh
);
93 #define K(x) ((x) << (PAGE_SHIFT - 10))
95 "BdiWriteback: %10lu kB\n"
96 "BdiReclaimable: %10lu kB\n"
97 "BdiDirtyThresh: %10lu kB\n"
98 "DirtyThresh: %10lu kB\n"
99 "BackgroundThresh: %10lu kB\n"
100 "BdiWritten: %10lu kB\n"
101 "BdiWriteBandwidth: %10lu kBps\n"
107 (unsigned long) K(bdi_stat(bdi
, BDI_WRITEBACK
)),
108 (unsigned long) K(bdi_stat(bdi
, BDI_RECLAIMABLE
)),
111 K(background_thresh
),
112 (unsigned long) K(bdi_stat(bdi
, BDI_WRITTEN
)),
113 (unsigned long) K(bdi
->write_bandwidth
),
117 !list_empty(&bdi
->bdi_list
), bdi
->state
);
123 static int bdi_debug_stats_open(struct inode
*inode
, struct file
*file
)
125 return single_open(file
, bdi_debug_stats_show
, inode
->i_private
);
128 static const struct file_operations bdi_debug_stats_fops
= {
129 .open
= bdi_debug_stats_open
,
132 .release
= single_release
,
135 static void bdi_debug_register(struct backing_dev_info
*bdi
, const char *name
)
137 bdi
->debug_dir
= debugfs_create_dir(name
, bdi_debug_root
);
138 bdi
->debug_stats
= debugfs_create_file("stats", 0444, bdi
->debug_dir
,
139 bdi
, &bdi_debug_stats_fops
);
142 static void bdi_debug_unregister(struct backing_dev_info
*bdi
)
144 debugfs_remove(bdi
->debug_stats
);
145 debugfs_remove(bdi
->debug_dir
);
148 static inline void bdi_debug_init(void)
151 static inline void bdi_debug_register(struct backing_dev_info
*bdi
,
155 static inline void bdi_debug_unregister(struct backing_dev_info
*bdi
)
160 static ssize_t
read_ahead_kb_store(struct device
*dev
,
161 struct device_attribute
*attr
,
162 const char *buf
, size_t count
)
164 struct backing_dev_info
*bdi
= dev_get_drvdata(dev
);
166 unsigned long read_ahead_kb
;
167 ssize_t ret
= -EINVAL
;
169 read_ahead_kb
= simple_strtoul(buf
, &end
, 10);
170 if (*buf
&& (end
[0] == '\0' || (end
[0] == '\n' && end
[1] == '\0'))) {
171 bdi
->ra_pages
= read_ahead_kb
>> (PAGE_SHIFT
- 10);
177 #define K(pages) ((pages) << (PAGE_SHIFT - 10))
179 #define BDI_SHOW(name, expr) \
180 static ssize_t name##_show(struct device *dev, \
181 struct device_attribute *attr, char *page) \
183 struct backing_dev_info *bdi = dev_get_drvdata(dev); \
185 return snprintf(page, PAGE_SIZE-1, "%lld\n", (long long)expr); \
188 BDI_SHOW(read_ahead_kb
, K(bdi
->ra_pages
))
190 static ssize_t
min_ratio_store(struct device
*dev
,
191 struct device_attribute
*attr
, const char *buf
, size_t count
)
193 struct backing_dev_info
*bdi
= dev_get_drvdata(dev
);
196 ssize_t ret
= -EINVAL
;
198 ratio
= simple_strtoul(buf
, &end
, 10);
199 if (*buf
&& (end
[0] == '\0' || (end
[0] == '\n' && end
[1] == '\0'))) {
200 ret
= bdi_set_min_ratio(bdi
, ratio
);
206 BDI_SHOW(min_ratio
, bdi
->min_ratio
)
208 static ssize_t
max_ratio_store(struct device
*dev
,
209 struct device_attribute
*attr
, const char *buf
, size_t count
)
211 struct backing_dev_info
*bdi
= dev_get_drvdata(dev
);
214 ssize_t ret
= -EINVAL
;
216 ratio
= simple_strtoul(buf
, &end
, 10);
217 if (*buf
&& (end
[0] == '\0' || (end
[0] == '\n' && end
[1] == '\0'))) {
218 ret
= bdi_set_max_ratio(bdi
, ratio
);
224 BDI_SHOW(max_ratio
, bdi
->max_ratio
)
226 #define __ATTR_RW(attr) __ATTR(attr, 0644, attr##_show, attr##_store)
228 static struct device_attribute bdi_dev_attrs
[] = {
229 __ATTR_RW(read_ahead_kb
),
230 __ATTR_RW(min_ratio
),
231 __ATTR_RW(max_ratio
),
235 static __init
int bdi_class_init(void)
237 bdi_class
= class_create(THIS_MODULE
, "bdi");
238 if (IS_ERR(bdi_class
))
239 return PTR_ERR(bdi_class
);
241 bdi_class
->dev_attrs
= bdi_dev_attrs
;
245 postcore_initcall(bdi_class_init
);
247 static int __init
default_bdi_init(void)
251 sync_supers_tsk
= kthread_run(bdi_sync_supers
, NULL
, "sync_supers");
252 BUG_ON(IS_ERR(sync_supers_tsk
));
254 setup_timer(&sync_supers_timer
, sync_supers_timer_fn
, 0);
255 bdi_arm_supers_timer();
257 err
= bdi_init(&default_backing_dev_info
);
259 bdi_register(&default_backing_dev_info
, NULL
, "default");
260 err
= bdi_init(&noop_backing_dev_info
);
264 subsys_initcall(default_bdi_init
);
266 int bdi_has_dirty_io(struct backing_dev_info
*bdi
)
268 return wb_has_dirty_io(&bdi
->wb
);
272 * kupdated() used to do this. We cannot do it from the bdi_forker_thread()
273 * or we risk deadlocking on ->s_umount. The longer term solution would be
274 * to implement sync_supers_bdi() or similar and simply do it from the
275 * bdi writeback thread individually.
277 static int bdi_sync_supers(void *unused
)
279 set_user_nice(current
, 0);
281 while (!kthread_should_stop()) {
282 set_current_state(TASK_INTERRUPTIBLE
);
286 * Do this periodically, like kupdated() did before.
294 void bdi_arm_supers_timer(void)
298 if (!dirty_writeback_interval
)
301 next
= msecs_to_jiffies(dirty_writeback_interval
* 10) + jiffies
;
302 mod_timer(&sync_supers_timer
, round_jiffies_up(next
));
305 static void sync_supers_timer_fn(unsigned long unused
)
307 wake_up_process(sync_supers_tsk
);
308 bdi_arm_supers_timer();
311 static void wakeup_timer_fn(unsigned long data
)
313 struct backing_dev_info
*bdi
= (struct backing_dev_info
*)data
;
315 spin_lock_bh(&bdi
->wb_lock
);
317 trace_writeback_wake_thread(bdi
);
318 wake_up_process(bdi
->wb
.task
);
321 * When bdi tasks are inactive for long time, they are killed.
322 * In this case we have to wake-up the forker thread which
323 * should create and run the bdi thread.
325 trace_writeback_wake_forker_thread(bdi
);
326 wake_up_process(default_backing_dev_info
.wb
.task
);
328 spin_unlock_bh(&bdi
->wb_lock
);
332 * This function is used when the first inode for this bdi is marked dirty. It
333 * wakes-up the corresponding bdi thread which should then take care of the
334 * periodic background write-out of dirty inodes. Since the write-out would
335 * starts only 'dirty_writeback_interval' centisecs from now anyway, we just
336 * set up a timer which wakes the bdi thread up later.
338 * Note, we wouldn't bother setting up the timer, but this function is on the
339 * fast-path (used by '__mark_inode_dirty()'), so we save few context switches
340 * by delaying the wake-up.
342 void bdi_wakeup_thread_delayed(struct backing_dev_info
*bdi
)
344 unsigned long timeout
;
346 timeout
= msecs_to_jiffies(dirty_writeback_interval
* 10);
347 mod_timer(&bdi
->wb
.wakeup_timer
, jiffies
+ timeout
);
351 * Calculate the longest interval (jiffies) bdi threads are allowed to be
354 static unsigned long bdi_longest_inactive(void)
356 unsigned long interval
;
358 interval
= msecs_to_jiffies(dirty_writeback_interval
* 10);
359 return max(5UL * 60 * HZ
, interval
);
362 static int bdi_forker_thread(void *ptr
)
364 struct bdi_writeback
*me
= ptr
;
366 current
->flags
|= PF_SWAPWRITE
;
370 * Our parent may run at a different priority, just set us to normal
372 set_user_nice(current
, 0);
375 struct task_struct
*task
= NULL
;
376 struct backing_dev_info
*bdi
;
378 NO_ACTION
, /* Nothing to do */
379 FORK_THREAD
, /* Fork bdi thread */
380 KILL_THREAD
, /* Kill inactive bdi thread */
381 } action
= NO_ACTION
;
384 * Temporary measure, we want to make sure we don't see
385 * dirty data on the default backing_dev_info
387 if (wb_has_dirty_io(me
) || !list_empty(&me
->bdi
->work_list
)) {
388 del_timer(&me
->wakeup_timer
);
389 wb_do_writeback(me
, 0);
392 spin_lock_bh(&bdi_lock
);
393 set_current_state(TASK_INTERRUPTIBLE
);
395 list_for_each_entry(bdi
, &bdi_list
, bdi_list
) {
398 if (!bdi_cap_writeback_dirty(bdi
) ||
399 bdi_cap_flush_forker(bdi
))
402 WARN(!test_bit(BDI_registered
, &bdi
->state
),
403 "bdi %p/%s is not registered!\n", bdi
, bdi
->name
);
405 have_dirty_io
= !list_empty(&bdi
->work_list
) ||
406 wb_has_dirty_io(&bdi
->wb
);
409 * If the bdi has work to do, but the thread does not
412 if (!bdi
->wb
.task
&& have_dirty_io
) {
414 * Set the pending bit - if someone will try to
415 * unregister this bdi - it'll wait on this bit.
417 set_bit(BDI_pending
, &bdi
->state
);
418 action
= FORK_THREAD
;
422 spin_lock(&bdi
->wb_lock
);
425 * If there is no work to do and the bdi thread was
426 * inactive long enough - kill it. The wb_lock is taken
427 * to make sure no-one adds more work to this bdi and
428 * wakes the bdi thread up.
430 if (bdi
->wb
.task
&& !have_dirty_io
&&
431 time_after(jiffies
, bdi
->wb
.last_active
+
432 bdi_longest_inactive())) {
435 spin_unlock(&bdi
->wb_lock
);
436 set_bit(BDI_pending
, &bdi
->state
);
437 action
= KILL_THREAD
;
440 spin_unlock(&bdi
->wb_lock
);
442 spin_unlock_bh(&bdi_lock
);
444 /* Keep working if default bdi still has things to do */
445 if (!list_empty(&me
->bdi
->work_list
))
446 __set_current_state(TASK_RUNNING
);
450 __set_current_state(TASK_RUNNING
);
451 task
= kthread_create(bdi_writeback_thread
, &bdi
->wb
,
452 "flush-%s", dev_name(bdi
->dev
));
455 * If thread creation fails, force writeout of
456 * the bdi from the thread. Hopefully 1024 is
457 * large enough for efficient IO.
459 writeback_inodes_wb(&bdi
->wb
, 1024);
462 * The spinlock makes sure we do not lose
463 * wake-ups when racing with 'bdi_queue_work()'.
464 * And as soon as the bdi thread is visible, we
467 spin_lock_bh(&bdi
->wb_lock
);
469 spin_unlock_bh(&bdi
->wb_lock
);
470 wake_up_process(task
);
475 __set_current_state(TASK_RUNNING
);
480 if (!wb_has_dirty_io(me
) || !dirty_writeback_interval
)
482 * There are no dirty data. The only thing we
483 * should now care about is checking for
484 * inactive bdi threads and killing them. Thus,
485 * let's sleep for longer time, save energy and
486 * be friendly for battery-driven devices.
488 schedule_timeout(bdi_longest_inactive());
490 schedule_timeout(msecs_to_jiffies(dirty_writeback_interval
* 10));
492 /* Back to the main loop */
497 * Clear pending bit and wakeup anybody waiting to tear us down.
499 clear_bit(BDI_pending
, &bdi
->state
);
500 smp_mb__after_clear_bit();
501 wake_up_bit(&bdi
->state
, BDI_pending
);
508 * Remove bdi from bdi_list, and ensure that it is no longer visible
510 static void bdi_remove_from_list(struct backing_dev_info
*bdi
)
512 spin_lock_bh(&bdi_lock
);
513 list_del_rcu(&bdi
->bdi_list
);
514 spin_unlock_bh(&bdi_lock
);
519 int bdi_register(struct backing_dev_info
*bdi
, struct device
*parent
,
520 const char *fmt
, ...)
525 if (bdi
->dev
) /* The driver needs to use separate queues per device */
529 dev
= device_create_vargs(bdi_class
, parent
, MKDEV(0, 0), bdi
, fmt
, args
);
537 * Just start the forker thread for our default backing_dev_info,
538 * and add other bdi's to the list. They will get a thread created
539 * on-demand when they need it.
541 if (bdi_cap_flush_forker(bdi
)) {
542 struct bdi_writeback
*wb
= &bdi
->wb
;
544 wb
->task
= kthread_run(bdi_forker_thread
, wb
, "bdi-%s",
546 if (IS_ERR(wb
->task
))
547 return PTR_ERR(wb
->task
);
550 bdi_debug_register(bdi
, dev_name(dev
));
551 set_bit(BDI_registered
, &bdi
->state
);
553 spin_lock_bh(&bdi_lock
);
554 list_add_tail_rcu(&bdi
->bdi_list
, &bdi_list
);
555 spin_unlock_bh(&bdi_lock
);
557 trace_writeback_bdi_register(bdi
);
560 EXPORT_SYMBOL(bdi_register
);
562 int bdi_register_dev(struct backing_dev_info
*bdi
, dev_t dev
)
564 return bdi_register(bdi
, NULL
, "%u:%u", MAJOR(dev
), MINOR(dev
));
566 EXPORT_SYMBOL(bdi_register_dev
);
569 * Remove bdi from the global list and shutdown any threads we have running
571 static void bdi_wb_shutdown(struct backing_dev_info
*bdi
)
573 if (!bdi_cap_writeback_dirty(bdi
))
577 * Make sure nobody finds us on the bdi_list anymore
579 bdi_remove_from_list(bdi
);
582 * If setup is pending, wait for that to complete first
584 wait_on_bit(&bdi
->state
, BDI_pending
, bdi_sched_wait
,
585 TASK_UNINTERRUPTIBLE
);
588 * Finally, kill the kernel thread. We don't need to be RCU
589 * safe anymore, since the bdi is gone from visibility. Force
590 * unfreeze of the thread before calling kthread_stop(), otherwise
591 * it would never exet if it is currently stuck in the refrigerator.
594 thaw_process(bdi
->wb
.task
);
595 kthread_stop(bdi
->wb
.task
);
600 * This bdi is going away now, make sure that no super_blocks point to it
602 static void bdi_prune_sb(struct backing_dev_info
*bdi
)
604 struct super_block
*sb
;
607 list_for_each_entry(sb
, &super_blocks
, s_list
) {
608 if (sb
->s_bdi
== bdi
)
609 sb
->s_bdi
= &default_backing_dev_info
;
611 spin_unlock(&sb_lock
);
614 void bdi_unregister(struct backing_dev_info
*bdi
)
617 bdi_set_min_ratio(bdi
, 0);
618 trace_writeback_bdi_unregister(bdi
);
620 del_timer_sync(&bdi
->wb
.wakeup_timer
);
622 if (!bdi_cap_flush_forker(bdi
))
623 bdi_wb_shutdown(bdi
);
624 bdi_debug_unregister(bdi
);
625 device_unregister(bdi
->dev
);
629 EXPORT_SYMBOL(bdi_unregister
);
631 static void bdi_wb_init(struct bdi_writeback
*wb
, struct backing_dev_info
*bdi
)
633 memset(wb
, 0, sizeof(*wb
));
636 wb
->last_old_flush
= jiffies
;
637 INIT_LIST_HEAD(&wb
->b_dirty
);
638 INIT_LIST_HEAD(&wb
->b_io
);
639 INIT_LIST_HEAD(&wb
->b_more_io
);
640 spin_lock_init(&wb
->list_lock
);
641 setup_timer(&wb
->wakeup_timer
, wakeup_timer_fn
, (unsigned long)bdi
);
645 * Initial write bandwidth: 100 MB/s
647 #define INIT_BW (100 << (20 - PAGE_SHIFT))
649 int bdi_init(struct backing_dev_info
*bdi
)
656 bdi
->max_ratio
= 100;
657 bdi
->max_prop_frac
= PROP_FRAC_BASE
;
658 spin_lock_init(&bdi
->wb_lock
);
659 INIT_LIST_HEAD(&bdi
->bdi_list
);
660 INIT_LIST_HEAD(&bdi
->work_list
);
662 bdi_wb_init(&bdi
->wb
, bdi
);
664 for (i
= 0; i
< NR_BDI_STAT_ITEMS
; i
++) {
665 err
= percpu_counter_init(&bdi
->bdi_stat
[i
], 0);
670 bdi
->dirty_exceeded
= 0;
672 bdi
->bw_time_stamp
= jiffies
;
673 bdi
->written_stamp
= 0;
675 bdi
->write_bandwidth
= INIT_BW
;
676 bdi
->avg_write_bandwidth
= INIT_BW
;
678 err
= prop_local_init_percpu(&bdi
->completions
);
683 percpu_counter_destroy(&bdi
->bdi_stat
[i
]);
688 EXPORT_SYMBOL(bdi_init
);
690 void bdi_destroy(struct backing_dev_info
*bdi
)
695 * Splice our entries to the default_backing_dev_info, if this
698 if (bdi_has_dirty_io(bdi
)) {
699 struct bdi_writeback
*dst
= &default_backing_dev_info
.wb
;
701 bdi_lock_two(&bdi
->wb
, dst
);
702 list_splice(&bdi
->wb
.b_dirty
, &dst
->b_dirty
);
703 list_splice(&bdi
->wb
.b_io
, &dst
->b_io
);
704 list_splice(&bdi
->wb
.b_more_io
, &dst
->b_more_io
);
705 spin_unlock(&bdi
->wb
.list_lock
);
706 spin_unlock(&dst
->list_lock
);
711 for (i
= 0; i
< NR_BDI_STAT_ITEMS
; i
++)
712 percpu_counter_destroy(&bdi
->bdi_stat
[i
]);
714 prop_local_destroy_percpu(&bdi
->completions
);
716 EXPORT_SYMBOL(bdi_destroy
);
719 * For use from filesystems to quickly init and register a bdi associated
720 * with dirty writeback
722 int bdi_setup_and_register(struct backing_dev_info
*bdi
, char *name
,
729 bdi
->capabilities
= cap
;
734 sprintf(tmp
, "%.28s%s", name
, "-%d");
735 err
= bdi_register(bdi
, NULL
, tmp
, atomic_long_inc_return(&bdi_seq
));
743 EXPORT_SYMBOL(bdi_setup_and_register
);
745 static wait_queue_head_t congestion_wqh
[2] = {
746 __WAIT_QUEUE_HEAD_INITIALIZER(congestion_wqh
[0]),
747 __WAIT_QUEUE_HEAD_INITIALIZER(congestion_wqh
[1])
749 static atomic_t nr_bdi_congested
[2];
751 void clear_bdi_congested(struct backing_dev_info
*bdi
, int sync
)
754 wait_queue_head_t
*wqh
= &congestion_wqh
[sync
];
756 bit
= sync
? BDI_sync_congested
: BDI_async_congested
;
757 if (test_and_clear_bit(bit
, &bdi
->state
))
758 atomic_dec(&nr_bdi_congested
[sync
]);
759 smp_mb__after_clear_bit();
760 if (waitqueue_active(wqh
))
763 EXPORT_SYMBOL(clear_bdi_congested
);
765 void set_bdi_congested(struct backing_dev_info
*bdi
, int sync
)
769 bit
= sync
? BDI_sync_congested
: BDI_async_congested
;
770 if (!test_and_set_bit(bit
, &bdi
->state
))
771 atomic_inc(&nr_bdi_congested
[sync
]);
773 EXPORT_SYMBOL(set_bdi_congested
);
776 * congestion_wait - wait for a backing_dev to become uncongested
777 * @sync: SYNC or ASYNC IO
778 * @timeout: timeout in jiffies
780 * Waits for up to @timeout jiffies for a backing_dev (any backing_dev) to exit
781 * write congestion. If no backing_devs are congested then just wait for the
782 * next write to be completed.
784 long congestion_wait(int sync
, long timeout
)
787 unsigned long start
= jiffies
;
789 wait_queue_head_t
*wqh
= &congestion_wqh
[sync
];
791 prepare_to_wait(wqh
, &wait
, TASK_UNINTERRUPTIBLE
);
792 ret
= io_schedule_timeout(timeout
);
793 finish_wait(wqh
, &wait
);
795 trace_writeback_congestion_wait(jiffies_to_usecs(timeout
),
796 jiffies_to_usecs(jiffies
- start
));
800 EXPORT_SYMBOL(congestion_wait
);
803 * wait_iff_congested - Conditionally wait for a backing_dev to become uncongested or a zone to complete writes
804 * @zone: A zone to check if it is heavily congested
805 * @sync: SYNC or ASYNC IO
806 * @timeout: timeout in jiffies
808 * In the event of a congested backing_dev (any backing_dev) and the given
809 * @zone has experienced recent congestion, this waits for up to @timeout
810 * jiffies for either a BDI to exit congestion of the given @sync queue
811 * or a write to complete.
813 * In the absence of zone congestion, cond_resched() is called to yield
814 * the processor if necessary but otherwise does not sleep.
816 * The return value is 0 if the sleep is for the full timeout. Otherwise,
817 * it is the number of jiffies that were still remaining when the function
818 * returned. return_value == timeout implies the function did not sleep.
820 long wait_iff_congested(struct zone
*zone
, int sync
, long timeout
)
823 unsigned long start
= jiffies
;
825 wait_queue_head_t
*wqh
= &congestion_wqh
[sync
];
828 * If there is no congestion, or heavy congestion is not being
829 * encountered in the current zone, yield if necessary instead
830 * of sleeping on the congestion queue
832 if (atomic_read(&nr_bdi_congested
[sync
]) == 0 ||
833 !zone_is_reclaim_congested(zone
)) {
836 /* In case we scheduled, work out time remaining */
837 ret
= timeout
- (jiffies
- start
);
844 /* Sleep until uncongested or a write happens */
845 prepare_to_wait(wqh
, &wait
, TASK_UNINTERRUPTIBLE
);
846 ret
= io_schedule_timeout(timeout
);
847 finish_wait(wqh
, &wait
);
850 trace_writeback_wait_iff_congested(jiffies_to_usecs(timeout
),
851 jiffies_to_usecs(jiffies
- start
));
855 EXPORT_SYMBOL(wait_iff_congested
);