blob: 40115c6c0791229d4afc121a4e777674f61ec0bb [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * linux/mm/filemap.c
3 *
4 * Copyright (C) 1994-1999 Linus Torvalds
5 */
6
7/*
8 * This file handles the generic file mmap semantics used by
9 * most "normal" filesystems (but you don't /have/ to use this:
10 * the NFS filesystem used to do this differently, for example)
11 */
Paul Gortmakerb95f1b312011-10-16 02:01:52 -040012#include <linux/export.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070013#include <linux/compiler.h>
14#include <linux/fs.h>
Hiro Yoshiokac22ce142006-06-23 02:04:16 -070015#include <linux/uaccess.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070016#include <linux/aio.h>
Randy.Dunlapc59ede72006-01-11 12:17:46 -080017#include <linux/capability.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070018#include <linux/kernel_stat.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090019#include <linux/gfp.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070020#include <linux/mm.h>
21#include <linux/swap.h>
22#include <linux/mman.h>
23#include <linux/pagemap.h>
24#include <linux/file.h>
25#include <linux/uio.h>
26#include <linux/hash.h>
27#include <linux/writeback.h>
Linus Torvalds53253382007-10-18 14:47:32 -070028#include <linux/backing-dev.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070029#include <linux/pagevec.h>
30#include <linux/blkdev.h>
31#include <linux/security.h>
Paul Jackson44110fe2006-03-24 03:16:04 -080032#include <linux/cpuset.h>
Nick Piggin2f718ff2007-10-16 01:24:59 -070033#include <linux/hardirq.h> /* for BUG_ON(!in_atomic()) only */
Balbir Singh8a9f3cc2008-02-07 00:13:53 -080034#include <linux/memcontrol.h>
Dan Magenheimerc515e1f2011-05-26 10:01:43 -060035#include <linux/cleancache.h>
Nick Piggin0f8053a2006-03-22 00:08:33 -080036#include "internal.h"
37
Robert Jarzmikfe0bfaa2013-04-29 15:06:10 -070038#define CREATE_TRACE_POINTS
39#include <trace/events/filemap.h>
40
Linus Torvalds1da177e2005-04-16 15:20:36 -070041/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070042 * FIXME: remove all knowledge of the buffer layer from the core VM
43 */
Jan Kara148f9482009-08-17 19:52:36 +020044#include <linux/buffer_head.h> /* for try_to_free_buffers */
Linus Torvalds1da177e2005-04-16 15:20:36 -070045
Linus Torvalds1da177e2005-04-16 15:20:36 -070046#include <asm/mman.h>
47
48/*
49 * Shared mappings implemented 30.11.1994. It's not fully working yet,
50 * though.
51 *
52 * Shared mappings now work. 15.8.1995 Bruno.
53 *
54 * finished 'unifying' the page and buffer cache and SMP-threaded the
55 * page-cache, 21.05.1999, Ingo Molnar <mingo@redhat.com>
56 *
57 * SMP-threaded pagemap-LRU 1999, Andrea Arcangeli <andrea@suse.de>
58 */
59
60/*
61 * Lock ordering:
62 *
Peter Zijlstra3d48ae42011-05-24 17:12:06 -070063 * ->i_mmap_mutex (truncate_pagecache)
Linus Torvalds1da177e2005-04-16 15:20:36 -070064 * ->private_lock (__free_pte->__set_page_dirty_buffers)
Hugh Dickins5d337b92005-09-03 15:54:41 -070065 * ->swap_lock (exclusive_swap_page, others)
66 * ->mapping->tree_lock
Linus Torvalds1da177e2005-04-16 15:20:36 -070067 *
Jes Sorensen1b1dcc12006-01-09 15:59:24 -080068 * ->i_mutex
Peter Zijlstra3d48ae42011-05-24 17:12:06 -070069 * ->i_mmap_mutex (truncate->unmap_mapping_range)
Linus Torvalds1da177e2005-04-16 15:20:36 -070070 *
71 * ->mmap_sem
Peter Zijlstra3d48ae42011-05-24 17:12:06 -070072 * ->i_mmap_mutex
Hugh Dickinsb8072f02005-10-29 18:16:41 -070073 * ->page_table_lock or pte_lock (various, mainly in memory.c)
Linus Torvalds1da177e2005-04-16 15:20:36 -070074 * ->mapping->tree_lock (arch-dependent flush_dcache_mmap_lock)
75 *
76 * ->mmap_sem
77 * ->lock_page (access_process_vm)
78 *
Nick Piggin82591e62006-10-19 23:29:10 -070079 * ->i_mutex (generic_file_buffered_write)
80 * ->mmap_sem (fault_in_pages_readable->do_page_fault)
Linus Torvalds1da177e2005-04-16 15:20:36 -070081 *
Christoph Hellwigf758eea2011-04-21 18:19:44 -060082 * bdi->wb.list_lock
Dave Chinnera66979a2011-03-22 22:23:41 +110083 * sb_lock (fs/fs-writeback.c)
Linus Torvalds1da177e2005-04-16 15:20:36 -070084 * ->mapping->tree_lock (__sync_single_inode)
85 *
Peter Zijlstra3d48ae42011-05-24 17:12:06 -070086 * ->i_mmap_mutex
Linus Torvalds1da177e2005-04-16 15:20:36 -070087 * ->anon_vma.lock (vma_adjust)
88 *
89 * ->anon_vma.lock
Hugh Dickinsb8072f02005-10-29 18:16:41 -070090 * ->page_table_lock or pte_lock (anon_vma_prepare and various)
Linus Torvalds1da177e2005-04-16 15:20:36 -070091 *
Hugh Dickinsb8072f02005-10-29 18:16:41 -070092 * ->page_table_lock or pte_lock
Hugh Dickins5d337b92005-09-03 15:54:41 -070093 * ->swap_lock (try_to_unmap_one)
Linus Torvalds1da177e2005-04-16 15:20:36 -070094 * ->private_lock (try_to_unmap_one)
95 * ->tree_lock (try_to_unmap_one)
96 * ->zone.lru_lock (follow_page->mark_page_accessed)
Nick Piggin053837f2006-01-18 17:42:27 -080097 * ->zone.lru_lock (check_pte_range->isolate_lru_page)
Linus Torvalds1da177e2005-04-16 15:20:36 -070098 * ->private_lock (page_remove_rmap->set_page_dirty)
99 * ->tree_lock (page_remove_rmap->set_page_dirty)
Christoph Hellwigf758eea2011-04-21 18:19:44 -0600100 * bdi.wb->list_lock (page_remove_rmap->set_page_dirty)
Dave Chinner250df6e2011-03-22 22:23:36 +1100101 * ->inode->i_lock (page_remove_rmap->set_page_dirty)
Christoph Hellwigf758eea2011-04-21 18:19:44 -0600102 * bdi.wb->list_lock (zap_pte_range->set_page_dirty)
Dave Chinner250df6e2011-03-22 22:23:36 +1100103 * ->inode->i_lock (zap_pte_range->set_page_dirty)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104 * ->private_lock (zap_pte_range->__set_page_dirty_buffers)
105 *
Andi Kleen9a3c5312012-03-21 16:34:09 -0700106 * ->i_mmap_mutex
107 * ->tasklist_lock (memory_failure, collect_procs_ao)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108 */
109
110/*
Minchan Kime64a7822011-03-22 16:32:44 -0700111 * Delete a page from the page cache and free it. Caller has to make
Linus Torvalds1da177e2005-04-16 15:20:36 -0700112 * sure the page is locked and that nobody else uses it - or that usage
Nick Piggin19fd6232008-07-25 19:45:32 -0700113 * is safe. The caller must hold the mapping's tree_lock.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700114 */
Minchan Kime64a7822011-03-22 16:32:44 -0700115void __delete_from_page_cache(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700116{
117 struct address_space *mapping = page->mapping;
118
Robert Jarzmikfe0bfaa2013-04-29 15:06:10 -0700119 trace_mm_filemap_delete_from_page_cache(page);
Dan Magenheimerc515e1f2011-05-26 10:01:43 -0600120 /*
121 * if we're uptodate, flush out into the cleancache, otherwise
122 * invalidate any existing cleancache entries. We can't leave
123 * stale data around in the cleancache once our page is gone
124 */
125 if (PageUptodate(page) && PageMappedToDisk(page))
126 cleancache_put_page(page);
127 else
Dan Magenheimer31677602011-09-21 11:56:28 -0400128 cleancache_invalidate_page(mapping, page);
Dan Magenheimerc515e1f2011-05-26 10:01:43 -0600129
Linus Torvalds1da177e2005-04-16 15:20:36 -0700130 radix_tree_delete(&mapping->page_tree, page->index);
131 page->mapping = NULL;
Hugh Dickinsb85e0ef2011-07-25 17:12:25 -0700132 /* Leave page->index set: truncation lookup relies upon it */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700133 mapping->nrpages--;
Christoph Lameter347ce432006-06-30 01:55:35 -0700134 __dec_zone_page_state(page, NR_FILE_PAGES);
KOSAKI Motohiro4b021082009-09-21 17:01:33 -0700135 if (PageSwapBacked(page))
136 __dec_zone_page_state(page, NR_SHMEM);
Nick Piggin45426812007-07-15 23:38:12 -0700137 BUG_ON(page_mapped(page));
Linus Torvalds3a692792007-12-19 14:05:13 -0800138
139 /*
140 * Some filesystems seem to re-dirty the page even after
141 * the VM has canceled the dirty bit (eg ext3 journaling).
142 *
143 * Fix it up by doing a final dirty accounting check after
144 * having removed the page entirely.
145 */
146 if (PageDirty(page) && mapping_cap_account_dirty(mapping)) {
147 dec_zone_page_state(page, NR_FILE_DIRTY);
148 dec_bdi_stat(mapping->backing_dev_info, BDI_RECLAIMABLE);
149 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700150}
151
Minchan Kim702cfbf2011-03-22 16:32:43 -0700152/**
153 * delete_from_page_cache - delete page from page cache
154 * @page: the page which the kernel is trying to remove from page cache
155 *
156 * This must be called only on pages that have been verified to be in the page
157 * cache and locked. It will never put the page into the free list, the caller
158 * has a reference on the page.
159 */
160void delete_from_page_cache(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700161{
162 struct address_space *mapping = page->mapping;
Linus Torvalds6072d132010-12-01 13:35:19 -0500163 void (*freepage)(struct page *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164
Matt Mackallcd7619d2005-05-01 08:59:01 -0700165 BUG_ON(!PageLocked(page));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166
Linus Torvalds6072d132010-12-01 13:35:19 -0500167 freepage = mapping->a_ops->freepage;
Nick Piggin19fd6232008-07-25 19:45:32 -0700168 spin_lock_irq(&mapping->tree_lock);
Minchan Kime64a7822011-03-22 16:32:44 -0700169 __delete_from_page_cache(page);
Nick Piggin19fd6232008-07-25 19:45:32 -0700170 spin_unlock_irq(&mapping->tree_lock);
Daisuke Nishimurae767e052009-05-28 14:34:28 -0700171 mem_cgroup_uncharge_cache_page(page);
Linus Torvalds6072d132010-12-01 13:35:19 -0500172
173 if (freepage)
174 freepage(page);
Minchan Kim97cecb52011-03-22 16:30:53 -0700175 page_cache_release(page);
176}
177EXPORT_SYMBOL(delete_from_page_cache);
178
Jens Axboe7eaceac2011-03-10 08:52:07 +0100179static int sleep_on_page(void *word)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700180{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700181 io_schedule();
182 return 0;
183}
184
Jens Axboe7eaceac2011-03-10 08:52:07 +0100185static int sleep_on_page_killable(void *word)
Matthew Wilcox2687a352007-12-06 11:18:49 -0500186{
Jens Axboe7eaceac2011-03-10 08:52:07 +0100187 sleep_on_page(word);
Matthew Wilcox2687a352007-12-06 11:18:49 -0500188 return fatal_signal_pending(current) ? -EINTR : 0;
189}
190
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700191static int filemap_check_errors(struct address_space *mapping)
192{
193 int ret = 0;
194 /* Check for outstanding write errors */
195 if (test_and_clear_bit(AS_ENOSPC, &mapping->flags))
196 ret = -ENOSPC;
197 if (test_and_clear_bit(AS_EIO, &mapping->flags))
198 ret = -EIO;
199 return ret;
200}
201
Linus Torvalds1da177e2005-04-16 15:20:36 -0700202/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700203 * __filemap_fdatawrite_range - start writeback on mapping dirty pages in range
Martin Waitz67be2dd2005-05-01 08:59:26 -0700204 * @mapping: address space structure to write
205 * @start: offset in bytes where the range starts
Andrew Morton469eb4d2006-03-24 03:17:45 -0800206 * @end: offset in bytes where the range ends (inclusive)
Martin Waitz67be2dd2005-05-01 08:59:26 -0700207 * @sync_mode: enable synchronous operation
Linus Torvalds1da177e2005-04-16 15:20:36 -0700208 *
Randy Dunlap485bb992006-06-23 02:03:49 -0700209 * Start writeback against all of a mapping's dirty pages that lie
210 * within the byte offsets <start, end> inclusive.
211 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700212 * If sync_mode is WB_SYNC_ALL then this is a "data integrity" operation, as
Randy Dunlap485bb992006-06-23 02:03:49 -0700213 * opposed to a regular memory cleansing writeback. The difference between
Linus Torvalds1da177e2005-04-16 15:20:36 -0700214 * these two operations is that if a dirty page/buffer is encountered, it must
215 * be waited upon, and not just skipped over.
216 */
Andrew Mortonebcf28e2006-03-24 03:18:04 -0800217int __filemap_fdatawrite_range(struct address_space *mapping, loff_t start,
218 loff_t end, int sync_mode)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700219{
220 int ret;
221 struct writeback_control wbc = {
222 .sync_mode = sync_mode,
Nick Piggin05fe4782009-01-06 14:39:08 -0800223 .nr_to_write = LONG_MAX,
OGAWA Hirofumi111ebb62006-06-23 02:03:26 -0700224 .range_start = start,
225 .range_end = end,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700226 };
227
228 if (!mapping_cap_writeback_dirty(mapping))
229 return 0;
230
231 ret = do_writepages(mapping, &wbc);
232 return ret;
233}
234
235static inline int __filemap_fdatawrite(struct address_space *mapping,
236 int sync_mode)
237{
OGAWA Hirofumi111ebb62006-06-23 02:03:26 -0700238 return __filemap_fdatawrite_range(mapping, 0, LLONG_MAX, sync_mode);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700239}
240
241int filemap_fdatawrite(struct address_space *mapping)
242{
243 return __filemap_fdatawrite(mapping, WB_SYNC_ALL);
244}
245EXPORT_SYMBOL(filemap_fdatawrite);
246
Jan Karaf4c0a0f2008-07-11 19:27:31 -0400247int filemap_fdatawrite_range(struct address_space *mapping, loff_t start,
Andrew Mortonebcf28e2006-03-24 03:18:04 -0800248 loff_t end)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249{
250 return __filemap_fdatawrite_range(mapping, start, end, WB_SYNC_ALL);
251}
Jan Karaf4c0a0f2008-07-11 19:27:31 -0400252EXPORT_SYMBOL(filemap_fdatawrite_range);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700253
Randy Dunlap485bb992006-06-23 02:03:49 -0700254/**
255 * filemap_flush - mostly a non-blocking flush
256 * @mapping: target address_space
257 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700258 * This is a mostly non-blocking flush. Not suitable for data-integrity
259 * purposes - I/O may not be started against all dirty pages.
260 */
261int filemap_flush(struct address_space *mapping)
262{
263 return __filemap_fdatawrite(mapping, WB_SYNC_NONE);
264}
265EXPORT_SYMBOL(filemap_flush);
266
Randy Dunlap485bb992006-06-23 02:03:49 -0700267/**
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200268 * filemap_fdatawait_range - wait for writeback to complete
269 * @mapping: address space structure to wait for
270 * @start_byte: offset in bytes where the range starts
271 * @end_byte: offset in bytes where the range ends (inclusive)
Randy Dunlap485bb992006-06-23 02:03:49 -0700272 *
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200273 * Walk the list of under-writeback pages of the given address space
274 * in the given range and wait for all of them.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700275 */
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200276int filemap_fdatawait_range(struct address_space *mapping, loff_t start_byte,
277 loff_t end_byte)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700278{
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200279 pgoff_t index = start_byte >> PAGE_CACHE_SHIFT;
280 pgoff_t end = end_byte >> PAGE_CACHE_SHIFT;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700281 struct pagevec pvec;
282 int nr_pages;
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700283 int ret2, ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700284
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200285 if (end_byte < start_byte)
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700286 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700287
288 pagevec_init(&pvec, 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700289 while ((index <= end) &&
290 (nr_pages = pagevec_lookup_tag(&pvec, mapping, &index,
291 PAGECACHE_TAG_WRITEBACK,
292 min(end - index, (pgoff_t)PAGEVEC_SIZE-1) + 1)) != 0) {
293 unsigned i;
294
295 for (i = 0; i < nr_pages; i++) {
296 struct page *page = pvec.pages[i];
297
298 /* until radix tree lookup accepts end_index */
299 if (page->index > end)
300 continue;
301
302 wait_on_page_writeback(page);
Rik van Riel212260a2011-01-13 15:46:06 -0800303 if (TestClearPageError(page))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700304 ret = -EIO;
305 }
306 pagevec_release(&pvec);
307 cond_resched();
308 }
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700309out:
310 ret2 = filemap_check_errors(mapping);
311 if (!ret)
312 ret = ret2;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700313
314 return ret;
315}
Jan Karad3bccb6f2009-08-17 19:30:27 +0200316EXPORT_SYMBOL(filemap_fdatawait_range);
317
318/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700319 * filemap_fdatawait - wait for all under-writeback pages to complete
Linus Torvalds1da177e2005-04-16 15:20:36 -0700320 * @mapping: address space structure to wait for
Randy Dunlap485bb992006-06-23 02:03:49 -0700321 *
322 * Walk the list of under-writeback pages of the given address space
323 * and wait for all of them.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700324 */
325int filemap_fdatawait(struct address_space *mapping)
326{
327 loff_t i_size = i_size_read(mapping->host);
328
329 if (i_size == 0)
330 return 0;
331
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200332 return filemap_fdatawait_range(mapping, 0, i_size - 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700333}
334EXPORT_SYMBOL(filemap_fdatawait);
335
336int filemap_write_and_wait(struct address_space *mapping)
337{
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800338 int err = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700339
340 if (mapping->nrpages) {
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800341 err = filemap_fdatawrite(mapping);
342 /*
343 * Even if the above returned error, the pages may be
344 * written partially (e.g. -ENOSPC), so we wait for it.
345 * But the -EIO is special case, it may indicate the worst
346 * thing (e.g. bug) happened, so we avoid waiting for it.
347 */
348 if (err != -EIO) {
349 int err2 = filemap_fdatawait(mapping);
350 if (!err)
351 err = err2;
352 }
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700353 } else {
354 err = filemap_check_errors(mapping);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700355 }
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800356 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700357}
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800358EXPORT_SYMBOL(filemap_write_and_wait);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700359
Randy Dunlap485bb992006-06-23 02:03:49 -0700360/**
361 * filemap_write_and_wait_range - write out & wait on a file range
362 * @mapping: the address_space for the pages
363 * @lstart: offset in bytes where the range starts
364 * @lend: offset in bytes where the range ends (inclusive)
365 *
Andrew Morton469eb4d2006-03-24 03:17:45 -0800366 * Write out and wait upon file offsets lstart->lend, inclusive.
367 *
368 * Note that `lend' is inclusive (describes the last byte to be written) so
369 * that this function can be used to write to the very end-of-file (end = -1).
370 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700371int filemap_write_and_wait_range(struct address_space *mapping,
372 loff_t lstart, loff_t lend)
373{
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800374 int err = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700375
376 if (mapping->nrpages) {
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800377 err = __filemap_fdatawrite_range(mapping, lstart, lend,
378 WB_SYNC_ALL);
379 /* See comment of filemap_write_and_wait() */
380 if (err != -EIO) {
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200381 int err2 = filemap_fdatawait_range(mapping,
382 lstart, lend);
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800383 if (!err)
384 err = err2;
385 }
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700386 } else {
387 err = filemap_check_errors(mapping);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700388 }
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800389 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700390}
Chris Masonf6995582009-04-15 13:22:37 -0400391EXPORT_SYMBOL(filemap_write_and_wait_range);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700392
Randy Dunlap485bb992006-06-23 02:03:49 -0700393/**
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700394 * replace_page_cache_page - replace a pagecache page with a new one
395 * @old: page to be replaced
396 * @new: page to replace with
397 * @gfp_mask: allocation mode
398 *
399 * This function replaces a page in the pagecache with a new one. On
400 * success it acquires the pagecache reference for the new page and
401 * drops it for the old page. Both the old and new pages must be
402 * locked. This function does not add the new page to the LRU, the
403 * caller must do that.
404 *
405 * The remove + add is atomic. The only way this function can fail is
406 * memory allocation failure.
407 */
408int replace_page_cache_page(struct page *old, struct page *new, gfp_t gfp_mask)
409{
410 int error;
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700411
Sasha Levin309381fea2014-01-23 15:52:54 -0800412 VM_BUG_ON_PAGE(!PageLocked(old), old);
413 VM_BUG_ON_PAGE(!PageLocked(new), new);
414 VM_BUG_ON_PAGE(new->mapping, new);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700415
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700416 error = radix_tree_preload(gfp_mask & ~__GFP_HIGHMEM);
417 if (!error) {
418 struct address_space *mapping = old->mapping;
419 void (*freepage)(struct page *);
420
421 pgoff_t offset = old->index;
422 freepage = mapping->a_ops->freepage;
423
424 page_cache_get(new);
425 new->mapping = mapping;
426 new->index = offset;
427
428 spin_lock_irq(&mapping->tree_lock);
Minchan Kime64a7822011-03-22 16:32:44 -0700429 __delete_from_page_cache(old);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700430 error = radix_tree_insert(&mapping->page_tree, offset, new);
431 BUG_ON(error);
432 mapping->nrpages++;
433 __inc_zone_page_state(new, NR_FILE_PAGES);
434 if (PageSwapBacked(new))
435 __inc_zone_page_state(new, NR_SHMEM);
436 spin_unlock_irq(&mapping->tree_lock);
KAMEZAWA Hiroyukiab936cb2012-01-12 17:17:44 -0800437 /* mem_cgroup codes must not be called under tree_lock */
438 mem_cgroup_replace_page_cache(old, new);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700439 radix_tree_preload_end();
440 if (freepage)
441 freepage(old);
442 page_cache_release(old);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700443 }
444
445 return error;
446}
447EXPORT_SYMBOL_GPL(replace_page_cache_page);
448
449/**
Nick Piggine2867812008-07-25 19:45:30 -0700450 * add_to_page_cache_locked - add a locked page to the pagecache
Randy Dunlap485bb992006-06-23 02:03:49 -0700451 * @page: page to add
452 * @mapping: the page's address_space
453 * @offset: page index
454 * @gfp_mask: page allocation mode
455 *
Nick Piggine2867812008-07-25 19:45:30 -0700456 * This function is used to add a page to the pagecache. It must be locked.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700457 * This function does not add the page to the LRU. The caller must do that.
458 */
Nick Piggine2867812008-07-25 19:45:30 -0700459int add_to_page_cache_locked(struct page *page, struct address_space *mapping,
Al Viro6daa0e22005-10-21 03:18:50 -0400460 pgoff_t offset, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700461{
Nick Piggine2867812008-07-25 19:45:30 -0700462 int error;
463
Sasha Levin309381fea2014-01-23 15:52:54 -0800464 VM_BUG_ON_PAGE(!PageLocked(page), page);
465 VM_BUG_ON_PAGE(PageSwapBacked(page), page);
Nick Piggine2867812008-07-25 19:45:30 -0700466
467 error = mem_cgroup_cache_charge(page, current->mm,
KAMEZAWA Hiroyuki2c26fdd2009-01-07 18:08:10 -0800468 gfp_mask & GFP_RECLAIM_MASK);
Balbir Singh35c754d2008-02-07 00:14:05 -0800469 if (error)
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700470 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700471
Jan Kara5e4c0d972013-09-11 14:26:05 -0700472 error = radix_tree_maybe_preload(gfp_mask & ~__GFP_HIGHMEM);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700473 if (error) {
KAMEZAWA Hiroyuki69029cd2008-07-25 01:47:14 -0700474 mem_cgroup_uncharge_cache_page(page);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700475 return error;
476 }
477
478 page_cache_get(page);
479 page->mapping = mapping;
480 page->index = offset;
481
482 spin_lock_irq(&mapping->tree_lock);
483 error = radix_tree_insert(&mapping->page_tree, offset, page);
484 radix_tree_preload_end();
485 if (unlikely(error))
486 goto err_insert;
487 mapping->nrpages++;
488 __inc_zone_page_state(page, NR_FILE_PAGES);
489 spin_unlock_irq(&mapping->tree_lock);
490 trace_mm_filemap_add_to_page_cache(page);
491 return 0;
492err_insert:
493 page->mapping = NULL;
494 /* Leave page->index set: truncation relies upon it */
495 spin_unlock_irq(&mapping->tree_lock);
496 mem_cgroup_uncharge_cache_page(page);
497 page_cache_release(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700498 return error;
499}
Nick Piggine2867812008-07-25 19:45:30 -0700500EXPORT_SYMBOL(add_to_page_cache_locked);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700501
502int add_to_page_cache_lru(struct page *page, struct address_space *mapping,
Al Viro6daa0e22005-10-21 03:18:50 -0400503 pgoff_t offset, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700504{
Rik van Riel4f98a2f2008-10-18 20:26:32 -0700505 int ret;
506
Rik van Riel4f98a2f2008-10-18 20:26:32 -0700507 ret = add_to_page_cache(page, mapping, offset, gfp_mask);
Hugh Dickins31475dd2011-08-03 16:21:27 -0700508 if (ret == 0)
509 lru_cache_add_file(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700510 return ret;
511}
Evgeniy Polyakov18bc0bb2009-02-09 17:02:42 +0300512EXPORT_SYMBOL_GPL(add_to_page_cache_lru);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700513
Paul Jackson44110fe2006-03-24 03:16:04 -0800514#ifdef CONFIG_NUMA
Nick Piggin2ae88142006-10-28 10:38:23 -0700515struct page *__page_cache_alloc(gfp_t gfp)
Paul Jackson44110fe2006-03-24 03:16:04 -0800516{
Miao Xiec0ff7452010-05-24 14:32:08 -0700517 int n;
518 struct page *page;
519
Paul Jackson44110fe2006-03-24 03:16:04 -0800520 if (cpuset_do_page_mem_spread()) {
Mel Gormancc9a6c82012-03-21 16:34:11 -0700521 unsigned int cpuset_mems_cookie;
522 do {
Mel Gormand26914d2014-04-03 14:47:24 -0700523 cpuset_mems_cookie = read_mems_allowed_begin();
Mel Gormancc9a6c82012-03-21 16:34:11 -0700524 n = cpuset_mem_spread_node();
525 page = alloc_pages_exact_node(n, gfp, 0);
Mel Gormand26914d2014-04-03 14:47:24 -0700526 } while (!page && read_mems_allowed_retry(cpuset_mems_cookie));
Mel Gormancc9a6c82012-03-21 16:34:11 -0700527
Miao Xiec0ff7452010-05-24 14:32:08 -0700528 return page;
Paul Jackson44110fe2006-03-24 03:16:04 -0800529 }
Nick Piggin2ae88142006-10-28 10:38:23 -0700530 return alloc_pages(gfp, 0);
Paul Jackson44110fe2006-03-24 03:16:04 -0800531}
Nick Piggin2ae88142006-10-28 10:38:23 -0700532EXPORT_SYMBOL(__page_cache_alloc);
Paul Jackson44110fe2006-03-24 03:16:04 -0800533#endif
534
Linus Torvalds1da177e2005-04-16 15:20:36 -0700535/*
536 * In order to wait for pages to become available there must be
537 * waitqueues associated with pages. By using a hash table of
538 * waitqueues where the bucket discipline is to maintain all
539 * waiters on the same queue and wake all when any of the pages
540 * become available, and for the woken contexts to check to be
541 * sure the appropriate page became available, this saves space
542 * at a cost of "thundering herd" phenomena during rare hash
543 * collisions.
544 */
545static wait_queue_head_t *page_waitqueue(struct page *page)
546{
547 const struct zone *zone = page_zone(page);
548
549 return &zone->wait_table[hash_ptr(page, zone->wait_table_bits)];
550}
551
552static inline void wake_up_page(struct page *page, int bit)
553{
554 __wake_up_bit(page_waitqueue(page), &page->flags, bit);
555}
556
Harvey Harrison920c7a52008-02-04 22:29:26 -0800557void wait_on_page_bit(struct page *page, int bit_nr)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700558{
559 DEFINE_WAIT_BIT(wait, &page->flags, bit_nr);
560
561 if (test_bit(bit_nr, &page->flags))
Jens Axboe7eaceac2011-03-10 08:52:07 +0100562 __wait_on_bit(page_waitqueue(page), &wait, sleep_on_page,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700563 TASK_UNINTERRUPTIBLE);
564}
565EXPORT_SYMBOL(wait_on_page_bit);
566
KOSAKI Motohirof62e00c2011-05-24 17:11:29 -0700567int wait_on_page_bit_killable(struct page *page, int bit_nr)
568{
569 DEFINE_WAIT_BIT(wait, &page->flags, bit_nr);
570
571 if (!test_bit(bit_nr, &page->flags))
572 return 0;
573
574 return __wait_on_bit(page_waitqueue(page), &wait,
575 sleep_on_page_killable, TASK_KILLABLE);
576}
577
Linus Torvalds1da177e2005-04-16 15:20:36 -0700578/**
David Howells385e1ca5f2009-04-03 16:42:39 +0100579 * add_page_wait_queue - Add an arbitrary waiter to a page's wait queue
Randy Dunlap697f6192009-04-13 14:39:54 -0700580 * @page: Page defining the wait queue of interest
581 * @waiter: Waiter to add to the queue
David Howells385e1ca5f2009-04-03 16:42:39 +0100582 *
583 * Add an arbitrary @waiter to the wait queue for the nominated @page.
584 */
585void add_page_wait_queue(struct page *page, wait_queue_t *waiter)
586{
587 wait_queue_head_t *q = page_waitqueue(page);
588 unsigned long flags;
589
590 spin_lock_irqsave(&q->lock, flags);
591 __add_wait_queue(q, waiter);
592 spin_unlock_irqrestore(&q->lock, flags);
593}
594EXPORT_SYMBOL_GPL(add_page_wait_queue);
595
596/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700597 * unlock_page - unlock a locked page
Linus Torvalds1da177e2005-04-16 15:20:36 -0700598 * @page: the page
599 *
600 * Unlocks the page and wakes up sleepers in ___wait_on_page_locked().
601 * Also wakes sleepers in wait_on_page_writeback() because the wakeup
602 * mechananism between PageLocked pages and PageWriteback pages is shared.
603 * But that's OK - sleepers in wait_on_page_writeback() just go back to sleep.
604 *
Nick Piggin8413ac92008-10-18 20:26:59 -0700605 * The mb is necessary to enforce ordering between the clear_bit and the read
606 * of the waitqueue (to avoid SMP races with a parallel wait_on_page_locked()).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700607 */
Harvey Harrison920c7a52008-02-04 22:29:26 -0800608void unlock_page(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700609{
Sasha Levin309381fea2014-01-23 15:52:54 -0800610 VM_BUG_ON_PAGE(!PageLocked(page), page);
Nick Piggin8413ac92008-10-18 20:26:59 -0700611 clear_bit_unlock(PG_locked, &page->flags);
612 smp_mb__after_clear_bit();
Linus Torvalds1da177e2005-04-16 15:20:36 -0700613 wake_up_page(page, PG_locked);
614}
615EXPORT_SYMBOL(unlock_page);
616
Randy Dunlap485bb992006-06-23 02:03:49 -0700617/**
618 * end_page_writeback - end writeback against a page
619 * @page: the page
Linus Torvalds1da177e2005-04-16 15:20:36 -0700620 */
621void end_page_writeback(struct page *page)
622{
Miklos Szerediac6aadb2008-04-28 02:12:38 -0700623 if (TestClearPageReclaim(page))
624 rotate_reclaimable_page(page);
625
626 if (!test_clear_page_writeback(page))
627 BUG();
628
Linus Torvalds1da177e2005-04-16 15:20:36 -0700629 smp_mb__after_clear_bit();
630 wake_up_page(page, PG_writeback);
631}
632EXPORT_SYMBOL(end_page_writeback);
633
Randy Dunlap485bb992006-06-23 02:03:49 -0700634/**
635 * __lock_page - get a lock on the page, assuming we need to sleep to get it
636 * @page: the page to lock
Linus Torvalds1da177e2005-04-16 15:20:36 -0700637 */
Harvey Harrison920c7a52008-02-04 22:29:26 -0800638void __lock_page(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700639{
640 DEFINE_WAIT_BIT(wait, &page->flags, PG_locked);
641
Jens Axboe7eaceac2011-03-10 08:52:07 +0100642 __wait_on_bit_lock(page_waitqueue(page), &wait, sleep_on_page,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700643 TASK_UNINTERRUPTIBLE);
644}
645EXPORT_SYMBOL(__lock_page);
646
Harvey Harrisonb5606c22008-02-13 15:03:16 -0800647int __lock_page_killable(struct page *page)
Matthew Wilcox2687a352007-12-06 11:18:49 -0500648{
649 DEFINE_WAIT_BIT(wait, &page->flags, PG_locked);
650
651 return __wait_on_bit_lock(page_waitqueue(page), &wait,
Jens Axboe7eaceac2011-03-10 08:52:07 +0100652 sleep_on_page_killable, TASK_KILLABLE);
Matthew Wilcox2687a352007-12-06 11:18:49 -0500653}
Evgeniy Polyakov18bc0bb2009-02-09 17:02:42 +0300654EXPORT_SYMBOL_GPL(__lock_page_killable);
Matthew Wilcox2687a352007-12-06 11:18:49 -0500655
Michel Lespinassed065bd82010-10-26 14:21:57 -0700656int __lock_page_or_retry(struct page *page, struct mm_struct *mm,
657 unsigned int flags)
658{
KOSAKI Motohiro37b23e02011-05-24 17:11:30 -0700659 if (flags & FAULT_FLAG_ALLOW_RETRY) {
660 /*
661 * CAUTION! In this case, mmap_sem is not released
662 * even though return 0.
663 */
664 if (flags & FAULT_FLAG_RETRY_NOWAIT)
665 return 0;
666
667 up_read(&mm->mmap_sem);
668 if (flags & FAULT_FLAG_KILLABLE)
669 wait_on_page_locked_killable(page);
670 else
Gleb Natapov318b2752011-03-22 16:30:51 -0700671 wait_on_page_locked(page);
Michel Lespinassed065bd82010-10-26 14:21:57 -0700672 return 0;
KOSAKI Motohiro37b23e02011-05-24 17:11:30 -0700673 } else {
674 if (flags & FAULT_FLAG_KILLABLE) {
675 int ret;
676
677 ret = __lock_page_killable(page);
678 if (ret) {
679 up_read(&mm->mmap_sem);
680 return 0;
681 }
682 } else
683 __lock_page(page);
684 return 1;
Michel Lespinassed065bd82010-10-26 14:21:57 -0700685 }
686}
687
Randy Dunlap485bb992006-06-23 02:03:49 -0700688/**
Johannes Weinere7b563b2014-04-03 14:47:44 -0700689 * page_cache_next_hole - find the next hole (not-present entry)
690 * @mapping: mapping
691 * @index: index
692 * @max_scan: maximum range to search
693 *
694 * Search the set [index, min(index+max_scan-1, MAX_INDEX)] for the
695 * lowest indexed hole.
696 *
697 * Returns: the index of the hole if found, otherwise returns an index
698 * outside of the set specified (in which case 'return - index >=
699 * max_scan' will be true). In rare cases of index wrap-around, 0 will
700 * be returned.
701 *
702 * page_cache_next_hole may be called under rcu_read_lock. However,
703 * like radix_tree_gang_lookup, this will not atomically search a
704 * snapshot of the tree at a single point in time. For example, if a
705 * hole is created at index 5, then subsequently a hole is created at
706 * index 10, page_cache_next_hole covering both indexes may return 10
707 * if called under rcu_read_lock.
708 */
709pgoff_t page_cache_next_hole(struct address_space *mapping,
710 pgoff_t index, unsigned long max_scan)
711{
712 unsigned long i;
713
714 for (i = 0; i < max_scan; i++) {
715 if (!radix_tree_lookup(&mapping->page_tree, index))
716 break;
717 index++;
718 if (index == 0)
719 break;
720 }
721
722 return index;
723}
724EXPORT_SYMBOL(page_cache_next_hole);
725
726/**
727 * page_cache_prev_hole - find the prev hole (not-present entry)
728 * @mapping: mapping
729 * @index: index
730 * @max_scan: maximum range to search
731 *
732 * Search backwards in the range [max(index-max_scan+1, 0), index] for
733 * the first hole.
734 *
735 * Returns: the index of the hole if found, otherwise returns an index
736 * outside of the set specified (in which case 'index - return >=
737 * max_scan' will be true). In rare cases of wrap-around, ULONG_MAX
738 * will be returned.
739 *
740 * page_cache_prev_hole may be called under rcu_read_lock. However,
741 * like radix_tree_gang_lookup, this will not atomically search a
742 * snapshot of the tree at a single point in time. For example, if a
743 * hole is created at index 10, then subsequently a hole is created at
744 * index 5, page_cache_prev_hole covering both indexes may return 5 if
745 * called under rcu_read_lock.
746 */
747pgoff_t page_cache_prev_hole(struct address_space *mapping,
748 pgoff_t index, unsigned long max_scan)
749{
750 unsigned long i;
751
752 for (i = 0; i < max_scan; i++) {
753 if (!radix_tree_lookup(&mapping->page_tree, index))
754 break;
755 index--;
756 if (index == ULONG_MAX)
757 break;
758 }
759
760 return index;
761}
762EXPORT_SYMBOL(page_cache_prev_hole);
763
764/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700765 * find_get_page - find and get a page reference
766 * @mapping: the address_space to search
767 * @offset: the page index
768 *
Nick Pigginda6052f2006-09-25 23:31:35 -0700769 * Is there a pagecache struct page at the given (mapping, offset) tuple?
770 * If yes, increment its refcount and return it; if no, return NULL.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700771 */
Nick Piggina60637c2008-07-25 19:45:31 -0700772struct page *find_get_page(struct address_space *mapping, pgoff_t offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700773{
Nick Piggina60637c2008-07-25 19:45:31 -0700774 void **pagep;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700775 struct page *page;
776
Nick Piggina60637c2008-07-25 19:45:31 -0700777 rcu_read_lock();
778repeat:
779 page = NULL;
780 pagep = radix_tree_lookup_slot(&mapping->page_tree, offset);
781 if (pagep) {
782 page = radix_tree_deref_slot(pagep);
Nick Piggin27d20fd2010-11-11 14:05:19 -0800783 if (unlikely(!page))
784 goto out;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700785 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -0700786 if (radix_tree_deref_retry(page))
787 goto repeat;
788 /*
789 * Otherwise, shmem/tmpfs must be storing a swap entry
790 * here as an exceptional entry: so return it without
791 * attempting to raise page count.
792 */
793 goto out;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700794 }
Nick Piggina60637c2008-07-25 19:45:31 -0700795 if (!page_cache_get_speculative(page))
796 goto repeat;
797
798 /*
799 * Has the page moved?
800 * This is part of the lockless pagecache protocol. See
801 * include/linux/pagemap.h for details.
802 */
803 if (unlikely(page != *pagep)) {
804 page_cache_release(page);
805 goto repeat;
806 }
807 }
Nick Piggin27d20fd2010-11-11 14:05:19 -0800808out:
Nick Piggina60637c2008-07-25 19:45:31 -0700809 rcu_read_unlock();
810
Linus Torvalds1da177e2005-04-16 15:20:36 -0700811 return page;
812}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700813EXPORT_SYMBOL(find_get_page);
814
Randy Dunlap485bb992006-06-23 02:03:49 -0700815/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700816 * find_lock_page - locate, pin and lock a pagecache page
Martin Waitz67be2dd2005-05-01 08:59:26 -0700817 * @mapping: the address_space to search
818 * @offset: the page index
Linus Torvalds1da177e2005-04-16 15:20:36 -0700819 *
820 * Locates the desired pagecache page, locks it, increments its reference
821 * count and returns its address.
822 *
823 * Returns zero if the page was not present. find_lock_page() may sleep.
824 */
Nick Piggina60637c2008-07-25 19:45:31 -0700825struct page *find_lock_page(struct address_space *mapping, pgoff_t offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700826{
827 struct page *page;
828
Linus Torvalds1da177e2005-04-16 15:20:36 -0700829repeat:
Nick Piggina60637c2008-07-25 19:45:31 -0700830 page = find_get_page(mapping, offset);
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700831 if (page && !radix_tree_exception(page)) {
Nick Piggina60637c2008-07-25 19:45:31 -0700832 lock_page(page);
833 /* Has the page been truncated? */
834 if (unlikely(page->mapping != mapping)) {
835 unlock_page(page);
836 page_cache_release(page);
837 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700838 }
Sasha Levin309381fea2014-01-23 15:52:54 -0800839 VM_BUG_ON_PAGE(page->index != offset, page);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700840 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700841 return page;
842}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700843EXPORT_SYMBOL(find_lock_page);
844
845/**
846 * find_or_create_page - locate or add a pagecache page
Martin Waitz67be2dd2005-05-01 08:59:26 -0700847 * @mapping: the page's address_space
848 * @index: the page's index into the mapping
849 * @gfp_mask: page allocation mode
Linus Torvalds1da177e2005-04-16 15:20:36 -0700850 *
851 * Locates a page in the pagecache. If the page is not present, a new page
852 * is allocated using @gfp_mask and is added to the pagecache and to the VM's
853 * LRU list. The returned page is locked and has its reference count
854 * incremented.
855 *
856 * find_or_create_page() may sleep, even if @gfp_flags specifies an atomic
857 * allocation!
858 *
859 * find_or_create_page() returns the desired page's address, or zero on
860 * memory exhaustion.
861 */
862struct page *find_or_create_page(struct address_space *mapping,
Fengguang Wu57f6b962007-10-16 01:24:37 -0700863 pgoff_t index, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700864{
Nick Piggineb2be182007-10-16 01:24:57 -0700865 struct page *page;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700866 int err;
867repeat:
868 page = find_lock_page(mapping, index);
869 if (!page) {
Nick Piggineb2be182007-10-16 01:24:57 -0700870 page = __page_cache_alloc(gfp_mask);
871 if (!page)
872 return NULL;
Nick Piggin67d58ac2009-01-06 14:40:28 -0800873 /*
874 * We want a regular kernel memory (not highmem or DMA etc)
875 * allocation for the radix tree nodes, but we need to honour
876 * the context-specific requirements the caller has asked for.
877 * GFP_RECLAIM_MASK collects those requirements.
878 */
879 err = add_to_page_cache_lru(page, mapping, index,
880 (gfp_mask & GFP_RECLAIM_MASK));
Nick Piggineb2be182007-10-16 01:24:57 -0700881 if (unlikely(err)) {
882 page_cache_release(page);
883 page = NULL;
884 if (err == -EEXIST)
885 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700886 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700887 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700888 return page;
889}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700890EXPORT_SYMBOL(find_or_create_page);
891
892/**
893 * find_get_pages - gang pagecache lookup
894 * @mapping: The address_space to search
895 * @start: The starting page index
896 * @nr_pages: The maximum number of pages
897 * @pages: Where the resulting pages are placed
898 *
899 * find_get_pages() will search for and return a group of up to
900 * @nr_pages pages in the mapping. The pages are placed at @pages.
901 * find_get_pages() takes a reference against the returned pages.
902 *
903 * The search returns a group of mapping-contiguous pages with ascending
904 * indexes. There may be holes in the indices due to not-present pages.
905 *
906 * find_get_pages() returns the number of pages which were found.
907 */
908unsigned find_get_pages(struct address_space *mapping, pgoff_t start,
909 unsigned int nr_pages, struct page **pages)
910{
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700911 struct radix_tree_iter iter;
912 void **slot;
913 unsigned ret = 0;
914
915 if (unlikely(!nr_pages))
916 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700917
Nick Piggina60637c2008-07-25 19:45:31 -0700918 rcu_read_lock();
919restart:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700920 radix_tree_for_each_slot(slot, &mapping->page_tree, &iter, start) {
Nick Piggina60637c2008-07-25 19:45:31 -0700921 struct page *page;
922repeat:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700923 page = radix_tree_deref_slot(slot);
Nick Piggina60637c2008-07-25 19:45:31 -0700924 if (unlikely(!page))
925 continue;
Hugh Dickins9d8aa4e2011-03-22 16:33:06 -0700926
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700927 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -0700928 if (radix_tree_deref_retry(page)) {
929 /*
930 * Transient condition which can only trigger
931 * when entry at index 0 moves out of or back
932 * to root: none yet gotten, safe to restart.
933 */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700934 WARN_ON(iter.index);
Hugh Dickins8079b1c2011-08-03 16:21:28 -0700935 goto restart;
936 }
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700937 /*
Hugh Dickins8079b1c2011-08-03 16:21:28 -0700938 * Otherwise, shmem/tmpfs must be storing a swap entry
939 * here as an exceptional entry: so skip over it -
940 * we only reach this from invalidate_mapping_pages().
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700941 */
Hugh Dickins8079b1c2011-08-03 16:21:28 -0700942 continue;
Nick Piggin27d20fd2010-11-11 14:05:19 -0800943 }
Nick Piggina60637c2008-07-25 19:45:31 -0700944
945 if (!page_cache_get_speculative(page))
946 goto repeat;
947
948 /* Has the page moved? */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700949 if (unlikely(page != *slot)) {
Nick Piggina60637c2008-07-25 19:45:31 -0700950 page_cache_release(page);
951 goto repeat;
952 }
953
954 pages[ret] = page;
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700955 if (++ret == nr_pages)
956 break;
Nick Piggina60637c2008-07-25 19:45:31 -0700957 }
Hugh Dickins5b280c02011-03-22 16:33:07 -0700958
Nick Piggina60637c2008-07-25 19:45:31 -0700959 rcu_read_unlock();
Linus Torvalds1da177e2005-04-16 15:20:36 -0700960 return ret;
961}
962
Jens Axboeebf43502006-04-27 08:46:01 +0200963/**
964 * find_get_pages_contig - gang contiguous pagecache lookup
965 * @mapping: The address_space to search
966 * @index: The starting page index
967 * @nr_pages: The maximum number of pages
968 * @pages: Where the resulting pages are placed
969 *
970 * find_get_pages_contig() works exactly like find_get_pages(), except
971 * that the returned number of pages are guaranteed to be contiguous.
972 *
973 * find_get_pages_contig() returns the number of pages which were found.
974 */
975unsigned find_get_pages_contig(struct address_space *mapping, pgoff_t index,
976 unsigned int nr_pages, struct page **pages)
977{
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700978 struct radix_tree_iter iter;
979 void **slot;
980 unsigned int ret = 0;
981
982 if (unlikely(!nr_pages))
983 return 0;
Jens Axboeebf43502006-04-27 08:46:01 +0200984
Nick Piggina60637c2008-07-25 19:45:31 -0700985 rcu_read_lock();
986restart:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700987 radix_tree_for_each_contig(slot, &mapping->page_tree, &iter, index) {
Nick Piggina60637c2008-07-25 19:45:31 -0700988 struct page *page;
989repeat:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700990 page = radix_tree_deref_slot(slot);
991 /* The hole, there no reason to continue */
Nick Piggina60637c2008-07-25 19:45:31 -0700992 if (unlikely(!page))
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -0700993 break;
Hugh Dickins9d8aa4e2011-03-22 16:33:06 -0700994
Hugh Dickinsa2c16d62011-08-03 16:21:19 -0700995 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -0700996 if (radix_tree_deref_retry(page)) {
997 /*
998 * Transient condition which can only trigger
999 * when entry at index 0 moves out of or back
1000 * to root: none yet gotten, safe to restart.
1001 */
1002 goto restart;
1003 }
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001004 /*
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001005 * Otherwise, shmem/tmpfs must be storing a swap entry
1006 * here as an exceptional entry: so stop looking for
1007 * contiguous pages.
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001008 */
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001009 break;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001010 }
Nick Piggina60637c2008-07-25 19:45:31 -07001011
Nick Piggina60637c2008-07-25 19:45:31 -07001012 if (!page_cache_get_speculative(page))
1013 goto repeat;
1014
1015 /* Has the page moved? */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001016 if (unlikely(page != *slot)) {
Nick Piggina60637c2008-07-25 19:45:31 -07001017 page_cache_release(page);
1018 goto repeat;
1019 }
1020
Nick Piggin9cbb4cb2011-01-13 15:45:51 -08001021 /*
1022 * must check mapping and index after taking the ref.
1023 * otherwise we can get both false positives and false
1024 * negatives, which is just confusing to the caller.
1025 */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001026 if (page->mapping == NULL || page->index != iter.index) {
Nick Piggin9cbb4cb2011-01-13 15:45:51 -08001027 page_cache_release(page);
1028 break;
1029 }
1030
Nick Piggina60637c2008-07-25 19:45:31 -07001031 pages[ret] = page;
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001032 if (++ret == nr_pages)
1033 break;
Jens Axboeebf43502006-04-27 08:46:01 +02001034 }
Nick Piggina60637c2008-07-25 19:45:31 -07001035 rcu_read_unlock();
1036 return ret;
Jens Axboeebf43502006-04-27 08:46:01 +02001037}
David Howellsef71c152007-05-09 02:33:44 -07001038EXPORT_SYMBOL(find_get_pages_contig);
Jens Axboeebf43502006-04-27 08:46:01 +02001039
Randy Dunlap485bb992006-06-23 02:03:49 -07001040/**
1041 * find_get_pages_tag - find and return pages that match @tag
1042 * @mapping: the address_space to search
1043 * @index: the starting page index
1044 * @tag: the tag index
1045 * @nr_pages: the maximum number of pages
1046 * @pages: where the resulting pages are placed
1047 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07001048 * Like find_get_pages, except we only return pages which are tagged with
Randy Dunlap485bb992006-06-23 02:03:49 -07001049 * @tag. We update @index to index the next page for the traversal.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001050 */
1051unsigned find_get_pages_tag(struct address_space *mapping, pgoff_t *index,
1052 int tag, unsigned int nr_pages, struct page **pages)
1053{
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001054 struct radix_tree_iter iter;
1055 void **slot;
1056 unsigned ret = 0;
1057
1058 if (unlikely(!nr_pages))
1059 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001060
Nick Piggina60637c2008-07-25 19:45:31 -07001061 rcu_read_lock();
1062restart:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001063 radix_tree_for_each_tagged(slot, &mapping->page_tree,
1064 &iter, *index, tag) {
Nick Piggina60637c2008-07-25 19:45:31 -07001065 struct page *page;
1066repeat:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001067 page = radix_tree_deref_slot(slot);
Nick Piggina60637c2008-07-25 19:45:31 -07001068 if (unlikely(!page))
1069 continue;
Hugh Dickins9d8aa4e2011-03-22 16:33:06 -07001070
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001071 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001072 if (radix_tree_deref_retry(page)) {
1073 /*
1074 * Transient condition which can only trigger
1075 * when entry at index 0 moves out of or back
1076 * to root: none yet gotten, safe to restart.
1077 */
1078 goto restart;
1079 }
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001080 /*
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001081 * This function is never used on a shmem/tmpfs
1082 * mapping, so a swap entry won't be found here.
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001083 */
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001084 BUG();
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001085 }
Nick Piggina60637c2008-07-25 19:45:31 -07001086
1087 if (!page_cache_get_speculative(page))
1088 goto repeat;
1089
1090 /* Has the page moved? */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001091 if (unlikely(page != *slot)) {
Nick Piggina60637c2008-07-25 19:45:31 -07001092 page_cache_release(page);
1093 goto repeat;
1094 }
1095
1096 pages[ret] = page;
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001097 if (++ret == nr_pages)
1098 break;
Nick Piggina60637c2008-07-25 19:45:31 -07001099 }
Hugh Dickins5b280c02011-03-22 16:33:07 -07001100
Nick Piggina60637c2008-07-25 19:45:31 -07001101 rcu_read_unlock();
1102
Linus Torvalds1da177e2005-04-16 15:20:36 -07001103 if (ret)
1104 *index = pages[ret - 1]->index + 1;
Nick Piggina60637c2008-07-25 19:45:31 -07001105
Linus Torvalds1da177e2005-04-16 15:20:36 -07001106 return ret;
1107}
David Howellsef71c152007-05-09 02:33:44 -07001108EXPORT_SYMBOL(find_get_pages_tag);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001109
Randy Dunlap485bb992006-06-23 02:03:49 -07001110/**
1111 * grab_cache_page_nowait - returns locked page at given index in given cache
1112 * @mapping: target address_space
1113 * @index: the page index
1114 *
Robert P. J. Day72fd4a32007-02-10 01:45:59 -08001115 * Same as grab_cache_page(), but do not wait if the page is unavailable.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001116 * This is intended for speculative data generators, where the data can
1117 * be regenerated if the page couldn't be grabbed. This routine should
1118 * be safe to call while holding the lock for another page.
1119 *
1120 * Clear __GFP_FS when allocating the page to avoid recursion into the fs
1121 * and deadlock against the caller's locked page.
1122 */
1123struct page *
Fengguang Wu57f6b962007-10-16 01:24:37 -07001124grab_cache_page_nowait(struct address_space *mapping, pgoff_t index)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001125{
1126 struct page *page = find_get_page(mapping, index);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001127
1128 if (page) {
Nick Piggin529ae9a2008-08-02 12:01:03 +02001129 if (trylock_page(page))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001130 return page;
1131 page_cache_release(page);
1132 return NULL;
1133 }
Nick Piggin2ae88142006-10-28 10:38:23 -07001134 page = __page_cache_alloc(mapping_gfp_mask(mapping) & ~__GFP_FS);
Nick Piggin67d58ac2009-01-06 14:40:28 -08001135 if (page && add_to_page_cache_lru(page, mapping, index, GFP_NOFS)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001136 page_cache_release(page);
1137 page = NULL;
1138 }
1139 return page;
1140}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001141EXPORT_SYMBOL(grab_cache_page_nowait);
1142
Wu Fengguang76d42bd2006-06-25 05:48:43 -07001143/*
1144 * CD/DVDs are error prone. When a medium error occurs, the driver may fail
1145 * a _large_ part of the i/o request. Imagine the worst scenario:
1146 *
1147 * ---R__________________________________________B__________
1148 * ^ reading here ^ bad block(assume 4k)
1149 *
1150 * read(R) => miss => readahead(R...B) => media error => frustrating retries
1151 * => failing the whole request => read(R) => read(R+1) =>
1152 * readahead(R+1...B+1) => bang => read(R+2) => read(R+3) =>
1153 * readahead(R+3...B+2) => bang => read(R+3) => read(R+4) =>
1154 * readahead(R+4...B+3) => bang => read(R+4) => read(R+5) => ......
1155 *
1156 * It is going insane. Fix it by quickly scaling down the readahead size.
1157 */
1158static void shrink_readahead_size_eio(struct file *filp,
1159 struct file_ra_state *ra)
1160{
Wu Fengguang76d42bd2006-06-25 05:48:43 -07001161 ra->ra_pages /= 4;
Wu Fengguang76d42bd2006-06-25 05:48:43 -07001162}
1163
Randy Dunlap485bb992006-06-23 02:03:49 -07001164/**
Christoph Hellwig36e78912008-02-08 04:21:24 -08001165 * do_generic_file_read - generic file read routine
Randy Dunlap485bb992006-06-23 02:03:49 -07001166 * @filp: the file to read
1167 * @ppos: current file position
1168 * @desc: read_descriptor
Randy Dunlap485bb992006-06-23 02:03:49 -07001169 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07001170 * This is a generic file read routine, and uses the
Randy Dunlap485bb992006-06-23 02:03:49 -07001171 * mapping->a_ops->readpage() function for the actual low-level stuff.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001172 *
1173 * This is really ugly. But the goto's actually try to clarify some
1174 * of the logic when it comes to error handling etc.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001175 */
Christoph Hellwig36e78912008-02-08 04:21:24 -08001176static void do_generic_file_read(struct file *filp, loff_t *ppos,
Kirill A. Shutemovb77d88d2013-11-14 14:30:40 -08001177 read_descriptor_t *desc)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001178{
Christoph Hellwig36e78912008-02-08 04:21:24 -08001179 struct address_space *mapping = filp->f_mapping;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001180 struct inode *inode = mapping->host;
Christoph Hellwig36e78912008-02-08 04:21:24 -08001181 struct file_ra_state *ra = &filp->f_ra;
Fengguang Wu57f6b962007-10-16 01:24:37 -07001182 pgoff_t index;
1183 pgoff_t last_index;
1184 pgoff_t prev_index;
1185 unsigned long offset; /* offset into pagecache page */
Jan Karaec0f1632007-05-06 14:49:25 -07001186 unsigned int prev_offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001187 int error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001188
Linus Torvalds1da177e2005-04-16 15:20:36 -07001189 index = *ppos >> PAGE_CACHE_SHIFT;
Fengguang Wu7ff81072007-10-16 01:24:35 -07001190 prev_index = ra->prev_pos >> PAGE_CACHE_SHIFT;
1191 prev_offset = ra->prev_pos & (PAGE_CACHE_SIZE-1);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001192 last_index = (*ppos + desc->count + PAGE_CACHE_SIZE-1) >> PAGE_CACHE_SHIFT;
1193 offset = *ppos & ~PAGE_CACHE_MASK;
1194
Linus Torvalds1da177e2005-04-16 15:20:36 -07001195 for (;;) {
1196 struct page *page;
Fengguang Wu57f6b962007-10-16 01:24:37 -07001197 pgoff_t end_index;
NeilBrowna32ea1e2007-07-17 04:03:04 -07001198 loff_t isize;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001199 unsigned long nr, ret;
1200
Linus Torvalds1da177e2005-04-16 15:20:36 -07001201 cond_resched();
Linus Torvalds1da177e2005-04-16 15:20:36 -07001202find_page:
1203 page = find_get_page(mapping, index);
Fengguang Wu3ea89ee2007-07-19 01:48:02 -07001204 if (!page) {
Rusty Russellcf914a72007-07-19 01:48:08 -07001205 page_cache_sync_readahead(mapping,
Fengguang Wu7ff81072007-10-16 01:24:35 -07001206 ra, filp,
Fengguang Wu3ea89ee2007-07-19 01:48:02 -07001207 index, last_index - index);
1208 page = find_get_page(mapping, index);
1209 if (unlikely(page == NULL))
1210 goto no_cached_page;
1211 }
1212 if (PageReadahead(page)) {
Rusty Russellcf914a72007-07-19 01:48:08 -07001213 page_cache_async_readahead(mapping,
Fengguang Wu7ff81072007-10-16 01:24:35 -07001214 ra, filp, page,
Fengguang Wu3ea89ee2007-07-19 01:48:02 -07001215 index, last_index - index);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001216 }
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001217 if (!PageUptodate(page)) {
1218 if (inode->i_blkbits == PAGE_CACHE_SHIFT ||
1219 !mapping->a_ops->is_partially_uptodate)
1220 goto page_not_up_to_date;
Nick Piggin529ae9a2008-08-02 12:01:03 +02001221 if (!trylock_page(page))
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001222 goto page_not_up_to_date;
Dave Hansen8d056cb2010-11-11 14:05:15 -08001223 /* Did it get truncated before we got the lock? */
1224 if (!page->mapping)
1225 goto page_not_up_to_date_locked;
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001226 if (!mapping->a_ops->is_partially_uptodate(page,
1227 desc, offset))
1228 goto page_not_up_to_date_locked;
1229 unlock_page(page);
1230 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001231page_ok:
NeilBrowna32ea1e2007-07-17 04:03:04 -07001232 /*
1233 * i_size must be checked after we know the page is Uptodate.
1234 *
1235 * Checking i_size after the check allows us to calculate
1236 * the correct value for "nr", which means the zero-filled
1237 * part of the page is not copied back to userspace (unless
1238 * another truncate extends the file - this is desired though).
1239 */
1240
1241 isize = i_size_read(inode);
1242 end_index = (isize - 1) >> PAGE_CACHE_SHIFT;
1243 if (unlikely(!isize || index > end_index)) {
1244 page_cache_release(page);
1245 goto out;
1246 }
1247
1248 /* nr is the maximum number of bytes to copy from this page */
1249 nr = PAGE_CACHE_SIZE;
1250 if (index == end_index) {
1251 nr = ((isize - 1) & ~PAGE_CACHE_MASK) + 1;
1252 if (nr <= offset) {
1253 page_cache_release(page);
1254 goto out;
1255 }
1256 }
1257 nr = nr - offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001258
1259 /* If users can be writing to this page using arbitrary
1260 * virtual addresses, take care about potential aliasing
1261 * before reading the page on the kernel side.
1262 */
1263 if (mapping_writably_mapped(mapping))
1264 flush_dcache_page(page);
1265
1266 /*
Jan Karaec0f1632007-05-06 14:49:25 -07001267 * When a sequential read accesses a page several times,
1268 * only mark it as accessed the first time.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001269 */
Jan Karaec0f1632007-05-06 14:49:25 -07001270 if (prev_index != index || offset != prev_offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001271 mark_page_accessed(page);
1272 prev_index = index;
1273
1274 /*
1275 * Ok, we have the page, and it's up-to-date, so
1276 * now we can copy it to user space...
1277 *
Kirill A. Shutemovb77d88d2013-11-14 14:30:40 -08001278 * The file_read_actor routine returns how many bytes were
1279 * actually used..
Linus Torvalds1da177e2005-04-16 15:20:36 -07001280 * NOTE! This may not be the same as how much of a user buffer
1281 * we filled up (we may be padding etc), so we can only update
1282 * "pos" here (the actor routine has to update the user buffer
1283 * pointers and the remaining count).
1284 */
Kirill A. Shutemovb77d88d2013-11-14 14:30:40 -08001285 ret = file_read_actor(desc, page, offset, nr);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001286 offset += ret;
1287 index += offset >> PAGE_CACHE_SHIFT;
1288 offset &= ~PAGE_CACHE_MASK;
Jan Kara6ce745e2007-05-06 14:49:26 -07001289 prev_offset = offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001290
1291 page_cache_release(page);
1292 if (ret == nr && desc->count)
1293 continue;
1294 goto out;
1295
1296page_not_up_to_date:
1297 /* Get exclusive access to the page ... */
Oleg Nesterov85462322008-06-08 21:20:43 +04001298 error = lock_page_killable(page);
1299 if (unlikely(error))
1300 goto readpage_error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001301
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001302page_not_up_to_date_locked:
Nick Pigginda6052f2006-09-25 23:31:35 -07001303 /* Did it get truncated before we got the lock? */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001304 if (!page->mapping) {
1305 unlock_page(page);
1306 page_cache_release(page);
1307 continue;
1308 }
1309
1310 /* Did somebody else fill it already? */
1311 if (PageUptodate(page)) {
1312 unlock_page(page);
1313 goto page_ok;
1314 }
1315
1316readpage:
Jeff Moyer91803b42010-05-26 11:49:40 -04001317 /*
1318 * A previous I/O error may have been due to temporary
1319 * failures, eg. multipath errors.
1320 * PG_error will be set again if readpage fails.
1321 */
1322 ClearPageError(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001323 /* Start the actual read. The read will unlock the page. */
1324 error = mapping->a_ops->readpage(filp, page);
1325
Zach Brown994fc28c2005-12-15 14:28:17 -08001326 if (unlikely(error)) {
1327 if (error == AOP_TRUNCATED_PAGE) {
1328 page_cache_release(page);
1329 goto find_page;
1330 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001331 goto readpage_error;
Zach Brown994fc28c2005-12-15 14:28:17 -08001332 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001333
1334 if (!PageUptodate(page)) {
Oleg Nesterov85462322008-06-08 21:20:43 +04001335 error = lock_page_killable(page);
1336 if (unlikely(error))
1337 goto readpage_error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001338 if (!PageUptodate(page)) {
1339 if (page->mapping == NULL) {
1340 /*
Christoph Hellwig2ecdc822010-01-26 17:27:20 +01001341 * invalidate_mapping_pages got it
Linus Torvalds1da177e2005-04-16 15:20:36 -07001342 */
1343 unlock_page(page);
1344 page_cache_release(page);
1345 goto find_page;
1346 }
1347 unlock_page(page);
Fengguang Wu7ff81072007-10-16 01:24:35 -07001348 shrink_readahead_size_eio(filp, ra);
Oleg Nesterov85462322008-06-08 21:20:43 +04001349 error = -EIO;
1350 goto readpage_error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001351 }
1352 unlock_page(page);
1353 }
1354
Linus Torvalds1da177e2005-04-16 15:20:36 -07001355 goto page_ok;
1356
1357readpage_error:
1358 /* UHHUH! A synchronous read error occurred. Report it */
1359 desc->error = error;
1360 page_cache_release(page);
1361 goto out;
1362
1363no_cached_page:
1364 /*
1365 * Ok, it wasn't cached, so we need to create a new
1366 * page..
1367 */
Nick Piggineb2be182007-10-16 01:24:57 -07001368 page = page_cache_alloc_cold(mapping);
1369 if (!page) {
1370 desc->error = -ENOMEM;
1371 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001372 }
Nick Piggineb2be182007-10-16 01:24:57 -07001373 error = add_to_page_cache_lru(page, mapping,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001374 index, GFP_KERNEL);
1375 if (error) {
Nick Piggineb2be182007-10-16 01:24:57 -07001376 page_cache_release(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001377 if (error == -EEXIST)
1378 goto find_page;
1379 desc->error = error;
1380 goto out;
1381 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001382 goto readpage;
1383 }
1384
1385out:
Fengguang Wu7ff81072007-10-16 01:24:35 -07001386 ra->prev_pos = prev_index;
1387 ra->prev_pos <<= PAGE_CACHE_SHIFT;
1388 ra->prev_pos |= prev_offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001389
Fengguang Wuf4e6b492007-10-16 01:24:33 -07001390 *ppos = ((loff_t)index << PAGE_CACHE_SHIFT) + offset;
Krishna Kumar0c6aa262008-10-15 22:01:13 -07001391 file_accessed(filp);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001392}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001393
1394int file_read_actor(read_descriptor_t *desc, struct page *page,
1395 unsigned long offset, unsigned long size)
1396{
1397 char *kaddr;
1398 unsigned long left, count = desc->count;
1399
1400 if (size > count)
1401 size = count;
1402
1403 /*
1404 * Faults on the destination of a read are common, so do it before
1405 * taking the kmap.
1406 */
1407 if (!fault_in_pages_writeable(desc->arg.buf, size)) {
Cong Wang9b04c5f2011-11-25 23:14:39 +08001408 kaddr = kmap_atomic(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001409 left = __copy_to_user_inatomic(desc->arg.buf,
1410 kaddr + offset, size);
Cong Wang9b04c5f2011-11-25 23:14:39 +08001411 kunmap_atomic(kaddr);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001412 if (left == 0)
1413 goto success;
1414 }
1415
1416 /* Do it the slow way */
1417 kaddr = kmap(page);
1418 left = __copy_to_user(desc->arg.buf, kaddr + offset, size);
1419 kunmap(page);
1420
1421 if (left) {
1422 size -= left;
1423 desc->error = -EFAULT;
1424 }
1425success:
1426 desc->count = count - size;
1427 desc->written += size;
1428 desc->arg.buf += size;
1429 return size;
1430}
1431
Dmitriy Monakhov0ceb3312007-05-08 00:23:02 -07001432/*
1433 * Performs necessary checks before doing a write
1434 * @iov: io vector request
1435 * @nr_segs: number of segments in the iovec
1436 * @count: number of bytes to write
1437 * @access_flags: type of access: %VERIFY_READ or %VERIFY_WRITE
1438 *
1439 * Adjust number of segments and amount of bytes to write (nr_segs should be
1440 * properly initialized first). Returns appropriate error code that caller
1441 * should return or zero in case that write should be allowed.
1442 */
1443int generic_segment_checks(const struct iovec *iov,
1444 unsigned long *nr_segs, size_t *count, int access_flags)
1445{
1446 unsigned long seg;
1447 size_t cnt = 0;
1448 for (seg = 0; seg < *nr_segs; seg++) {
1449 const struct iovec *iv = &iov[seg];
1450
1451 /*
1452 * If any segment has a negative length, or the cumulative
1453 * length ever wraps negative then return -EINVAL.
1454 */
1455 cnt += iv->iov_len;
1456 if (unlikely((ssize_t)(cnt|iv->iov_len) < 0))
1457 return -EINVAL;
1458 if (access_ok(access_flags, iv->iov_base, iv->iov_len))
1459 continue;
1460 if (seg == 0)
1461 return -EFAULT;
1462 *nr_segs = seg;
1463 cnt -= iv->iov_len; /* This segment is no good */
1464 break;
1465 }
1466 *count = cnt;
1467 return 0;
1468}
1469EXPORT_SYMBOL(generic_segment_checks);
1470
Randy Dunlap485bb992006-06-23 02:03:49 -07001471/**
Henrik Kretzschmarb2abacf2006-10-04 02:15:22 -07001472 * generic_file_aio_read - generic filesystem read routine
Randy Dunlap485bb992006-06-23 02:03:49 -07001473 * @iocb: kernel I/O control block
1474 * @iov: io vector request
1475 * @nr_segs: number of segments in the iovec
Henrik Kretzschmarb2abacf2006-10-04 02:15:22 -07001476 * @pos: current file position
Randy Dunlap485bb992006-06-23 02:03:49 -07001477 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07001478 * This is the "read()" routine for all filesystems
1479 * that can use the page cache directly.
1480 */
1481ssize_t
Badari Pulavarty543ade12006-09-30 23:28:48 -07001482generic_file_aio_read(struct kiocb *iocb, const struct iovec *iov,
1483 unsigned long nr_segs, loff_t pos)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001484{
1485 struct file *filp = iocb->ki_filp;
1486 ssize_t retval;
Josef Bacik66f998f2010-05-23 11:00:54 -04001487 unsigned long seg = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001488 size_t count;
Badari Pulavarty543ade12006-09-30 23:28:48 -07001489 loff_t *ppos = &iocb->ki_pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001490
1491 count = 0;
Dmitriy Monakhov0ceb3312007-05-08 00:23:02 -07001492 retval = generic_segment_checks(iov, &nr_segs, &count, VERIFY_WRITE);
1493 if (retval)
1494 return retval;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001495
1496 /* coalesce the iovecs and go direct-to-BIO for O_DIRECT */
1497 if (filp->f_flags & O_DIRECT) {
Badari Pulavarty543ade12006-09-30 23:28:48 -07001498 loff_t size;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001499 struct address_space *mapping;
1500 struct inode *inode;
1501
1502 mapping = filp->f_mapping;
1503 inode = mapping->host;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001504 if (!count)
1505 goto out; /* skip atime */
1506 size = i_size_read(inode);
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00001507 retval = filemap_write_and_wait_range(mapping, pos,
Nick Piggin48b47c52009-01-06 14:40:22 -08001508 pos + iov_length(iov, nr_segs) - 1);
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00001509 if (!retval) {
1510 retval = mapping->a_ops->direct_IO(READ, iocb,
1511 iov, pos, nr_segs);
1512 }
1513 if (retval > 0) {
1514 *ppos = pos + retval;
1515 count -= retval;
1516 }
Josef Bacik66f998f2010-05-23 11:00:54 -04001517
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00001518 /*
1519 * Btrfs can have a short DIO read if we encounter
1520 * compressed extents, so if there was an error, or if
1521 * we've already read everything we wanted to, or if
1522 * there was a short read because we hit EOF, go ahead
1523 * and return. Otherwise fallthrough to buffered io for
1524 * the rest of the read.
1525 */
1526 if (retval < 0 || !count || *ppos >= size) {
1527 file_accessed(filp);
1528 goto out;
Steven Whitehouse0e0bcae2006-09-27 14:45:07 -04001529 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001530 }
1531
Josef Bacik66f998f2010-05-23 11:00:54 -04001532 count = retval;
Hugh Dickins11fa9772008-07-23 21:27:34 -07001533 for (seg = 0; seg < nr_segs; seg++) {
1534 read_descriptor_t desc;
Josef Bacik66f998f2010-05-23 11:00:54 -04001535 loff_t offset = 0;
1536
1537 /*
1538 * If we did a short DIO read we need to skip the section of the
1539 * iov that we've already read data into.
1540 */
1541 if (count) {
1542 if (count > iov[seg].iov_len) {
1543 count -= iov[seg].iov_len;
1544 continue;
1545 }
1546 offset = count;
1547 count = 0;
1548 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001549
Hugh Dickins11fa9772008-07-23 21:27:34 -07001550 desc.written = 0;
Josef Bacik66f998f2010-05-23 11:00:54 -04001551 desc.arg.buf = iov[seg].iov_base + offset;
1552 desc.count = iov[seg].iov_len - offset;
Hugh Dickins11fa9772008-07-23 21:27:34 -07001553 if (desc.count == 0)
1554 continue;
1555 desc.error = 0;
Kirill A. Shutemovb77d88d2013-11-14 14:30:40 -08001556 do_generic_file_read(filp, ppos, &desc);
Hugh Dickins11fa9772008-07-23 21:27:34 -07001557 retval += desc.written;
1558 if (desc.error) {
1559 retval = retval ?: desc.error;
1560 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001561 }
Hugh Dickins11fa9772008-07-23 21:27:34 -07001562 if (desc.count > 0)
1563 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001564 }
1565out:
1566 return retval;
1567}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001568EXPORT_SYMBOL(generic_file_aio_read);
1569
Linus Torvalds1da177e2005-04-16 15:20:36 -07001570#ifdef CONFIG_MMU
Randy Dunlap485bb992006-06-23 02:03:49 -07001571/**
1572 * page_cache_read - adds requested page to the page cache if not already there
1573 * @file: file to read
1574 * @offset: page index
1575 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07001576 * This adds the requested page to the page cache if it isn't already there,
1577 * and schedules an I/O to read in its contents from disk.
1578 */
Harvey Harrison920c7a52008-02-04 22:29:26 -08001579static int page_cache_read(struct file *file, pgoff_t offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001580{
1581 struct address_space *mapping = file->f_mapping;
1582 struct page *page;
Zach Brown994fc28c2005-12-15 14:28:17 -08001583 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001584
Zach Brown994fc28c2005-12-15 14:28:17 -08001585 do {
1586 page = page_cache_alloc_cold(mapping);
1587 if (!page)
1588 return -ENOMEM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001589
Zach Brown994fc28c2005-12-15 14:28:17 -08001590 ret = add_to_page_cache_lru(page, mapping, offset, GFP_KERNEL);
1591 if (ret == 0)
1592 ret = mapping->a_ops->readpage(file, page);
1593 else if (ret == -EEXIST)
1594 ret = 0; /* losing race to add is OK */
1595
Linus Torvalds1da177e2005-04-16 15:20:36 -07001596 page_cache_release(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001597
Zach Brown994fc28c2005-12-15 14:28:17 -08001598 } while (ret == AOP_TRUNCATED_PAGE);
1599
1600 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001601}
1602
1603#define MMAP_LOTSAMISS (100)
1604
Linus Torvaldsef00e082009-06-16 15:31:25 -07001605/*
1606 * Synchronous readahead happens when we don't even find
1607 * a page in the page cache at all.
1608 */
1609static void do_sync_mmap_readahead(struct vm_area_struct *vma,
1610 struct file_ra_state *ra,
1611 struct file *file,
1612 pgoff_t offset)
1613{
1614 unsigned long ra_pages;
1615 struct address_space *mapping = file->f_mapping;
1616
1617 /* If we don't want any read-ahead, don't bother */
Joe Perches64363aa2013-07-08 16:00:18 -07001618 if (vma->vm_flags & VM_RAND_READ)
Linus Torvaldsef00e082009-06-16 15:31:25 -07001619 return;
Wu Fengguang275b12b2011-05-24 17:12:28 -07001620 if (!ra->ra_pages)
1621 return;
Linus Torvaldsef00e082009-06-16 15:31:25 -07001622
Joe Perches64363aa2013-07-08 16:00:18 -07001623 if (vma->vm_flags & VM_SEQ_READ) {
Wu Fengguang7ffc59b2009-06-16 15:31:38 -07001624 page_cache_sync_readahead(mapping, ra, file, offset,
1625 ra->ra_pages);
Linus Torvaldsef00e082009-06-16 15:31:25 -07001626 return;
1627 }
1628
Andi Kleen207d04b2011-05-24 17:12:29 -07001629 /* Avoid banging the cache line if not needed */
1630 if (ra->mmap_miss < MMAP_LOTSAMISS * 10)
Linus Torvaldsef00e082009-06-16 15:31:25 -07001631 ra->mmap_miss++;
1632
1633 /*
1634 * Do we miss much more than hit in this file? If so,
1635 * stop bothering with read-ahead. It will only hurt.
1636 */
1637 if (ra->mmap_miss > MMAP_LOTSAMISS)
1638 return;
1639
Wu Fengguangd30a1102009-06-16 15:31:30 -07001640 /*
1641 * mmap read-around
1642 */
Linus Torvaldsef00e082009-06-16 15:31:25 -07001643 ra_pages = max_sane_readahead(ra->ra_pages);
Wu Fengguang275b12b2011-05-24 17:12:28 -07001644 ra->start = max_t(long, 0, offset - ra_pages / 2);
1645 ra->size = ra_pages;
Wu Fengguang2cbea1d2011-05-24 17:12:30 -07001646 ra->async_size = ra_pages / 4;
Wu Fengguang275b12b2011-05-24 17:12:28 -07001647 ra_submit(ra, mapping, file);
Linus Torvaldsef00e082009-06-16 15:31:25 -07001648}
1649
1650/*
1651 * Asynchronous readahead happens when we find the page and PG_readahead,
1652 * so we want to possibly extend the readahead further..
1653 */
1654static void do_async_mmap_readahead(struct vm_area_struct *vma,
1655 struct file_ra_state *ra,
1656 struct file *file,
1657 struct page *page,
1658 pgoff_t offset)
1659{
1660 struct address_space *mapping = file->f_mapping;
1661
1662 /* If we don't want any read-ahead, don't bother */
Joe Perches64363aa2013-07-08 16:00:18 -07001663 if (vma->vm_flags & VM_RAND_READ)
Linus Torvaldsef00e082009-06-16 15:31:25 -07001664 return;
1665 if (ra->mmap_miss > 0)
1666 ra->mmap_miss--;
1667 if (PageReadahead(page))
Wu Fengguang2fad6f52009-06-16 15:31:29 -07001668 page_cache_async_readahead(mapping, ra, file,
1669 page, offset, ra->ra_pages);
Linus Torvaldsef00e082009-06-16 15:31:25 -07001670}
1671
Randy Dunlap485bb992006-06-23 02:03:49 -07001672/**
Nick Piggin54cb8822007-07-19 01:46:59 -07001673 * filemap_fault - read in file data for page fault handling
Nick Piggind0217ac2007-07-19 01:47:03 -07001674 * @vma: vma in which the fault was taken
1675 * @vmf: struct vm_fault containing details of the fault
Randy Dunlap485bb992006-06-23 02:03:49 -07001676 *
Nick Piggin54cb8822007-07-19 01:46:59 -07001677 * filemap_fault() is invoked via the vma operations vector for a
Linus Torvalds1da177e2005-04-16 15:20:36 -07001678 * mapped memory region to read in file data during a page fault.
1679 *
1680 * The goto's are kind of ugly, but this streamlines the normal case of having
1681 * it in the page cache, and handles the special cases reasonably without
1682 * having a lot of duplicated code.
1683 */
Nick Piggind0217ac2007-07-19 01:47:03 -07001684int filemap_fault(struct vm_area_struct *vma, struct vm_fault *vmf)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001685{
1686 int error;
Nick Piggin54cb8822007-07-19 01:46:59 -07001687 struct file *file = vma->vm_file;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001688 struct address_space *mapping = file->f_mapping;
1689 struct file_ra_state *ra = &file->f_ra;
1690 struct inode *inode = mapping->host;
Linus Torvaldsef00e082009-06-16 15:31:25 -07001691 pgoff_t offset = vmf->pgoff;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001692 struct page *page;
Jan Kara2004dc82008-02-08 04:20:11 -08001693 pgoff_t size;
Nick Piggin83c54072007-07-19 01:47:05 -07001694 int ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001695
Linus Torvalds1da177e2005-04-16 15:20:36 -07001696 size = (i_size_read(inode) + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
Linus Torvaldsef00e082009-06-16 15:31:25 -07001697 if (offset >= size)
Linus Torvalds5307cc12007-10-31 09:19:46 -07001698 return VM_FAULT_SIGBUS;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001699
Linus Torvalds1da177e2005-04-16 15:20:36 -07001700 /*
Johannes Weiner49426422013-10-16 13:46:59 -07001701 * Do we have something in the page cache already?
Linus Torvalds1da177e2005-04-16 15:20:36 -07001702 */
Linus Torvaldsef00e082009-06-16 15:31:25 -07001703 page = find_get_page(mapping, offset);
Shaohua Li45cac652012-10-08 16:32:19 -07001704 if (likely(page) && !(vmf->flags & FAULT_FLAG_TRIED)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001705 /*
Linus Torvaldsef00e082009-06-16 15:31:25 -07001706 * We found the page, so try async readahead before
1707 * waiting for the lock.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001708 */
Linus Torvaldsef00e082009-06-16 15:31:25 -07001709 do_async_mmap_readahead(vma, ra, file, page, offset);
Shaohua Li45cac652012-10-08 16:32:19 -07001710 } else if (!page) {
Linus Torvaldsef00e082009-06-16 15:31:25 -07001711 /* No page in the page cache at all */
1712 do_sync_mmap_readahead(vma, ra, file, offset);
1713 count_vm_event(PGMAJFAULT);
Ying Han456f9982011-05-26 16:25:38 -07001714 mem_cgroup_count_vm_event(vma->vm_mm, PGMAJFAULT);
Linus Torvaldsef00e082009-06-16 15:31:25 -07001715 ret = VM_FAULT_MAJOR;
1716retry_find:
Michel Lespinasseb522c942010-10-26 14:21:56 -07001717 page = find_get_page(mapping, offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001718 if (!page)
1719 goto no_cached_page;
1720 }
1721
Michel Lespinassed88c0922010-11-02 13:05:18 -07001722 if (!lock_page_or_retry(page, vma->vm_mm, vmf->flags)) {
1723 page_cache_release(page);
Michel Lespinassed065bd82010-10-26 14:21:57 -07001724 return ret | VM_FAULT_RETRY;
Michel Lespinassed88c0922010-11-02 13:05:18 -07001725 }
Michel Lespinasseb522c942010-10-26 14:21:56 -07001726
1727 /* Did it get truncated? */
1728 if (unlikely(page->mapping != mapping)) {
1729 unlock_page(page);
1730 put_page(page);
1731 goto retry_find;
1732 }
Sasha Levin309381fea2014-01-23 15:52:54 -08001733 VM_BUG_ON_PAGE(page->index != offset, page);
Michel Lespinasseb522c942010-10-26 14:21:56 -07001734
Linus Torvalds1da177e2005-04-16 15:20:36 -07001735 /*
Nick Piggind00806b2007-07-19 01:46:57 -07001736 * We have a locked page in the page cache, now we need to check
1737 * that it's up-to-date. If not, it is going to be due to an error.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001738 */
Nick Piggind00806b2007-07-19 01:46:57 -07001739 if (unlikely(!PageUptodate(page)))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001740 goto page_not_uptodate;
1741
Linus Torvaldsef00e082009-06-16 15:31:25 -07001742 /*
1743 * Found the page and have a reference on it.
1744 * We must recheck i_size under page lock.
1745 */
Nick Piggind00806b2007-07-19 01:46:57 -07001746 size = (i_size_read(inode) + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
Linus Torvaldsef00e082009-06-16 15:31:25 -07001747 if (unlikely(offset >= size)) {
Nick Piggind00806b2007-07-19 01:46:57 -07001748 unlock_page(page);
Yan Zheng745ad482007-10-08 10:08:37 -07001749 page_cache_release(page);
Linus Torvalds5307cc12007-10-31 09:19:46 -07001750 return VM_FAULT_SIGBUS;
Nick Piggind00806b2007-07-19 01:46:57 -07001751 }
1752
Nick Piggind0217ac2007-07-19 01:47:03 -07001753 vmf->page = page;
Nick Piggin83c54072007-07-19 01:47:05 -07001754 return ret | VM_FAULT_LOCKED;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001755
Linus Torvalds1da177e2005-04-16 15:20:36 -07001756no_cached_page:
1757 /*
1758 * We're only likely to ever get here if MADV_RANDOM is in
1759 * effect.
1760 */
Linus Torvaldsef00e082009-06-16 15:31:25 -07001761 error = page_cache_read(file, offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001762
1763 /*
1764 * The page we want has now been added to the page cache.
1765 * In the unlikely event that someone removed it in the
1766 * meantime, we'll just come back here and read it again.
1767 */
1768 if (error >= 0)
1769 goto retry_find;
1770
1771 /*
1772 * An error return from page_cache_read can result if the
1773 * system is low on memory, or a problem occurs while trying
1774 * to schedule I/O.
1775 */
1776 if (error == -ENOMEM)
Nick Piggind0217ac2007-07-19 01:47:03 -07001777 return VM_FAULT_OOM;
1778 return VM_FAULT_SIGBUS;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001779
1780page_not_uptodate:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001781 /*
1782 * Umm, take care of errors if the page isn't up-to-date.
1783 * Try to re-read it _once_. We do this synchronously,
1784 * because there really aren't any performance issues here
1785 * and we need to check for errors.
1786 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001787 ClearPageError(page);
Zach Brown994fc28c2005-12-15 14:28:17 -08001788 error = mapping->a_ops->readpage(file, page);
Miklos Szeredi3ef0f722008-05-14 16:05:37 -07001789 if (!error) {
1790 wait_on_page_locked(page);
1791 if (!PageUptodate(page))
1792 error = -EIO;
1793 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001794 page_cache_release(page);
Nick Piggind00806b2007-07-19 01:46:57 -07001795
1796 if (!error || error == AOP_TRUNCATED_PAGE)
1797 goto retry_find;
1798
1799 /* Things didn't work out. Return zero to tell the mm layer so. */
1800 shrink_readahead_size_eio(file, ra);
Nick Piggind0217ac2007-07-19 01:47:03 -07001801 return VM_FAULT_SIGBUS;
Nick Piggin54cb8822007-07-19 01:46:59 -07001802}
1803EXPORT_SYMBOL(filemap_fault);
1804
Jan Kara4fcf1c62012-06-12 16:20:29 +02001805int filemap_page_mkwrite(struct vm_area_struct *vma, struct vm_fault *vmf)
1806{
1807 struct page *page = vmf->page;
Al Viro496ad9a2013-01-23 17:07:38 -05001808 struct inode *inode = file_inode(vma->vm_file);
Jan Kara4fcf1c62012-06-12 16:20:29 +02001809 int ret = VM_FAULT_LOCKED;
1810
Jan Kara14da9202012-06-12 16:20:37 +02001811 sb_start_pagefault(inode->i_sb);
Jan Kara4fcf1c62012-06-12 16:20:29 +02001812 file_update_time(vma->vm_file);
1813 lock_page(page);
1814 if (page->mapping != inode->i_mapping) {
1815 unlock_page(page);
1816 ret = VM_FAULT_NOPAGE;
1817 goto out;
1818 }
Jan Kara14da9202012-06-12 16:20:37 +02001819 /*
1820 * We mark the page dirty already here so that when freeze is in
1821 * progress, we are guaranteed that writeback during freezing will
1822 * see the dirty page and writeprotect it again.
1823 */
1824 set_page_dirty(page);
Darrick J. Wong1d1d1a72013-02-21 16:42:51 -08001825 wait_for_stable_page(page);
Jan Kara4fcf1c62012-06-12 16:20:29 +02001826out:
Jan Kara14da9202012-06-12 16:20:37 +02001827 sb_end_pagefault(inode->i_sb);
Jan Kara4fcf1c62012-06-12 16:20:29 +02001828 return ret;
1829}
1830EXPORT_SYMBOL(filemap_page_mkwrite);
1831
Alexey Dobriyanf0f37e22009-09-27 22:29:37 +04001832const struct vm_operations_struct generic_file_vm_ops = {
Nick Piggin54cb8822007-07-19 01:46:59 -07001833 .fault = filemap_fault,
Jan Kara4fcf1c62012-06-12 16:20:29 +02001834 .page_mkwrite = filemap_page_mkwrite,
Konstantin Khlebnikov0b173bc2012-10-08 16:28:46 -07001835 .remap_pages = generic_file_remap_pages,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001836};
1837
1838/* This is used for a general mmap of a disk file */
1839
1840int generic_file_mmap(struct file * file, struct vm_area_struct * vma)
1841{
1842 struct address_space *mapping = file->f_mapping;
1843
1844 if (!mapping->a_ops->readpage)
1845 return -ENOEXEC;
1846 file_accessed(file);
1847 vma->vm_ops = &generic_file_vm_ops;
1848 return 0;
1849}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001850
1851/*
1852 * This is for filesystems which do not implement ->writepage.
1853 */
1854int generic_file_readonly_mmap(struct file *file, struct vm_area_struct *vma)
1855{
1856 if ((vma->vm_flags & VM_SHARED) && (vma->vm_flags & VM_MAYWRITE))
1857 return -EINVAL;
1858 return generic_file_mmap(file, vma);
1859}
1860#else
1861int generic_file_mmap(struct file * file, struct vm_area_struct * vma)
1862{
1863 return -ENOSYS;
1864}
1865int generic_file_readonly_mmap(struct file * file, struct vm_area_struct * vma)
1866{
1867 return -ENOSYS;
1868}
1869#endif /* CONFIG_MMU */
1870
1871EXPORT_SYMBOL(generic_file_mmap);
1872EXPORT_SYMBOL(generic_file_readonly_mmap);
1873
Nick Piggin6fe69002007-05-06 14:49:04 -07001874static struct page *__read_cache_page(struct address_space *mapping,
Fengguang Wu57f6b962007-10-16 01:24:37 -07001875 pgoff_t index,
Hugh Dickins5e5358e2011-07-25 17:12:23 -07001876 int (*filler)(void *, struct page *),
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001877 void *data,
1878 gfp_t gfp)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001879{
Nick Piggineb2be182007-10-16 01:24:57 -07001880 struct page *page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001881 int err;
1882repeat:
1883 page = find_get_page(mapping, index);
1884 if (!page) {
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001885 page = __page_cache_alloc(gfp | __GFP_COLD);
Nick Piggineb2be182007-10-16 01:24:57 -07001886 if (!page)
1887 return ERR_PTR(-ENOMEM);
Dave Kleikampe6f67b82011-12-21 11:05:48 -06001888 err = add_to_page_cache_lru(page, mapping, index, gfp);
Nick Piggineb2be182007-10-16 01:24:57 -07001889 if (unlikely(err)) {
1890 page_cache_release(page);
1891 if (err == -EEXIST)
1892 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001893 /* Presumably ENOMEM for radix tree node */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001894 return ERR_PTR(err);
1895 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001896 err = filler(data, page);
1897 if (err < 0) {
1898 page_cache_release(page);
1899 page = ERR_PTR(err);
1900 }
1901 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001902 return page;
1903}
1904
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001905static struct page *do_read_cache_page(struct address_space *mapping,
Fengguang Wu57f6b962007-10-16 01:24:37 -07001906 pgoff_t index,
Hugh Dickins5e5358e2011-07-25 17:12:23 -07001907 int (*filler)(void *, struct page *),
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001908 void *data,
1909 gfp_t gfp)
1910
Linus Torvalds1da177e2005-04-16 15:20:36 -07001911{
1912 struct page *page;
1913 int err;
1914
1915retry:
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001916 page = __read_cache_page(mapping, index, filler, data, gfp);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001917 if (IS_ERR(page))
David Howellsc855ff32007-05-09 13:42:20 +01001918 return page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001919 if (PageUptodate(page))
1920 goto out;
1921
1922 lock_page(page);
1923 if (!page->mapping) {
1924 unlock_page(page);
1925 page_cache_release(page);
1926 goto retry;
1927 }
1928 if (PageUptodate(page)) {
1929 unlock_page(page);
1930 goto out;
1931 }
1932 err = filler(data, page);
1933 if (err < 0) {
1934 page_cache_release(page);
David Howellsc855ff32007-05-09 13:42:20 +01001935 return ERR_PTR(err);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001936 }
David Howellsc855ff32007-05-09 13:42:20 +01001937out:
Nick Piggin6fe69002007-05-06 14:49:04 -07001938 mark_page_accessed(page);
1939 return page;
1940}
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001941
1942/**
1943 * read_cache_page_async - read into page cache, fill it if needed
1944 * @mapping: the page's address_space
1945 * @index: the page index
1946 * @filler: function to perform the read
Hugh Dickins5e5358e2011-07-25 17:12:23 -07001947 * @data: first arg to filler(data, page) function, often left as NULL
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001948 *
1949 * Same as read_cache_page, but don't wait for page to become unlocked
1950 * after submitting it to the filler.
1951 *
1952 * Read into the page cache. If a page already exists, and PageUptodate() is
1953 * not set, try to fill the page but don't wait for it to become unlocked.
1954 *
1955 * If the page does not get brought uptodate, return -EIO.
1956 */
1957struct page *read_cache_page_async(struct address_space *mapping,
1958 pgoff_t index,
Hugh Dickins5e5358e2011-07-25 17:12:23 -07001959 int (*filler)(void *, struct page *),
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001960 void *data)
1961{
1962 return do_read_cache_page(mapping, index, filler, data, mapping_gfp_mask(mapping));
1963}
Nick Piggin6fe69002007-05-06 14:49:04 -07001964EXPORT_SYMBOL(read_cache_page_async);
1965
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001966static struct page *wait_on_page_read(struct page *page)
1967{
1968 if (!IS_ERR(page)) {
1969 wait_on_page_locked(page);
1970 if (!PageUptodate(page)) {
1971 page_cache_release(page);
1972 page = ERR_PTR(-EIO);
1973 }
1974 }
1975 return page;
1976}
1977
1978/**
1979 * read_cache_page_gfp - read into page cache, using specified page allocation flags.
1980 * @mapping: the page's address_space
1981 * @index: the page index
1982 * @gfp: the page allocator flags to use if allocating
1983 *
1984 * This is the same as "read_mapping_page(mapping, index, NULL)", but with
Dave Kleikampe6f67b82011-12-21 11:05:48 -06001985 * any new page allocations done using the specified allocation flags.
Linus Torvalds0531b2a2010-01-27 09:20:03 -08001986 *
1987 * If the page does not get brought uptodate, return -EIO.
1988 */
1989struct page *read_cache_page_gfp(struct address_space *mapping,
1990 pgoff_t index,
1991 gfp_t gfp)
1992{
1993 filler_t *filler = (filler_t *)mapping->a_ops->readpage;
1994
1995 return wait_on_page_read(do_read_cache_page(mapping, index, filler, NULL, gfp));
1996}
1997EXPORT_SYMBOL(read_cache_page_gfp);
1998
Nick Piggin6fe69002007-05-06 14:49:04 -07001999/**
2000 * read_cache_page - read into page cache, fill it if needed
2001 * @mapping: the page's address_space
2002 * @index: the page index
2003 * @filler: function to perform the read
Hugh Dickins5e5358e2011-07-25 17:12:23 -07002004 * @data: first arg to filler(data, page) function, often left as NULL
Nick Piggin6fe69002007-05-06 14:49:04 -07002005 *
2006 * Read into the page cache. If a page already exists, and PageUptodate() is
2007 * not set, try to fill the page then wait for it to become unlocked.
2008 *
2009 * If the page does not get brought uptodate, return -EIO.
2010 */
2011struct page *read_cache_page(struct address_space *mapping,
Fengguang Wu57f6b962007-10-16 01:24:37 -07002012 pgoff_t index,
Hugh Dickins5e5358e2011-07-25 17:12:23 -07002013 int (*filler)(void *, struct page *),
Nick Piggin6fe69002007-05-06 14:49:04 -07002014 void *data)
2015{
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002016 return wait_on_page_read(read_cache_page_async(mapping, index, filler, data));
Linus Torvalds1da177e2005-04-16 15:20:36 -07002017}
Linus Torvalds1da177e2005-04-16 15:20:36 -07002018EXPORT_SYMBOL(read_cache_page);
2019
Nick Piggin2f718ff2007-10-16 01:24:59 -07002020static size_t __iovec_copy_from_user_inatomic(char *vaddr,
Linus Torvalds1da177e2005-04-16 15:20:36 -07002021 const struct iovec *iov, size_t base, size_t bytes)
2022{
Ingo Molnarf1800532009-03-02 11:00:57 +01002023 size_t copied = 0, left = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002024
2025 while (bytes) {
2026 char __user *buf = iov->iov_base + base;
2027 int copy = min(bytes, iov->iov_len - base);
2028
2029 base = 0;
Ingo Molnarf1800532009-03-02 11:00:57 +01002030 left = __copy_from_user_inatomic(vaddr, buf, copy);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002031 copied += copy;
2032 bytes -= copy;
2033 vaddr += copy;
2034 iov++;
2035
NeilBrown01408c42006-06-25 05:47:58 -07002036 if (unlikely(left))
Linus Torvalds1da177e2005-04-16 15:20:36 -07002037 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002038 }
2039 return copied - left;
2040}
2041
2042/*
Nick Piggin2f718ff2007-10-16 01:24:59 -07002043 * Copy as much as we can into the page and return the number of bytes which
André Goddard Rosaaf901ca2009-11-14 13:09:05 -02002044 * were successfully copied. If a fault is encountered then return the number of
Nick Piggin2f718ff2007-10-16 01:24:59 -07002045 * bytes which were copied.
2046 */
2047size_t iov_iter_copy_from_user_atomic(struct page *page,
2048 struct iov_iter *i, unsigned long offset, size_t bytes)
2049{
2050 char *kaddr;
2051 size_t copied;
2052
2053 BUG_ON(!in_atomic());
Cong Wang9b04c5f2011-11-25 23:14:39 +08002054 kaddr = kmap_atomic(page);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002055 if (likely(i->nr_segs == 1)) {
2056 int left;
2057 char __user *buf = i->iov->iov_base + i->iov_offset;
Ingo Molnarf1800532009-03-02 11:00:57 +01002058 left = __copy_from_user_inatomic(kaddr + offset, buf, bytes);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002059 copied = bytes - left;
2060 } else {
2061 copied = __iovec_copy_from_user_inatomic(kaddr + offset,
2062 i->iov, i->iov_offset, bytes);
2063 }
Cong Wang9b04c5f2011-11-25 23:14:39 +08002064 kunmap_atomic(kaddr);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002065
2066 return copied;
2067}
Nick Piggin89e10782007-10-16 01:25:07 -07002068EXPORT_SYMBOL(iov_iter_copy_from_user_atomic);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002069
2070/*
2071 * This has the same sideeffects and return value as
2072 * iov_iter_copy_from_user_atomic().
2073 * The difference is that it attempts to resolve faults.
2074 * Page must not be locked.
2075 */
2076size_t iov_iter_copy_from_user(struct page *page,
2077 struct iov_iter *i, unsigned long offset, size_t bytes)
2078{
2079 char *kaddr;
2080 size_t copied;
2081
2082 kaddr = kmap(page);
2083 if (likely(i->nr_segs == 1)) {
2084 int left;
2085 char __user *buf = i->iov->iov_base + i->iov_offset;
Ingo Molnarf1800532009-03-02 11:00:57 +01002086 left = __copy_from_user(kaddr + offset, buf, bytes);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002087 copied = bytes - left;
2088 } else {
2089 copied = __iovec_copy_from_user_inatomic(kaddr + offset,
2090 i->iov, i->iov_offset, bytes);
2091 }
2092 kunmap(page);
2093 return copied;
2094}
Nick Piggin89e10782007-10-16 01:25:07 -07002095EXPORT_SYMBOL(iov_iter_copy_from_user);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002096
Nick Pigginf7009262008-03-10 11:43:59 -07002097void iov_iter_advance(struct iov_iter *i, size_t bytes)
Nick Piggin2f718ff2007-10-16 01:24:59 -07002098{
Nick Pigginf7009262008-03-10 11:43:59 -07002099 BUG_ON(i->count < bytes);
2100
Nick Piggin2f718ff2007-10-16 01:24:59 -07002101 if (likely(i->nr_segs == 1)) {
2102 i->iov_offset += bytes;
Nick Pigginf7009262008-03-10 11:43:59 -07002103 i->count -= bytes;
Nick Piggin2f718ff2007-10-16 01:24:59 -07002104 } else {
2105 const struct iovec *iov = i->iov;
2106 size_t base = i->iov_offset;
Jeff Layton39be79c2011-10-27 23:53:08 +02002107 unsigned long nr_segs = i->nr_segs;
Nick Piggin2f718ff2007-10-16 01:24:59 -07002108
Nick Piggin124d3b72008-02-02 15:01:17 +01002109 /*
2110 * The !iov->iov_len check ensures we skip over unlikely
Nick Pigginf7009262008-03-10 11:43:59 -07002111 * zero-length segments (without overruning the iovec).
Nick Piggin124d3b72008-02-02 15:01:17 +01002112 */
Linus Torvalds94ad3742008-07-30 14:45:12 -07002113 while (bytes || unlikely(i->count && !iov->iov_len)) {
Nick Pigginf7009262008-03-10 11:43:59 -07002114 int copy;
Nick Piggin2f718ff2007-10-16 01:24:59 -07002115
Nick Pigginf7009262008-03-10 11:43:59 -07002116 copy = min(bytes, iov->iov_len - base);
2117 BUG_ON(!i->count || i->count < copy);
2118 i->count -= copy;
Nick Piggin2f718ff2007-10-16 01:24:59 -07002119 bytes -= copy;
2120 base += copy;
2121 if (iov->iov_len == base) {
2122 iov++;
Jeff Layton39be79c2011-10-27 23:53:08 +02002123 nr_segs--;
Nick Piggin2f718ff2007-10-16 01:24:59 -07002124 base = 0;
2125 }
2126 }
2127 i->iov = iov;
2128 i->iov_offset = base;
Jeff Layton39be79c2011-10-27 23:53:08 +02002129 i->nr_segs = nr_segs;
Nick Piggin2f718ff2007-10-16 01:24:59 -07002130 }
2131}
Nick Piggin89e10782007-10-16 01:25:07 -07002132EXPORT_SYMBOL(iov_iter_advance);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002133
Nick Pigginafddba42007-10-16 01:25:01 -07002134/*
2135 * Fault in the first iovec of the given iov_iter, to a maximum length
2136 * of bytes. Returns 0 on success, or non-zero if the memory could not be
2137 * accessed (ie. because it is an invalid address).
2138 *
2139 * writev-intensive code may want this to prefault several iovecs -- that
2140 * would be possible (callers must not rely on the fact that _only_ the
2141 * first iovec will be faulted with the current implementation).
2142 */
2143int iov_iter_fault_in_readable(struct iov_iter *i, size_t bytes)
Nick Piggin2f718ff2007-10-16 01:24:59 -07002144{
Nick Piggin2f718ff2007-10-16 01:24:59 -07002145 char __user *buf = i->iov->iov_base + i->iov_offset;
Nick Pigginafddba42007-10-16 01:25:01 -07002146 bytes = min(bytes, i->iov->iov_len - i->iov_offset);
2147 return fault_in_pages_readable(buf, bytes);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002148}
Nick Piggin89e10782007-10-16 01:25:07 -07002149EXPORT_SYMBOL(iov_iter_fault_in_readable);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002150
2151/*
2152 * Return the count of just the current iov_iter segment.
2153 */
Maxim Patlasovd28574e2012-10-26 19:50:04 +04002154size_t iov_iter_single_seg_count(const struct iov_iter *i)
Nick Piggin2f718ff2007-10-16 01:24:59 -07002155{
2156 const struct iovec *iov = i->iov;
2157 if (i->nr_segs == 1)
2158 return i->count;
2159 else
2160 return min(i->count, iov->iov_len - i->iov_offset);
2161}
Nick Piggin89e10782007-10-16 01:25:07 -07002162EXPORT_SYMBOL(iov_iter_single_seg_count);
Nick Piggin2f718ff2007-10-16 01:24:59 -07002163
2164/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07002165 * Performs necessary checks before doing a write
2166 *
Randy Dunlap485bb992006-06-23 02:03:49 -07002167 * Can adjust writing position or amount of bytes to write.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002168 * Returns appropriate error code that caller should return or
2169 * zero in case that write should be allowed.
2170 */
2171inline int generic_write_checks(struct file *file, loff_t *pos, size_t *count, int isblk)
2172{
2173 struct inode *inode = file->f_mapping->host;
Jiri Slaby59e99e52010-03-05 13:41:44 -08002174 unsigned long limit = rlimit(RLIMIT_FSIZE);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002175
2176 if (unlikely(*pos < 0))
2177 return -EINVAL;
2178
Linus Torvalds1da177e2005-04-16 15:20:36 -07002179 if (!isblk) {
2180 /* FIXME: this is for backwards compatibility with 2.4 */
2181 if (file->f_flags & O_APPEND)
2182 *pos = i_size_read(inode);
2183
2184 if (limit != RLIM_INFINITY) {
2185 if (*pos >= limit) {
2186 send_sig(SIGXFSZ, current, 0);
2187 return -EFBIG;
2188 }
2189 if (*count > limit - (typeof(limit))*pos) {
2190 *count = limit - (typeof(limit))*pos;
2191 }
2192 }
2193 }
2194
2195 /*
2196 * LFS rule
2197 */
2198 if (unlikely(*pos + *count > MAX_NON_LFS &&
2199 !(file->f_flags & O_LARGEFILE))) {
2200 if (*pos >= MAX_NON_LFS) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002201 return -EFBIG;
2202 }
2203 if (*count > MAX_NON_LFS - (unsigned long)*pos) {
2204 *count = MAX_NON_LFS - (unsigned long)*pos;
2205 }
2206 }
2207
2208 /*
2209 * Are we about to exceed the fs block limit ?
2210 *
2211 * If we have written data it becomes a short write. If we have
2212 * exceeded without writing data we send a signal and return EFBIG.
2213 * Linus frestrict idea will clean these up nicely..
2214 */
2215 if (likely(!isblk)) {
2216 if (unlikely(*pos >= inode->i_sb->s_maxbytes)) {
2217 if (*count || *pos > inode->i_sb->s_maxbytes) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002218 return -EFBIG;
2219 }
2220 /* zero-length writes at ->s_maxbytes are OK */
2221 }
2222
2223 if (unlikely(*pos + *count > inode->i_sb->s_maxbytes))
2224 *count = inode->i_sb->s_maxbytes - *pos;
2225 } else {
David Howells93614012006-09-30 20:45:40 +02002226#ifdef CONFIG_BLOCK
Linus Torvalds1da177e2005-04-16 15:20:36 -07002227 loff_t isize;
2228 if (bdev_read_only(I_BDEV(inode)))
2229 return -EPERM;
2230 isize = i_size_read(inode);
2231 if (*pos >= isize) {
2232 if (*count || *pos > isize)
2233 return -ENOSPC;
2234 }
2235
2236 if (*pos + *count > isize)
2237 *count = isize - *pos;
David Howells93614012006-09-30 20:45:40 +02002238#else
2239 return -EPERM;
2240#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -07002241 }
2242 return 0;
2243}
2244EXPORT_SYMBOL(generic_write_checks);
2245
Nick Pigginafddba42007-10-16 01:25:01 -07002246int pagecache_write_begin(struct file *file, struct address_space *mapping,
2247 loff_t pos, unsigned len, unsigned flags,
2248 struct page **pagep, void **fsdata)
2249{
2250 const struct address_space_operations *aops = mapping->a_ops;
2251
Nick Piggin4e02ed42008-10-29 14:00:55 -07002252 return aops->write_begin(file, mapping, pos, len, flags,
Nick Pigginafddba42007-10-16 01:25:01 -07002253 pagep, fsdata);
Nick Pigginafddba42007-10-16 01:25:01 -07002254}
2255EXPORT_SYMBOL(pagecache_write_begin);
2256
2257int pagecache_write_end(struct file *file, struct address_space *mapping,
2258 loff_t pos, unsigned len, unsigned copied,
2259 struct page *page, void *fsdata)
2260{
2261 const struct address_space_operations *aops = mapping->a_ops;
Nick Pigginafddba42007-10-16 01:25:01 -07002262
Nick Piggin4e02ed42008-10-29 14:00:55 -07002263 mark_page_accessed(page);
2264 return aops->write_end(file, mapping, pos, len, copied, page, fsdata);
Nick Pigginafddba42007-10-16 01:25:01 -07002265}
2266EXPORT_SYMBOL(pagecache_write_end);
2267
Linus Torvalds1da177e2005-04-16 15:20:36 -07002268ssize_t
2269generic_file_direct_write(struct kiocb *iocb, const struct iovec *iov,
2270 unsigned long *nr_segs, loff_t pos, loff_t *ppos,
2271 size_t count, size_t ocount)
2272{
2273 struct file *file = iocb->ki_filp;
2274 struct address_space *mapping = file->f_mapping;
2275 struct inode *inode = mapping->host;
2276 ssize_t written;
Christoph Hellwiga969e902008-07-23 21:27:04 -07002277 size_t write_len;
2278 pgoff_t end;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002279
2280 if (count != ocount)
2281 *nr_segs = iov_shorten((struct iovec *)iov, *nr_segs, count);
2282
Christoph Hellwiga969e902008-07-23 21:27:04 -07002283 write_len = iov_length(iov, *nr_segs);
2284 end = (pos + write_len - 1) >> PAGE_CACHE_SHIFT;
Christoph Hellwiga969e902008-07-23 21:27:04 -07002285
Nick Piggin48b47c52009-01-06 14:40:22 -08002286 written = filemap_write_and_wait_range(mapping, pos, pos + write_len - 1);
Christoph Hellwiga969e902008-07-23 21:27:04 -07002287 if (written)
2288 goto out;
2289
2290 /*
2291 * After a write we want buffered reads to be sure to go to disk to get
2292 * the new data. We invalidate clean cached page from the region we're
2293 * about to write. We do this *before* the write so that we can return
Hisashi Hifumi6ccfa802008-09-02 14:35:40 -07002294 * without clobbering -EIOCBQUEUED from ->direct_IO().
Christoph Hellwiga969e902008-07-23 21:27:04 -07002295 */
2296 if (mapping->nrpages) {
2297 written = invalidate_inode_pages2_range(mapping,
2298 pos >> PAGE_CACHE_SHIFT, end);
Hisashi Hifumi6ccfa802008-09-02 14:35:40 -07002299 /*
2300 * If a page can not be invalidated, return 0 to fall back
2301 * to buffered write.
2302 */
2303 if (written) {
2304 if (written == -EBUSY)
2305 return 0;
Christoph Hellwiga969e902008-07-23 21:27:04 -07002306 goto out;
Hisashi Hifumi6ccfa802008-09-02 14:35:40 -07002307 }
Christoph Hellwiga969e902008-07-23 21:27:04 -07002308 }
2309
2310 written = mapping->a_ops->direct_IO(WRITE, iocb, iov, pos, *nr_segs);
2311
2312 /*
2313 * Finally, try again to invalidate clean pages which might have been
2314 * cached by non-direct readahead, or faulted in by get_user_pages()
2315 * if the source of the write was an mmap'ed region of the file
2316 * we're writing. Either one is a pretty crazy thing to do,
2317 * so we don't support it 100%. If this invalidation
2318 * fails, tough, the write still worked...
2319 */
2320 if (mapping->nrpages) {
2321 invalidate_inode_pages2_range(mapping,
2322 pos >> PAGE_CACHE_SHIFT, end);
2323 }
2324
Linus Torvalds1da177e2005-04-16 15:20:36 -07002325 if (written > 0) {
Namhyung Kim01166512010-10-26 14:21:58 -07002326 pos += written;
2327 if (pos > i_size_read(inode) && !S_ISBLK(inode->i_mode)) {
2328 i_size_write(inode, pos);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002329 mark_inode_dirty(inode);
2330 }
Namhyung Kim01166512010-10-26 14:21:58 -07002331 *ppos = pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002332 }
Christoph Hellwiga969e902008-07-23 21:27:04 -07002333out:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002334 return written;
2335}
2336EXPORT_SYMBOL(generic_file_direct_write);
2337
Nick Piggineb2be182007-10-16 01:24:57 -07002338/*
2339 * Find or create a page at the given pagecache position. Return the locked
2340 * page. This function is specifically for buffered writes.
2341 */
Nick Piggin54566b22009-01-04 12:00:53 -08002342struct page *grab_cache_page_write_begin(struct address_space *mapping,
2343 pgoff_t index, unsigned flags)
Nick Piggineb2be182007-10-16 01:24:57 -07002344{
2345 int status;
Johannes Weiner0faa70c2012-01-10 15:07:53 -08002346 gfp_t gfp_mask;
Nick Piggineb2be182007-10-16 01:24:57 -07002347 struct page *page;
Nick Piggin54566b22009-01-04 12:00:53 -08002348 gfp_t gfp_notmask = 0;
Johannes Weiner0faa70c2012-01-10 15:07:53 -08002349
Fengguang Wu1010bb12012-03-21 16:34:08 -07002350 gfp_mask = mapping_gfp_mask(mapping);
2351 if (mapping_cap_account_dirty(mapping))
2352 gfp_mask |= __GFP_WRITE;
Nick Piggin54566b22009-01-04 12:00:53 -08002353 if (flags & AOP_FLAG_NOFS)
2354 gfp_notmask = __GFP_FS;
Nick Piggineb2be182007-10-16 01:24:57 -07002355repeat:
2356 page = find_lock_page(mapping, index);
Steven Rostedtc585a262011-01-13 15:46:18 -08002357 if (page)
Darrick J. Wong3d08bcc2011-05-27 12:23:34 -07002358 goto found;
Nick Piggineb2be182007-10-16 01:24:57 -07002359
Johannes Weiner0faa70c2012-01-10 15:07:53 -08002360 page = __page_cache_alloc(gfp_mask & ~gfp_notmask);
Nick Piggineb2be182007-10-16 01:24:57 -07002361 if (!page)
2362 return NULL;
Nick Piggin54566b22009-01-04 12:00:53 -08002363 status = add_to_page_cache_lru(page, mapping, index,
2364 GFP_KERNEL & ~gfp_notmask);
Nick Piggineb2be182007-10-16 01:24:57 -07002365 if (unlikely(status)) {
2366 page_cache_release(page);
2367 if (status == -EEXIST)
2368 goto repeat;
2369 return NULL;
2370 }
Darrick J. Wong3d08bcc2011-05-27 12:23:34 -07002371found:
Darrick J. Wong1d1d1a72013-02-21 16:42:51 -08002372 wait_for_stable_page(page);
Nick Piggineb2be182007-10-16 01:24:57 -07002373 return page;
2374}
Nick Piggin54566b22009-01-04 12:00:53 -08002375EXPORT_SYMBOL(grab_cache_page_write_begin);
Nick Piggineb2be182007-10-16 01:24:57 -07002376
Nick Pigginafddba42007-10-16 01:25:01 -07002377static ssize_t generic_perform_write(struct file *file,
2378 struct iov_iter *i, loff_t pos)
2379{
2380 struct address_space *mapping = file->f_mapping;
2381 const struct address_space_operations *a_ops = mapping->a_ops;
2382 long status = 0;
2383 ssize_t written = 0;
Nick Piggin674b8922007-10-16 01:25:03 -07002384 unsigned int flags = 0;
2385
2386 /*
2387 * Copies from kernel address space cannot fail (NFSD is a big user).
2388 */
2389 if (segment_eq(get_fs(), KERNEL_DS))
2390 flags |= AOP_FLAG_UNINTERRUPTIBLE;
Nick Pigginafddba42007-10-16 01:25:01 -07002391
2392 do {
2393 struct page *page;
Nick Pigginafddba42007-10-16 01:25:01 -07002394 unsigned long offset; /* Offset into pagecache page */
2395 unsigned long bytes; /* Bytes to write to page */
2396 size_t copied; /* Bytes copied from user */
2397 void *fsdata;
2398
2399 offset = (pos & (PAGE_CACHE_SIZE - 1));
Nick Pigginafddba42007-10-16 01:25:01 -07002400 bytes = min_t(unsigned long, PAGE_CACHE_SIZE - offset,
2401 iov_iter_count(i));
2402
2403again:
Nick Pigginafddba42007-10-16 01:25:01 -07002404 /*
2405 * Bring in the user page that we will copy from _first_.
2406 * Otherwise there's a nasty deadlock on copying from the
2407 * same page as we're writing to, without it being marked
2408 * up-to-date.
2409 *
2410 * Not only is this an optimisation, but it is also required
2411 * to check that the address is actually valid, when atomic
2412 * usercopies are used, below.
2413 */
2414 if (unlikely(iov_iter_fault_in_readable(i, bytes))) {
2415 status = -EFAULT;
2416 break;
2417 }
2418
Nick Piggin674b8922007-10-16 01:25:03 -07002419 status = a_ops->write_begin(file, mapping, pos, bytes, flags,
Nick Pigginafddba42007-10-16 01:25:01 -07002420 &page, &fsdata);
2421 if (unlikely(status))
2422 break;
2423
anfei zhou931e80e2010-02-02 13:44:02 -08002424 if (mapping_writably_mapped(mapping))
2425 flush_dcache_page(page);
2426
Nick Pigginafddba42007-10-16 01:25:01 -07002427 pagefault_disable();
2428 copied = iov_iter_copy_from_user_atomic(page, i, offset, bytes);
2429 pagefault_enable();
2430 flush_dcache_page(page);
2431
Josef Bacikc8236db2009-07-05 12:08:18 -07002432 mark_page_accessed(page);
Nick Pigginafddba42007-10-16 01:25:01 -07002433 status = a_ops->write_end(file, mapping, pos, bytes, copied,
2434 page, fsdata);
2435 if (unlikely(status < 0))
2436 break;
2437 copied = status;
2438
2439 cond_resched();
2440
Nick Piggin124d3b72008-02-02 15:01:17 +01002441 iov_iter_advance(i, copied);
Nick Pigginafddba42007-10-16 01:25:01 -07002442 if (unlikely(copied == 0)) {
2443 /*
2444 * If we were unable to copy any data at all, we must
2445 * fall back to a single segment length write.
2446 *
2447 * If we didn't fallback here, we could livelock
2448 * because not all segments in the iov can be copied at
2449 * once without a pagefault.
2450 */
2451 bytes = min_t(unsigned long, PAGE_CACHE_SIZE - offset,
2452 iov_iter_single_seg_count(i));
2453 goto again;
2454 }
Nick Pigginafddba42007-10-16 01:25:01 -07002455 pos += copied;
2456 written += copied;
2457
2458 balance_dirty_pages_ratelimited(mapping);
Jan Karaa50527b2011-12-02 09:17:02 +08002459 if (fatal_signal_pending(current)) {
2460 status = -EINTR;
2461 break;
2462 }
Nick Pigginafddba42007-10-16 01:25:01 -07002463 } while (iov_iter_count(i));
2464
2465 return written ? written : status;
2466}
2467
2468ssize_t
2469generic_file_buffered_write(struct kiocb *iocb, const struct iovec *iov,
2470 unsigned long nr_segs, loff_t pos, loff_t *ppos,
2471 size_t count, ssize_t written)
2472{
2473 struct file *file = iocb->ki_filp;
Nick Pigginafddba42007-10-16 01:25:01 -07002474 ssize_t status;
2475 struct iov_iter i;
2476
2477 iov_iter_init(&i, iov, nr_segs, count, written);
Nick Piggin4e02ed42008-10-29 14:00:55 -07002478 status = generic_perform_write(file, &i, pos);
Nick Pigginafddba42007-10-16 01:25:01 -07002479
Linus Torvalds1da177e2005-04-16 15:20:36 -07002480 if (likely(status >= 0)) {
Nick Pigginafddba42007-10-16 01:25:01 -07002481 written += status;
2482 *ppos = pos + status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002483 }
2484
Linus Torvalds1da177e2005-04-16 15:20:36 -07002485 return written ? written : status;
2486}
2487EXPORT_SYMBOL(generic_file_buffered_write);
2488
Jan Karae4dd9de2009-08-17 18:10:06 +02002489/**
2490 * __generic_file_aio_write - write data to a file
2491 * @iocb: IO state structure (file, offset, etc.)
2492 * @iov: vector with data to write
2493 * @nr_segs: number of segments in the vector
2494 * @ppos: position where to write
2495 *
2496 * This function does all the work needed for actually writing data to a
2497 * file. It does all basic checks, removes SUID from the file, updates
2498 * modification times and calls proper subroutines depending on whether we
2499 * do direct IO or a standard buffered write.
2500 *
2501 * It expects i_mutex to be grabbed unless we work on a block device or similar
2502 * object which does not need locking at all.
2503 *
2504 * This function does *not* take care of syncing data in case of O_SYNC write.
2505 * A caller has to handle it. This is mainly due to the fact that we want to
2506 * avoid syncing under i_mutex.
2507 */
2508ssize_t __generic_file_aio_write(struct kiocb *iocb, const struct iovec *iov,
2509 unsigned long nr_segs, loff_t *ppos)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002510{
2511 struct file *file = iocb->ki_filp;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002512 struct address_space * mapping = file->f_mapping;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002513 size_t ocount; /* original count */
2514 size_t count; /* after file limit checks */
2515 struct inode *inode = mapping->host;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002516 loff_t pos;
2517 ssize_t written;
2518 ssize_t err;
2519
2520 ocount = 0;
Dmitriy Monakhov0ceb3312007-05-08 00:23:02 -07002521 err = generic_segment_checks(iov, &nr_segs, &ocount, VERIFY_READ);
2522 if (err)
2523 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002524
2525 count = ocount;
2526 pos = *ppos;
2527
Linus Torvalds1da177e2005-04-16 15:20:36 -07002528 /* We can write back this queue in page reclaim */
2529 current->backing_dev_info = mapping->backing_dev_info;
2530 written = 0;
2531
2532 err = generic_write_checks(file, &pos, &count, S_ISBLK(inode->i_mode));
2533 if (err)
2534 goto out;
2535
2536 if (count == 0)
2537 goto out;
2538
Miklos Szeredi2f1936b2008-06-24 16:50:14 +02002539 err = file_remove_suid(file);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002540 if (err)
2541 goto out;
2542
Josef Bacikc3b2da32012-03-26 09:59:21 -04002543 err = file_update_time(file);
2544 if (err)
2545 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002546
2547 /* coalesce the iovecs and go direct-to-BIO for O_DIRECT */
2548 if (unlikely(file->f_flags & O_DIRECT)) {
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002549 loff_t endbyte;
2550 ssize_t written_buffered;
2551
2552 written = generic_file_direct_write(iocb, iov, &nr_segs, pos,
2553 ppos, count, ocount);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002554 if (written < 0 || written == count)
2555 goto out;
2556 /*
2557 * direct-io write to a hole: fall through to buffered I/O
2558 * for completing the rest of the request.
2559 */
2560 pos += written;
2561 count -= written;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002562 written_buffered = generic_file_buffered_write(iocb, iov,
2563 nr_segs, pos, ppos, count,
2564 written);
2565 /*
2566 * If generic_file_buffered_write() retuned a synchronous error
2567 * then we want to return the number of bytes which were
2568 * direct-written, or the error code if that was zero. Note
2569 * that this differs from normal direct-io semantics, which
2570 * will return -EFOO even if some bytes were written.
2571 */
2572 if (written_buffered < 0) {
2573 err = written_buffered;
2574 goto out;
2575 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002576
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002577 /*
2578 * We need to ensure that the page cache pages are written to
2579 * disk and invalidated to preserve the expected O_DIRECT
2580 * semantics.
2581 */
2582 endbyte = pos + written_buffered - written - 1;
Christoph Hellwigc05c4ed2009-09-23 15:07:30 +02002583 err = filemap_write_and_wait_range(file->f_mapping, pos, endbyte);
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002584 if (err == 0) {
2585 written = written_buffered;
2586 invalidate_mapping_pages(mapping,
2587 pos >> PAGE_CACHE_SHIFT,
2588 endbyte >> PAGE_CACHE_SHIFT);
2589 } else {
2590 /*
2591 * We don't know how much we wrote, so just return
2592 * the number of bytes which were direct-written
2593 */
2594 }
2595 } else {
2596 written = generic_file_buffered_write(iocb, iov, nr_segs,
2597 pos, ppos, count, written);
2598 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002599out:
2600 current->backing_dev_info = NULL;
2601 return written ? written : err;
2602}
Jan Karae4dd9de2009-08-17 18:10:06 +02002603EXPORT_SYMBOL(__generic_file_aio_write);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002604
Jan Karae4dd9de2009-08-17 18:10:06 +02002605/**
2606 * generic_file_aio_write - write data to a file
2607 * @iocb: IO state structure
2608 * @iov: vector with data to write
2609 * @nr_segs: number of segments in the vector
2610 * @pos: position in file where to write
2611 *
2612 * This is a wrapper around __generic_file_aio_write() to be used by most
2613 * filesystems. It takes care of syncing the file in case of O_SYNC file
2614 * and acquires i_mutex as needed.
2615 */
Badari Pulavarty027445c2006-09-30 23:28:46 -07002616ssize_t generic_file_aio_write(struct kiocb *iocb, const struct iovec *iov,
2617 unsigned long nr_segs, loff_t pos)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002618{
2619 struct file *file = iocb->ki_filp;
Jan Kara148f9482009-08-17 19:52:36 +02002620 struct inode *inode = file->f_mapping->host;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002621 ssize_t ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002622
2623 BUG_ON(iocb->ki_pos != pos);
2624
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002625 mutex_lock(&inode->i_mutex);
Jan Karae4dd9de2009-08-17 18:10:06 +02002626 ret = __generic_file_aio_write(iocb, iov, nr_segs, &iocb->ki_pos);
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002627 mutex_unlock(&inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002628
Christoph Hellwig02afc27f2013-09-04 15:04:40 +02002629 if (ret > 0) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002630 ssize_t err;
2631
Al Virod311d792014-02-09 15:18:09 -05002632 err = generic_write_sync(file, iocb->ki_pos - ret, ret);
2633 if (err < 0)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002634 ret = err;
2635 }
2636 return ret;
2637}
2638EXPORT_SYMBOL(generic_file_aio_write);
2639
David Howellscf9a2ae2006-08-29 19:05:54 +01002640/**
2641 * try_to_release_page() - release old fs-specific metadata on a page
2642 *
2643 * @page: the page which the kernel is trying to free
2644 * @gfp_mask: memory allocation flags (and I/O mode)
2645 *
2646 * The address_space is to try to release any data against the page
2647 * (presumably at page->private). If the release was successful, return `1'.
2648 * Otherwise return zero.
2649 *
David Howells266cf652009-04-03 16:42:36 +01002650 * This may also be called if PG_fscache is set on a page, indicating that the
2651 * page is known to the local caching routines.
2652 *
David Howellscf9a2ae2006-08-29 19:05:54 +01002653 * The @gfp_mask argument specifies whether I/O may be performed to release
Mingming Cao3f31fdd2008-07-25 01:46:22 -07002654 * this page (__GFP_IO), and whether the call may block (__GFP_WAIT & __GFP_FS).
David Howellscf9a2ae2006-08-29 19:05:54 +01002655 *
David Howellscf9a2ae2006-08-29 19:05:54 +01002656 */
2657int try_to_release_page(struct page *page, gfp_t gfp_mask)
2658{
2659 struct address_space * const mapping = page->mapping;
2660
2661 BUG_ON(!PageLocked(page));
2662 if (PageWriteback(page))
2663 return 0;
2664
2665 if (mapping && mapping->a_ops->releasepage)
2666 return mapping->a_ops->releasepage(page, gfp_mask);
2667 return try_to_free_buffers(page);
2668}
2669
2670EXPORT_SYMBOL(try_to_release_page);