vfs: Create __block_page_mkwrite() helper passing error values back
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / fs / buffer.c
blobf6ad8f9b8fa5d91f8752aea209d472049416c41d
1 /*
2 * linux/fs/buffer.c
4 * Copyright (C) 1991, 1992, 2002 Linus Torvalds
5 */
7 /*
8 * Start bdflush() with kernel_thread not syscall - Paul Gortmaker, 12/95
10 * Removed a lot of unnecessary code and simplified things now that
11 * the buffer cache isn't our primary cache - Andrew Tridgell 12/96
13 * Speed up hash, lru, and free list operations. Use gfp() for allocating
14 * hash table, use SLAB cache for buffer heads. SMP threading. -DaveM
16 * Added 32k buffer block sizes - these are required older ARM systems. - RMK
18 * async buffer flushing, 1999 Andrea Arcangeli <andrea@suse.de>
21 #include <linux/kernel.h>
22 #include <linux/syscalls.h>
23 #include <linux/fs.h>
24 #include <linux/mm.h>
25 #include <linux/percpu.h>
26 #include <linux/slab.h>
27 #include <linux/capability.h>
28 #include <linux/blkdev.h>
29 #include <linux/file.h>
30 #include <linux/quotaops.h>
31 #include <linux/highmem.h>
32 #include <linux/module.h>
33 #include <linux/writeback.h>
34 #include <linux/hash.h>
35 #include <linux/suspend.h>
36 #include <linux/buffer_head.h>
37 #include <linux/task_io_accounting_ops.h>
38 #include <linux/bio.h>
39 #include <linux/notifier.h>
40 #include <linux/cpu.h>
41 #include <linux/bitops.h>
42 #include <linux/mpage.h>
43 #include <linux/bit_spinlock.h>
45 static int fsync_buffers_list(spinlock_t *lock, struct list_head *list);
47 #define BH_ENTRY(list) list_entry((list), struct buffer_head, b_assoc_buffers)
49 inline void
50 init_buffer(struct buffer_head *bh, bh_end_io_t *handler, void *private)
52 bh->b_end_io = handler;
53 bh->b_private = private;
55 EXPORT_SYMBOL(init_buffer);
57 static int sleep_on_buffer(void *word)
59 io_schedule();
60 return 0;
63 void __lock_buffer(struct buffer_head *bh)
65 wait_on_bit_lock(&bh->b_state, BH_Lock, sleep_on_buffer,
66 TASK_UNINTERRUPTIBLE);
68 EXPORT_SYMBOL(__lock_buffer);
70 void unlock_buffer(struct buffer_head *bh)
72 clear_bit_unlock(BH_Lock, &bh->b_state);
73 smp_mb__after_clear_bit();
74 wake_up_bit(&bh->b_state, BH_Lock);
76 EXPORT_SYMBOL(unlock_buffer);
79 * Block until a buffer comes unlocked. This doesn't stop it
80 * from becoming locked again - you have to lock it yourself
81 * if you want to preserve its state.
83 void __wait_on_buffer(struct buffer_head * bh)
85 wait_on_bit(&bh->b_state, BH_Lock, sleep_on_buffer, TASK_UNINTERRUPTIBLE);
87 EXPORT_SYMBOL(__wait_on_buffer);
89 static void
90 __clear_page_buffers(struct page *page)
92 ClearPagePrivate(page);
93 set_page_private(page, 0);
94 page_cache_release(page);
98 static int quiet_error(struct buffer_head *bh)
100 if (!test_bit(BH_Quiet, &bh->b_state) && printk_ratelimit())
101 return 0;
102 return 1;
106 static void buffer_io_error(struct buffer_head *bh)
108 char b[BDEVNAME_SIZE];
109 printk(KERN_ERR "Buffer I/O error on device %s, logical block %Lu\n",
110 bdevname(bh->b_bdev, b),
111 (unsigned long long)bh->b_blocknr);
115 * End-of-IO handler helper function which does not touch the bh after
116 * unlocking it.
117 * Note: unlock_buffer() sort-of does touch the bh after unlocking it, but
118 * a race there is benign: unlock_buffer() only use the bh's address for
119 * hashing after unlocking the buffer, so it doesn't actually touch the bh
120 * itself.
122 static void __end_buffer_read_notouch(struct buffer_head *bh, int uptodate)
124 if (uptodate) {
125 set_buffer_uptodate(bh);
126 } else {
127 /* This happens, due to failed READA attempts. */
128 clear_buffer_uptodate(bh);
130 unlock_buffer(bh);
134 * Default synchronous end-of-IO handler.. Just mark it up-to-date and
135 * unlock the buffer. This is what ll_rw_block uses too.
137 void end_buffer_read_sync(struct buffer_head *bh, int uptodate)
139 __end_buffer_read_notouch(bh, uptodate);
140 put_bh(bh);
142 EXPORT_SYMBOL(end_buffer_read_sync);
144 void end_buffer_write_sync(struct buffer_head *bh, int uptodate)
146 char b[BDEVNAME_SIZE];
148 if (uptodate) {
149 set_buffer_uptodate(bh);
150 } else {
151 if (!quiet_error(bh)) {
152 buffer_io_error(bh);
153 printk(KERN_WARNING "lost page write due to "
154 "I/O error on %s\n",
155 bdevname(bh->b_bdev, b));
157 set_buffer_write_io_error(bh);
158 clear_buffer_uptodate(bh);
160 unlock_buffer(bh);
161 put_bh(bh);
163 EXPORT_SYMBOL(end_buffer_write_sync);
166 * Various filesystems appear to want __find_get_block to be non-blocking.
167 * But it's the page lock which protects the buffers. To get around this,
168 * we get exclusion from try_to_free_buffers with the blockdev mapping's
169 * private_lock.
171 * Hack idea: for the blockdev mapping, i_bufferlist_lock contention
172 * may be quite high. This code could TryLock the page, and if that
173 * succeeds, there is no need to take private_lock. (But if
174 * private_lock is contended then so is mapping->tree_lock).
176 static struct buffer_head *
177 __find_get_block_slow(struct block_device *bdev, sector_t block)
179 struct inode *bd_inode = bdev->bd_inode;
180 struct address_space *bd_mapping = bd_inode->i_mapping;
181 struct buffer_head *ret = NULL;
182 pgoff_t index;
183 struct buffer_head *bh;
184 struct buffer_head *head;
185 struct page *page;
186 int all_mapped = 1;
188 index = block >> (PAGE_CACHE_SHIFT - bd_inode->i_blkbits);
189 page = find_get_page(bd_mapping, index);
190 if (!page)
191 goto out;
193 spin_lock(&bd_mapping->private_lock);
194 if (!page_has_buffers(page))
195 goto out_unlock;
196 head = page_buffers(page);
197 bh = head;
198 do {
199 if (!buffer_mapped(bh))
200 all_mapped = 0;
201 else if (bh->b_blocknr == block) {
202 ret = bh;
203 get_bh(bh);
204 goto out_unlock;
206 bh = bh->b_this_page;
207 } while (bh != head);
209 /* we might be here because some of the buffers on this page are
210 * not mapped. This is due to various races between
211 * file io on the block device and getblk. It gets dealt with
212 * elsewhere, don't buffer_error if we had some unmapped buffers
214 if (all_mapped) {
215 printk("__find_get_block_slow() failed. "
216 "block=%llu, b_blocknr=%llu\n",
217 (unsigned long long)block,
218 (unsigned long long)bh->b_blocknr);
219 printk("b_state=0x%08lx, b_size=%zu\n",
220 bh->b_state, bh->b_size);
221 printk("device blocksize: %d\n", 1 << bd_inode->i_blkbits);
223 out_unlock:
224 spin_unlock(&bd_mapping->private_lock);
225 page_cache_release(page);
226 out:
227 return ret;
230 /* If invalidate_buffers() will trash dirty buffers, it means some kind
231 of fs corruption is going on. Trashing dirty data always imply losing
232 information that was supposed to be just stored on the physical layer
233 by the user.
235 Thus invalidate_buffers in general usage is not allwowed to trash
236 dirty buffers. For example ioctl(FLSBLKBUF) expects dirty data to
237 be preserved. These buffers are simply skipped.
239 We also skip buffers which are still in use. For example this can
240 happen if a userspace program is reading the block device.
242 NOTE: In the case where the user removed a removable-media-disk even if
243 there's still dirty data not synced on disk (due a bug in the device driver
244 or due an error of the user), by not destroying the dirty buffers we could
245 generate corruption also on the next media inserted, thus a parameter is
246 necessary to handle this case in the most safe way possible (trying
247 to not corrupt also the new disk inserted with the data belonging to
248 the old now corrupted disk). Also for the ramdisk the natural thing
249 to do in order to release the ramdisk memory is to destroy dirty buffers.
251 These are two special cases. Normal usage imply the device driver
252 to issue a sync on the device (without waiting I/O completion) and
253 then an invalidate_buffers call that doesn't trash dirty buffers.
255 For handling cache coherency with the blkdev pagecache the 'update' case
256 is been introduced. It is needed to re-read from disk any pinned
257 buffer. NOTE: re-reading from disk is destructive so we can do it only
258 when we assume nobody is changing the buffercache under our I/O and when
259 we think the disk contains more recent information than the buffercache.
260 The update == 1 pass marks the buffers we need to update, the update == 2
261 pass does the actual I/O. */
262 void invalidate_bdev(struct block_device *bdev)
264 struct address_space *mapping = bdev->bd_inode->i_mapping;
266 if (mapping->nrpages == 0)
267 return;
269 invalidate_bh_lrus();
270 lru_add_drain_all(); /* make sure all lru add caches are flushed */
271 invalidate_mapping_pages(mapping, 0, -1);
273 EXPORT_SYMBOL(invalidate_bdev);
276 * Kick the writeback threads then try to free up some ZONE_NORMAL memory.
278 static void free_more_memory(void)
280 struct zone *zone;
281 int nid;
283 wakeup_flusher_threads(1024);
284 yield();
286 for_each_online_node(nid) {
287 (void)first_zones_zonelist(node_zonelist(nid, GFP_NOFS),
288 gfp_zone(GFP_NOFS), NULL,
289 &zone);
290 if (zone)
291 try_to_free_pages(node_zonelist(nid, GFP_NOFS), 0,
292 GFP_NOFS, NULL);
297 * I/O completion handler for block_read_full_page() - pages
298 * which come unlocked at the end of I/O.
300 static void end_buffer_async_read(struct buffer_head *bh, int uptodate)
302 unsigned long flags;
303 struct buffer_head *first;
304 struct buffer_head *tmp;
305 struct page *page;
306 int page_uptodate = 1;
308 BUG_ON(!buffer_async_read(bh));
310 page = bh->b_page;
311 if (uptodate) {
312 set_buffer_uptodate(bh);
313 } else {
314 clear_buffer_uptodate(bh);
315 if (!quiet_error(bh))
316 buffer_io_error(bh);
317 SetPageError(page);
321 * Be _very_ careful from here on. Bad things can happen if
322 * two buffer heads end IO at almost the same time and both
323 * decide that the page is now completely done.
325 first = page_buffers(page);
326 local_irq_save(flags);
327 bit_spin_lock(BH_Uptodate_Lock, &first->b_state);
328 clear_buffer_async_read(bh);
329 unlock_buffer(bh);
330 tmp = bh;
331 do {
332 if (!buffer_uptodate(tmp))
333 page_uptodate = 0;
334 if (buffer_async_read(tmp)) {
335 BUG_ON(!buffer_locked(tmp));
336 goto still_busy;
338 tmp = tmp->b_this_page;
339 } while (tmp != bh);
340 bit_spin_unlock(BH_Uptodate_Lock, &first->b_state);
341 local_irq_restore(flags);
344 * If none of the buffers had errors and they are all
345 * uptodate then we can set the page uptodate.
347 if (page_uptodate && !PageError(page))
348 SetPageUptodate(page);
349 unlock_page(page);
350 return;
352 still_busy:
353 bit_spin_unlock(BH_Uptodate_Lock, &first->b_state);
354 local_irq_restore(flags);
355 return;
359 * Completion handler for block_write_full_page() - pages which are unlocked
360 * during I/O, and which have PageWriteback cleared upon I/O completion.
362 void end_buffer_async_write(struct buffer_head *bh, int uptodate)
364 char b[BDEVNAME_SIZE];
365 unsigned long flags;
366 struct buffer_head *first;
367 struct buffer_head *tmp;
368 struct page *page;
370 BUG_ON(!buffer_async_write(bh));
372 page = bh->b_page;
373 if (uptodate) {
374 set_buffer_uptodate(bh);
375 } else {
376 if (!quiet_error(bh)) {
377 buffer_io_error(bh);
378 printk(KERN_WARNING "lost page write due to "
379 "I/O error on %s\n",
380 bdevname(bh->b_bdev, b));
382 set_bit(AS_EIO, &page->mapping->flags);
383 set_buffer_write_io_error(bh);
384 clear_buffer_uptodate(bh);
385 SetPageError(page);
388 first = page_buffers(page);
389 local_irq_save(flags);
390 bit_spin_lock(BH_Uptodate_Lock, &first->b_state);
392 clear_buffer_async_write(bh);
393 unlock_buffer(bh);
394 tmp = bh->b_this_page;
395 while (tmp != bh) {
396 if (buffer_async_write(tmp)) {
397 BUG_ON(!buffer_locked(tmp));
398 goto still_busy;
400 tmp = tmp->b_this_page;
402 bit_spin_unlock(BH_Uptodate_Lock, &first->b_state);
403 local_irq_restore(flags);
404 end_page_writeback(page);
405 return;
407 still_busy:
408 bit_spin_unlock(BH_Uptodate_Lock, &first->b_state);
409 local_irq_restore(flags);
410 return;
412 EXPORT_SYMBOL(end_buffer_async_write);
415 * If a page's buffers are under async readin (end_buffer_async_read
416 * completion) then there is a possibility that another thread of
417 * control could lock one of the buffers after it has completed
418 * but while some of the other buffers have not completed. This
419 * locked buffer would confuse end_buffer_async_read() into not unlocking
420 * the page. So the absence of BH_Async_Read tells end_buffer_async_read()
421 * that this buffer is not under async I/O.
423 * The page comes unlocked when it has no locked buffer_async buffers
424 * left.
426 * PageLocked prevents anyone starting new async I/O reads any of
427 * the buffers.
429 * PageWriteback is used to prevent simultaneous writeout of the same
430 * page.
432 * PageLocked prevents anyone from starting writeback of a page which is
433 * under read I/O (PageWriteback is only ever set against a locked page).
435 static void mark_buffer_async_read(struct buffer_head *bh)
437 bh->b_end_io = end_buffer_async_read;
438 set_buffer_async_read(bh);
441 static void mark_buffer_async_write_endio(struct buffer_head *bh,
442 bh_end_io_t *handler)
444 bh->b_end_io = handler;
445 set_buffer_async_write(bh);
448 void mark_buffer_async_write(struct buffer_head *bh)
450 mark_buffer_async_write_endio(bh, end_buffer_async_write);
452 EXPORT_SYMBOL(mark_buffer_async_write);
456 * fs/buffer.c contains helper functions for buffer-backed address space's
457 * fsync functions. A common requirement for buffer-based filesystems is
458 * that certain data from the backing blockdev needs to be written out for
459 * a successful fsync(). For example, ext2 indirect blocks need to be
460 * written back and waited upon before fsync() returns.
462 * The functions mark_buffer_inode_dirty(), fsync_inode_buffers(),
463 * inode_has_buffers() and invalidate_inode_buffers() are provided for the
464 * management of a list of dependent buffers at ->i_mapping->private_list.
466 * Locking is a little subtle: try_to_free_buffers() will remove buffers
467 * from their controlling inode's queue when they are being freed. But
468 * try_to_free_buffers() will be operating against the *blockdev* mapping
469 * at the time, not against the S_ISREG file which depends on those buffers.
470 * So the locking for private_list is via the private_lock in the address_space
471 * which backs the buffers. Which is different from the address_space
472 * against which the buffers are listed. So for a particular address_space,
473 * mapping->private_lock does *not* protect mapping->private_list! In fact,
474 * mapping->private_list will always be protected by the backing blockdev's
475 * ->private_lock.
477 * Which introduces a requirement: all buffers on an address_space's
478 * ->private_list must be from the same address_space: the blockdev's.
480 * address_spaces which do not place buffers at ->private_list via these
481 * utility functions are free to use private_lock and private_list for
482 * whatever they want. The only requirement is that list_empty(private_list)
483 * be true at clear_inode() time.
485 * FIXME: clear_inode should not call invalidate_inode_buffers(). The
486 * filesystems should do that. invalidate_inode_buffers() should just go
487 * BUG_ON(!list_empty).
489 * FIXME: mark_buffer_dirty_inode() is a data-plane operation. It should
490 * take an address_space, not an inode. And it should be called
491 * mark_buffer_dirty_fsync() to clearly define why those buffers are being
492 * queued up.
494 * FIXME: mark_buffer_dirty_inode() doesn't need to add the buffer to the
495 * list if it is already on a list. Because if the buffer is on a list,
496 * it *must* already be on the right one. If not, the filesystem is being
497 * silly. This will save a ton of locking. But first we have to ensure
498 * that buffers are taken *off* the old inode's list when they are freed
499 * (presumably in truncate). That requires careful auditing of all
500 * filesystems (do it inside bforget()). It could also be done by bringing
501 * b_inode back.
505 * The buffer's backing address_space's private_lock must be held
507 static void __remove_assoc_queue(struct buffer_head *bh)
509 list_del_init(&bh->b_assoc_buffers);
510 WARN_ON(!bh->b_assoc_map);
511 if (buffer_write_io_error(bh))
512 set_bit(AS_EIO, &bh->b_assoc_map->flags);
513 bh->b_assoc_map = NULL;
516 int inode_has_buffers(struct inode *inode)
518 return !list_empty(&inode->i_data.private_list);
522 * osync is designed to support O_SYNC io. It waits synchronously for
523 * all already-submitted IO to complete, but does not queue any new
524 * writes to the disk.
526 * To do O_SYNC writes, just queue the buffer writes with ll_rw_block as
527 * you dirty the buffers, and then use osync_inode_buffers to wait for
528 * completion. Any other dirty buffers which are not yet queued for
529 * write will not be flushed to disk by the osync.
531 static int osync_buffers_list(spinlock_t *lock, struct list_head *list)
533 struct buffer_head *bh;
534 struct list_head *p;
535 int err = 0;
537 spin_lock(lock);
538 repeat:
539 list_for_each_prev(p, list) {
540 bh = BH_ENTRY(p);
541 if (buffer_locked(bh)) {
542 get_bh(bh);
543 spin_unlock(lock);
544 wait_on_buffer(bh);
545 if (!buffer_uptodate(bh))
546 err = -EIO;
547 brelse(bh);
548 spin_lock(lock);
549 goto repeat;
552 spin_unlock(lock);
553 return err;
556 static void do_thaw_one(struct super_block *sb, void *unused)
558 char b[BDEVNAME_SIZE];
559 while (sb->s_bdev && !thaw_bdev(sb->s_bdev, sb))
560 printk(KERN_WARNING "Emergency Thaw on %s\n",
561 bdevname(sb->s_bdev, b));
564 static void do_thaw_all(struct work_struct *work)
566 iterate_supers(do_thaw_one, NULL);
567 kfree(work);
568 printk(KERN_WARNING "Emergency Thaw complete\n");
572 * emergency_thaw_all -- forcibly thaw every frozen filesystem
574 * Used for emergency unfreeze of all filesystems via SysRq
576 void emergency_thaw_all(void)
578 struct work_struct *work;
580 work = kmalloc(sizeof(*work), GFP_ATOMIC);
581 if (work) {
582 INIT_WORK(work, do_thaw_all);
583 schedule_work(work);
588 * sync_mapping_buffers - write out & wait upon a mapping's "associated" buffers
589 * @mapping: the mapping which wants those buffers written
591 * Starts I/O against the buffers at mapping->private_list, and waits upon
592 * that I/O.
594 * Basically, this is a convenience function for fsync().
595 * @mapping is a file or directory which needs those buffers to be written for
596 * a successful fsync().
598 int sync_mapping_buffers(struct address_space *mapping)
600 struct address_space *buffer_mapping = mapping->assoc_mapping;
602 if (buffer_mapping == NULL || list_empty(&mapping->private_list))
603 return 0;
605 return fsync_buffers_list(&buffer_mapping->private_lock,
606 &mapping->private_list);
608 EXPORT_SYMBOL(sync_mapping_buffers);
611 * Called when we've recently written block `bblock', and it is known that
612 * `bblock' was for a buffer_boundary() buffer. This means that the block at
613 * `bblock + 1' is probably a dirty indirect block. Hunt it down and, if it's
614 * dirty, schedule it for IO. So that indirects merge nicely with their data.
616 void write_boundary_block(struct block_device *bdev,
617 sector_t bblock, unsigned blocksize)
619 struct buffer_head *bh = __find_get_block(bdev, bblock + 1, blocksize);
620 if (bh) {
621 if (buffer_dirty(bh))
622 ll_rw_block(WRITE, 1, &bh);
623 put_bh(bh);
627 void mark_buffer_dirty_inode(struct buffer_head *bh, struct inode *inode)
629 struct address_space *mapping = inode->i_mapping;
630 struct address_space *buffer_mapping = bh->b_page->mapping;
632 mark_buffer_dirty(bh);
633 if (!mapping->assoc_mapping) {
634 mapping->assoc_mapping = buffer_mapping;
635 } else {
636 BUG_ON(mapping->assoc_mapping != buffer_mapping);
638 if (!bh->b_assoc_map) {
639 spin_lock(&buffer_mapping->private_lock);
640 list_move_tail(&bh->b_assoc_buffers,
641 &mapping->private_list);
642 bh->b_assoc_map = mapping;
643 spin_unlock(&buffer_mapping->private_lock);
646 EXPORT_SYMBOL(mark_buffer_dirty_inode);
649 * Mark the page dirty, and set it dirty in the radix tree, and mark the inode
650 * dirty.
652 * If warn is true, then emit a warning if the page is not uptodate and has
653 * not been truncated.
655 static void __set_page_dirty(struct page *page,
656 struct address_space *mapping, int warn)
658 spin_lock_irq(&mapping->tree_lock);
659 if (page->mapping) { /* Race with truncate? */
660 WARN_ON_ONCE(warn && !PageUptodate(page));
661 account_page_dirtied(page, mapping);
662 radix_tree_tag_set(&mapping->page_tree,
663 page_index(page), PAGECACHE_TAG_DIRTY);
665 spin_unlock_irq(&mapping->tree_lock);
666 __mark_inode_dirty(mapping->host, I_DIRTY_PAGES);
670 * Add a page to the dirty page list.
672 * It is a sad fact of life that this function is called from several places
673 * deeply under spinlocking. It may not sleep.
675 * If the page has buffers, the uptodate buffers are set dirty, to preserve
676 * dirty-state coherency between the page and the buffers. It the page does
677 * not have buffers then when they are later attached they will all be set
678 * dirty.
680 * The buffers are dirtied before the page is dirtied. There's a small race
681 * window in which a writepage caller may see the page cleanness but not the
682 * buffer dirtiness. That's fine. If this code were to set the page dirty
683 * before the buffers, a concurrent writepage caller could clear the page dirty
684 * bit, see a bunch of clean buffers and we'd end up with dirty buffers/clean
685 * page on the dirty page list.
687 * We use private_lock to lock against try_to_free_buffers while using the
688 * page's buffer list. Also use this to protect against clean buffers being
689 * added to the page after it was set dirty.
691 * FIXME: may need to call ->reservepage here as well. That's rather up to the
692 * address_space though.
694 int __set_page_dirty_buffers(struct page *page)
696 int newly_dirty;
697 struct address_space *mapping = page_mapping(page);
699 if (unlikely(!mapping))
700 return !TestSetPageDirty(page);
702 spin_lock(&mapping->private_lock);
703 if (page_has_buffers(page)) {
704 struct buffer_head *head = page_buffers(page);
705 struct buffer_head *bh = head;
707 do {
708 set_buffer_dirty(bh);
709 bh = bh->b_this_page;
710 } while (bh != head);
712 newly_dirty = !TestSetPageDirty(page);
713 spin_unlock(&mapping->private_lock);
715 if (newly_dirty)
716 __set_page_dirty(page, mapping, 1);
717 return newly_dirty;
719 EXPORT_SYMBOL(__set_page_dirty_buffers);
722 * Write out and wait upon a list of buffers.
724 * We have conflicting pressures: we want to make sure that all
725 * initially dirty buffers get waited on, but that any subsequently
726 * dirtied buffers don't. After all, we don't want fsync to last
727 * forever if somebody is actively writing to the file.
729 * Do this in two main stages: first we copy dirty buffers to a
730 * temporary inode list, queueing the writes as we go. Then we clean
731 * up, waiting for those writes to complete.
733 * During this second stage, any subsequent updates to the file may end
734 * up refiling the buffer on the original inode's dirty list again, so
735 * there is a chance we will end up with a buffer queued for write but
736 * not yet completed on that list. So, as a final cleanup we go through
737 * the osync code to catch these locked, dirty buffers without requeuing
738 * any newly dirty buffers for write.
740 static int fsync_buffers_list(spinlock_t *lock, struct list_head *list)
742 struct buffer_head *bh;
743 struct list_head tmp;
744 struct address_space *mapping;
745 int err = 0, err2;
746 struct blk_plug plug;
748 INIT_LIST_HEAD(&tmp);
749 blk_start_plug(&plug);
751 spin_lock(lock);
752 while (!list_empty(list)) {
753 bh = BH_ENTRY(list->next);
754 mapping = bh->b_assoc_map;
755 __remove_assoc_queue(bh);
756 /* Avoid race with mark_buffer_dirty_inode() which does
757 * a lockless check and we rely on seeing the dirty bit */
758 smp_mb();
759 if (buffer_dirty(bh) || buffer_locked(bh)) {
760 list_add(&bh->b_assoc_buffers, &tmp);
761 bh->b_assoc_map = mapping;
762 if (buffer_dirty(bh)) {
763 get_bh(bh);
764 spin_unlock(lock);
766 * Ensure any pending I/O completes so that
767 * write_dirty_buffer() actually writes the
768 * current contents - it is a noop if I/O is
769 * still in flight on potentially older
770 * contents.
772 write_dirty_buffer(bh, WRITE_SYNC);
775 * Kick off IO for the previous mapping. Note
776 * that we will not run the very last mapping,
777 * wait_on_buffer() will do that for us
778 * through sync_buffer().
780 brelse(bh);
781 spin_lock(lock);
786 spin_unlock(lock);
787 blk_finish_plug(&plug);
788 spin_lock(lock);
790 while (!list_empty(&tmp)) {
791 bh = BH_ENTRY(tmp.prev);
792 get_bh(bh);
793 mapping = bh->b_assoc_map;
794 __remove_assoc_queue(bh);
795 /* Avoid race with mark_buffer_dirty_inode() which does
796 * a lockless check and we rely on seeing the dirty bit */
797 smp_mb();
798 if (buffer_dirty(bh)) {
799 list_add(&bh->b_assoc_buffers,
800 &mapping->private_list);
801 bh->b_assoc_map = mapping;
803 spin_unlock(lock);
804 wait_on_buffer(bh);
805 if (!buffer_uptodate(bh))
806 err = -EIO;
807 brelse(bh);
808 spin_lock(lock);
811 spin_unlock(lock);
812 err2 = osync_buffers_list(lock, list);
813 if (err)
814 return err;
815 else
816 return err2;
820 * Invalidate any and all dirty buffers on a given inode. We are
821 * probably unmounting the fs, but that doesn't mean we have already
822 * done a sync(). Just drop the buffers from the inode list.
824 * NOTE: we take the inode's blockdev's mapping's private_lock. Which
825 * assumes that all the buffers are against the blockdev. Not true
826 * for reiserfs.
828 void invalidate_inode_buffers(struct inode *inode)
830 if (inode_has_buffers(inode)) {
831 struct address_space *mapping = &inode->i_data;
832 struct list_head *list = &mapping->private_list;
833 struct address_space *buffer_mapping = mapping->assoc_mapping;
835 spin_lock(&buffer_mapping->private_lock);
836 while (!list_empty(list))
837 __remove_assoc_queue(BH_ENTRY(list->next));
838 spin_unlock(&buffer_mapping->private_lock);
841 EXPORT_SYMBOL(invalidate_inode_buffers);
844 * Remove any clean buffers from the inode's buffer list. This is called
845 * when we're trying to free the inode itself. Those buffers can pin it.
847 * Returns true if all buffers were removed.
849 int remove_inode_buffers(struct inode *inode)
851 int ret = 1;
853 if (inode_has_buffers(inode)) {
854 struct address_space *mapping = &inode->i_data;
855 struct list_head *list = &mapping->private_list;
856 struct address_space *buffer_mapping = mapping->assoc_mapping;
858 spin_lock(&buffer_mapping->private_lock);
859 while (!list_empty(list)) {
860 struct buffer_head *bh = BH_ENTRY(list->next);
861 if (buffer_dirty(bh)) {
862 ret = 0;
863 break;
865 __remove_assoc_queue(bh);
867 spin_unlock(&buffer_mapping->private_lock);
869 return ret;
873 * Create the appropriate buffers when given a page for data area and
874 * the size of each buffer.. Use the bh->b_this_page linked list to
875 * follow the buffers created. Return NULL if unable to create more
876 * buffers.
878 * The retry flag is used to differentiate async IO (paging, swapping)
879 * which may not fail from ordinary buffer allocations.
881 struct buffer_head *alloc_page_buffers(struct page *page, unsigned long size,
882 int retry)
884 struct buffer_head *bh, *head;
885 long offset;
887 try_again:
888 head = NULL;
889 offset = PAGE_SIZE;
890 while ((offset -= size) >= 0) {
891 bh = alloc_buffer_head(GFP_NOFS);
892 if (!bh)
893 goto no_grow;
895 bh->b_bdev = NULL;
896 bh->b_this_page = head;
897 bh->b_blocknr = -1;
898 head = bh;
900 bh->b_state = 0;
901 atomic_set(&bh->b_count, 0);
902 bh->b_size = size;
904 /* Link the buffer to its page */
905 set_bh_page(bh, page, offset);
907 init_buffer(bh, NULL, NULL);
909 return head;
911 * In case anything failed, we just free everything we got.
913 no_grow:
914 if (head) {
915 do {
916 bh = head;
917 head = head->b_this_page;
918 free_buffer_head(bh);
919 } while (head);
923 * Return failure for non-async IO requests. Async IO requests
924 * are not allowed to fail, so we have to wait until buffer heads
925 * become available. But we don't want tasks sleeping with
926 * partially complete buffers, so all were released above.
928 if (!retry)
929 return NULL;
931 /* We're _really_ low on memory. Now we just
932 * wait for old buffer heads to become free due to
933 * finishing IO. Since this is an async request and
934 * the reserve list is empty, we're sure there are
935 * async buffer heads in use.
937 free_more_memory();
938 goto try_again;
940 EXPORT_SYMBOL_GPL(alloc_page_buffers);
942 static inline void
943 link_dev_buffers(struct page *page, struct buffer_head *head)
945 struct buffer_head *bh, *tail;
947 bh = head;
948 do {
949 tail = bh;
950 bh = bh->b_this_page;
951 } while (bh);
952 tail->b_this_page = head;
953 attach_page_buffers(page, head);
957 * Initialise the state of a blockdev page's buffers.
959 static void
960 init_page_buffers(struct page *page, struct block_device *bdev,
961 sector_t block, int size)
963 struct buffer_head *head = page_buffers(page);
964 struct buffer_head *bh = head;
965 int uptodate = PageUptodate(page);
967 do {
968 if (!buffer_mapped(bh)) {
969 init_buffer(bh, NULL, NULL);
970 bh->b_bdev = bdev;
971 bh->b_blocknr = block;
972 if (uptodate)
973 set_buffer_uptodate(bh);
974 set_buffer_mapped(bh);
976 block++;
977 bh = bh->b_this_page;
978 } while (bh != head);
982 * Create the page-cache page that contains the requested block.
984 * This is user purely for blockdev mappings.
986 static struct page *
987 grow_dev_page(struct block_device *bdev, sector_t block,
988 pgoff_t index, int size)
990 struct inode *inode = bdev->bd_inode;
991 struct page *page;
992 struct buffer_head *bh;
994 page = find_or_create_page(inode->i_mapping, index,
995 (mapping_gfp_mask(inode->i_mapping) & ~__GFP_FS)|__GFP_MOVABLE);
996 if (!page)
997 return NULL;
999 BUG_ON(!PageLocked(page));
1001 if (page_has_buffers(page)) {
1002 bh = page_buffers(page);
1003 if (bh->b_size == size) {
1004 init_page_buffers(page, bdev, block, size);
1005 return page;
1007 if (!try_to_free_buffers(page))
1008 goto failed;
1012 * Allocate some buffers for this page
1014 bh = alloc_page_buffers(page, size, 0);
1015 if (!bh)
1016 goto failed;
1019 * Link the page to the buffers and initialise them. Take the
1020 * lock to be atomic wrt __find_get_block(), which does not
1021 * run under the page lock.
1023 spin_lock(&inode->i_mapping->private_lock);
1024 link_dev_buffers(page, bh);
1025 init_page_buffers(page, bdev, block, size);
1026 spin_unlock(&inode->i_mapping->private_lock);
1027 return page;
1029 failed:
1030 BUG();
1031 unlock_page(page);
1032 page_cache_release(page);
1033 return NULL;
1037 * Create buffers for the specified block device block's page. If
1038 * that page was dirty, the buffers are set dirty also.
1040 static int
1041 grow_buffers(struct block_device *bdev, sector_t block, int size)
1043 struct page *page;
1044 pgoff_t index;
1045 int sizebits;
1047 sizebits = -1;
1048 do {
1049 sizebits++;
1050 } while ((size << sizebits) < PAGE_SIZE);
1052 index = block >> sizebits;
1055 * Check for a block which wants to lie outside our maximum possible
1056 * pagecache index. (this comparison is done using sector_t types).
1058 if (unlikely(index != block >> sizebits)) {
1059 char b[BDEVNAME_SIZE];
1061 printk(KERN_ERR "%s: requested out-of-range block %llu for "
1062 "device %s\n",
1063 __func__, (unsigned long long)block,
1064 bdevname(bdev, b));
1065 return -EIO;
1067 block = index << sizebits;
1068 /* Create a page with the proper size buffers.. */
1069 page = grow_dev_page(bdev, block, index, size);
1070 if (!page)
1071 return 0;
1072 unlock_page(page);
1073 page_cache_release(page);
1074 return 1;
1077 static struct buffer_head *
1078 __getblk_slow(struct block_device *bdev, sector_t block, int size)
1080 /* Size must be multiple of hard sectorsize */
1081 if (unlikely(size & (bdev_logical_block_size(bdev)-1) ||
1082 (size < 512 || size > PAGE_SIZE))) {
1083 printk(KERN_ERR "getblk(): invalid block size %d requested\n",
1084 size);
1085 printk(KERN_ERR "logical block size: %d\n",
1086 bdev_logical_block_size(bdev));
1088 dump_stack();
1089 return NULL;
1092 for (;;) {
1093 struct buffer_head * bh;
1094 int ret;
1096 bh = __find_get_block(bdev, block, size);
1097 if (bh)
1098 return bh;
1100 ret = grow_buffers(bdev, block, size);
1101 if (ret < 0)
1102 return NULL;
1103 if (ret == 0)
1104 free_more_memory();
1109 * The relationship between dirty buffers and dirty pages:
1111 * Whenever a page has any dirty buffers, the page's dirty bit is set, and
1112 * the page is tagged dirty in its radix tree.
1114 * At all times, the dirtiness of the buffers represents the dirtiness of
1115 * subsections of the page. If the page has buffers, the page dirty bit is
1116 * merely a hint about the true dirty state.
1118 * When a page is set dirty in its entirety, all its buffers are marked dirty
1119 * (if the page has buffers).
1121 * When a buffer is marked dirty, its page is dirtied, but the page's other
1122 * buffers are not.
1124 * Also. When blockdev buffers are explicitly read with bread(), they
1125 * individually become uptodate. But their backing page remains not
1126 * uptodate - even if all of its buffers are uptodate. A subsequent
1127 * block_read_full_page() against that page will discover all the uptodate
1128 * buffers, will set the page uptodate and will perform no I/O.
1132 * mark_buffer_dirty - mark a buffer_head as needing writeout
1133 * @bh: the buffer_head to mark dirty
1135 * mark_buffer_dirty() will set the dirty bit against the buffer, then set its
1136 * backing page dirty, then tag the page as dirty in its address_space's radix
1137 * tree and then attach the address_space's inode to its superblock's dirty
1138 * inode list.
1140 * mark_buffer_dirty() is atomic. It takes bh->b_page->mapping->private_lock,
1141 * mapping->tree_lock and mapping->host->i_lock.
1143 void mark_buffer_dirty(struct buffer_head *bh)
1145 WARN_ON_ONCE(!buffer_uptodate(bh));
1148 * Very *carefully* optimize the it-is-already-dirty case.
1150 * Don't let the final "is it dirty" escape to before we
1151 * perhaps modified the buffer.
1153 if (buffer_dirty(bh)) {
1154 smp_mb();
1155 if (buffer_dirty(bh))
1156 return;
1159 if (!test_set_buffer_dirty(bh)) {
1160 struct page *page = bh->b_page;
1161 if (!TestSetPageDirty(page)) {
1162 struct address_space *mapping = page_mapping(page);
1163 if (mapping)
1164 __set_page_dirty(page, mapping, 0);
1168 EXPORT_SYMBOL(mark_buffer_dirty);
1171 * Decrement a buffer_head's reference count. If all buffers against a page
1172 * have zero reference count, are clean and unlocked, and if the page is clean
1173 * and unlocked then try_to_free_buffers() may strip the buffers from the page
1174 * in preparation for freeing it (sometimes, rarely, buffers are removed from
1175 * a page but it ends up not being freed, and buffers may later be reattached).
1177 void __brelse(struct buffer_head * buf)
1179 if (atomic_read(&buf->b_count)) {
1180 put_bh(buf);
1181 return;
1183 WARN(1, KERN_ERR "VFS: brelse: Trying to free free buffer\n");
1185 EXPORT_SYMBOL(__brelse);
1188 * bforget() is like brelse(), except it discards any
1189 * potentially dirty data.
1191 void __bforget(struct buffer_head *bh)
1193 clear_buffer_dirty(bh);
1194 if (bh->b_assoc_map) {
1195 struct address_space *buffer_mapping = bh->b_page->mapping;
1197 spin_lock(&buffer_mapping->private_lock);
1198 list_del_init(&bh->b_assoc_buffers);
1199 bh->b_assoc_map = NULL;
1200 spin_unlock(&buffer_mapping->private_lock);
1202 __brelse(bh);
1204 EXPORT_SYMBOL(__bforget);
1206 static struct buffer_head *__bread_slow(struct buffer_head *bh)
1208 lock_buffer(bh);
1209 if (buffer_uptodate(bh)) {
1210 unlock_buffer(bh);
1211 return bh;
1212 } else {
1213 get_bh(bh);
1214 bh->b_end_io = end_buffer_read_sync;
1215 submit_bh(READ, bh);
1216 wait_on_buffer(bh);
1217 if (buffer_uptodate(bh))
1218 return bh;
1220 brelse(bh);
1221 return NULL;
1225 * Per-cpu buffer LRU implementation. To reduce the cost of __find_get_block().
1226 * The bhs[] array is sorted - newest buffer is at bhs[0]. Buffers have their
1227 * refcount elevated by one when they're in an LRU. A buffer can only appear
1228 * once in a particular CPU's LRU. A single buffer can be present in multiple
1229 * CPU's LRUs at the same time.
1231 * This is a transparent caching front-end to sb_bread(), sb_getblk() and
1232 * sb_find_get_block().
1234 * The LRUs themselves only need locking against invalidate_bh_lrus. We use
1235 * a local interrupt disable for that.
1238 #define BH_LRU_SIZE 8
1240 struct bh_lru {
1241 struct buffer_head *bhs[BH_LRU_SIZE];
1244 static DEFINE_PER_CPU(struct bh_lru, bh_lrus) = {{ NULL }};
1246 #ifdef CONFIG_SMP
1247 #define bh_lru_lock() local_irq_disable()
1248 #define bh_lru_unlock() local_irq_enable()
1249 #else
1250 #define bh_lru_lock() preempt_disable()
1251 #define bh_lru_unlock() preempt_enable()
1252 #endif
1254 static inline void check_irqs_on(void)
1256 #ifdef irqs_disabled
1257 BUG_ON(irqs_disabled());
1258 #endif
1262 * The LRU management algorithm is dopey-but-simple. Sorry.
1264 static void bh_lru_install(struct buffer_head *bh)
1266 struct buffer_head *evictee = NULL;
1268 check_irqs_on();
1269 bh_lru_lock();
1270 if (__this_cpu_read(bh_lrus.bhs[0]) != bh) {
1271 struct buffer_head *bhs[BH_LRU_SIZE];
1272 int in;
1273 int out = 0;
1275 get_bh(bh);
1276 bhs[out++] = bh;
1277 for (in = 0; in < BH_LRU_SIZE; in++) {
1278 struct buffer_head *bh2 =
1279 __this_cpu_read(bh_lrus.bhs[in]);
1281 if (bh2 == bh) {
1282 __brelse(bh2);
1283 } else {
1284 if (out >= BH_LRU_SIZE) {
1285 BUG_ON(evictee != NULL);
1286 evictee = bh2;
1287 } else {
1288 bhs[out++] = bh2;
1292 while (out < BH_LRU_SIZE)
1293 bhs[out++] = NULL;
1294 memcpy(__this_cpu_ptr(&bh_lrus.bhs), bhs, sizeof(bhs));
1296 bh_lru_unlock();
1298 if (evictee)
1299 __brelse(evictee);
1303 * Look up the bh in this cpu's LRU. If it's there, move it to the head.
1305 static struct buffer_head *
1306 lookup_bh_lru(struct block_device *bdev, sector_t block, unsigned size)
1308 struct buffer_head *ret = NULL;
1309 unsigned int i;
1311 check_irqs_on();
1312 bh_lru_lock();
1313 for (i = 0; i < BH_LRU_SIZE; i++) {
1314 struct buffer_head *bh = __this_cpu_read(bh_lrus.bhs[i]);
1316 if (bh && bh->b_bdev == bdev &&
1317 bh->b_blocknr == block && bh->b_size == size) {
1318 if (i) {
1319 while (i) {
1320 __this_cpu_write(bh_lrus.bhs[i],
1321 __this_cpu_read(bh_lrus.bhs[i - 1]));
1322 i--;
1324 __this_cpu_write(bh_lrus.bhs[0], bh);
1326 get_bh(bh);
1327 ret = bh;
1328 break;
1331 bh_lru_unlock();
1332 return ret;
1336 * Perform a pagecache lookup for the matching buffer. If it's there, refresh
1337 * it in the LRU and mark it as accessed. If it is not present then return
1338 * NULL
1340 struct buffer_head *
1341 __find_get_block(struct block_device *bdev, sector_t block, unsigned size)
1343 struct buffer_head *bh = lookup_bh_lru(bdev, block, size);
1345 if (bh == NULL) {
1346 bh = __find_get_block_slow(bdev, block);
1347 if (bh)
1348 bh_lru_install(bh);
1350 if (bh)
1351 touch_buffer(bh);
1352 return bh;
1354 EXPORT_SYMBOL(__find_get_block);
1357 * __getblk will locate (and, if necessary, create) the buffer_head
1358 * which corresponds to the passed block_device, block and size. The
1359 * returned buffer has its reference count incremented.
1361 * __getblk() cannot fail - it just keeps trying. If you pass it an
1362 * illegal block number, __getblk() will happily return a buffer_head
1363 * which represents the non-existent block. Very weird.
1365 * __getblk() will lock up the machine if grow_dev_page's try_to_free_buffers()
1366 * attempt is failing. FIXME, perhaps?
1368 struct buffer_head *
1369 __getblk(struct block_device *bdev, sector_t block, unsigned size)
1371 struct buffer_head *bh = __find_get_block(bdev, block, size);
1373 might_sleep();
1374 if (bh == NULL)
1375 bh = __getblk_slow(bdev, block, size);
1376 return bh;
1378 EXPORT_SYMBOL(__getblk);
1381 * Do async read-ahead on a buffer..
1383 void __breadahead(struct block_device *bdev, sector_t block, unsigned size)
1385 struct buffer_head *bh = __getblk(bdev, block, size);
1386 if (likely(bh)) {
1387 ll_rw_block(READA, 1, &bh);
1388 brelse(bh);
1391 EXPORT_SYMBOL(__breadahead);
1394 * __bread() - reads a specified block and returns the bh
1395 * @bdev: the block_device to read from
1396 * @block: number of block
1397 * @size: size (in bytes) to read
1399 * Reads a specified block, and returns buffer head that contains it.
1400 * It returns NULL if the block was unreadable.
1402 struct buffer_head *
1403 __bread(struct block_device *bdev, sector_t block, unsigned size)
1405 struct buffer_head *bh = __getblk(bdev, block, size);
1407 if (likely(bh) && !buffer_uptodate(bh))
1408 bh = __bread_slow(bh);
1409 return bh;
1411 EXPORT_SYMBOL(__bread);
1414 * invalidate_bh_lrus() is called rarely - but not only at unmount.
1415 * This doesn't race because it runs in each cpu either in irq
1416 * or with preempt disabled.
1418 static void invalidate_bh_lru(void *arg)
1420 struct bh_lru *b = &get_cpu_var(bh_lrus);
1421 int i;
1423 for (i = 0; i < BH_LRU_SIZE; i++) {
1424 brelse(b->bhs[i]);
1425 b->bhs[i] = NULL;
1427 put_cpu_var(bh_lrus);
1430 void invalidate_bh_lrus(void)
1432 on_each_cpu(invalidate_bh_lru, NULL, 1);
1434 EXPORT_SYMBOL_GPL(invalidate_bh_lrus);
1436 void set_bh_page(struct buffer_head *bh,
1437 struct page *page, unsigned long offset)
1439 bh->b_page = page;
1440 BUG_ON(offset >= PAGE_SIZE);
1441 if (PageHighMem(page))
1443 * This catches illegal uses and preserves the offset:
1445 bh->b_data = (char *)(0 + offset);
1446 else
1447 bh->b_data = page_address(page) + offset;
1449 EXPORT_SYMBOL(set_bh_page);
1452 * Called when truncating a buffer on a page completely.
1454 static void discard_buffer(struct buffer_head * bh)
1456 lock_buffer(bh);
1457 clear_buffer_dirty(bh);
1458 bh->b_bdev = NULL;
1459 clear_buffer_mapped(bh);
1460 clear_buffer_req(bh);
1461 clear_buffer_new(bh);
1462 clear_buffer_delay(bh);
1463 clear_buffer_unwritten(bh);
1464 unlock_buffer(bh);
1468 * block_invalidatepage - invalidate part of all of a buffer-backed page
1470 * @page: the page which is affected
1471 * @offset: the index of the truncation point
1473 * block_invalidatepage() is called when all or part of the page has become
1474 * invalidatedby a truncate operation.
1476 * block_invalidatepage() does not have to release all buffers, but it must
1477 * ensure that no dirty buffer is left outside @offset and that no I/O
1478 * is underway against any of the blocks which are outside the truncation
1479 * point. Because the caller is about to free (and possibly reuse) those
1480 * blocks on-disk.
1482 void block_invalidatepage(struct page *page, unsigned long offset)
1484 struct buffer_head *head, *bh, *next;
1485 unsigned int curr_off = 0;
1487 BUG_ON(!PageLocked(page));
1488 if (!page_has_buffers(page))
1489 goto out;
1491 head = page_buffers(page);
1492 bh = head;
1493 do {
1494 unsigned int next_off = curr_off + bh->b_size;
1495 next = bh->b_this_page;
1498 * is this block fully invalidated?
1500 if (offset <= curr_off)
1501 discard_buffer(bh);
1502 curr_off = next_off;
1503 bh = next;
1504 } while (bh != head);
1507 * We release buffers only if the entire page is being invalidated.
1508 * The get_block cached value has been unconditionally invalidated,
1509 * so real IO is not possible anymore.
1511 if (offset == 0)
1512 try_to_release_page(page, 0);
1513 out:
1514 return;
1516 EXPORT_SYMBOL(block_invalidatepage);
1519 * We attach and possibly dirty the buffers atomically wrt
1520 * __set_page_dirty_buffers() via private_lock. try_to_free_buffers
1521 * is already excluded via the page lock.
1523 void create_empty_buffers(struct page *page,
1524 unsigned long blocksize, unsigned long b_state)
1526 struct buffer_head *bh, *head, *tail;
1528 head = alloc_page_buffers(page, blocksize, 1);
1529 bh = head;
1530 do {
1531 bh->b_state |= b_state;
1532 tail = bh;
1533 bh = bh->b_this_page;
1534 } while (bh);
1535 tail->b_this_page = head;
1537 spin_lock(&page->mapping->private_lock);
1538 if (PageUptodate(page) || PageDirty(page)) {
1539 bh = head;
1540 do {
1541 if (PageDirty(page))
1542 set_buffer_dirty(bh);
1543 if (PageUptodate(page))
1544 set_buffer_uptodate(bh);
1545 bh = bh->b_this_page;
1546 } while (bh != head);
1548 attach_page_buffers(page, head);
1549 spin_unlock(&page->mapping->private_lock);
1551 EXPORT_SYMBOL(create_empty_buffers);
1554 * We are taking a block for data and we don't want any output from any
1555 * buffer-cache aliases starting from return from that function and
1556 * until the moment when something will explicitly mark the buffer
1557 * dirty (hopefully that will not happen until we will free that block ;-)
1558 * We don't even need to mark it not-uptodate - nobody can expect
1559 * anything from a newly allocated buffer anyway. We used to used
1560 * unmap_buffer() for such invalidation, but that was wrong. We definitely
1561 * don't want to mark the alias unmapped, for example - it would confuse
1562 * anyone who might pick it with bread() afterwards...
1564 * Also.. Note that bforget() doesn't lock the buffer. So there can
1565 * be writeout I/O going on against recently-freed buffers. We don't
1566 * wait on that I/O in bforget() - it's more efficient to wait on the I/O
1567 * only if we really need to. That happens here.
1569 void unmap_underlying_metadata(struct block_device *bdev, sector_t block)
1571 struct buffer_head *old_bh;
1573 might_sleep();
1575 old_bh = __find_get_block_slow(bdev, block);
1576 if (old_bh) {
1577 clear_buffer_dirty(old_bh);
1578 wait_on_buffer(old_bh);
1579 clear_buffer_req(old_bh);
1580 __brelse(old_bh);
1583 EXPORT_SYMBOL(unmap_underlying_metadata);
1586 * NOTE! All mapped/uptodate combinations are valid:
1588 * Mapped Uptodate Meaning
1590 * No No "unknown" - must do get_block()
1591 * No Yes "hole" - zero-filled
1592 * Yes No "allocated" - allocated on disk, not read in
1593 * Yes Yes "valid" - allocated and up-to-date in memory.
1595 * "Dirty" is valid only with the last case (mapped+uptodate).
1599 * While block_write_full_page is writing back the dirty buffers under
1600 * the page lock, whoever dirtied the buffers may decide to clean them
1601 * again at any time. We handle that by only looking at the buffer
1602 * state inside lock_buffer().
1604 * If block_write_full_page() is called for regular writeback
1605 * (wbc->sync_mode == WB_SYNC_NONE) then it will redirty a page which has a
1606 * locked buffer. This only can happen if someone has written the buffer
1607 * directly, with submit_bh(). At the address_space level PageWriteback
1608 * prevents this contention from occurring.
1610 * If block_write_full_page() is called with wbc->sync_mode ==
1611 * WB_SYNC_ALL, the writes are posted using WRITE_SYNC; this
1612 * causes the writes to be flagged as synchronous writes.
1614 static int __block_write_full_page(struct inode *inode, struct page *page,
1615 get_block_t *get_block, struct writeback_control *wbc,
1616 bh_end_io_t *handler)
1618 int err;
1619 sector_t block;
1620 sector_t last_block;
1621 struct buffer_head *bh, *head;
1622 const unsigned blocksize = 1 << inode->i_blkbits;
1623 int nr_underway = 0;
1624 int write_op = (wbc->sync_mode == WB_SYNC_ALL ?
1625 WRITE_SYNC : WRITE);
1627 BUG_ON(!PageLocked(page));
1629 last_block = (i_size_read(inode) - 1) >> inode->i_blkbits;
1631 if (!page_has_buffers(page)) {
1632 create_empty_buffers(page, blocksize,
1633 (1 << BH_Dirty)|(1 << BH_Uptodate));
1637 * Be very careful. We have no exclusion from __set_page_dirty_buffers
1638 * here, and the (potentially unmapped) buffers may become dirty at
1639 * any time. If a buffer becomes dirty here after we've inspected it
1640 * then we just miss that fact, and the page stays dirty.
1642 * Buffers outside i_size may be dirtied by __set_page_dirty_buffers;
1643 * handle that here by just cleaning them.
1646 block = (sector_t)page->index << (PAGE_CACHE_SHIFT - inode->i_blkbits);
1647 head = page_buffers(page);
1648 bh = head;
1651 * Get all the dirty buffers mapped to disk addresses and
1652 * handle any aliases from the underlying blockdev's mapping.
1654 do {
1655 if (block > last_block) {
1657 * mapped buffers outside i_size will occur, because
1658 * this page can be outside i_size when there is a
1659 * truncate in progress.
1662 * The buffer was zeroed by block_write_full_page()
1664 clear_buffer_dirty(bh);
1665 set_buffer_uptodate(bh);
1666 } else if ((!buffer_mapped(bh) || buffer_delay(bh)) &&
1667 buffer_dirty(bh)) {
1668 WARN_ON(bh->b_size != blocksize);
1669 err = get_block(inode, block, bh, 1);
1670 if (err)
1671 goto recover;
1672 clear_buffer_delay(bh);
1673 if (buffer_new(bh)) {
1674 /* blockdev mappings never come here */
1675 clear_buffer_new(bh);
1676 unmap_underlying_metadata(bh->b_bdev,
1677 bh->b_blocknr);
1680 bh = bh->b_this_page;
1681 block++;
1682 } while (bh != head);
1684 do {
1685 if (!buffer_mapped(bh))
1686 continue;
1688 * If it's a fully non-blocking write attempt and we cannot
1689 * lock the buffer then redirty the page. Note that this can
1690 * potentially cause a busy-wait loop from writeback threads
1691 * and kswapd activity, but those code paths have their own
1692 * higher-level throttling.
1694 if (wbc->sync_mode != WB_SYNC_NONE) {
1695 lock_buffer(bh);
1696 } else if (!trylock_buffer(bh)) {
1697 redirty_page_for_writepage(wbc, page);
1698 continue;
1700 if (test_clear_buffer_dirty(bh)) {
1701 mark_buffer_async_write_endio(bh, handler);
1702 } else {
1703 unlock_buffer(bh);
1705 } while ((bh = bh->b_this_page) != head);
1708 * The page and its buffers are protected by PageWriteback(), so we can
1709 * drop the bh refcounts early.
1711 BUG_ON(PageWriteback(page));
1712 set_page_writeback(page);
1714 do {
1715 struct buffer_head *next = bh->b_this_page;
1716 if (buffer_async_write(bh)) {
1717 submit_bh(write_op, bh);
1718 nr_underway++;
1720 bh = next;
1721 } while (bh != head);
1722 unlock_page(page);
1724 err = 0;
1725 done:
1726 if (nr_underway == 0) {
1728 * The page was marked dirty, but the buffers were
1729 * clean. Someone wrote them back by hand with
1730 * ll_rw_block/submit_bh. A rare case.
1732 end_page_writeback(page);
1735 * The page and buffer_heads can be released at any time from
1736 * here on.
1739 return err;
1741 recover:
1743 * ENOSPC, or some other error. We may already have added some
1744 * blocks to the file, so we need to write these out to avoid
1745 * exposing stale data.
1746 * The page is currently locked and not marked for writeback
1748 bh = head;
1749 /* Recovery: lock and submit the mapped buffers */
1750 do {
1751 if (buffer_mapped(bh) && buffer_dirty(bh) &&
1752 !buffer_delay(bh)) {
1753 lock_buffer(bh);
1754 mark_buffer_async_write_endio(bh, handler);
1755 } else {
1757 * The buffer may have been set dirty during
1758 * attachment to a dirty page.
1760 clear_buffer_dirty(bh);
1762 } while ((bh = bh->b_this_page) != head);
1763 SetPageError(page);
1764 BUG_ON(PageWriteback(page));
1765 mapping_set_error(page->mapping, err);
1766 set_page_writeback(page);
1767 do {
1768 struct buffer_head *next = bh->b_this_page;
1769 if (buffer_async_write(bh)) {
1770 clear_buffer_dirty(bh);
1771 submit_bh(write_op, bh);
1772 nr_underway++;
1774 bh = next;
1775 } while (bh != head);
1776 unlock_page(page);
1777 goto done;
1781 * If a page has any new buffers, zero them out here, and mark them uptodate
1782 * and dirty so they'll be written out (in order to prevent uninitialised
1783 * block data from leaking). And clear the new bit.
1785 void page_zero_new_buffers(struct page *page, unsigned from, unsigned to)
1787 unsigned int block_start, block_end;
1788 struct buffer_head *head, *bh;
1790 BUG_ON(!PageLocked(page));
1791 if (!page_has_buffers(page))
1792 return;
1794 bh = head = page_buffers(page);
1795 block_start = 0;
1796 do {
1797 block_end = block_start + bh->b_size;
1799 if (buffer_new(bh)) {
1800 if (block_end > from && block_start < to) {
1801 if (!PageUptodate(page)) {
1802 unsigned start, size;
1804 start = max(from, block_start);
1805 size = min(to, block_end) - start;
1807 zero_user(page, start, size);
1808 set_buffer_uptodate(bh);
1811 clear_buffer_new(bh);
1812 mark_buffer_dirty(bh);
1816 block_start = block_end;
1817 bh = bh->b_this_page;
1818 } while (bh != head);
1820 EXPORT_SYMBOL(page_zero_new_buffers);
1822 int __block_write_begin(struct page *page, loff_t pos, unsigned len,
1823 get_block_t *get_block)
1825 unsigned from = pos & (PAGE_CACHE_SIZE - 1);
1826 unsigned to = from + len;
1827 struct inode *inode = page->mapping->host;
1828 unsigned block_start, block_end;
1829 sector_t block;
1830 int err = 0;
1831 unsigned blocksize, bbits;
1832 struct buffer_head *bh, *head, *wait[2], **wait_bh=wait;
1834 BUG_ON(!PageLocked(page));
1835 BUG_ON(from > PAGE_CACHE_SIZE);
1836 BUG_ON(to > PAGE_CACHE_SIZE);
1837 BUG_ON(from > to);
1839 blocksize = 1 << inode->i_blkbits;
1840 if (!page_has_buffers(page))
1841 create_empty_buffers(page, blocksize, 0);
1842 head = page_buffers(page);
1844 bbits = inode->i_blkbits;
1845 block = (sector_t)page->index << (PAGE_CACHE_SHIFT - bbits);
1847 for(bh = head, block_start = 0; bh != head || !block_start;
1848 block++, block_start=block_end, bh = bh->b_this_page) {
1849 block_end = block_start + blocksize;
1850 if (block_end <= from || block_start >= to) {
1851 if (PageUptodate(page)) {
1852 if (!buffer_uptodate(bh))
1853 set_buffer_uptodate(bh);
1855 continue;
1857 if (buffer_new(bh))
1858 clear_buffer_new(bh);
1859 if (!buffer_mapped(bh)) {
1860 WARN_ON(bh->b_size != blocksize);
1861 err = get_block(inode, block, bh, 1);
1862 if (err)
1863 break;
1864 if (buffer_new(bh)) {
1865 unmap_underlying_metadata(bh->b_bdev,
1866 bh->b_blocknr);
1867 if (PageUptodate(page)) {
1868 clear_buffer_new(bh);
1869 set_buffer_uptodate(bh);
1870 mark_buffer_dirty(bh);
1871 continue;
1873 if (block_end > to || block_start < from)
1874 zero_user_segments(page,
1875 to, block_end,
1876 block_start, from);
1877 continue;
1880 if (PageUptodate(page)) {
1881 if (!buffer_uptodate(bh))
1882 set_buffer_uptodate(bh);
1883 continue;
1885 if (!buffer_uptodate(bh) && !buffer_delay(bh) &&
1886 !buffer_unwritten(bh) &&
1887 (block_start < from || block_end > to)) {
1888 ll_rw_block(READ, 1, &bh);
1889 *wait_bh++=bh;
1893 * If we issued read requests - let them complete.
1895 while(wait_bh > wait) {
1896 wait_on_buffer(*--wait_bh);
1897 if (!buffer_uptodate(*wait_bh))
1898 err = -EIO;
1900 if (unlikely(err)) {
1901 page_zero_new_buffers(page, from, to);
1902 ClearPageUptodate(page);
1904 return err;
1906 EXPORT_SYMBOL(__block_write_begin);
1908 static int __block_commit_write(struct inode *inode, struct page *page,
1909 unsigned from, unsigned to)
1911 unsigned block_start, block_end;
1912 int partial = 0;
1913 unsigned blocksize;
1914 struct buffer_head *bh, *head;
1916 blocksize = 1 << inode->i_blkbits;
1918 for(bh = head = page_buffers(page), block_start = 0;
1919 bh != head || !block_start;
1920 block_start=block_end, bh = bh->b_this_page) {
1921 block_end = block_start + blocksize;
1922 if (block_end <= from || block_start >= to) {
1923 if (!buffer_uptodate(bh))
1924 partial = 1;
1925 } else {
1926 set_buffer_uptodate(bh);
1927 mark_buffer_dirty(bh);
1929 clear_buffer_new(bh);
1933 * If this is a partial write which happened to make all buffers
1934 * uptodate then we can optimize away a bogus readpage() for
1935 * the next read(). Here we 'discover' whether the page went
1936 * uptodate as a result of this (potentially partial) write.
1938 if (!partial)
1939 SetPageUptodate(page);
1940 return 0;
1944 * block_write_begin takes care of the basic task of block allocation and
1945 * bringing partial write blocks uptodate first.
1947 * The filesystem needs to handle block truncation upon failure.
1949 int block_write_begin(struct address_space *mapping, loff_t pos, unsigned len,
1950 unsigned flags, struct page **pagep, get_block_t *get_block)
1952 pgoff_t index = pos >> PAGE_CACHE_SHIFT;
1953 struct page *page;
1954 int status;
1956 page = grab_cache_page_write_begin(mapping, index, flags);
1957 if (!page)
1958 return -ENOMEM;
1960 status = __block_write_begin(page, pos, len, get_block);
1961 if (unlikely(status)) {
1962 unlock_page(page);
1963 page_cache_release(page);
1964 page = NULL;
1967 *pagep = page;
1968 return status;
1970 EXPORT_SYMBOL(block_write_begin);
1972 int block_write_end(struct file *file, struct address_space *mapping,
1973 loff_t pos, unsigned len, unsigned copied,
1974 struct page *page, void *fsdata)
1976 struct inode *inode = mapping->host;
1977 unsigned start;
1979 start = pos & (PAGE_CACHE_SIZE - 1);
1981 if (unlikely(copied < len)) {
1983 * The buffers that were written will now be uptodate, so we
1984 * don't have to worry about a readpage reading them and
1985 * overwriting a partial write. However if we have encountered
1986 * a short write and only partially written into a buffer, it
1987 * will not be marked uptodate, so a readpage might come in and
1988 * destroy our partial write.
1990 * Do the simplest thing, and just treat any short write to a
1991 * non uptodate page as a zero-length write, and force the
1992 * caller to redo the whole thing.
1994 if (!PageUptodate(page))
1995 copied = 0;
1997 page_zero_new_buffers(page, start+copied, start+len);
1999 flush_dcache_page(page);
2001 /* This could be a short (even 0-length) commit */
2002 __block_commit_write(inode, page, start, start+copied);
2004 return copied;
2006 EXPORT_SYMBOL(block_write_end);
2008 int generic_write_end(struct file *file, struct address_space *mapping,
2009 loff_t pos, unsigned len, unsigned copied,
2010 struct page *page, void *fsdata)
2012 struct inode *inode = mapping->host;
2013 int i_size_changed = 0;
2015 copied = block_write_end(file, mapping, pos, len, copied, page, fsdata);
2018 * No need to use i_size_read() here, the i_size
2019 * cannot change under us because we hold i_mutex.
2021 * But it's important to update i_size while still holding page lock:
2022 * page writeout could otherwise come in and zero beyond i_size.
2024 if (pos+copied > inode->i_size) {
2025 i_size_write(inode, pos+copied);
2026 i_size_changed = 1;
2029 unlock_page(page);
2030 page_cache_release(page);
2033 * Don't mark the inode dirty under page lock. First, it unnecessarily
2034 * makes the holding time of page lock longer. Second, it forces lock
2035 * ordering of page lock and transaction start for journaling
2036 * filesystems.
2038 if (i_size_changed)
2039 mark_inode_dirty(inode);
2041 return copied;
2043 EXPORT_SYMBOL(generic_write_end);
2046 * block_is_partially_uptodate checks whether buffers within a page are
2047 * uptodate or not.
2049 * Returns true if all buffers which correspond to a file portion
2050 * we want to read are uptodate.
2052 int block_is_partially_uptodate(struct page *page, read_descriptor_t *desc,
2053 unsigned long from)
2055 struct inode *inode = page->mapping->host;
2056 unsigned block_start, block_end, blocksize;
2057 unsigned to;
2058 struct buffer_head *bh, *head;
2059 int ret = 1;
2061 if (!page_has_buffers(page))
2062 return 0;
2064 blocksize = 1 << inode->i_blkbits;
2065 to = min_t(unsigned, PAGE_CACHE_SIZE - from, desc->count);
2066 to = from + to;
2067 if (from < blocksize && to > PAGE_CACHE_SIZE - blocksize)
2068 return 0;
2070 head = page_buffers(page);
2071 bh = head;
2072 block_start = 0;
2073 do {
2074 block_end = block_start + blocksize;
2075 if (block_end > from && block_start < to) {
2076 if (!buffer_uptodate(bh)) {
2077 ret = 0;
2078 break;
2080 if (block_end >= to)
2081 break;
2083 block_start = block_end;
2084 bh = bh->b_this_page;
2085 } while (bh != head);
2087 return ret;
2089 EXPORT_SYMBOL(block_is_partially_uptodate);
2092 * Generic "read page" function for block devices that have the normal
2093 * get_block functionality. This is most of the block device filesystems.
2094 * Reads the page asynchronously --- the unlock_buffer() and
2095 * set/clear_buffer_uptodate() functions propagate buffer state into the
2096 * page struct once IO has completed.
2098 int block_read_full_page(struct page *page, get_block_t *get_block)
2100 struct inode *inode = page->mapping->host;
2101 sector_t iblock, lblock;
2102 struct buffer_head *bh, *head, *arr[MAX_BUF_PER_PAGE];
2103 unsigned int blocksize;
2104 int nr, i;
2105 int fully_mapped = 1;
2107 BUG_ON(!PageLocked(page));
2108 blocksize = 1 << inode->i_blkbits;
2109 if (!page_has_buffers(page))
2110 create_empty_buffers(page, blocksize, 0);
2111 head = page_buffers(page);
2113 iblock = (sector_t)page->index << (PAGE_CACHE_SHIFT - inode->i_blkbits);
2114 lblock = (i_size_read(inode)+blocksize-1) >> inode->i_blkbits;
2115 bh = head;
2116 nr = 0;
2117 i = 0;
2119 do {
2120 if (buffer_uptodate(bh))
2121 continue;
2123 if (!buffer_mapped(bh)) {
2124 int err = 0;
2126 fully_mapped = 0;
2127 if (iblock < lblock) {
2128 WARN_ON(bh->b_size != blocksize);
2129 err = get_block(inode, iblock, bh, 0);
2130 if (err)
2131 SetPageError(page);
2133 if (!buffer_mapped(bh)) {
2134 zero_user(page, i * blocksize, blocksize);
2135 if (!err)
2136 set_buffer_uptodate(bh);
2137 continue;
2140 * get_block() might have updated the buffer
2141 * synchronously
2143 if (buffer_uptodate(bh))
2144 continue;
2146 arr[nr++] = bh;
2147 } while (i++, iblock++, (bh = bh->b_this_page) != head);
2149 if (fully_mapped)
2150 SetPageMappedToDisk(page);
2152 if (!nr) {
2154 * All buffers are uptodate - we can set the page uptodate
2155 * as well. But not if get_block() returned an error.
2157 if (!PageError(page))
2158 SetPageUptodate(page);
2159 unlock_page(page);
2160 return 0;
2163 /* Stage two: lock the buffers */
2164 for (i = 0; i < nr; i++) {
2165 bh = arr[i];
2166 lock_buffer(bh);
2167 mark_buffer_async_read(bh);
2171 * Stage 3: start the IO. Check for uptodateness
2172 * inside the buffer lock in case another process reading
2173 * the underlying blockdev brought it uptodate (the sct fix).
2175 for (i = 0; i < nr; i++) {
2176 bh = arr[i];
2177 if (buffer_uptodate(bh))
2178 end_buffer_async_read(bh, 1);
2179 else
2180 submit_bh(READ, bh);
2182 return 0;
2184 EXPORT_SYMBOL(block_read_full_page);
2186 /* utility function for filesystems that need to do work on expanding
2187 * truncates. Uses filesystem pagecache writes to allow the filesystem to
2188 * deal with the hole.
2190 int generic_cont_expand_simple(struct inode *inode, loff_t size)
2192 struct address_space *mapping = inode->i_mapping;
2193 struct page *page;
2194 void *fsdata;
2195 int err;
2197 err = inode_newsize_ok(inode, size);
2198 if (err)
2199 goto out;
2201 err = pagecache_write_begin(NULL, mapping, size, 0,
2202 AOP_FLAG_UNINTERRUPTIBLE|AOP_FLAG_CONT_EXPAND,
2203 &page, &fsdata);
2204 if (err)
2205 goto out;
2207 err = pagecache_write_end(NULL, mapping, size, 0, 0, page, fsdata);
2208 BUG_ON(err > 0);
2210 out:
2211 return err;
2213 EXPORT_SYMBOL(generic_cont_expand_simple);
2215 static int cont_expand_zero(struct file *file, struct address_space *mapping,
2216 loff_t pos, loff_t *bytes)
2218 struct inode *inode = mapping->host;
2219 unsigned blocksize = 1 << inode->i_blkbits;
2220 struct page *page;
2221 void *fsdata;
2222 pgoff_t index, curidx;
2223 loff_t curpos;
2224 unsigned zerofrom, offset, len;
2225 int err = 0;
2227 index = pos >> PAGE_CACHE_SHIFT;
2228 offset = pos & ~PAGE_CACHE_MASK;
2230 while (index > (curidx = (curpos = *bytes)>>PAGE_CACHE_SHIFT)) {
2231 zerofrom = curpos & ~PAGE_CACHE_MASK;
2232 if (zerofrom & (blocksize-1)) {
2233 *bytes |= (blocksize-1);
2234 (*bytes)++;
2236 len = PAGE_CACHE_SIZE - zerofrom;
2238 err = pagecache_write_begin(file, mapping, curpos, len,
2239 AOP_FLAG_UNINTERRUPTIBLE,
2240 &page, &fsdata);
2241 if (err)
2242 goto out;
2243 zero_user(page, zerofrom, len);
2244 err = pagecache_write_end(file, mapping, curpos, len, len,
2245 page, fsdata);
2246 if (err < 0)
2247 goto out;
2248 BUG_ON(err != len);
2249 err = 0;
2251 balance_dirty_pages_ratelimited(mapping);
2254 /* page covers the boundary, find the boundary offset */
2255 if (index == curidx) {
2256 zerofrom = curpos & ~PAGE_CACHE_MASK;
2257 /* if we will expand the thing last block will be filled */
2258 if (offset <= zerofrom) {
2259 goto out;
2261 if (zerofrom & (blocksize-1)) {
2262 *bytes |= (blocksize-1);
2263 (*bytes)++;
2265 len = offset - zerofrom;
2267 err = pagecache_write_begin(file, mapping, curpos, len,
2268 AOP_FLAG_UNINTERRUPTIBLE,
2269 &page, &fsdata);
2270 if (err)
2271 goto out;
2272 zero_user(page, zerofrom, len);
2273 err = pagecache_write_end(file, mapping, curpos, len, len,
2274 page, fsdata);
2275 if (err < 0)
2276 goto out;
2277 BUG_ON(err != len);
2278 err = 0;
2280 out:
2281 return err;
2285 * For moronic filesystems that do not allow holes in file.
2286 * We may have to extend the file.
2288 int cont_write_begin(struct file *file, struct address_space *mapping,
2289 loff_t pos, unsigned len, unsigned flags,
2290 struct page **pagep, void **fsdata,
2291 get_block_t *get_block, loff_t *bytes)
2293 struct inode *inode = mapping->host;
2294 unsigned blocksize = 1 << inode->i_blkbits;
2295 unsigned zerofrom;
2296 int err;
2298 err = cont_expand_zero(file, mapping, pos, bytes);
2299 if (err)
2300 return err;
2302 zerofrom = *bytes & ~PAGE_CACHE_MASK;
2303 if (pos+len > *bytes && zerofrom & (blocksize-1)) {
2304 *bytes |= (blocksize-1);
2305 (*bytes)++;
2308 return block_write_begin(mapping, pos, len, flags, pagep, get_block);
2310 EXPORT_SYMBOL(cont_write_begin);
2312 int block_commit_write(struct page *page, unsigned from, unsigned to)
2314 struct inode *inode = page->mapping->host;
2315 __block_commit_write(inode,page,from,to);
2316 return 0;
2318 EXPORT_SYMBOL(block_commit_write);
2321 * block_page_mkwrite() is not allowed to change the file size as it gets
2322 * called from a page fault handler when a page is first dirtied. Hence we must
2323 * be careful to check for EOF conditions here. We set the page up correctly
2324 * for a written page which means we get ENOSPC checking when writing into
2325 * holes and correct delalloc and unwritten extent mapping on filesystems that
2326 * support these features.
2328 * We are not allowed to take the i_mutex here so we have to play games to
2329 * protect against truncate races as the page could now be beyond EOF. Because
2330 * truncate writes the inode size before removing pages, once we have the
2331 * page lock we can determine safely if the page is beyond EOF. If it is not
2332 * beyond EOF, then the page is guaranteed safe against truncation until we
2333 * unlock the page.
2335 int __block_page_mkwrite(struct vm_area_struct *vma, struct vm_fault *vmf,
2336 get_block_t get_block)
2338 struct page *page = vmf->page;
2339 struct inode *inode = vma->vm_file->f_path.dentry->d_inode;
2340 unsigned long end;
2341 loff_t size;
2342 int ret;
2344 lock_page(page);
2345 size = i_size_read(inode);
2346 if ((page->mapping != inode->i_mapping) ||
2347 (page_offset(page) > size)) {
2348 /* We overload EFAULT to mean page got truncated */
2349 ret = -EFAULT;
2350 goto out_unlock;
2353 /* page is wholly or partially inside EOF */
2354 if (((page->index + 1) << PAGE_CACHE_SHIFT) > size)
2355 end = size & ~PAGE_CACHE_MASK;
2356 else
2357 end = PAGE_CACHE_SIZE;
2359 ret = __block_write_begin(page, 0, end, get_block);
2360 if (!ret)
2361 ret = block_commit_write(page, 0, end);
2363 if (unlikely(ret < 0))
2364 goto out_unlock;
2365 return 0;
2366 out_unlock:
2367 unlock_page(page);
2368 return ret;
2370 EXPORT_SYMBOL(__block_page_mkwrite);
2372 int block_page_mkwrite(struct vm_area_struct *vma, struct vm_fault *vmf,
2373 get_block_t get_block)
2375 int ret = __block_page_mkwrite(vma, vmf, get_block);
2377 return block_page_mkwrite_return(ret);
2379 EXPORT_SYMBOL(block_page_mkwrite);
2382 * nobh_write_begin()'s prereads are special: the buffer_heads are freed
2383 * immediately, while under the page lock. So it needs a special end_io
2384 * handler which does not touch the bh after unlocking it.
2386 static void end_buffer_read_nobh(struct buffer_head *bh, int uptodate)
2388 __end_buffer_read_notouch(bh, uptodate);
2392 * Attach the singly-linked list of buffers created by nobh_write_begin, to
2393 * the page (converting it to circular linked list and taking care of page
2394 * dirty races).
2396 static void attach_nobh_buffers(struct page *page, struct buffer_head *head)
2398 struct buffer_head *bh;
2400 BUG_ON(!PageLocked(page));
2402 spin_lock(&page->mapping->private_lock);
2403 bh = head;
2404 do {
2405 if (PageDirty(page))
2406 set_buffer_dirty(bh);
2407 if (!bh->b_this_page)
2408 bh->b_this_page = head;
2409 bh = bh->b_this_page;
2410 } while (bh != head);
2411 attach_page_buffers(page, head);
2412 spin_unlock(&page->mapping->private_lock);
2416 * On entry, the page is fully not uptodate.
2417 * On exit the page is fully uptodate in the areas outside (from,to)
2418 * The filesystem needs to handle block truncation upon failure.
2420 int nobh_write_begin(struct address_space *mapping,
2421 loff_t pos, unsigned len, unsigned flags,
2422 struct page **pagep, void **fsdata,
2423 get_block_t *get_block)
2425 struct inode *inode = mapping->host;
2426 const unsigned blkbits = inode->i_blkbits;
2427 const unsigned blocksize = 1 << blkbits;
2428 struct buffer_head *head, *bh;
2429 struct page *page;
2430 pgoff_t index;
2431 unsigned from, to;
2432 unsigned block_in_page;
2433 unsigned block_start, block_end;
2434 sector_t block_in_file;
2435 int nr_reads = 0;
2436 int ret = 0;
2437 int is_mapped_to_disk = 1;
2439 index = pos >> PAGE_CACHE_SHIFT;
2440 from = pos & (PAGE_CACHE_SIZE - 1);
2441 to = from + len;
2443 page = grab_cache_page_write_begin(mapping, index, flags);
2444 if (!page)
2445 return -ENOMEM;
2446 *pagep = page;
2447 *fsdata = NULL;
2449 if (page_has_buffers(page)) {
2450 ret = __block_write_begin(page, pos, len, get_block);
2451 if (unlikely(ret))
2452 goto out_release;
2453 return ret;
2456 if (PageMappedToDisk(page))
2457 return 0;
2460 * Allocate buffers so that we can keep track of state, and potentially
2461 * attach them to the page if an error occurs. In the common case of
2462 * no error, they will just be freed again without ever being attached
2463 * to the page (which is all OK, because we're under the page lock).
2465 * Be careful: the buffer linked list is a NULL terminated one, rather
2466 * than the circular one we're used to.
2468 head = alloc_page_buffers(page, blocksize, 0);
2469 if (!head) {
2470 ret = -ENOMEM;
2471 goto out_release;
2474 block_in_file = (sector_t)page->index << (PAGE_CACHE_SHIFT - blkbits);
2477 * We loop across all blocks in the page, whether or not they are
2478 * part of the affected region. This is so we can discover if the
2479 * page is fully mapped-to-disk.
2481 for (block_start = 0, block_in_page = 0, bh = head;
2482 block_start < PAGE_CACHE_SIZE;
2483 block_in_page++, block_start += blocksize, bh = bh->b_this_page) {
2484 int create;
2486 block_end = block_start + blocksize;
2487 bh->b_state = 0;
2488 create = 1;
2489 if (block_start >= to)
2490 create = 0;
2491 ret = get_block(inode, block_in_file + block_in_page,
2492 bh, create);
2493 if (ret)
2494 goto failed;
2495 if (!buffer_mapped(bh))
2496 is_mapped_to_disk = 0;
2497 if (buffer_new(bh))
2498 unmap_underlying_metadata(bh->b_bdev, bh->b_blocknr);
2499 if (PageUptodate(page)) {
2500 set_buffer_uptodate(bh);
2501 continue;
2503 if (buffer_new(bh) || !buffer_mapped(bh)) {
2504 zero_user_segments(page, block_start, from,
2505 to, block_end);
2506 continue;
2508 if (buffer_uptodate(bh))
2509 continue; /* reiserfs does this */
2510 if (block_start < from || block_end > to) {
2511 lock_buffer(bh);
2512 bh->b_end_io = end_buffer_read_nobh;
2513 submit_bh(READ, bh);
2514 nr_reads++;
2518 if (nr_reads) {
2520 * The page is locked, so these buffers are protected from
2521 * any VM or truncate activity. Hence we don't need to care
2522 * for the buffer_head refcounts.
2524 for (bh = head; bh; bh = bh->b_this_page) {
2525 wait_on_buffer(bh);
2526 if (!buffer_uptodate(bh))
2527 ret = -EIO;
2529 if (ret)
2530 goto failed;
2533 if (is_mapped_to_disk)
2534 SetPageMappedToDisk(page);
2536 *fsdata = head; /* to be released by nobh_write_end */
2538 return 0;
2540 failed:
2541 BUG_ON(!ret);
2543 * Error recovery is a bit difficult. We need to zero out blocks that
2544 * were newly allocated, and dirty them to ensure they get written out.
2545 * Buffers need to be attached to the page at this point, otherwise
2546 * the handling of potential IO errors during writeout would be hard
2547 * (could try doing synchronous writeout, but what if that fails too?)
2549 attach_nobh_buffers(page, head);
2550 page_zero_new_buffers(page, from, to);
2552 out_release:
2553 unlock_page(page);
2554 page_cache_release(page);
2555 *pagep = NULL;
2557 return ret;
2559 EXPORT_SYMBOL(nobh_write_begin);
2561 int nobh_write_end(struct file *file, struct address_space *mapping,
2562 loff_t pos, unsigned len, unsigned copied,
2563 struct page *page, void *fsdata)
2565 struct inode *inode = page->mapping->host;
2566 struct buffer_head *head = fsdata;
2567 struct buffer_head *bh;
2568 BUG_ON(fsdata != NULL && page_has_buffers(page));
2570 if (unlikely(copied < len) && head)
2571 attach_nobh_buffers(page, head);
2572 if (page_has_buffers(page))
2573 return generic_write_end(file, mapping, pos, len,
2574 copied, page, fsdata);
2576 SetPageUptodate(page);
2577 set_page_dirty(page);
2578 if (pos+copied > inode->i_size) {
2579 i_size_write(inode, pos+copied);
2580 mark_inode_dirty(inode);
2583 unlock_page(page);
2584 page_cache_release(page);
2586 while (head) {
2587 bh = head;
2588 head = head->b_this_page;
2589 free_buffer_head(bh);
2592 return copied;
2594 EXPORT_SYMBOL(nobh_write_end);
2597 * nobh_writepage() - based on block_full_write_page() except
2598 * that it tries to operate without attaching bufferheads to
2599 * the page.
2601 int nobh_writepage(struct page *page, get_block_t *get_block,
2602 struct writeback_control *wbc)
2604 struct inode * const inode = page->mapping->host;
2605 loff_t i_size = i_size_read(inode);
2606 const pgoff_t end_index = i_size >> PAGE_CACHE_SHIFT;
2607 unsigned offset;
2608 int ret;
2610 /* Is the page fully inside i_size? */
2611 if (page->index < end_index)
2612 goto out;
2614 /* Is the page fully outside i_size? (truncate in progress) */
2615 offset = i_size & (PAGE_CACHE_SIZE-1);
2616 if (page->index >= end_index+1 || !offset) {
2618 * The page may have dirty, unmapped buffers. For example,
2619 * they may have been added in ext3_writepage(). Make them
2620 * freeable here, so the page does not leak.
2622 #if 0
2623 /* Not really sure about this - do we need this ? */
2624 if (page->mapping->a_ops->invalidatepage)
2625 page->mapping->a_ops->invalidatepage(page, offset);
2626 #endif
2627 unlock_page(page);
2628 return 0; /* don't care */
2632 * The page straddles i_size. It must be zeroed out on each and every
2633 * writepage invocation because it may be mmapped. "A file is mapped
2634 * in multiples of the page size. For a file that is not a multiple of
2635 * the page size, the remaining memory is zeroed when mapped, and
2636 * writes to that region are not written out to the file."
2638 zero_user_segment(page, offset, PAGE_CACHE_SIZE);
2639 out:
2640 ret = mpage_writepage(page, get_block, wbc);
2641 if (ret == -EAGAIN)
2642 ret = __block_write_full_page(inode, page, get_block, wbc,
2643 end_buffer_async_write);
2644 return ret;
2646 EXPORT_SYMBOL(nobh_writepage);
2648 int nobh_truncate_page(struct address_space *mapping,
2649 loff_t from, get_block_t *get_block)
2651 pgoff_t index = from >> PAGE_CACHE_SHIFT;
2652 unsigned offset = from & (PAGE_CACHE_SIZE-1);
2653 unsigned blocksize;
2654 sector_t iblock;
2655 unsigned length, pos;
2656 struct inode *inode = mapping->host;
2657 struct page *page;
2658 struct buffer_head map_bh;
2659 int err;
2661 blocksize = 1 << inode->i_blkbits;
2662 length = offset & (blocksize - 1);
2664 /* Block boundary? Nothing to do */
2665 if (!length)
2666 return 0;
2668 length = blocksize - length;
2669 iblock = (sector_t)index << (PAGE_CACHE_SHIFT - inode->i_blkbits);
2671 page = grab_cache_page(mapping, index);
2672 err = -ENOMEM;
2673 if (!page)
2674 goto out;
2676 if (page_has_buffers(page)) {
2677 has_buffers:
2678 unlock_page(page);
2679 page_cache_release(page);
2680 return block_truncate_page(mapping, from, get_block);
2683 /* Find the buffer that contains "offset" */
2684 pos = blocksize;
2685 while (offset >= pos) {
2686 iblock++;
2687 pos += blocksize;
2690 map_bh.b_size = blocksize;
2691 map_bh.b_state = 0;
2692 err = get_block(inode, iblock, &map_bh, 0);
2693 if (err)
2694 goto unlock;
2695 /* unmapped? It's a hole - nothing to do */
2696 if (!buffer_mapped(&map_bh))
2697 goto unlock;
2699 /* Ok, it's mapped. Make sure it's up-to-date */
2700 if (!PageUptodate(page)) {
2701 err = mapping->a_ops->readpage(NULL, page);
2702 if (err) {
2703 page_cache_release(page);
2704 goto out;
2706 lock_page(page);
2707 if (!PageUptodate(page)) {
2708 err = -EIO;
2709 goto unlock;
2711 if (page_has_buffers(page))
2712 goto has_buffers;
2714 zero_user(page, offset, length);
2715 set_page_dirty(page);
2716 err = 0;
2718 unlock:
2719 unlock_page(page);
2720 page_cache_release(page);
2721 out:
2722 return err;
2724 EXPORT_SYMBOL(nobh_truncate_page);
2726 int block_truncate_page(struct address_space *mapping,
2727 loff_t from, get_block_t *get_block)
2729 pgoff_t index = from >> PAGE_CACHE_SHIFT;
2730 unsigned offset = from & (PAGE_CACHE_SIZE-1);
2731 unsigned blocksize;
2732 sector_t iblock;
2733 unsigned length, pos;
2734 struct inode *inode = mapping->host;
2735 struct page *page;
2736 struct buffer_head *bh;
2737 int err;
2739 blocksize = 1 << inode->i_blkbits;
2740 length = offset & (blocksize - 1);
2742 /* Block boundary? Nothing to do */
2743 if (!length)
2744 return 0;
2746 length = blocksize - length;
2747 iblock = (sector_t)index << (PAGE_CACHE_SHIFT - inode->i_blkbits);
2749 page = grab_cache_page(mapping, index);
2750 err = -ENOMEM;
2751 if (!page)
2752 goto out;
2754 if (!page_has_buffers(page))
2755 create_empty_buffers(page, blocksize, 0);
2757 /* Find the buffer that contains "offset" */
2758 bh = page_buffers(page);
2759 pos = blocksize;
2760 while (offset >= pos) {
2761 bh = bh->b_this_page;
2762 iblock++;
2763 pos += blocksize;
2766 err = 0;
2767 if (!buffer_mapped(bh)) {
2768 WARN_ON(bh->b_size != blocksize);
2769 err = get_block(inode, iblock, bh, 0);
2770 if (err)
2771 goto unlock;
2772 /* unmapped? It's a hole - nothing to do */
2773 if (!buffer_mapped(bh))
2774 goto unlock;
2777 /* Ok, it's mapped. Make sure it's up-to-date */
2778 if (PageUptodate(page))
2779 set_buffer_uptodate(bh);
2781 if (!buffer_uptodate(bh) && !buffer_delay(bh) && !buffer_unwritten(bh)) {
2782 err = -EIO;
2783 ll_rw_block(READ, 1, &bh);
2784 wait_on_buffer(bh);
2785 /* Uhhuh. Read error. Complain and punt. */
2786 if (!buffer_uptodate(bh))
2787 goto unlock;
2790 zero_user(page, offset, length);
2791 mark_buffer_dirty(bh);
2792 err = 0;
2794 unlock:
2795 unlock_page(page);
2796 page_cache_release(page);
2797 out:
2798 return err;
2800 EXPORT_SYMBOL(block_truncate_page);
2803 * The generic ->writepage function for buffer-backed address_spaces
2804 * this form passes in the end_io handler used to finish the IO.
2806 int block_write_full_page_endio(struct page *page, get_block_t *get_block,
2807 struct writeback_control *wbc, bh_end_io_t *handler)
2809 struct inode * const inode = page->mapping->host;
2810 loff_t i_size = i_size_read(inode);
2811 const pgoff_t end_index = i_size >> PAGE_CACHE_SHIFT;
2812 unsigned offset;
2814 /* Is the page fully inside i_size? */
2815 if (page->index < end_index)
2816 return __block_write_full_page(inode, page, get_block, wbc,
2817 handler);
2819 /* Is the page fully outside i_size? (truncate in progress) */
2820 offset = i_size & (PAGE_CACHE_SIZE-1);
2821 if (page->index >= end_index+1 || !offset) {
2823 * The page may have dirty, unmapped buffers. For example,
2824 * they may have been added in ext3_writepage(). Make them
2825 * freeable here, so the page does not leak.
2827 do_invalidatepage(page, 0);
2828 unlock_page(page);
2829 return 0; /* don't care */
2833 * The page straddles i_size. It must be zeroed out on each and every
2834 * writepage invocation because it may be mmapped. "A file is mapped
2835 * in multiples of the page size. For a file that is not a multiple of
2836 * the page size, the remaining memory is zeroed when mapped, and
2837 * writes to that region are not written out to the file."
2839 zero_user_segment(page, offset, PAGE_CACHE_SIZE);
2840 return __block_write_full_page(inode, page, get_block, wbc, handler);
2842 EXPORT_SYMBOL(block_write_full_page_endio);
2845 * The generic ->writepage function for buffer-backed address_spaces
2847 int block_write_full_page(struct page *page, get_block_t *get_block,
2848 struct writeback_control *wbc)
2850 return block_write_full_page_endio(page, get_block, wbc,
2851 end_buffer_async_write);
2853 EXPORT_SYMBOL(block_write_full_page);
2855 sector_t generic_block_bmap(struct address_space *mapping, sector_t block,
2856 get_block_t *get_block)
2858 struct buffer_head tmp;
2859 struct inode *inode = mapping->host;
2860 tmp.b_state = 0;
2861 tmp.b_blocknr = 0;
2862 tmp.b_size = 1 << inode->i_blkbits;
2863 get_block(inode, block, &tmp, 0);
2864 return tmp.b_blocknr;
2866 EXPORT_SYMBOL(generic_block_bmap);
2868 static void end_bio_bh_io_sync(struct bio *bio, int err)
2870 struct buffer_head *bh = bio->bi_private;
2872 if (err == -EOPNOTSUPP) {
2873 set_bit(BIO_EOPNOTSUPP, &bio->bi_flags);
2876 if (unlikely (test_bit(BIO_QUIET,&bio->bi_flags)))
2877 set_bit(BH_Quiet, &bh->b_state);
2879 bh->b_end_io(bh, test_bit(BIO_UPTODATE, &bio->bi_flags));
2880 bio_put(bio);
2883 int submit_bh(int rw, struct buffer_head * bh)
2885 struct bio *bio;
2886 int ret = 0;
2888 BUG_ON(!buffer_locked(bh));
2889 BUG_ON(!buffer_mapped(bh));
2890 BUG_ON(!bh->b_end_io);
2891 BUG_ON(buffer_delay(bh));
2892 BUG_ON(buffer_unwritten(bh));
2895 * Only clear out a write error when rewriting
2897 if (test_set_buffer_req(bh) && (rw & WRITE))
2898 clear_buffer_write_io_error(bh);
2901 * from here on down, it's all bio -- do the initial mapping,
2902 * submit_bio -> generic_make_request may further map this bio around
2904 bio = bio_alloc(GFP_NOIO, 1);
2906 bio->bi_sector = bh->b_blocknr * (bh->b_size >> 9);
2907 bio->bi_bdev = bh->b_bdev;
2908 bio->bi_io_vec[0].bv_page = bh->b_page;
2909 bio->bi_io_vec[0].bv_len = bh->b_size;
2910 bio->bi_io_vec[0].bv_offset = bh_offset(bh);
2912 bio->bi_vcnt = 1;
2913 bio->bi_idx = 0;
2914 bio->bi_size = bh->b_size;
2916 bio->bi_end_io = end_bio_bh_io_sync;
2917 bio->bi_private = bh;
2919 bio_get(bio);
2920 submit_bio(rw, bio);
2922 if (bio_flagged(bio, BIO_EOPNOTSUPP))
2923 ret = -EOPNOTSUPP;
2925 bio_put(bio);
2926 return ret;
2928 EXPORT_SYMBOL(submit_bh);
2931 * ll_rw_block: low-level access to block devices (DEPRECATED)
2932 * @rw: whether to %READ or %WRITE or maybe %READA (readahead)
2933 * @nr: number of &struct buffer_heads in the array
2934 * @bhs: array of pointers to &struct buffer_head
2936 * ll_rw_block() takes an array of pointers to &struct buffer_heads, and
2937 * requests an I/O operation on them, either a %READ or a %WRITE. The third
2938 * %READA option is described in the documentation for generic_make_request()
2939 * which ll_rw_block() calls.
2941 * This function drops any buffer that it cannot get a lock on (with the
2942 * BH_Lock state bit), any buffer that appears to be clean when doing a write
2943 * request, and any buffer that appears to be up-to-date when doing read
2944 * request. Further it marks as clean buffers that are processed for
2945 * writing (the buffer cache won't assume that they are actually clean
2946 * until the buffer gets unlocked).
2948 * ll_rw_block sets b_end_io to simple completion handler that marks
2949 * the buffer up-to-date (if approriate), unlocks the buffer and wakes
2950 * any waiters.
2952 * All of the buffers must be for the same device, and must also be a
2953 * multiple of the current approved size for the device.
2955 void ll_rw_block(int rw, int nr, struct buffer_head *bhs[])
2957 int i;
2959 for (i = 0; i < nr; i++) {
2960 struct buffer_head *bh = bhs[i];
2962 if (!trylock_buffer(bh))
2963 continue;
2964 if (rw == WRITE) {
2965 if (test_clear_buffer_dirty(bh)) {
2966 bh->b_end_io = end_buffer_write_sync;
2967 get_bh(bh);
2968 submit_bh(WRITE, bh);
2969 continue;
2971 } else {
2972 if (!buffer_uptodate(bh)) {
2973 bh->b_end_io = end_buffer_read_sync;
2974 get_bh(bh);
2975 submit_bh(rw, bh);
2976 continue;
2979 unlock_buffer(bh);
2982 EXPORT_SYMBOL(ll_rw_block);
2984 void write_dirty_buffer(struct buffer_head *bh, int rw)
2986 lock_buffer(bh);
2987 if (!test_clear_buffer_dirty(bh)) {
2988 unlock_buffer(bh);
2989 return;
2991 bh->b_end_io = end_buffer_write_sync;
2992 get_bh(bh);
2993 submit_bh(rw, bh);
2995 EXPORT_SYMBOL(write_dirty_buffer);
2998 * For a data-integrity writeout, we need to wait upon any in-progress I/O
2999 * and then start new I/O and then wait upon it. The caller must have a ref on
3000 * the buffer_head.
3002 int __sync_dirty_buffer(struct buffer_head *bh, int rw)
3004 int ret = 0;
3006 WARN_ON(atomic_read(&bh->b_count) < 1);
3007 lock_buffer(bh);
3008 if (test_clear_buffer_dirty(bh)) {
3009 get_bh(bh);
3010 bh->b_end_io = end_buffer_write_sync;
3011 ret = submit_bh(rw, bh);
3012 wait_on_buffer(bh);
3013 if (!ret && !buffer_uptodate(bh))
3014 ret = -EIO;
3015 } else {
3016 unlock_buffer(bh);
3018 return ret;
3020 EXPORT_SYMBOL(__sync_dirty_buffer);
3022 int sync_dirty_buffer(struct buffer_head *bh)
3024 return __sync_dirty_buffer(bh, WRITE_SYNC);
3026 EXPORT_SYMBOL(sync_dirty_buffer);
3029 * try_to_free_buffers() checks if all the buffers on this particular page
3030 * are unused, and releases them if so.
3032 * Exclusion against try_to_free_buffers may be obtained by either
3033 * locking the page or by holding its mapping's private_lock.
3035 * If the page is dirty but all the buffers are clean then we need to
3036 * be sure to mark the page clean as well. This is because the page
3037 * may be against a block device, and a later reattachment of buffers
3038 * to a dirty page will set *all* buffers dirty. Which would corrupt
3039 * filesystem data on the same device.
3041 * The same applies to regular filesystem pages: if all the buffers are
3042 * clean then we set the page clean and proceed. To do that, we require
3043 * total exclusion from __set_page_dirty_buffers(). That is obtained with
3044 * private_lock.
3046 * try_to_free_buffers() is non-blocking.
3048 static inline int buffer_busy(struct buffer_head *bh)
3050 return atomic_read(&bh->b_count) |
3051 (bh->b_state & ((1 << BH_Dirty) | (1 << BH_Lock)));
3054 static int
3055 drop_buffers(struct page *page, struct buffer_head **buffers_to_free)
3057 struct buffer_head *head = page_buffers(page);
3058 struct buffer_head *bh;
3060 bh = head;
3061 do {
3062 if (buffer_write_io_error(bh) && page->mapping)
3063 set_bit(AS_EIO, &page->mapping->flags);
3064 if (buffer_busy(bh))
3065 goto failed;
3066 bh = bh->b_this_page;
3067 } while (bh != head);
3069 do {
3070 struct buffer_head *next = bh->b_this_page;
3072 if (bh->b_assoc_map)
3073 __remove_assoc_queue(bh);
3074 bh = next;
3075 } while (bh != head);
3076 *buffers_to_free = head;
3077 __clear_page_buffers(page);
3078 return 1;
3079 failed:
3080 return 0;
3083 int try_to_free_buffers(struct page *page)
3085 struct address_space * const mapping = page->mapping;
3086 struct buffer_head *buffers_to_free = NULL;
3087 int ret = 0;
3089 BUG_ON(!PageLocked(page));
3090 if (PageWriteback(page))
3091 return 0;
3093 if (mapping == NULL) { /* can this still happen? */
3094 ret = drop_buffers(page, &buffers_to_free);
3095 goto out;
3098 spin_lock(&mapping->private_lock);
3099 ret = drop_buffers(page, &buffers_to_free);
3102 * If the filesystem writes its buffers by hand (eg ext3)
3103 * then we can have clean buffers against a dirty page. We
3104 * clean the page here; otherwise the VM will never notice
3105 * that the filesystem did any IO at all.
3107 * Also, during truncate, discard_buffer will have marked all
3108 * the page's buffers clean. We discover that here and clean
3109 * the page also.
3111 * private_lock must be held over this entire operation in order
3112 * to synchronise against __set_page_dirty_buffers and prevent the
3113 * dirty bit from being lost.
3115 if (ret)
3116 cancel_dirty_page(page, PAGE_CACHE_SIZE);
3117 spin_unlock(&mapping->private_lock);
3118 out:
3119 if (buffers_to_free) {
3120 struct buffer_head *bh = buffers_to_free;
3122 do {
3123 struct buffer_head *next = bh->b_this_page;
3124 free_buffer_head(bh);
3125 bh = next;
3126 } while (bh != buffers_to_free);
3128 return ret;
3130 EXPORT_SYMBOL(try_to_free_buffers);
3133 * There are no bdflush tunables left. But distributions are
3134 * still running obsolete flush daemons, so we terminate them here.
3136 * Use of bdflush() is deprecated and will be removed in a future kernel.
3137 * The `flush-X' kernel threads fully replace bdflush daemons and this call.
3139 SYSCALL_DEFINE2(bdflush, int, func, long, data)
3141 static int msg_count;
3143 if (!capable(CAP_SYS_ADMIN))
3144 return -EPERM;
3146 if (msg_count < 5) {
3147 msg_count++;
3148 printk(KERN_INFO
3149 "warning: process `%s' used the obsolete bdflush"
3150 " system call\n", current->comm);
3151 printk(KERN_INFO "Fix your initscripts?\n");
3154 if (func == 1)
3155 do_exit(0);
3156 return 0;
3160 * Buffer-head allocation
3162 static struct kmem_cache *bh_cachep;
3165 * Once the number of bh's in the machine exceeds this level, we start
3166 * stripping them in writeback.
3168 static int max_buffer_heads;
3170 int buffer_heads_over_limit;
3172 struct bh_accounting {
3173 int nr; /* Number of live bh's */
3174 int ratelimit; /* Limit cacheline bouncing */
3177 static DEFINE_PER_CPU(struct bh_accounting, bh_accounting) = {0, 0};
3179 static void recalc_bh_state(void)
3181 int i;
3182 int tot = 0;
3184 if (__this_cpu_inc_return(bh_accounting.ratelimit) - 1 < 4096)
3185 return;
3186 __this_cpu_write(bh_accounting.ratelimit, 0);
3187 for_each_online_cpu(i)
3188 tot += per_cpu(bh_accounting, i).nr;
3189 buffer_heads_over_limit = (tot > max_buffer_heads);
3192 struct buffer_head *alloc_buffer_head(gfp_t gfp_flags)
3194 struct buffer_head *ret = kmem_cache_zalloc(bh_cachep, gfp_flags);
3195 if (ret) {
3196 INIT_LIST_HEAD(&ret->b_assoc_buffers);
3197 preempt_disable();
3198 __this_cpu_inc(bh_accounting.nr);
3199 recalc_bh_state();
3200 preempt_enable();
3202 return ret;
3204 EXPORT_SYMBOL(alloc_buffer_head);
3206 void free_buffer_head(struct buffer_head *bh)
3208 BUG_ON(!list_empty(&bh->b_assoc_buffers));
3209 kmem_cache_free(bh_cachep, bh);
3210 preempt_disable();
3211 __this_cpu_dec(bh_accounting.nr);
3212 recalc_bh_state();
3213 preempt_enable();
3215 EXPORT_SYMBOL(free_buffer_head);
3217 static void buffer_exit_cpu(int cpu)
3219 int i;
3220 struct bh_lru *b = &per_cpu(bh_lrus, cpu);
3222 for (i = 0; i < BH_LRU_SIZE; i++) {
3223 brelse(b->bhs[i]);
3224 b->bhs[i] = NULL;
3226 this_cpu_add(bh_accounting.nr, per_cpu(bh_accounting, cpu).nr);
3227 per_cpu(bh_accounting, cpu).nr = 0;
3230 static int buffer_cpu_notify(struct notifier_block *self,
3231 unsigned long action, void *hcpu)
3233 if (action == CPU_DEAD || action == CPU_DEAD_FROZEN)
3234 buffer_exit_cpu((unsigned long)hcpu);
3235 return NOTIFY_OK;
3239 * bh_uptodate_or_lock - Test whether the buffer is uptodate
3240 * @bh: struct buffer_head
3242 * Return true if the buffer is up-to-date and false,
3243 * with the buffer locked, if not.
3245 int bh_uptodate_or_lock(struct buffer_head *bh)
3247 if (!buffer_uptodate(bh)) {
3248 lock_buffer(bh);
3249 if (!buffer_uptodate(bh))
3250 return 0;
3251 unlock_buffer(bh);
3253 return 1;
3255 EXPORT_SYMBOL(bh_uptodate_or_lock);
3258 * bh_submit_read - Submit a locked buffer for reading
3259 * @bh: struct buffer_head
3261 * Returns zero on success and -EIO on error.
3263 int bh_submit_read(struct buffer_head *bh)
3265 BUG_ON(!buffer_locked(bh));
3267 if (buffer_uptodate(bh)) {
3268 unlock_buffer(bh);
3269 return 0;
3272 get_bh(bh);
3273 bh->b_end_io = end_buffer_read_sync;
3274 submit_bh(READ, bh);
3275 wait_on_buffer(bh);
3276 if (buffer_uptodate(bh))
3277 return 0;
3278 return -EIO;
3280 EXPORT_SYMBOL(bh_submit_read);
3282 void __init buffer_init(void)
3284 int nrpages;
3286 bh_cachep = kmem_cache_create("buffer_head",
3287 sizeof(struct buffer_head), 0,
3288 (SLAB_RECLAIM_ACCOUNT|SLAB_PANIC|
3289 SLAB_MEM_SPREAD),
3290 NULL);
3293 * Limit the bh occupancy to 10% of ZONE_NORMAL
3295 nrpages = (nr_free_buffer_pages() * 10) / 100;
3296 max_buffer_heads = nrpages * (PAGE_SIZE / sizeof(struct buffer_head));
3297 hotcpu_notifier(buffer_cpu_notify, 0);