mm/backing-dev.c

   1
   2 #include <linux/wait.h>
   3 #include <linux/backing-dev.h>
   4 #include <linux/kthread.h>
   5 #include <linux/freezer.h>
   6 #include <linux/fs.h>
   7 #include <linux/pagemap.h>
   8 #include <linux/mm.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>
  14
  15 static atomic_long_t bdi_seq = ATOMIC_LONG_INIT(0);
  16
  17 struct backing_dev_info default_backing_dev_info = {
  18         .name           = "default",
  19         .ra_pages       = VM_MAX_READAHEAD * 1024 / PAGE_CACHE_SIZE,
  20         .state          = 0,
  21         .capabilities   = BDI_CAP_MAP_COPY,
  22 };
  23 EXPORT_SYMBOL_GPL(default_backing_dev_info);
  24
  25 struct backing_dev_info noop_backing_dev_info = {
  26         .name           = "noop",
  27         .capabilities   = BDI_CAP_NO_ACCT_AND_WRITEBACK,
  28 };
  29 EXPORT_SYMBOL_GPL(noop_backing_dev_info);
  30
  31 static struct class *bdi_class;
  32
  33 /*
  34  * bdi_lock protects updates to bdi_list. bdi_list has RCU reader side
  35  * locking.
  36  */
  37 DEFINE_SPINLOCK(bdi_lock);
  38 LIST_HEAD(bdi_list);
  39
  40 /* bdi_wq serves all asynchronous writeback tasks */
  41 struct workqueue_struct *bdi_wq;
  42
  43 void bdi_lock_two(struct bdi_writeback *wb1, struct bdi_writeback *wb2)
  44 {
  45         if (wb1 < wb2) {
  46                 spin_lock(&wb1->list_lock);
  47                 spin_lock_nested(&wb2->list_lock, 1);
  48         } else {
  49                 spin_lock(&wb2->list_lock);
  50                 spin_lock_nested(&wb1->list_lock, 1);
  51         }
  52 }
  53
  54 #ifdef CONFIG_DEBUG_FS
  55 #include <linux/debugfs.h>
  56 #include <linux/seq_file.h>
  57
  58 static struct dentry *bdi_debug_root;
  59
  60 static void bdi_debug_init(void)
  61 {
  62         bdi_debug_root = debugfs_create_dir("bdi", NULL);
  63 }
  64
  65 static int bdi_debug_stats_show(struct seq_file *m, void *v)
  66 {
  67         struct backing_dev_info *bdi = m->private;
  68         struct bdi_writeback *wb = &bdi->wb;
  69         unsigned long background_thresh;
  70         unsigned long dirty_thresh;
  71         unsigned long bdi_thresh;
  72         unsigned long nr_dirty, nr_io, nr_more_io;
  73         struct inode *inode;
  74
  75         nr_dirty = nr_io = nr_more_io = 0;
  76         spin_lock(&wb->list_lock);
  77         list_for_each_entry(inode, &wb->b_dirty, i_wb_list)
  78                 nr_dirty++;
  79         list_for_each_entry(inode, &wb->b_io, i_wb_list)
  80                 nr_io++;
  81         list_for_each_entry(inode, &wb->b_more_io, i_wb_list)
  82                 nr_more_io++;
  83         spin_unlock(&wb->list_lock);
  84
  85         global_dirty_limits(&background_thresh, &dirty_thresh);
  86         bdi_thresh = bdi_dirty_limit(bdi, dirty_thresh);
  87
  88 #define K(x) ((x) << (PAGE_SHIFT - 10))
  89         seq_printf(m,
  90                    "BdiWriteback:       %10lu kB\n"
  91                    "BdiReclaimable:     %10lu kB\n"
  92                    "BdiDirtyThresh:     %10lu kB\n"
  93                    "DirtyThresh:        %10lu kB\n"
  94                    "BackgroundThresh:   %10lu kB\n"
  95                    "BdiDirtied:         %10lu kB\n"
  96                    "BdiWritten:         %10lu kB\n"
  97                    "BdiWriteBandwidth:  %10lu kBps\n"
  98                    "b_dirty:            %10lu\n"
  99                    "b_io:               %10lu\n"
 100                    "b_more_io:          %10lu\n"
 101                    "bdi_list:           %10u\n"
 102                    "state:              %10lx\n",
 103                    (unsigned long) K(bdi_stat(bdi, BDI_WRITEBACK)),
 104                    (unsigned long) K(bdi_stat(bdi, BDI_RECLAIMABLE)),
 105                    K(bdi_thresh),
 106                    K(dirty_thresh),
 107                    K(background_thresh),
 108                    (unsigned long) K(bdi_stat(bdi, BDI_DIRTIED)),
 109                    (unsigned long) K(bdi_stat(bdi, BDI_WRITTEN)),
 110                    (unsigned long) K(bdi->write_bandwidth),
 111                    nr_dirty,
 112                    nr_io,
 113                    nr_more_io,
 114                    !list_empty(&bdi->bdi_list), bdi->state);
 115 #undef K
 116
 117         return 0;
 118 }
 119
 120 static int bdi_debug_stats_open(struct inode *inode, struct file *file)
 121 {
 122         return single_open(file, bdi_debug_stats_show, inode->i_private);
 123 }
 124
 125 static const struct file_operations bdi_debug_stats_fops = {
 126         .open           = bdi_debug_stats_open,
 127         .read           = seq_read,
 128         .llseek         = seq_lseek,
 129         .release        = single_release,
 130 };
 131
 132 static void bdi_debug_register(struct backing_dev_info *bdi, const char *name)
 133 {
 134         bdi->debug_dir = debugfs_create_dir(name, bdi_debug_root);
 135         bdi->debug_stats = debugfs_create_file("stats", 0444, bdi->debug_dir,
 136                                                bdi, &bdi_debug_stats_fops);
 137 }
 138
 139 static void bdi_debug_unregister(struct backing_dev_info *bdi)
 140 {
 141         debugfs_remove(bdi->debug_stats);
 142         debugfs_remove(bdi->debug_dir);
 143 }
 144 #else
 145 static inline void bdi_debug_init(void)
 146 {
 147 }
 148 static inline void bdi_debug_register(struct backing_dev_info *bdi,
 149                                       const char *name)
 150 {
 151 }
 152 static inline void bdi_debug_unregister(struct backing_dev_info *bdi)
 153 {
 154 }
 155 #endif
 156
 157 static ssize_t read_ahead_kb_store(struct device *dev,
 158                                   struct device_attribute *attr,
 159                                   const char *buf, size_t count)
 160 {
 161         struct backing_dev_info *bdi = dev_get_drvdata(dev);
 162         unsigned long read_ahead_kb;
 163         ssize_t ret;
 164
 165         ret = kstrtoul(buf, 10, &read_ahead_kb);
 166         if (ret < 0)
 167                 return ret;
 168
 169         bdi->ra_pages = read_ahead_kb >> (PAGE_SHIFT - 10);
 170
 171         return count;
 172 }
 173
 174 #define K(pages) ((pages) << (PAGE_SHIFT - 10))
 175
 176 #define BDI_SHOW(name, expr)                                            \
 177 static ssize_t name##_show(struct device *dev,                          \
 178                            struct device_attribute *attr, char *page)   \
 179 {                                                                       \
 180         struct backing_dev_info *bdi = dev_get_drvdata(dev);            \
 181                                                                         \
 182         return snprintf(page, PAGE_SIZE-1, "%lld\n", (long long)expr);  \
 183 }                                                                       \
 184 static DEVICE_ATTR_RW(name);
 185
 186 BDI_SHOW(read_ahead_kb, K(bdi->ra_pages))
 187
 188 static ssize_t min_ratio_store(struct device *dev,
 189                 struct device_attribute *attr, const char *buf, size_t count)
 190 {
 191         struct backing_dev_info *bdi = dev_get_drvdata(dev);
 192         unsigned int ratio;
 193         ssize_t ret;
 194
 195         ret = kstrtouint(buf, 10, &ratio);
 196         if (ret < 0)
 197                 return ret;
 198
 199         ret = bdi_set_min_ratio(bdi, ratio);
 200         if (!ret)
 201                 ret = count;
 202
 203         return ret;
 204 }
 205 BDI_SHOW(min_ratio, bdi->min_ratio)
 206
 207 static ssize_t max_ratio_store(struct device *dev,
 208                 struct device_attribute *attr, const char *buf, size_t count)
 209 {
 210         struct backing_dev_info *bdi = dev_get_drvdata(dev);
 211         unsigned int ratio;
 212         ssize_t ret;
 213
 214         ret = kstrtouint(buf, 10, &ratio);
 215         if (ret < 0)
 216                 return ret;
 217
 218         ret = bdi_set_max_ratio(bdi, ratio);
 219         if (!ret)
 220                 ret = count;
 221
 222         return ret;
 223 }
 224 BDI_SHOW(max_ratio, bdi->max_ratio)
 225
 226 static ssize_t stable_pages_required_show(struct device *dev,
 227                                           struct device_attribute *attr,
 228                                           char *page)
 229 {
 230         struct backing_dev_info *bdi = dev_get_drvdata(dev);
 231
 232         return snprintf(page, PAGE_SIZE-1, "%d\n",
 233                         bdi_cap_stable_pages_required(bdi) ? 1 : 0);
 234 }
 235 static DEVICE_ATTR_RO(stable_pages_required);
 236
 237 static ssize_t strictlimit_store(struct device *dev,
 238                 struct device_attribute *attr, const char *buf, size_t count)
 239 {
 240         struct backing_dev_info *bdi = dev_get_drvdata(dev);
 241         unsigned int val;
 242         ssize_t ret;
 243
 244         ret = kstrtouint(buf, 10, &val);
 245         if (ret < 0)
 246                 return ret;
 247
 248         switch (val) {
 249         case 0:
 250                 bdi->capabilities &= ~BDI_CAP_STRICTLIMIT;
 251                 break;
 252         case 1:
 253                 bdi->capabilities |= BDI_CAP_STRICTLIMIT;
 254                 break;
 255         default:
 256                 return -EINVAL;
 257         }
 258
 259         return count;
 260 }
 261 static ssize_t strictlimit_show(struct device *dev,
 262                 struct device_attribute *attr, char *page)
 263 {
 264         struct backing_dev_info *bdi = dev_get_drvdata(dev);
 265
 266         return snprintf(page, PAGE_SIZE-1, "%d\n",
 267                         !!(bdi->capabilities & BDI_CAP_STRICTLIMIT));
 268 }
 269 static DEVICE_ATTR_RW(strictlimit);
 270
 271 static struct attribute *bdi_dev_attrs[] = {
 272         &dev_attr_read_ahead_kb.attr,
 273         &dev_attr_min_ratio.attr,
 274         &dev_attr_max_ratio.attr,
 275         &dev_attr_stable_pages_required.attr,
 276         &dev_attr_strictlimit.attr,
 277         NULL,
 278 };
 279 ATTRIBUTE_GROUPS(bdi_dev);
 280
 281 static __init int bdi_class_init(void)
 282 {
 283         bdi_class = class_create(THIS_MODULE, "bdi");
 284         if (IS_ERR(bdi_class))
 285                 return PTR_ERR(bdi_class);
 286
 287         bdi_class->dev_groups = bdi_dev_groups;
 288         bdi_debug_init();
 289         return 0;
 290 }
 291 postcore_initcall(bdi_class_init);
 292
 293 static int __init default_bdi_init(void)
 294 {
 295         int err;
 296
 297         bdi_wq = alloc_workqueue("writeback", WQ_MEM_RECLAIM | WQ_FREEZABLE |
 298                                               WQ_UNBOUND | WQ_SYSFS, 0);
 299         if (!bdi_wq)
 300                 return -ENOMEM;
 301
 302         err = bdi_init(&default_backing_dev_info);
 303         if (!err)
 304                 bdi_register(&default_backing_dev_info, NULL, "default");
 305         err = bdi_init(&noop_backing_dev_info);
 306
 307         return err;
 308 }
 309 subsys_initcall(default_bdi_init);
 310
 311 int bdi_has_dirty_io(struct backing_dev_info *bdi)
 312 {
 313         return wb_has_dirty_io(&bdi->wb);
 314 }
 315
 316 /*
 317  * This function is used when the first inode for this bdi is marked dirty. It
 318  * wakes-up the corresponding bdi thread which should then take care of the
 319  * periodic background write-out of dirty inodes. Since the write-out would
 320  * starts only 'dirty_writeback_interval' centisecs from now anyway, we just
 321  * set up a timer which wakes the bdi thread up later.
 322  *
 323  * Note, we wouldn't bother setting up the timer, but this function is on the
 324  * fast-path (used by '__mark_inode_dirty()'), so we save few context switches
 325  * by delaying the wake-up.
 326  */
 327 void bdi_wakeup_thread_delayed(struct backing_dev_info *bdi)
 328 {
 329         unsigned long timeout;
 330
 331         timeout = msecs_to_jiffies(dirty_writeback_interval * 10);
 332         mod_delayed_work(bdi_wq, &bdi->wb.dwork, timeout);
 333 }
 334
 335 /*
 336  * Remove bdi from bdi_list, and ensure that it is no longer visible
 337  */
 338 static void bdi_remove_from_list(struct backing_dev_info *bdi)
 339 {
 340         spin_lock_bh(&bdi_lock);
 341         list_del_rcu(&bdi->bdi_list);
 342         spin_unlock_bh(&bdi_lock);
 343
 344         synchronize_rcu_expedited();
 345
 346         /* bdi_list is now unused, clear it to mark @bdi dying */
 347         INIT_LIST_HEAD(&bdi->bdi_list);
 348 }
 349
 350 int bdi_register(struct backing_dev_info *bdi, struct device *parent,
 351                 const char *fmt, ...)
 352 {
 353         va_list args;
 354         struct device *dev;
 355
 356         if (bdi->dev)   /* The driver needs to use separate queues per device */
 357                 return 0;
 358
 359         va_start(args, fmt);
 360         dev = device_create_vargs(bdi_class, parent, MKDEV(0, 0), bdi, fmt, args);
 361         va_end(args);
 362         if (IS_ERR(dev))
 363                 return PTR_ERR(dev);
 364
 365         bdi->dev = dev;
 366
 367         bdi_debug_register(bdi, dev_name(dev));
 368         set_bit(BDI_registered, &bdi->state);
 369
 370         spin_lock_bh(&bdi_lock);
 371         list_add_tail_rcu(&bdi->bdi_list, &bdi_list);
 372         spin_unlock_bh(&bdi_lock);
 373
 374         trace_writeback_bdi_register(bdi);
 375         return 0;
 376 }
 377 EXPORT_SYMBOL(bdi_register);
 378
 379 int bdi_register_dev(struct backing_dev_info *bdi, dev_t dev)
 380 {
 381         return bdi_register(bdi, NULL, "%u:%u", MAJOR(dev), MINOR(dev));
 382 }
 383 EXPORT_SYMBOL(bdi_register_dev);
 384
 385 /*
 386  * Remove bdi from the global list and shutdown any threads we have running
 387  */
 388 static void bdi_wb_shutdown(struct backing_dev_info *bdi)
 389 {
 390         if (!bdi_cap_writeback_dirty(bdi))
 391                 return;
 392
 393         /*
 394          * Make sure nobody finds us on the bdi_list anymore
 395          */
 396         bdi_remove_from_list(bdi);
 397
 398         /*
 399          * Drain work list and shutdown the delayed_work.  At this point,
 400          * @bdi->bdi_list is empty telling bdi_Writeback_workfn() that @bdi
 401          * is dying and its work_list needs to be drained no matter what.
 402          */
 403         mod_delayed_work(bdi_wq, &bdi->wb.dwork, 0);
 404         flush_delayed_work(&bdi->wb.dwork);
 405         WARN_ON(!list_empty(&bdi->work_list));
 406
 407         /*
 408          * This shouldn't be necessary unless @bdi for some reason has
 409          * unflushed dirty IO after work_list is drained.  Do it anyway
 410          * just in case.
 411          */
 412         cancel_delayed_work_sync(&bdi->wb.dwork);
 413 }
 414
 415 /*
 416  * This bdi is going away now, make sure that no super_blocks point to it
 417  */
 418 static void bdi_prune_sb(struct backing_dev_info *bdi)
 419 {
 420         struct super_block *sb;
 421
 422         spin_lock(&sb_lock);
 423         list_for_each_entry(sb, &super_blocks, s_list) {
 424                 if (sb->s_bdi == bdi)
 425                         sb->s_bdi = &default_backing_dev_info;
 426         }
 427         spin_unlock(&sb_lock);
 428 }
 429
 430 void bdi_unregister(struct backing_dev_info *bdi)
 431 {
 432         struct device *dev = bdi->dev;
 433
 434         if (dev) {
 435                 bdi_set_min_ratio(bdi, 0);
 436                 trace_writeback_bdi_unregister(bdi);
 437                 bdi_prune_sb(bdi);
 438
 439                 bdi_wb_shutdown(bdi);
 440                 bdi_debug_unregister(bdi);
 441
 442                 spin_lock_bh(&bdi->wb_lock);
 443                 bdi->dev = NULL;
 444                 spin_unlock_bh(&bdi->wb_lock);
 445
 446                 device_unregister(dev);
 447         }
 448 }
 449 EXPORT_SYMBOL(bdi_unregister);
 450
 451 static void bdi_wb_init(struct bdi_writeback *wb, struct backing_dev_info *bdi)
 452 {
 453         memset(wb, 0, sizeof(*wb));
 454
 455         wb->bdi = bdi;
 456         wb->last_old_flush = jiffies;
 457         INIT_LIST_HEAD(&wb->b_dirty);
 458         INIT_LIST_HEAD(&wb->b_io);
 459         INIT_LIST_HEAD(&wb->b_more_io);
 460         spin_lock_init(&wb->list_lock);
 461         INIT_DELAYED_WORK(&wb->dwork, bdi_writeback_workfn);
 462 }
 463
 464 /*
 465  * Initial write bandwidth: 100 MB/s
 466  */
 467 #define INIT_BW         (100 << (20 - PAGE_SHIFT))
 468
 469 int bdi_init(struct backing_dev_info *bdi)
 470 {
 471         int i, err;
 472
 473         bdi->dev = NULL;
 474
 475         bdi->min_ratio = 0;
 476         bdi->max_ratio = 100;
 477         bdi->max_prop_frac = FPROP_FRAC_BASE;
 478         spin_lock_init(&bdi->wb_lock);
 479         INIT_LIST_HEAD(&bdi->bdi_list);
 480         INIT_LIST_HEAD(&bdi->work_list);
 481
 482         bdi_wb_init(&bdi->wb, bdi);
 483
 484         for (i = 0; i < NR_BDI_STAT_ITEMS; i++) {
 485                 err = percpu_counter_init(&bdi->bdi_stat[i], 0);
 486                 if (err)
 487                         goto err;
 488         }
 489
 490         bdi->dirty_exceeded = 0;
 491
 492         bdi->bw_time_stamp = jiffies;
 493         bdi->written_stamp = 0;
 494
 495         bdi->balanced_dirty_ratelimit = INIT_BW;
 496         bdi->dirty_ratelimit = INIT_BW;
 497         bdi->write_bandwidth = INIT_BW;
 498         bdi->avg_write_bandwidth = INIT_BW;
 499
 500         err = fprop_local_init_percpu(&bdi->completions);
 501
 502         if (err) {
 503 err:
 504                 while (i--)
 505                         percpu_counter_destroy(&bdi->bdi_stat[i]);
 506         }
 507
 508         return err;
 509 }
 510 EXPORT_SYMBOL(bdi_init);
 511
 512 void bdi_destroy(struct backing_dev_info *bdi)
 513 {
 514         int i;
 515
 516         /*
 517          * Splice our entries to the default_backing_dev_info, if this
 518          * bdi disappears
 519          */
 520         if (bdi_has_dirty_io(bdi)) {
 521                 struct bdi_writeback *dst = &default_backing_dev_info.wb;
 522
 523                 bdi_lock_two(&bdi->wb, dst);
 524                 list_splice(&bdi->wb.b_dirty, &dst->b_dirty);
 525                 list_splice(&bdi->wb.b_io, &dst->b_io);
 526                 list_splice(&bdi->wb.b_more_io, &dst->b_more_io);
 527                 spin_unlock(&bdi->wb.list_lock);
 528                 spin_unlock(&dst->list_lock);
 529         }
 530
 531         bdi_unregister(bdi);
 532
 533         /*
 534          * If bdi_unregister() had already been called earlier, the dwork
 535          * could still be pending because bdi_prune_sb() can race with the
 536          * bdi_wakeup_thread_delayed() calls from __mark_inode_dirty().
 537          */
 538         cancel_delayed_work_sync(&bdi->wb.dwork);
 539
 540         for (i = 0; i < NR_BDI_STAT_ITEMS; i++)
 541                 percpu_counter_destroy(&bdi->bdi_stat[i]);
 542
 543         fprop_local_destroy_percpu(&bdi->completions);
 544 }
 545 EXPORT_SYMBOL(bdi_destroy);
 546
 547 /*
 548  * For use from filesystems to quickly init and register a bdi associated
 549  * with dirty writeback
 550  */
 551 int bdi_setup_and_register(struct backing_dev_info *bdi, char *name,
 552                            unsigned int cap)
 553 {
 554         int err;
 555
 556         bdi->name = name;
 557         bdi->capabilities = cap;
 558         err = bdi_init(bdi);
 559         if (err)
 560                 return err;
 561
 562         err = bdi_register(bdi, NULL, "%.28s-%ld", name,
 563                            atomic_long_inc_return(&bdi_seq));
 564         if (err) {
 565                 bdi_destroy(bdi);
 566                 return err;
 567         }
 568
 569         return 0;
 570 }
 571 EXPORT_SYMBOL(bdi_setup_and_register);
 572
 573 static wait_queue_head_t congestion_wqh[2] = {
 574                 __WAIT_QUEUE_HEAD_INITIALIZER(congestion_wqh[0]),
 575                 __WAIT_QUEUE_HEAD_INITIALIZER(congestion_wqh[1])
 576         };
 577 static atomic_t nr_bdi_congested[2];
 578
 579 void clear_bdi_congested(struct backing_dev_info *bdi, int sync)
 580 {
 581         enum bdi_state bit;
 582         wait_queue_head_t *wqh = &congestion_wqh[sync];
 583
 584         bit = sync ? BDI_sync_congested : BDI_async_congested;
 585         if (test_and_clear_bit(bit, &bdi->state))
 586                 atomic_dec(&nr_bdi_congested[sync]);
 587         smp_mb__after_clear_bit();
 588         if (waitqueue_active(wqh))
 589                 wake_up(wqh);
 590 }
 591 EXPORT_SYMBOL(clear_bdi_congested);
 592
 593 void set_bdi_congested(struct backing_dev_info *bdi, int sync)
 594 {
 595         enum bdi_state bit;
 596
 597         bit = sync ? BDI_sync_congested : BDI_async_congested;
 598         if (!test_and_set_bit(bit, &bdi->state))
 599                 atomic_inc(&nr_bdi_congested[sync]);
 600 }
 601 EXPORT_SYMBOL(set_bdi_congested);
 602
 603 /**
 604  * congestion_wait - wait for a backing_dev to become uncongested
 605  * @sync: SYNC or ASYNC IO
 606  * @timeout: timeout in jiffies
 607  *
 608  * Waits for up to @timeout jiffies for a backing_dev (any backing_dev) to exit
 609  * write congestion.  If no backing_devs are congested then just wait for the
 610  * next write to be completed.
 611  */
 612 long congestion_wait(int sync, long timeout)
 613 {
 614         long ret;
 615         unsigned long start = jiffies;
 616         DEFINE_WAIT(wait);
 617         wait_queue_head_t *wqh = &congestion_wqh[sync];
 618
 619         prepare_to_wait(wqh, &wait, TASK_UNINTERRUPTIBLE);
 620         ret = io_schedule_timeout(timeout);
 621         finish_wait(wqh, &wait);
 622
 623         trace_writeback_congestion_wait(jiffies_to_usecs(timeout),
 624                                         jiffies_to_usecs(jiffies - start));
 625
 626         return ret;
 627 }
 628 EXPORT_SYMBOL(congestion_wait);
 629
 630 /**
 631  * wait_iff_congested - Conditionally wait for a backing_dev to become uncongested or a zone to complete writes
 632  * @zone: A zone to check if it is heavily congested
 633  * @sync: SYNC or ASYNC IO
 634  * @timeout: timeout in jiffies
 635  *
 636  * In the event of a congested backing_dev (any backing_dev) and the given
 637  * @zone has experienced recent congestion, this waits for up to @timeout
 638  * jiffies for either a BDI to exit congestion of the given @sync queue
 639  * or a write to complete.
 640  *
 641  * In the absence of zone congestion, cond_resched() is called to yield
 642  * the processor if necessary but otherwise does not sleep.
 643  *
 644  * The return value is 0 if the sleep is for the full timeout. Otherwise,
 645  * it is the number of jiffies that were still remaining when the function
 646  * returned. return_value == timeout implies the function did not sleep.
 647  */
 648 long wait_iff_congested(struct zone *zone, int sync, long timeout)
 649 {
 650         long ret;
 651         unsigned long start = jiffies;
 652         DEFINE_WAIT(wait);
 653         wait_queue_head_t *wqh = &congestion_wqh[sync];
 654
 655         /*
 656          * If there is no congestion, or heavy congestion is not being
 657          * encountered in the current zone, yield if necessary instead
 658          * of sleeping on the congestion queue
 659          */
 660         if (atomic_read(&nr_bdi_congested[sync]) == 0 ||
 661                         !zone_is_reclaim_congested(zone)) {
 662                 cond_resched();
 663
 664                 /* In case we scheduled, work out time remaining */
 665                 ret = timeout - (jiffies - start);
 666                 if (ret < 0)
 667                         ret = 0;
 668
 669                 goto out;
 670         }
 671
 672         /* Sleep until uncongested or a write happens */
 673         prepare_to_wait(wqh, &wait, TASK_UNINTERRUPTIBLE);
 674         ret = io_schedule_timeout(timeout);
 675         finish_wait(wqh, &wait);
 676
 677 out:
 678         trace_writeback_wait_iff_congested(jiffies_to_usecs(timeout),
 679                                         jiffies_to_usecs(jiffies - start));
 680
 681         return ret;
 682 }
 683 EXPORT_SYMBOL(wait_iff_congested);
 684
 685 int pdflush_proc_obsolete(struct ctl_table *table, int write,
 686                         void __user *buffer, size_t *lenp, loff_t *ppos)
 687 {
 688         char kbuf[] = "0\n";
 689
 690         if (*ppos || *lenp < sizeof(kbuf)) {
 691                 *lenp = 0;
 692                 return 0;
 693         }
 694
 695         if (copy_to_user(buffer, kbuf, sizeof(kbuf)))
 696                 return -EFAULT;
 697         printk_once(KERN_WARNING "%s exported in /proc is scheduled for removal\n",
 698                         table->procname);
 699
 700         *lenp = 2;
 701         *ppos += *lenp;
 702         return 2;
 703 }