blob: 1694623a628902b76e11d6983eebd1ea7d33ddf1 [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>
Ross Zwislerf9fe48b2016-01-22 15:10:40 -080014#include <linux/dax.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070015#include <linux/fs.h>
Ingo Molnar3f07c012017-02-08 18:51:30 +010016#include <linux/sched/signal.h>
Hiro Yoshiokac22ce142006-06-23 02:04:16 -070017#include <linux/uaccess.h>
Randy.Dunlapc59ede72006-01-11 12:17:46 -080018#include <linux/capability.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070019#include <linux/kernel_stat.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090020#include <linux/gfp.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070021#include <linux/mm.h>
22#include <linux/swap.h>
23#include <linux/mman.h>
24#include <linux/pagemap.h>
25#include <linux/file.h>
26#include <linux/uio.h>
27#include <linux/hash.h>
28#include <linux/writeback.h>
Linus Torvalds53253382007-10-18 14:47:32 -070029#include <linux/backing-dev.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070030#include <linux/pagevec.h>
31#include <linux/blkdev.h>
32#include <linux/security.h>
Paul Jackson44110fe2006-03-24 03:16:04 -080033#include <linux/cpuset.h>
Nick Piggin2f718ff2007-10-16 01:24:59 -070034#include <linux/hardirq.h> /* for BUG_ON(!in_atomic()) only */
Johannes Weiner00501b52014-08-08 14:19:20 -070035#include <linux/hugetlb.h>
Balbir Singh8a9f3cc2008-02-07 00:13:53 -080036#include <linux/memcontrol.h>
Dan Magenheimerc515e1f2011-05-26 10:01:43 -060037#include <linux/cleancache.h>
Kirill A. Shutemovf1820362014-04-07 15:37:19 -070038#include <linux/rmap.h>
Nick Piggin0f8053a2006-03-22 00:08:33 -080039#include "internal.h"
40
Robert Jarzmikfe0bfaa2013-04-29 15:06:10 -070041#define CREATE_TRACE_POINTS
42#include <trace/events/filemap.h>
43
Linus Torvalds1da177e2005-04-16 15:20:36 -070044/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070045 * FIXME: remove all knowledge of the buffer layer from the core VM
46 */
Jan Kara148f9482009-08-17 19:52:36 +020047#include <linux/buffer_head.h> /* for try_to_free_buffers */
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
Linus Torvalds1da177e2005-04-16 15:20:36 -070049#include <asm/mman.h>
50
51/*
52 * Shared mappings implemented 30.11.1994. It's not fully working yet,
53 * though.
54 *
55 * Shared mappings now work. 15.8.1995 Bruno.
56 *
57 * finished 'unifying' the page and buffer cache and SMP-threaded the
58 * page-cache, 21.05.1999, Ingo Molnar <mingo@redhat.com>
59 *
60 * SMP-threaded pagemap-LRU 1999, Andrea Arcangeli <andrea@suse.de>
61 */
62
63/*
64 * Lock ordering:
65 *
Davidlohr Buesoc8c06ef2014-12-12 16:54:24 -080066 * ->i_mmap_rwsem (truncate_pagecache)
Linus Torvalds1da177e2005-04-16 15:20:36 -070067 * ->private_lock (__free_pte->__set_page_dirty_buffers)
Hugh Dickins5d337b92005-09-03 15:54:41 -070068 * ->swap_lock (exclusive_swap_page, others)
69 * ->mapping->tree_lock
Linus Torvalds1da177e2005-04-16 15:20:36 -070070 *
Jes Sorensen1b1dcc12006-01-09 15:59:24 -080071 * ->i_mutex
Davidlohr Buesoc8c06ef2014-12-12 16:54:24 -080072 * ->i_mmap_rwsem (truncate->unmap_mapping_range)
Linus Torvalds1da177e2005-04-16 15:20:36 -070073 *
74 * ->mmap_sem
Davidlohr Buesoc8c06ef2014-12-12 16:54:24 -080075 * ->i_mmap_rwsem
Hugh Dickinsb8072f02005-10-29 18:16:41 -070076 * ->page_table_lock or pte_lock (various, mainly in memory.c)
Linus Torvalds1da177e2005-04-16 15:20:36 -070077 * ->mapping->tree_lock (arch-dependent flush_dcache_mmap_lock)
78 *
79 * ->mmap_sem
80 * ->lock_page (access_process_vm)
81 *
Al Viroccad2362014-02-11 22:36:48 -050082 * ->i_mutex (generic_perform_write)
Nick Piggin82591e62006-10-19 23:29:10 -070083 * ->mmap_sem (fault_in_pages_readable->do_page_fault)
Linus Torvalds1da177e2005-04-16 15:20:36 -070084 *
Christoph Hellwigf758eea2011-04-21 18:19:44 -060085 * bdi->wb.list_lock
Dave Chinnera66979a2011-03-22 22:23:41 +110086 * sb_lock (fs/fs-writeback.c)
Linus Torvalds1da177e2005-04-16 15:20:36 -070087 * ->mapping->tree_lock (__sync_single_inode)
88 *
Davidlohr Buesoc8c06ef2014-12-12 16:54:24 -080089 * ->i_mmap_rwsem
Linus Torvalds1da177e2005-04-16 15:20:36 -070090 * ->anon_vma.lock (vma_adjust)
91 *
92 * ->anon_vma.lock
Hugh Dickinsb8072f02005-10-29 18:16:41 -070093 * ->page_table_lock or pte_lock (anon_vma_prepare and various)
Linus Torvalds1da177e2005-04-16 15:20:36 -070094 *
Hugh Dickinsb8072f02005-10-29 18:16:41 -070095 * ->page_table_lock or pte_lock
Hugh Dickins5d337b92005-09-03 15:54:41 -070096 * ->swap_lock (try_to_unmap_one)
Linus Torvalds1da177e2005-04-16 15:20:36 -070097 * ->private_lock (try_to_unmap_one)
98 * ->tree_lock (try_to_unmap_one)
Mel Gormana52633d2016-07-28 15:45:28 -070099 * ->zone_lru_lock(zone) (follow_page->mark_page_accessed)
100 * ->zone_lru_lock(zone) (check_pte_range->isolate_lru_page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700101 * ->private_lock (page_remove_rmap->set_page_dirty)
102 * ->tree_lock (page_remove_rmap->set_page_dirty)
Christoph Hellwigf758eea2011-04-21 18:19:44 -0600103 * bdi.wb->list_lock (page_remove_rmap->set_page_dirty)
Dave Chinner250df6e2011-03-22 22:23:36 +1100104 * ->inode->i_lock (page_remove_rmap->set_page_dirty)
Johannes Weiner81f8c3a2016-03-15 14:57:04 -0700105 * ->memcg->move_lock (page_remove_rmap->lock_page_memcg)
Christoph Hellwigf758eea2011-04-21 18:19:44 -0600106 * bdi.wb->list_lock (zap_pte_range->set_page_dirty)
Dave Chinner250df6e2011-03-22 22:23:36 +1100107 * ->inode->i_lock (zap_pte_range->set_page_dirty)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108 * ->private_lock (zap_pte_range->__set_page_dirty_buffers)
109 *
Davidlohr Buesoc8c06ef2014-12-12 16:54:24 -0800110 * ->i_mmap_rwsem
Andi Kleen9a3c5312012-03-21 16:34:09 -0700111 * ->tasklist_lock (memory_failure, collect_procs_ao)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700112 */
113
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700114static int page_cache_tree_insert(struct address_space *mapping,
115 struct page *page, void **shadowp)
116{
117 struct radix_tree_node *node;
118 void **slot;
119 int error;
120
121 error = __radix_tree_create(&mapping->page_tree, page->index, 0,
122 &node, &slot);
123 if (error)
124 return error;
125 if (*slot) {
126 void *p;
127
128 p = radix_tree_deref_slot_protected(slot, &mapping->tree_lock);
129 if (!radix_tree_exceptional_entry(p))
130 return -EEXIST;
131
132 mapping->nrexceptional--;
133 if (!dax_mapping(mapping)) {
134 if (shadowp)
135 *shadowp = p;
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700136 } else {
137 /* DAX can replace empty locked entry with a hole */
138 WARN_ON_ONCE(p !=
Ross Zwisler642261a2016-11-08 11:34:45 +1100139 dax_radix_locked_entry(0, RADIX_DAX_EMPTY));
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700140 /* Wakeup waiters for exceptional entry lock */
Ross Zwisler63e95b52016-11-08 11:32:20 +1100141 dax_wake_mapping_entry_waiter(mapping, page->index, p,
Ross Zwisler965d0042017-01-10 16:57:15 -0800142 true);
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700143 }
144 }
Johannes Weiner14b46872016-12-12 16:43:52 -0800145 __radix_tree_replace(&mapping->page_tree, node, slot, page,
146 workingset_update_node, mapping);
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700147 mapping->nrpages++;
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700148 return 0;
149}
150
Johannes Weiner91b0abe2014-04-03 14:47:49 -0700151static void page_cache_tree_delete(struct address_space *mapping,
152 struct page *page, void *shadow)
153{
Kirill A. Shutemovc70b6472016-12-12 16:43:17 -0800154 int i, nr;
155
156 /* hugetlb pages are represented by one entry in the radix tree */
157 nr = PageHuge(page) ? 1 : hpage_nr_pages(page);
Johannes Weiner91b0abe2014-04-03 14:47:49 -0700158
Kirill A. Shutemov83929372016-07-26 15:26:04 -0700159 VM_BUG_ON_PAGE(!PageLocked(page), page);
160 VM_BUG_ON_PAGE(PageTail(page), page);
161 VM_BUG_ON_PAGE(nr != 1 && shadow, page);
Johannes Weiner449dd692014-04-03 14:47:56 -0700162
Kirill A. Shutemov83929372016-07-26 15:26:04 -0700163 for (i = 0; i < nr; i++) {
Johannes Weinerd3798ae2016-10-04 22:02:08 +0200164 struct radix_tree_node *node;
165 void **slot;
166
167 __radix_tree_lookup(&mapping->page_tree, page->index + i,
168 &node, &slot);
169
Johannes Weinerdbc446b2016-12-12 16:43:55 -0800170 VM_BUG_ON_PAGE(!node && nr != 1, page);
Johannes Weiner449dd692014-04-03 14:47:56 -0700171
Johannes Weiner14b46872016-12-12 16:43:52 -0800172 radix_tree_clear_tags(&mapping->page_tree, node, slot);
173 __radix_tree_replace(&mapping->page_tree, node, slot, shadow,
174 workingset_update_node, mapping);
Johannes Weiner449dd692014-04-03 14:47:56 -0700175 }
Johannes Weinerd3798ae2016-10-04 22:02:08 +0200176
177 if (shadow) {
178 mapping->nrexceptional += nr;
179 /*
180 * Make sure the nrexceptional update is committed before
181 * the nrpages update so that final truncate racing
182 * with reclaim does not see both counters 0 at the
183 * same time and miss a shadow entry.
184 */
185 smp_wmb();
186 }
187 mapping->nrpages -= nr;
Johannes Weiner91b0abe2014-04-03 14:47:49 -0700188}
189
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190/*
Minchan Kime64a7822011-03-22 16:32:44 -0700191 * Delete a page from the page cache and free it. Caller has to make
Linus Torvalds1da177e2005-04-16 15:20:36 -0700192 * sure the page is locked and that nobody else uses it - or that usage
Johannes Weinerfdf1cdb2016-03-15 14:57:25 -0700193 * is safe. The caller must hold the mapping's tree_lock.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700194 */
Johannes Weiner62cccb82016-03-15 14:57:22 -0700195void __delete_from_page_cache(struct page *page, void *shadow)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700196{
197 struct address_space *mapping = page->mapping;
Kirill A. Shutemov83929372016-07-26 15:26:04 -0700198 int nr = hpage_nr_pages(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700199
Robert Jarzmikfe0bfaa2013-04-29 15:06:10 -0700200 trace_mm_filemap_delete_from_page_cache(page);
Dan Magenheimerc515e1f2011-05-26 10:01:43 -0600201 /*
202 * if we're uptodate, flush out into the cleancache, otherwise
203 * invalidate any existing cleancache entries. We can't leave
204 * stale data around in the cleancache once our page is gone
205 */
206 if (PageUptodate(page) && PageMappedToDisk(page))
207 cleancache_put_page(page);
208 else
Dan Magenheimer31677602011-09-21 11:56:28 -0400209 cleancache_invalidate_page(mapping, page);
Dan Magenheimerc515e1f2011-05-26 10:01:43 -0600210
Kirill A. Shutemov83929372016-07-26 15:26:04 -0700211 VM_BUG_ON_PAGE(PageTail(page), page);
Hugh Dickins06b241f2016-03-09 14:08:07 -0800212 VM_BUG_ON_PAGE(page_mapped(page), page);
213 if (!IS_ENABLED(CONFIG_DEBUG_VM) && unlikely(page_mapped(page))) {
214 int mapcount;
215
216 pr_alert("BUG: Bad page cache in process %s pfn:%05lx\n",
217 current->comm, page_to_pfn(page));
218 dump_page(page, "still mapped when deleted");
219 dump_stack();
220 add_taint(TAINT_BAD_PAGE, LOCKDEP_NOW_UNRELIABLE);
221
222 mapcount = page_mapcount(page);
223 if (mapping_exiting(mapping) &&
224 page_count(page) >= mapcount + 2) {
225 /*
226 * All vmas have already been torn down, so it's
227 * a good bet that actually the page is unmapped,
228 * and we'd prefer not to leak it: if we're wrong,
229 * some other bad page check should catch it later.
230 */
231 page_mapcount_reset(page);
Joonsoo Kim6d061f92016-05-19 17:10:46 -0700232 page_ref_sub(page, mapcount);
Hugh Dickins06b241f2016-03-09 14:08:07 -0800233 }
234 }
235
Johannes Weiner91b0abe2014-04-03 14:47:49 -0700236 page_cache_tree_delete(mapping, page, shadow);
237
Linus Torvalds1da177e2005-04-16 15:20:36 -0700238 page->mapping = NULL;
Hugh Dickinsb85e0ef2011-07-25 17:12:25 -0700239 /* Leave page->index set: truncation lookup relies upon it */
Johannes Weiner91b0abe2014-04-03 14:47:49 -0700240
Michal Hocko4165b9b2015-06-24 16:57:24 -0700241 /* hugetlb pages do not participate in page cache accounting. */
242 if (!PageHuge(page))
Mel Gorman11fb9982016-07-28 15:46:20 -0700243 __mod_node_page_state(page_pgdat(page), NR_FILE_PAGES, -nr);
Kirill A. Shutemov800d8c62016-07-26 15:26:18 -0700244 if (PageSwapBacked(page)) {
Mel Gorman11fb9982016-07-28 15:46:20 -0700245 __mod_node_page_state(page_pgdat(page), NR_SHMEM, -nr);
Kirill A. Shutemov800d8c62016-07-26 15:26:18 -0700246 if (PageTransHuge(page))
Mel Gorman11fb9982016-07-28 15:46:20 -0700247 __dec_node_page_state(page, NR_SHMEM_THPS);
Kirill A. Shutemov800d8c62016-07-26 15:26:18 -0700248 } else {
249 VM_BUG_ON_PAGE(PageTransHuge(page) && !PageHuge(page), page);
250 }
Linus Torvalds3a692792007-12-19 14:05:13 -0800251
252 /*
Konstantin Khlebnikovb9ea2512015-04-14 15:45:27 -0700253 * At this point page must be either written or cleaned by truncate.
254 * Dirty page here signals a bug and loss of unwritten data.
Linus Torvalds3a692792007-12-19 14:05:13 -0800255 *
Konstantin Khlebnikovb9ea2512015-04-14 15:45:27 -0700256 * This fixes dirty accounting after removing the page entirely but
257 * leaves PageDirty set: it has no effect for truncated page and
258 * anyway will be cleared before returning page into buddy allocator.
Linus Torvalds3a692792007-12-19 14:05:13 -0800259 */
Konstantin Khlebnikovb9ea2512015-04-14 15:45:27 -0700260 if (WARN_ON_ONCE(PageDirty(page)))
Johannes Weiner62cccb82016-03-15 14:57:22 -0700261 account_page_cleaned(page, mapping, inode_to_wb(mapping->host));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700262}
263
Minchan Kim702cfbf2011-03-22 16:32:43 -0700264/**
265 * delete_from_page_cache - delete page from page cache
266 * @page: the page which the kernel is trying to remove from page cache
267 *
268 * This must be called only on pages that have been verified to be in the page
269 * cache and locked. It will never put the page into the free list, the caller
270 * has a reference on the page.
271 */
272void delete_from_page_cache(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700273{
Kirill A. Shutemov83929372016-07-26 15:26:04 -0700274 struct address_space *mapping = page_mapping(page);
Greg Thelenc4843a72015-05-22 17:13:16 -0400275 unsigned long flags;
Linus Torvalds6072d132010-12-01 13:35:19 -0500276 void (*freepage)(struct page *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700277
Matt Mackallcd7619d2005-05-01 08:59:01 -0700278 BUG_ON(!PageLocked(page));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700279
Linus Torvalds6072d132010-12-01 13:35:19 -0500280 freepage = mapping->a_ops->freepage;
Greg Thelenc4843a72015-05-22 17:13:16 -0400281
Greg Thelenc4843a72015-05-22 17:13:16 -0400282 spin_lock_irqsave(&mapping->tree_lock, flags);
Johannes Weiner62cccb82016-03-15 14:57:22 -0700283 __delete_from_page_cache(page, NULL);
Greg Thelenc4843a72015-05-22 17:13:16 -0400284 spin_unlock_irqrestore(&mapping->tree_lock, flags);
Linus Torvalds6072d132010-12-01 13:35:19 -0500285
286 if (freepage)
287 freepage(page);
Kirill A. Shutemov83929372016-07-26 15:26:04 -0700288
289 if (PageTransHuge(page) && !PageHuge(page)) {
290 page_ref_sub(page, HPAGE_PMD_NR);
291 VM_BUG_ON_PAGE(page_count(page) <= 0, page);
292 } else {
293 put_page(page);
294 }
Minchan Kim97cecb52011-03-22 16:30:53 -0700295}
296EXPORT_SYMBOL(delete_from_page_cache);
297
Miklos Szeredid72d9e22016-07-29 14:10:57 +0200298int filemap_check_errors(struct address_space *mapping)
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700299{
300 int ret = 0;
301 /* Check for outstanding write errors */
Jens Axboe7fcbbaf2014-05-22 11:54:16 -0700302 if (test_bit(AS_ENOSPC, &mapping->flags) &&
303 test_and_clear_bit(AS_ENOSPC, &mapping->flags))
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700304 ret = -ENOSPC;
Jens Axboe7fcbbaf2014-05-22 11:54:16 -0700305 if (test_bit(AS_EIO, &mapping->flags) &&
306 test_and_clear_bit(AS_EIO, &mapping->flags))
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700307 ret = -EIO;
308 return ret;
309}
Miklos Szeredid72d9e22016-07-29 14:10:57 +0200310EXPORT_SYMBOL(filemap_check_errors);
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700311
Linus Torvalds1da177e2005-04-16 15:20:36 -0700312/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700313 * __filemap_fdatawrite_range - start writeback on mapping dirty pages in range
Martin Waitz67be2dd2005-05-01 08:59:26 -0700314 * @mapping: address space structure to write
315 * @start: offset in bytes where the range starts
Andrew Morton469eb4d2006-03-24 03:17:45 -0800316 * @end: offset in bytes where the range ends (inclusive)
Martin Waitz67be2dd2005-05-01 08:59:26 -0700317 * @sync_mode: enable synchronous operation
Linus Torvalds1da177e2005-04-16 15:20:36 -0700318 *
Randy Dunlap485bb992006-06-23 02:03:49 -0700319 * Start writeback against all of a mapping's dirty pages that lie
320 * within the byte offsets <start, end> inclusive.
321 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700322 * If sync_mode is WB_SYNC_ALL then this is a "data integrity" operation, as
Randy Dunlap485bb992006-06-23 02:03:49 -0700323 * opposed to a regular memory cleansing writeback. The difference between
Linus Torvalds1da177e2005-04-16 15:20:36 -0700324 * these two operations is that if a dirty page/buffer is encountered, it must
325 * be waited upon, and not just skipped over.
326 */
Andrew Mortonebcf28e2006-03-24 03:18:04 -0800327int __filemap_fdatawrite_range(struct address_space *mapping, loff_t start,
328 loff_t end, int sync_mode)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700329{
330 int ret;
331 struct writeback_control wbc = {
332 .sync_mode = sync_mode,
Nick Piggin05fe4782009-01-06 14:39:08 -0800333 .nr_to_write = LONG_MAX,
OGAWA Hirofumi111ebb62006-06-23 02:03:26 -0700334 .range_start = start,
335 .range_end = end,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700336 };
337
338 if (!mapping_cap_writeback_dirty(mapping))
339 return 0;
340
Tejun Heob16b1de2015-06-02 08:39:48 -0600341 wbc_attach_fdatawrite_inode(&wbc, mapping->host);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700342 ret = do_writepages(mapping, &wbc);
Tejun Heob16b1de2015-06-02 08:39:48 -0600343 wbc_detach_inode(&wbc);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700344 return ret;
345}
346
347static inline int __filemap_fdatawrite(struct address_space *mapping,
348 int sync_mode)
349{
OGAWA Hirofumi111ebb62006-06-23 02:03:26 -0700350 return __filemap_fdatawrite_range(mapping, 0, LLONG_MAX, sync_mode);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700351}
352
353int filemap_fdatawrite(struct address_space *mapping)
354{
355 return __filemap_fdatawrite(mapping, WB_SYNC_ALL);
356}
357EXPORT_SYMBOL(filemap_fdatawrite);
358
Jan Karaf4c0a0f2008-07-11 19:27:31 -0400359int filemap_fdatawrite_range(struct address_space *mapping, loff_t start,
Andrew Mortonebcf28e2006-03-24 03:18:04 -0800360 loff_t end)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700361{
362 return __filemap_fdatawrite_range(mapping, start, end, WB_SYNC_ALL);
363}
Jan Karaf4c0a0f2008-07-11 19:27:31 -0400364EXPORT_SYMBOL(filemap_fdatawrite_range);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700365
Randy Dunlap485bb992006-06-23 02:03:49 -0700366/**
367 * filemap_flush - mostly a non-blocking flush
368 * @mapping: target address_space
369 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700370 * This is a mostly non-blocking flush. Not suitable for data-integrity
371 * purposes - I/O may not be started against all dirty pages.
372 */
373int filemap_flush(struct address_space *mapping)
374{
375 return __filemap_fdatawrite(mapping, WB_SYNC_NONE);
376}
377EXPORT_SYMBOL(filemap_flush);
378
Junichi Nomuraaa750fd2015-11-05 18:47:23 -0800379static int __filemap_fdatawait_range(struct address_space *mapping,
380 loff_t start_byte, loff_t end_byte)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700381{
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300382 pgoff_t index = start_byte >> PAGE_SHIFT;
383 pgoff_t end = end_byte >> PAGE_SHIFT;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700384 struct pagevec pvec;
385 int nr_pages;
Junichi Nomuraaa750fd2015-11-05 18:47:23 -0800386 int ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700387
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200388 if (end_byte < start_byte)
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700389 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700390
391 pagevec_init(&pvec, 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700392 while ((index <= end) &&
393 (nr_pages = pagevec_lookup_tag(&pvec, mapping, &index,
394 PAGECACHE_TAG_WRITEBACK,
395 min(end - index, (pgoff_t)PAGEVEC_SIZE-1) + 1)) != 0) {
396 unsigned i;
397
398 for (i = 0; i < nr_pages; i++) {
399 struct page *page = pvec.pages[i];
400
401 /* until radix tree lookup accepts end_index */
402 if (page->index > end)
403 continue;
404
405 wait_on_page_writeback(page);
Rik van Riel212260a2011-01-13 15:46:06 -0800406 if (TestClearPageError(page))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700407 ret = -EIO;
408 }
409 pagevec_release(&pvec);
410 cond_resched();
411 }
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700412out:
Junichi Nomuraaa750fd2015-11-05 18:47:23 -0800413 return ret;
414}
415
416/**
417 * filemap_fdatawait_range - wait for writeback to complete
418 * @mapping: address space structure to wait for
419 * @start_byte: offset in bytes where the range starts
420 * @end_byte: offset in bytes where the range ends (inclusive)
421 *
422 * Walk the list of under-writeback pages of the given address space
423 * in the given range and wait for all of them. Check error status of
424 * the address space and return it.
425 *
426 * Since the error status of the address space is cleared by this function,
427 * callers are responsible for checking the return value and handling and/or
428 * reporting the error.
429 */
430int filemap_fdatawait_range(struct address_space *mapping, loff_t start_byte,
431 loff_t end_byte)
432{
433 int ret, ret2;
434
435 ret = __filemap_fdatawait_range(mapping, start_byte, end_byte);
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700436 ret2 = filemap_check_errors(mapping);
437 if (!ret)
438 ret = ret2;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700439
440 return ret;
441}
Jan Karad3bccb6f2009-08-17 19:30:27 +0200442EXPORT_SYMBOL(filemap_fdatawait_range);
443
444/**
Junichi Nomuraaa750fd2015-11-05 18:47:23 -0800445 * filemap_fdatawait_keep_errors - wait for writeback without clearing errors
446 * @mapping: address space structure to wait for
447 *
448 * Walk the list of under-writeback pages of the given address space
449 * and wait for all of them. Unlike filemap_fdatawait(), this function
450 * does not clear error status of the address space.
451 *
452 * Use this function if callers don't handle errors themselves. Expected
453 * call sites are system-wide / filesystem-wide data flushers: e.g. sync(2),
454 * fsfreeze(8)
455 */
456void filemap_fdatawait_keep_errors(struct address_space *mapping)
457{
458 loff_t i_size = i_size_read(mapping->host);
459
460 if (i_size == 0)
461 return;
462
463 __filemap_fdatawait_range(mapping, 0, i_size - 1);
464}
465
466/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700467 * filemap_fdatawait - wait for all under-writeback pages to complete
Linus Torvalds1da177e2005-04-16 15:20:36 -0700468 * @mapping: address space structure to wait for
Randy Dunlap485bb992006-06-23 02:03:49 -0700469 *
470 * Walk the list of under-writeback pages of the given address space
Junichi Nomuraaa750fd2015-11-05 18:47:23 -0800471 * and wait for all of them. Check error status of the address space
472 * and return it.
473 *
474 * Since the error status of the address space is cleared by this function,
475 * callers are responsible for checking the return value and handling and/or
476 * reporting the error.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700477 */
478int filemap_fdatawait(struct address_space *mapping)
479{
480 loff_t i_size = i_size_read(mapping->host);
481
482 if (i_size == 0)
483 return 0;
484
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200485 return filemap_fdatawait_range(mapping, 0, i_size - 1);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700486}
487EXPORT_SYMBOL(filemap_fdatawait);
488
489int filemap_write_and_wait(struct address_space *mapping)
490{
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800491 int err = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700492
Ross Zwisler7f6d5b52016-02-26 15:19:55 -0800493 if ((!dax_mapping(mapping) && mapping->nrpages) ||
494 (dax_mapping(mapping) && mapping->nrexceptional)) {
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800495 err = filemap_fdatawrite(mapping);
496 /*
497 * Even if the above returned error, the pages may be
498 * written partially (e.g. -ENOSPC), so we wait for it.
499 * But the -EIO is special case, it may indicate the worst
500 * thing (e.g. bug) happened, so we avoid waiting for it.
501 */
502 if (err != -EIO) {
503 int err2 = filemap_fdatawait(mapping);
504 if (!err)
505 err = err2;
506 }
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700507 } else {
508 err = filemap_check_errors(mapping);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700509 }
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800510 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700511}
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800512EXPORT_SYMBOL(filemap_write_and_wait);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700513
Randy Dunlap485bb992006-06-23 02:03:49 -0700514/**
515 * filemap_write_and_wait_range - write out & wait on a file range
516 * @mapping: the address_space for the pages
517 * @lstart: offset in bytes where the range starts
518 * @lend: offset in bytes where the range ends (inclusive)
519 *
Andrew Morton469eb4d2006-03-24 03:17:45 -0800520 * Write out and wait upon file offsets lstart->lend, inclusive.
521 *
522 * Note that `lend' is inclusive (describes the last byte to be written) so
523 * that this function can be used to write to the very end-of-file (end = -1).
524 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700525int filemap_write_and_wait_range(struct address_space *mapping,
526 loff_t lstart, loff_t lend)
527{
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800528 int err = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700529
Ross Zwisler7f6d5b52016-02-26 15:19:55 -0800530 if ((!dax_mapping(mapping) && mapping->nrpages) ||
531 (dax_mapping(mapping) && mapping->nrexceptional)) {
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800532 err = __filemap_fdatawrite_range(mapping, lstart, lend,
533 WB_SYNC_ALL);
534 /* See comment of filemap_write_and_wait() */
535 if (err != -EIO) {
Christoph Hellwig94004ed2009-09-30 22:16:33 +0200536 int err2 = filemap_fdatawait_range(mapping,
537 lstart, lend);
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800538 if (!err)
539 err = err2;
540 }
Dmitry Monakhov865ffef32013-04-29 15:08:42 -0700541 } else {
542 err = filemap_check_errors(mapping);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700543 }
OGAWA Hirofumi28fd1292006-01-08 01:02:14 -0800544 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700545}
Chris Masonf6995582009-04-15 13:22:37 -0400546EXPORT_SYMBOL(filemap_write_and_wait_range);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700547
Randy Dunlap485bb992006-06-23 02:03:49 -0700548/**
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700549 * replace_page_cache_page - replace a pagecache page with a new one
550 * @old: page to be replaced
551 * @new: page to replace with
552 * @gfp_mask: allocation mode
553 *
554 * This function replaces a page in the pagecache with a new one. On
555 * success it acquires the pagecache reference for the new page and
556 * drops it for the old page. Both the old and new pages must be
557 * locked. This function does not add the new page to the LRU, the
558 * caller must do that.
559 *
560 * The remove + add is atomic. The only way this function can fail is
561 * memory allocation failure.
562 */
563int replace_page_cache_page(struct page *old, struct page *new, gfp_t gfp_mask)
564{
565 int error;
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700566
Sasha Levin309381fea2014-01-23 15:52:54 -0800567 VM_BUG_ON_PAGE(!PageLocked(old), old);
568 VM_BUG_ON_PAGE(!PageLocked(new), new);
569 VM_BUG_ON_PAGE(new->mapping, new);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700570
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700571 error = radix_tree_preload(gfp_mask & ~__GFP_HIGHMEM);
572 if (!error) {
573 struct address_space *mapping = old->mapping;
574 void (*freepage)(struct page *);
Greg Thelenc4843a72015-05-22 17:13:16 -0400575 unsigned long flags;
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700576
577 pgoff_t offset = old->index;
578 freepage = mapping->a_ops->freepage;
579
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300580 get_page(new);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700581 new->mapping = mapping;
582 new->index = offset;
583
Greg Thelenc4843a72015-05-22 17:13:16 -0400584 spin_lock_irqsave(&mapping->tree_lock, flags);
Johannes Weiner62cccb82016-03-15 14:57:22 -0700585 __delete_from_page_cache(old, NULL);
Johannes Weiner22f2ac52016-09-30 15:11:29 -0700586 error = page_cache_tree_insert(mapping, new, NULL);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700587 BUG_ON(error);
Michal Hocko4165b9b2015-06-24 16:57:24 -0700588
589 /*
590 * hugetlb pages do not participate in page cache accounting.
591 */
592 if (!PageHuge(new))
Mel Gorman11fb9982016-07-28 15:46:20 -0700593 __inc_node_page_state(new, NR_FILE_PAGES);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700594 if (PageSwapBacked(new))
Mel Gorman11fb9982016-07-28 15:46:20 -0700595 __inc_node_page_state(new, NR_SHMEM);
Greg Thelenc4843a72015-05-22 17:13:16 -0400596 spin_unlock_irqrestore(&mapping->tree_lock, flags);
Johannes Weiner6a93ca82016-03-15 14:57:19 -0700597 mem_cgroup_migrate(old, new);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700598 radix_tree_preload_end();
599 if (freepage)
600 freepage(old);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300601 put_page(old);
Miklos Szeredief6a3c62011-03-22 16:30:52 -0700602 }
603
604 return error;
605}
606EXPORT_SYMBOL_GPL(replace_page_cache_page);
607
Johannes Weinera5289102014-04-03 14:47:51 -0700608static int __add_to_page_cache_locked(struct page *page,
609 struct address_space *mapping,
610 pgoff_t offset, gfp_t gfp_mask,
611 void **shadowp)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700612{
Johannes Weiner00501b52014-08-08 14:19:20 -0700613 int huge = PageHuge(page);
614 struct mem_cgroup *memcg;
Nick Piggine2867812008-07-25 19:45:30 -0700615 int error;
616
Sasha Levin309381fea2014-01-23 15:52:54 -0800617 VM_BUG_ON_PAGE(!PageLocked(page), page);
618 VM_BUG_ON_PAGE(PageSwapBacked(page), page);
Nick Piggine2867812008-07-25 19:45:30 -0700619
Johannes Weiner00501b52014-08-08 14:19:20 -0700620 if (!huge) {
621 error = mem_cgroup_try_charge(page, current->mm,
Kirill A. Shutemovf627c2f2016-01-15 16:52:20 -0800622 gfp_mask, &memcg, false);
Johannes Weiner00501b52014-08-08 14:19:20 -0700623 if (error)
624 return error;
625 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626
Jan Kara5e4c0d972013-09-11 14:26:05 -0700627 error = radix_tree_maybe_preload(gfp_mask & ~__GFP_HIGHMEM);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700628 if (error) {
Johannes Weiner00501b52014-08-08 14:19:20 -0700629 if (!huge)
Kirill A. Shutemovf627c2f2016-01-15 16:52:20 -0800630 mem_cgroup_cancel_charge(page, memcg, false);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700631 return error;
632 }
633
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300634 get_page(page);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700635 page->mapping = mapping;
636 page->index = offset;
637
638 spin_lock_irq(&mapping->tree_lock);
Johannes Weinera5289102014-04-03 14:47:51 -0700639 error = page_cache_tree_insert(mapping, page, shadowp);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700640 radix_tree_preload_end();
641 if (unlikely(error))
642 goto err_insert;
Michal Hocko4165b9b2015-06-24 16:57:24 -0700643
644 /* hugetlb pages do not participate in page cache accounting. */
645 if (!huge)
Mel Gorman11fb9982016-07-28 15:46:20 -0700646 __inc_node_page_state(page, NR_FILE_PAGES);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700647 spin_unlock_irq(&mapping->tree_lock);
Johannes Weiner00501b52014-08-08 14:19:20 -0700648 if (!huge)
Kirill A. Shutemovf627c2f2016-01-15 16:52:20 -0800649 mem_cgroup_commit_charge(page, memcg, false, false);
Kirill A. Shutemov66a0c8e2013-09-12 15:13:59 -0700650 trace_mm_filemap_add_to_page_cache(page);
651 return 0;
652err_insert:
653 page->mapping = NULL;
654 /* Leave page->index set: truncation relies upon it */
655 spin_unlock_irq(&mapping->tree_lock);
Johannes Weiner00501b52014-08-08 14:19:20 -0700656 if (!huge)
Kirill A. Shutemovf627c2f2016-01-15 16:52:20 -0800657 mem_cgroup_cancel_charge(page, memcg, false);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300658 put_page(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700659 return error;
660}
Johannes Weinera5289102014-04-03 14:47:51 -0700661
662/**
663 * add_to_page_cache_locked - add a locked page to the pagecache
664 * @page: page to add
665 * @mapping: the page's address_space
666 * @offset: page index
667 * @gfp_mask: page allocation mode
668 *
669 * This function is used to add a page to the pagecache. It must be locked.
670 * This function does not add the page to the LRU. The caller must do that.
671 */
672int add_to_page_cache_locked(struct page *page, struct address_space *mapping,
673 pgoff_t offset, gfp_t gfp_mask)
674{
675 return __add_to_page_cache_locked(page, mapping, offset,
676 gfp_mask, NULL);
677}
Nick Piggine2867812008-07-25 19:45:30 -0700678EXPORT_SYMBOL(add_to_page_cache_locked);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700679
680int add_to_page_cache_lru(struct page *page, struct address_space *mapping,
Al Viro6daa0e22005-10-21 03:18:50 -0400681 pgoff_t offset, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700682{
Johannes Weinera5289102014-04-03 14:47:51 -0700683 void *shadow = NULL;
Rik van Riel4f98a2f2008-10-18 20:26:32 -0700684 int ret;
685
Kirill A. Shutemov48c935a2016-01-15 16:51:24 -0800686 __SetPageLocked(page);
Johannes Weinera5289102014-04-03 14:47:51 -0700687 ret = __add_to_page_cache_locked(page, mapping, offset,
688 gfp_mask, &shadow);
689 if (unlikely(ret))
Kirill A. Shutemov48c935a2016-01-15 16:51:24 -0800690 __ClearPageLocked(page);
Johannes Weinera5289102014-04-03 14:47:51 -0700691 else {
692 /*
693 * The page might have been evicted from cache only
694 * recently, in which case it should be activated like
695 * any other repeatedly accessed page.
Rik van Rielf0281a02016-05-20 16:56:25 -0700696 * The exception is pages getting rewritten; evicting other
697 * data from the working set, only to cache data that will
698 * get overwritten with something else, is a waste of memory.
Johannes Weinera5289102014-04-03 14:47:51 -0700699 */
Rik van Rielf0281a02016-05-20 16:56:25 -0700700 if (!(gfp_mask & __GFP_WRITE) &&
701 shadow && workingset_refault(shadow)) {
Johannes Weinera5289102014-04-03 14:47:51 -0700702 SetPageActive(page);
703 workingset_activation(page);
704 } else
705 ClearPageActive(page);
706 lru_cache_add(page);
707 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700708 return ret;
709}
Evgeniy Polyakov18bc0bb2009-02-09 17:02:42 +0300710EXPORT_SYMBOL_GPL(add_to_page_cache_lru);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700711
Paul Jackson44110fe2006-03-24 03:16:04 -0800712#ifdef CONFIG_NUMA
Nick Piggin2ae88142006-10-28 10:38:23 -0700713struct page *__page_cache_alloc(gfp_t gfp)
Paul Jackson44110fe2006-03-24 03:16:04 -0800714{
Miao Xiec0ff7452010-05-24 14:32:08 -0700715 int n;
716 struct page *page;
717
Paul Jackson44110fe2006-03-24 03:16:04 -0800718 if (cpuset_do_page_mem_spread()) {
Mel Gormancc9a6c82012-03-21 16:34:11 -0700719 unsigned int cpuset_mems_cookie;
720 do {
Mel Gormand26914d2014-04-03 14:47:24 -0700721 cpuset_mems_cookie = read_mems_allowed_begin();
Mel Gormancc9a6c82012-03-21 16:34:11 -0700722 n = cpuset_mem_spread_node();
Vlastimil Babka96db8002015-09-08 15:03:50 -0700723 page = __alloc_pages_node(n, gfp, 0);
Mel Gormand26914d2014-04-03 14:47:24 -0700724 } while (!page && read_mems_allowed_retry(cpuset_mems_cookie));
Mel Gormancc9a6c82012-03-21 16:34:11 -0700725
Miao Xiec0ff7452010-05-24 14:32:08 -0700726 return page;
Paul Jackson44110fe2006-03-24 03:16:04 -0800727 }
Nick Piggin2ae88142006-10-28 10:38:23 -0700728 return alloc_pages(gfp, 0);
Paul Jackson44110fe2006-03-24 03:16:04 -0800729}
Nick Piggin2ae88142006-10-28 10:38:23 -0700730EXPORT_SYMBOL(__page_cache_alloc);
Paul Jackson44110fe2006-03-24 03:16:04 -0800731#endif
732
Linus Torvalds1da177e2005-04-16 15:20:36 -0700733/*
734 * In order to wait for pages to become available there must be
735 * waitqueues associated with pages. By using a hash table of
736 * waitqueues where the bucket discipline is to maintain all
737 * waiters on the same queue and wake all when any of the pages
738 * become available, and for the woken contexts to check to be
739 * sure the appropriate page became available, this saves space
740 * at a cost of "thundering herd" phenomena during rare hash
741 * collisions.
742 */
Nicholas Piggin62906022016-12-25 13:00:30 +1000743#define PAGE_WAIT_TABLE_BITS 8
744#define PAGE_WAIT_TABLE_SIZE (1 << PAGE_WAIT_TABLE_BITS)
745static wait_queue_head_t page_wait_table[PAGE_WAIT_TABLE_SIZE] __cacheline_aligned;
746
747static wait_queue_head_t *page_waitqueue(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700748{
Nicholas Piggin62906022016-12-25 13:00:30 +1000749 return &page_wait_table[hash_ptr(page, PAGE_WAIT_TABLE_BITS)];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700750}
Nicholas Piggin62906022016-12-25 13:00:30 +1000751
752void __init pagecache_init(void)
753{
754 int i;
755
756 for (i = 0; i < PAGE_WAIT_TABLE_SIZE; i++)
757 init_waitqueue_head(&page_wait_table[i]);
758
759 page_writeback_init();
760}
761
762struct wait_page_key {
763 struct page *page;
764 int bit_nr;
765 int page_match;
766};
767
768struct wait_page_queue {
769 struct page *page;
770 int bit_nr;
771 wait_queue_t wait;
772};
773
774static int wake_page_function(wait_queue_t *wait, unsigned mode, int sync, void *arg)
775{
776 struct wait_page_key *key = arg;
777 struct wait_page_queue *wait_page
778 = container_of(wait, struct wait_page_queue, wait);
779
780 if (wait_page->page != key->page)
781 return 0;
782 key->page_match = 1;
783
784 if (wait_page->bit_nr != key->bit_nr)
785 return 0;
786 if (test_bit(key->bit_nr, &key->page->flags))
787 return 0;
788
789 return autoremove_wake_function(wait, mode, sync, key);
790}
791
Nicholas Piggin74d81bf2017-02-22 15:44:41 -0800792static void wake_up_page_bit(struct page *page, int bit_nr)
Nicholas Piggin62906022016-12-25 13:00:30 +1000793{
794 wait_queue_head_t *q = page_waitqueue(page);
795 struct wait_page_key key;
796 unsigned long flags;
797
798 key.page = page;
799 key.bit_nr = bit_nr;
800 key.page_match = 0;
801
802 spin_lock_irqsave(&q->lock, flags);
803 __wake_up_locked_key(q, TASK_NORMAL, &key);
804 /*
805 * It is possible for other pages to have collided on the waitqueue
806 * hash, so in that case check for a page match. That prevents a long-
807 * term waiter
808 *
809 * It is still possible to miss a case here, when we woke page waiters
810 * and removed them from the waitqueue, but there are still other
811 * page waiters.
812 */
813 if (!waitqueue_active(q) || !key.page_match) {
814 ClearPageWaiters(page);
815 /*
816 * It's possible to miss clearing Waiters here, when we woke
817 * our page waiters, but the hashed waitqueue has waiters for
818 * other pages on it.
819 *
820 * That's okay, it's a rare case. The next waker will clear it.
821 */
822 }
823 spin_unlock_irqrestore(&q->lock, flags);
824}
Nicholas Piggin74d81bf2017-02-22 15:44:41 -0800825
826static void wake_up_page(struct page *page, int bit)
827{
828 if (!PageWaiters(page))
829 return;
830 wake_up_page_bit(page, bit);
831}
Nicholas Piggin62906022016-12-25 13:00:30 +1000832
833static inline int wait_on_page_bit_common(wait_queue_head_t *q,
834 struct page *page, int bit_nr, int state, bool lock)
835{
836 struct wait_page_queue wait_page;
837 wait_queue_t *wait = &wait_page.wait;
838 int ret = 0;
839
840 init_wait(wait);
841 wait->func = wake_page_function;
842 wait_page.page = page;
843 wait_page.bit_nr = bit_nr;
844
845 for (;;) {
846 spin_lock_irq(&q->lock);
847
848 if (likely(list_empty(&wait->task_list))) {
849 if (lock)
850 __add_wait_queue_tail_exclusive(q, wait);
851 else
852 __add_wait_queue(q, wait);
853 SetPageWaiters(page);
854 }
855
856 set_current_state(state);
857
858 spin_unlock_irq(&q->lock);
859
860 if (likely(test_bit(bit_nr, &page->flags))) {
861 io_schedule();
862 if (unlikely(signal_pending_state(state, current))) {
863 ret = -EINTR;
864 break;
865 }
866 }
867
868 if (lock) {
869 if (!test_and_set_bit_lock(bit_nr, &page->flags))
870 break;
871 } else {
872 if (!test_bit(bit_nr, &page->flags))
873 break;
874 }
875 }
876
877 finish_wait(q, wait);
878
879 /*
880 * A signal could leave PageWaiters set. Clearing it here if
881 * !waitqueue_active would be possible (by open-coding finish_wait),
882 * but still fail to catch it in the case of wait hash collision. We
883 * already can fail to clear wait hash collision cases, so don't
884 * bother with signals either.
885 */
886
887 return ret;
888}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700889
Harvey Harrison920c7a52008-02-04 22:29:26 -0800890void wait_on_page_bit(struct page *page, int bit_nr)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700891{
Nicholas Piggin62906022016-12-25 13:00:30 +1000892 wait_queue_head_t *q = page_waitqueue(page);
893 wait_on_page_bit_common(q, page, bit_nr, TASK_UNINTERRUPTIBLE, false);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700894}
895EXPORT_SYMBOL(wait_on_page_bit);
896
KOSAKI Motohirof62e00c2011-05-24 17:11:29 -0700897int wait_on_page_bit_killable(struct page *page, int bit_nr)
898{
Nicholas Piggin62906022016-12-25 13:00:30 +1000899 wait_queue_head_t *q = page_waitqueue(page);
900 return wait_on_page_bit_common(q, page, bit_nr, TASK_KILLABLE, false);
KOSAKI Motohirof62e00c2011-05-24 17:11:29 -0700901}
902
Linus Torvalds1da177e2005-04-16 15:20:36 -0700903/**
David Howells385e1ca5f2009-04-03 16:42:39 +0100904 * add_page_wait_queue - Add an arbitrary waiter to a page's wait queue
Randy Dunlap697f6192009-04-13 14:39:54 -0700905 * @page: Page defining the wait queue of interest
906 * @waiter: Waiter to add to the queue
David Howells385e1ca5f2009-04-03 16:42:39 +0100907 *
908 * Add an arbitrary @waiter to the wait queue for the nominated @page.
909 */
910void add_page_wait_queue(struct page *page, wait_queue_t *waiter)
911{
912 wait_queue_head_t *q = page_waitqueue(page);
913 unsigned long flags;
914
915 spin_lock_irqsave(&q->lock, flags);
916 __add_wait_queue(q, waiter);
Nicholas Piggin62906022016-12-25 13:00:30 +1000917 SetPageWaiters(page);
David Howells385e1ca5f2009-04-03 16:42:39 +0100918 spin_unlock_irqrestore(&q->lock, flags);
919}
920EXPORT_SYMBOL_GPL(add_page_wait_queue);
921
Linus Torvaldsb91e1302016-12-27 11:40:38 -0800922#ifndef clear_bit_unlock_is_negative_byte
923
924/*
925 * PG_waiters is the high bit in the same byte as PG_lock.
926 *
927 * On x86 (and on many other architectures), we can clear PG_lock and
928 * test the sign bit at the same time. But if the architecture does
929 * not support that special operation, we just do this all by hand
930 * instead.
931 *
932 * The read of PG_waiters has to be after (or concurrently with) PG_locked
933 * being cleared, but a memory barrier should be unneccssary since it is
934 * in the same byte as PG_locked.
935 */
936static inline bool clear_bit_unlock_is_negative_byte(long nr, volatile void *mem)
937{
938 clear_bit_unlock(nr, mem);
939 /* smp_mb__after_atomic(); */
Olof Johansson98473f92016-12-29 14:16:07 -0800940 return test_bit(PG_waiters, mem);
Linus Torvaldsb91e1302016-12-27 11:40:38 -0800941}
942
943#endif
944
David Howells385e1ca5f2009-04-03 16:42:39 +0100945/**
Randy Dunlap485bb992006-06-23 02:03:49 -0700946 * unlock_page - unlock a locked page
Linus Torvalds1da177e2005-04-16 15:20:36 -0700947 * @page: the page
948 *
949 * Unlocks the page and wakes up sleepers in ___wait_on_page_locked().
950 * Also wakes sleepers in wait_on_page_writeback() because the wakeup
Masanari Iidada3dae52014-09-09 01:27:23 +0900951 * mechanism between PageLocked pages and PageWriteback pages is shared.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700952 * But that's OK - sleepers in wait_on_page_writeback() just go back to sleep.
953 *
Linus Torvaldsb91e1302016-12-27 11:40:38 -0800954 * Note that this depends on PG_waiters being the sign bit in the byte
955 * that contains PG_locked - thus the BUILD_BUG_ON(). That allows us to
956 * clear the PG_locked bit and test PG_waiters at the same time fairly
957 * portably (architectures that do LL/SC can test any bit, while x86 can
958 * test the sign bit).
Linus Torvalds1da177e2005-04-16 15:20:36 -0700959 */
Harvey Harrison920c7a52008-02-04 22:29:26 -0800960void unlock_page(struct page *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700961{
Linus Torvaldsb91e1302016-12-27 11:40:38 -0800962 BUILD_BUG_ON(PG_waiters != 7);
Kirill A. Shutemov48c935a2016-01-15 16:51:24 -0800963 page = compound_head(page);
Sasha Levin309381fea2014-01-23 15:52:54 -0800964 VM_BUG_ON_PAGE(!PageLocked(page), page);
Linus Torvaldsb91e1302016-12-27 11:40:38 -0800965 if (clear_bit_unlock_is_negative_byte(PG_locked, &page->flags))
966 wake_up_page_bit(page, PG_locked);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700967}
968EXPORT_SYMBOL(unlock_page);
969
Randy Dunlap485bb992006-06-23 02:03:49 -0700970/**
971 * end_page_writeback - end writeback against a page
972 * @page: the page
Linus Torvalds1da177e2005-04-16 15:20:36 -0700973 */
974void end_page_writeback(struct page *page)
975{
Mel Gorman888cf2d2014-06-04 16:10:34 -0700976 /*
977 * TestClearPageReclaim could be used here but it is an atomic
978 * operation and overkill in this particular case. Failing to
979 * shuffle a page marked for immediate reclaim is too mild to
980 * justify taking an atomic operation penalty at the end of
981 * ever page writeback.
982 */
983 if (PageReclaim(page)) {
984 ClearPageReclaim(page);
Miklos Szerediac6aadb2008-04-28 02:12:38 -0700985 rotate_reclaimable_page(page);
Mel Gorman888cf2d2014-06-04 16:10:34 -0700986 }
Miklos Szerediac6aadb2008-04-28 02:12:38 -0700987
988 if (!test_clear_page_writeback(page))
989 BUG();
990
Peter Zijlstra4e857c52014-03-17 18:06:10 +0100991 smp_mb__after_atomic();
Linus Torvalds1da177e2005-04-16 15:20:36 -0700992 wake_up_page(page, PG_writeback);
993}
994EXPORT_SYMBOL(end_page_writeback);
995
Matthew Wilcox57d99842014-06-04 16:07:45 -0700996/*
997 * After completing I/O on a page, call this routine to update the page
998 * flags appropriately
999 */
Jens Axboec11f0c02016-08-05 08:11:04 -06001000void page_endio(struct page *page, bool is_write, int err)
Matthew Wilcox57d99842014-06-04 16:07:45 -07001001{
Jens Axboec11f0c02016-08-05 08:11:04 -06001002 if (!is_write) {
Matthew Wilcox57d99842014-06-04 16:07:45 -07001003 if (!err) {
1004 SetPageUptodate(page);
1005 } else {
1006 ClearPageUptodate(page);
1007 SetPageError(page);
1008 }
1009 unlock_page(page);
Mike Christieabf54542016-08-04 14:23:34 -06001010 } else {
Matthew Wilcox57d99842014-06-04 16:07:45 -07001011 if (err) {
Minchan Kimdd8416c2017-02-24 14:59:59 -08001012 struct address_space *mapping;
1013
Matthew Wilcox57d99842014-06-04 16:07:45 -07001014 SetPageError(page);
Minchan Kimdd8416c2017-02-24 14:59:59 -08001015 mapping = page_mapping(page);
1016 if (mapping)
1017 mapping_set_error(mapping, err);
Matthew Wilcox57d99842014-06-04 16:07:45 -07001018 }
1019 end_page_writeback(page);
1020 }
1021}
1022EXPORT_SYMBOL_GPL(page_endio);
1023
Randy Dunlap485bb992006-06-23 02:03:49 -07001024/**
1025 * __lock_page - get a lock on the page, assuming we need to sleep to get it
Randy Dunlap87066752017-02-22 15:44:44 -08001026 * @__page: the page to lock
Linus Torvalds1da177e2005-04-16 15:20:36 -07001027 */
Nicholas Piggin62906022016-12-25 13:00:30 +10001028void __lock_page(struct page *__page)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001029{
Nicholas Piggin62906022016-12-25 13:00:30 +10001030 struct page *page = compound_head(__page);
1031 wait_queue_head_t *q = page_waitqueue(page);
1032 wait_on_page_bit_common(q, page, PG_locked, TASK_UNINTERRUPTIBLE, true);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001033}
1034EXPORT_SYMBOL(__lock_page);
1035
Nicholas Piggin62906022016-12-25 13:00:30 +10001036int __lock_page_killable(struct page *__page)
Matthew Wilcox2687a352007-12-06 11:18:49 -05001037{
Nicholas Piggin62906022016-12-25 13:00:30 +10001038 struct page *page = compound_head(__page);
1039 wait_queue_head_t *q = page_waitqueue(page);
1040 return wait_on_page_bit_common(q, page, PG_locked, TASK_KILLABLE, true);
Matthew Wilcox2687a352007-12-06 11:18:49 -05001041}
Evgeniy Polyakov18bc0bb2009-02-09 17:02:42 +03001042EXPORT_SYMBOL_GPL(__lock_page_killable);
Matthew Wilcox2687a352007-12-06 11:18:49 -05001043
Paul Cassella9a95f3c2014-08-06 16:07:24 -07001044/*
1045 * Return values:
1046 * 1 - page is locked; mmap_sem is still held.
1047 * 0 - page is not locked.
1048 * mmap_sem has been released (up_read()), unless flags had both
1049 * FAULT_FLAG_ALLOW_RETRY and FAULT_FLAG_RETRY_NOWAIT set, in
1050 * which case mmap_sem is still held.
1051 *
1052 * If neither ALLOW_RETRY nor KILLABLE are set, will always return 1
1053 * with the page locked and the mmap_sem unperturbed.
1054 */
Michel Lespinassed065bd82010-10-26 14:21:57 -07001055int __lock_page_or_retry(struct page *page, struct mm_struct *mm,
1056 unsigned int flags)
1057{
KOSAKI Motohiro37b23e02011-05-24 17:11:30 -07001058 if (flags & FAULT_FLAG_ALLOW_RETRY) {
1059 /*
1060 * CAUTION! In this case, mmap_sem is not released
1061 * even though return 0.
1062 */
1063 if (flags & FAULT_FLAG_RETRY_NOWAIT)
1064 return 0;
1065
1066 up_read(&mm->mmap_sem);
1067 if (flags & FAULT_FLAG_KILLABLE)
1068 wait_on_page_locked_killable(page);
1069 else
Gleb Natapov318b2752011-03-22 16:30:51 -07001070 wait_on_page_locked(page);
Michel Lespinassed065bd82010-10-26 14:21:57 -07001071 return 0;
KOSAKI Motohiro37b23e02011-05-24 17:11:30 -07001072 } else {
1073 if (flags & FAULT_FLAG_KILLABLE) {
1074 int ret;
1075
1076 ret = __lock_page_killable(page);
1077 if (ret) {
1078 up_read(&mm->mmap_sem);
1079 return 0;
1080 }
1081 } else
1082 __lock_page(page);
1083 return 1;
Michel Lespinassed065bd82010-10-26 14:21:57 -07001084 }
1085}
1086
Randy Dunlap485bb992006-06-23 02:03:49 -07001087/**
Johannes Weinere7b563b2014-04-03 14:47:44 -07001088 * page_cache_next_hole - find the next hole (not-present entry)
1089 * @mapping: mapping
1090 * @index: index
1091 * @max_scan: maximum range to search
1092 *
1093 * Search the set [index, min(index+max_scan-1, MAX_INDEX)] for the
1094 * lowest indexed hole.
1095 *
1096 * Returns: the index of the hole if found, otherwise returns an index
1097 * outside of the set specified (in which case 'return - index >=
1098 * max_scan' will be true). In rare cases of index wrap-around, 0 will
1099 * be returned.
1100 *
1101 * page_cache_next_hole may be called under rcu_read_lock. However,
1102 * like radix_tree_gang_lookup, this will not atomically search a
1103 * snapshot of the tree at a single point in time. For example, if a
1104 * hole is created at index 5, then subsequently a hole is created at
1105 * index 10, page_cache_next_hole covering both indexes may return 10
1106 * if called under rcu_read_lock.
1107 */
1108pgoff_t page_cache_next_hole(struct address_space *mapping,
1109 pgoff_t index, unsigned long max_scan)
1110{
1111 unsigned long i;
1112
1113 for (i = 0; i < max_scan; i++) {
Johannes Weiner0cd61442014-04-03 14:47:46 -07001114 struct page *page;
1115
1116 page = radix_tree_lookup(&mapping->page_tree, index);
1117 if (!page || radix_tree_exceptional_entry(page))
Johannes Weinere7b563b2014-04-03 14:47:44 -07001118 break;
1119 index++;
1120 if (index == 0)
1121 break;
1122 }
1123
1124 return index;
1125}
1126EXPORT_SYMBOL(page_cache_next_hole);
1127
1128/**
1129 * page_cache_prev_hole - find the prev hole (not-present entry)
1130 * @mapping: mapping
1131 * @index: index
1132 * @max_scan: maximum range to search
1133 *
1134 * Search backwards in the range [max(index-max_scan+1, 0), index] for
1135 * the first hole.
1136 *
1137 * Returns: the index of the hole if found, otherwise returns an index
1138 * outside of the set specified (in which case 'index - return >=
1139 * max_scan' will be true). In rare cases of wrap-around, ULONG_MAX
1140 * will be returned.
1141 *
1142 * page_cache_prev_hole may be called under rcu_read_lock. However,
1143 * like radix_tree_gang_lookup, this will not atomically search a
1144 * snapshot of the tree at a single point in time. For example, if a
1145 * hole is created at index 10, then subsequently a hole is created at
1146 * index 5, page_cache_prev_hole covering both indexes may return 5 if
1147 * called under rcu_read_lock.
1148 */
1149pgoff_t page_cache_prev_hole(struct address_space *mapping,
1150 pgoff_t index, unsigned long max_scan)
1151{
1152 unsigned long i;
1153
1154 for (i = 0; i < max_scan; i++) {
Johannes Weiner0cd61442014-04-03 14:47:46 -07001155 struct page *page;
1156
1157 page = radix_tree_lookup(&mapping->page_tree, index);
1158 if (!page || radix_tree_exceptional_entry(page))
Johannes Weinere7b563b2014-04-03 14:47:44 -07001159 break;
1160 index--;
1161 if (index == ULONG_MAX)
1162 break;
1163 }
1164
1165 return index;
1166}
1167EXPORT_SYMBOL(page_cache_prev_hole);
1168
1169/**
Johannes Weiner0cd61442014-04-03 14:47:46 -07001170 * find_get_entry - find and get a page cache entry
Randy Dunlap485bb992006-06-23 02:03:49 -07001171 * @mapping: the address_space to search
Johannes Weiner0cd61442014-04-03 14:47:46 -07001172 * @offset: the page cache index
Randy Dunlap485bb992006-06-23 02:03:49 -07001173 *
Johannes Weiner0cd61442014-04-03 14:47:46 -07001174 * Looks up the page cache slot at @mapping & @offset. If there is a
1175 * page cache page, it is returned with an increased refcount.
1176 *
Johannes Weiner139b6a62014-05-06 12:50:05 -07001177 * If the slot holds a shadow entry of a previously evicted page, or a
1178 * swap entry from shmem/tmpfs, it is returned.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001179 *
1180 * Otherwise, %NULL is returned.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001181 */
Johannes Weiner0cd61442014-04-03 14:47:46 -07001182struct page *find_get_entry(struct address_space *mapping, pgoff_t offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001183{
Nick Piggina60637c2008-07-25 19:45:31 -07001184 void **pagep;
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001185 struct page *head, *page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001186
Nick Piggina60637c2008-07-25 19:45:31 -07001187 rcu_read_lock();
1188repeat:
1189 page = NULL;
1190 pagep = radix_tree_lookup_slot(&mapping->page_tree, offset);
1191 if (pagep) {
1192 page = radix_tree_deref_slot(pagep);
Nick Piggin27d20fd2010-11-11 14:05:19 -08001193 if (unlikely(!page))
1194 goto out;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001195 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001196 if (radix_tree_deref_retry(page))
1197 goto repeat;
1198 /*
Johannes Weiner139b6a62014-05-06 12:50:05 -07001199 * A shadow entry of a recently evicted page,
1200 * or a swap entry from shmem/tmpfs. Return
1201 * it without attempting to raise page count.
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001202 */
1203 goto out;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001204 }
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001205
1206 head = compound_head(page);
1207 if (!page_cache_get_speculative(head))
Nick Piggina60637c2008-07-25 19:45:31 -07001208 goto repeat;
1209
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001210 /* The page was split under us? */
1211 if (compound_head(page) != head) {
1212 put_page(head);
1213 goto repeat;
1214 }
1215
Nick Piggina60637c2008-07-25 19:45:31 -07001216 /*
1217 * Has the page moved?
1218 * This is part of the lockless pagecache protocol. See
1219 * include/linux/pagemap.h for details.
1220 */
1221 if (unlikely(page != *pagep)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001222 put_page(head);
Nick Piggina60637c2008-07-25 19:45:31 -07001223 goto repeat;
1224 }
1225 }
Nick Piggin27d20fd2010-11-11 14:05:19 -08001226out:
Nick Piggina60637c2008-07-25 19:45:31 -07001227 rcu_read_unlock();
1228
Linus Torvalds1da177e2005-04-16 15:20:36 -07001229 return page;
1230}
Johannes Weiner0cd61442014-04-03 14:47:46 -07001231EXPORT_SYMBOL(find_get_entry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001232
Randy Dunlap485bb992006-06-23 02:03:49 -07001233/**
Johannes Weiner0cd61442014-04-03 14:47:46 -07001234 * find_lock_entry - locate, pin and lock a page cache entry
1235 * @mapping: the address_space to search
1236 * @offset: the page cache index
1237 *
1238 * Looks up the page cache slot at @mapping & @offset. If there is a
1239 * page cache page, it is returned locked and with an increased
1240 * refcount.
1241 *
Johannes Weiner139b6a62014-05-06 12:50:05 -07001242 * If the slot holds a shadow entry of a previously evicted page, or a
1243 * swap entry from shmem/tmpfs, it is returned.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001244 *
1245 * Otherwise, %NULL is returned.
1246 *
1247 * find_lock_entry() may sleep.
1248 */
1249struct page *find_lock_entry(struct address_space *mapping, pgoff_t offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001250{
1251 struct page *page;
1252
Linus Torvalds1da177e2005-04-16 15:20:36 -07001253repeat:
Johannes Weiner0cd61442014-04-03 14:47:46 -07001254 page = find_get_entry(mapping, offset);
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001255 if (page && !radix_tree_exception(page)) {
Nick Piggina60637c2008-07-25 19:45:31 -07001256 lock_page(page);
1257 /* Has the page been truncated? */
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001258 if (unlikely(page_mapping(page) != mapping)) {
Nick Piggina60637c2008-07-25 19:45:31 -07001259 unlock_page(page);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001260 put_page(page);
Nick Piggina60637c2008-07-25 19:45:31 -07001261 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001262 }
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001263 VM_BUG_ON_PAGE(page_to_pgoff(page) != offset, page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001264 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001265 return page;
1266}
Johannes Weiner0cd61442014-04-03 14:47:46 -07001267EXPORT_SYMBOL(find_lock_entry);
1268
1269/**
Mel Gorman2457aec2014-06-04 16:10:31 -07001270 * pagecache_get_page - find and get a page reference
Johannes Weiner0cd61442014-04-03 14:47:46 -07001271 * @mapping: the address_space to search
1272 * @offset: the page index
Mel Gorman2457aec2014-06-04 16:10:31 -07001273 * @fgp_flags: PCG flags
Michal Hocko45f87de2014-12-29 20:30:35 +01001274 * @gfp_mask: gfp mask to use for the page cache data page allocation
Johannes Weiner0cd61442014-04-03 14:47:46 -07001275 *
Mel Gorman2457aec2014-06-04 16:10:31 -07001276 * Looks up the page cache slot at @mapping & @offset.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001277 *
Randy Dunlap75325182014-07-30 16:08:37 -07001278 * PCG flags modify how the page is returned.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001279 *
Mel Gorman2457aec2014-06-04 16:10:31 -07001280 * FGP_ACCESSED: the page will be marked accessed
1281 * FGP_LOCK: Page is return locked
1282 * FGP_CREAT: If page is not present then a new page is allocated using
Michal Hocko45f87de2014-12-29 20:30:35 +01001283 * @gfp_mask and added to the page cache and the VM's LRU
1284 * list. The page is returned locked and with an increased
1285 * refcount. Otherwise, %NULL is returned.
Mel Gorman2457aec2014-06-04 16:10:31 -07001286 *
1287 * If FGP_LOCK or FGP_CREAT are specified then the function may sleep even
1288 * if the GFP flags specified for FGP_CREAT are atomic.
1289 *
1290 * If there is a page cache page, it is returned with an increased refcount.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001291 */
Mel Gorman2457aec2014-06-04 16:10:31 -07001292struct page *pagecache_get_page(struct address_space *mapping, pgoff_t offset,
Michal Hocko45f87de2014-12-29 20:30:35 +01001293 int fgp_flags, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001294{
Nick Piggineb2be182007-10-16 01:24:57 -07001295 struct page *page;
Mel Gorman2457aec2014-06-04 16:10:31 -07001296
Linus Torvalds1da177e2005-04-16 15:20:36 -07001297repeat:
Mel Gorman2457aec2014-06-04 16:10:31 -07001298 page = find_get_entry(mapping, offset);
1299 if (radix_tree_exceptional_entry(page))
1300 page = NULL;
1301 if (!page)
1302 goto no_page;
1303
1304 if (fgp_flags & FGP_LOCK) {
1305 if (fgp_flags & FGP_NOWAIT) {
1306 if (!trylock_page(page)) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001307 put_page(page);
Mel Gorman2457aec2014-06-04 16:10:31 -07001308 return NULL;
1309 }
1310 } else {
1311 lock_page(page);
1312 }
1313
1314 /* Has the page been truncated? */
1315 if (unlikely(page->mapping != mapping)) {
1316 unlock_page(page);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001317 put_page(page);
Mel Gorman2457aec2014-06-04 16:10:31 -07001318 goto repeat;
1319 }
1320 VM_BUG_ON_PAGE(page->index != offset, page);
1321 }
1322
1323 if (page && (fgp_flags & FGP_ACCESSED))
1324 mark_page_accessed(page);
1325
1326no_page:
1327 if (!page && (fgp_flags & FGP_CREAT)) {
1328 int err;
1329 if ((fgp_flags & FGP_WRITE) && mapping_cap_account_dirty(mapping))
Michal Hocko45f87de2014-12-29 20:30:35 +01001330 gfp_mask |= __GFP_WRITE;
1331 if (fgp_flags & FGP_NOFS)
1332 gfp_mask &= ~__GFP_FS;
Mel Gorman2457aec2014-06-04 16:10:31 -07001333
Michal Hocko45f87de2014-12-29 20:30:35 +01001334 page = __page_cache_alloc(gfp_mask);
Nick Piggineb2be182007-10-16 01:24:57 -07001335 if (!page)
1336 return NULL;
Mel Gorman2457aec2014-06-04 16:10:31 -07001337
1338 if (WARN_ON_ONCE(!(fgp_flags & FGP_LOCK)))
1339 fgp_flags |= FGP_LOCK;
1340
Hugh Dickinseb39d612014-08-06 16:06:43 -07001341 /* Init accessed so avoid atomic mark_page_accessed later */
Mel Gorman2457aec2014-06-04 16:10:31 -07001342 if (fgp_flags & FGP_ACCESSED)
Hugh Dickinseb39d612014-08-06 16:06:43 -07001343 __SetPageReferenced(page);
Mel Gorman2457aec2014-06-04 16:10:31 -07001344
Michal Hocko45f87de2014-12-29 20:30:35 +01001345 err = add_to_page_cache_lru(page, mapping, offset,
1346 gfp_mask & GFP_RECLAIM_MASK);
Nick Piggineb2be182007-10-16 01:24:57 -07001347 if (unlikely(err)) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001348 put_page(page);
Nick Piggineb2be182007-10-16 01:24:57 -07001349 page = NULL;
1350 if (err == -EEXIST)
1351 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001352 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001353 }
Mel Gorman2457aec2014-06-04 16:10:31 -07001354
Linus Torvalds1da177e2005-04-16 15:20:36 -07001355 return page;
1356}
Mel Gorman2457aec2014-06-04 16:10:31 -07001357EXPORT_SYMBOL(pagecache_get_page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001358
1359/**
Johannes Weiner0cd61442014-04-03 14:47:46 -07001360 * find_get_entries - gang pagecache lookup
1361 * @mapping: The address_space to search
1362 * @start: The starting page cache index
1363 * @nr_entries: The maximum number of entries
1364 * @entries: Where the resulting entries are placed
1365 * @indices: The cache indices corresponding to the entries in @entries
1366 *
1367 * find_get_entries() will search for and return a group of up to
1368 * @nr_entries entries in the mapping. The entries are placed at
1369 * @entries. find_get_entries() takes a reference against any actual
1370 * pages it returns.
1371 *
1372 * The search returns a group of mapping-contiguous page cache entries
1373 * with ascending indexes. There may be holes in the indices due to
1374 * not-present pages.
1375 *
Johannes Weiner139b6a62014-05-06 12:50:05 -07001376 * Any shadow entries of evicted pages, or swap entries from
1377 * shmem/tmpfs, are included in the returned array.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001378 *
1379 * find_get_entries() returns the number of pages and shadow entries
1380 * which were found.
1381 */
1382unsigned find_get_entries(struct address_space *mapping,
1383 pgoff_t start, unsigned int nr_entries,
1384 struct page **entries, pgoff_t *indices)
1385{
1386 void **slot;
1387 unsigned int ret = 0;
1388 struct radix_tree_iter iter;
1389
1390 if (!nr_entries)
1391 return 0;
1392
1393 rcu_read_lock();
Johannes Weiner0cd61442014-04-03 14:47:46 -07001394 radix_tree_for_each_slot(slot, &mapping->page_tree, &iter, start) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001395 struct page *head, *page;
Johannes Weiner0cd61442014-04-03 14:47:46 -07001396repeat:
1397 page = radix_tree_deref_slot(slot);
1398 if (unlikely(!page))
1399 continue;
1400 if (radix_tree_exception(page)) {
Matthew Wilcox2cf938a2016-03-17 14:22:03 -07001401 if (radix_tree_deref_retry(page)) {
1402 slot = radix_tree_iter_retry(&iter);
1403 continue;
1404 }
Johannes Weiner0cd61442014-04-03 14:47:46 -07001405 /*
Ross Zwislerf9fe48b2016-01-22 15:10:40 -08001406 * A shadow entry of a recently evicted page, a swap
1407 * entry from shmem/tmpfs or a DAX entry. Return it
1408 * without attempting to raise page count.
Johannes Weiner0cd61442014-04-03 14:47:46 -07001409 */
1410 goto export;
1411 }
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001412
1413 head = compound_head(page);
1414 if (!page_cache_get_speculative(head))
Johannes Weiner0cd61442014-04-03 14:47:46 -07001415 goto repeat;
1416
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001417 /* The page was split under us? */
1418 if (compound_head(page) != head) {
1419 put_page(head);
1420 goto repeat;
1421 }
1422
Johannes Weiner0cd61442014-04-03 14:47:46 -07001423 /* Has the page moved? */
1424 if (unlikely(page != *slot)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001425 put_page(head);
Johannes Weiner0cd61442014-04-03 14:47:46 -07001426 goto repeat;
1427 }
1428export:
1429 indices[ret] = iter.index;
1430 entries[ret] = page;
1431 if (++ret == nr_entries)
1432 break;
1433 }
1434 rcu_read_unlock();
1435 return ret;
1436}
1437
1438/**
Linus Torvalds1da177e2005-04-16 15:20:36 -07001439 * find_get_pages - gang pagecache lookup
1440 * @mapping: The address_space to search
1441 * @start: The starting page index
1442 * @nr_pages: The maximum number of pages
1443 * @pages: Where the resulting pages are placed
1444 *
1445 * find_get_pages() will search for and return a group of up to
1446 * @nr_pages pages in the mapping. The pages are placed at @pages.
1447 * find_get_pages() takes a reference against the returned pages.
1448 *
1449 * The search returns a group of mapping-contiguous pages with ascending
1450 * indexes. There may be holes in the indices due to not-present pages.
1451 *
1452 * find_get_pages() returns the number of pages which were found.
1453 */
1454unsigned find_get_pages(struct address_space *mapping, pgoff_t start,
1455 unsigned int nr_pages, struct page **pages)
1456{
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001457 struct radix_tree_iter iter;
1458 void **slot;
1459 unsigned ret = 0;
1460
1461 if (unlikely(!nr_pages))
1462 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001463
Nick Piggina60637c2008-07-25 19:45:31 -07001464 rcu_read_lock();
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001465 radix_tree_for_each_slot(slot, &mapping->page_tree, &iter, start) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001466 struct page *head, *page;
Nick Piggina60637c2008-07-25 19:45:31 -07001467repeat:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001468 page = radix_tree_deref_slot(slot);
Nick Piggina60637c2008-07-25 19:45:31 -07001469 if (unlikely(!page))
1470 continue;
Hugh Dickins9d8aa4e2011-03-22 16:33:06 -07001471
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001472 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001473 if (radix_tree_deref_retry(page)) {
Matthew Wilcox2cf938a2016-03-17 14:22:03 -07001474 slot = radix_tree_iter_retry(&iter);
1475 continue;
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001476 }
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001477 /*
Johannes Weiner139b6a62014-05-06 12:50:05 -07001478 * A shadow entry of a recently evicted page,
1479 * or a swap entry from shmem/tmpfs. Skip
1480 * over it.
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001481 */
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001482 continue;
Nick Piggin27d20fd2010-11-11 14:05:19 -08001483 }
Nick Piggina60637c2008-07-25 19:45:31 -07001484
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001485 head = compound_head(page);
1486 if (!page_cache_get_speculative(head))
Nick Piggina60637c2008-07-25 19:45:31 -07001487 goto repeat;
1488
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001489 /* The page was split under us? */
1490 if (compound_head(page) != head) {
1491 put_page(head);
1492 goto repeat;
1493 }
1494
Nick Piggina60637c2008-07-25 19:45:31 -07001495 /* Has the page moved? */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001496 if (unlikely(page != *slot)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001497 put_page(head);
Nick Piggina60637c2008-07-25 19:45:31 -07001498 goto repeat;
1499 }
1500
1501 pages[ret] = page;
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001502 if (++ret == nr_pages)
1503 break;
Nick Piggina60637c2008-07-25 19:45:31 -07001504 }
Hugh Dickins5b280c02011-03-22 16:33:07 -07001505
Nick Piggina60637c2008-07-25 19:45:31 -07001506 rcu_read_unlock();
Linus Torvalds1da177e2005-04-16 15:20:36 -07001507 return ret;
1508}
1509
Jens Axboeebf43502006-04-27 08:46:01 +02001510/**
1511 * find_get_pages_contig - gang contiguous pagecache lookup
1512 * @mapping: The address_space to search
1513 * @index: The starting page index
1514 * @nr_pages: The maximum number of pages
1515 * @pages: Where the resulting pages are placed
1516 *
1517 * find_get_pages_contig() works exactly like find_get_pages(), except
1518 * that the returned number of pages are guaranteed to be contiguous.
1519 *
1520 * find_get_pages_contig() returns the number of pages which were found.
1521 */
1522unsigned find_get_pages_contig(struct address_space *mapping, pgoff_t index,
1523 unsigned int nr_pages, struct page **pages)
1524{
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001525 struct radix_tree_iter iter;
1526 void **slot;
1527 unsigned int ret = 0;
1528
1529 if (unlikely(!nr_pages))
1530 return 0;
Jens Axboeebf43502006-04-27 08:46:01 +02001531
Nick Piggina60637c2008-07-25 19:45:31 -07001532 rcu_read_lock();
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001533 radix_tree_for_each_contig(slot, &mapping->page_tree, &iter, index) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001534 struct page *head, *page;
Nick Piggina60637c2008-07-25 19:45:31 -07001535repeat:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001536 page = radix_tree_deref_slot(slot);
1537 /* The hole, there no reason to continue */
Nick Piggina60637c2008-07-25 19:45:31 -07001538 if (unlikely(!page))
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001539 break;
Hugh Dickins9d8aa4e2011-03-22 16:33:06 -07001540
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001541 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001542 if (radix_tree_deref_retry(page)) {
Matthew Wilcox2cf938a2016-03-17 14:22:03 -07001543 slot = radix_tree_iter_retry(&iter);
1544 continue;
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001545 }
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001546 /*
Johannes Weiner139b6a62014-05-06 12:50:05 -07001547 * A shadow entry of a recently evicted page,
1548 * or a swap entry from shmem/tmpfs. Stop
1549 * looking for contiguous pages.
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001550 */
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001551 break;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001552 }
Nick Piggina60637c2008-07-25 19:45:31 -07001553
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001554 head = compound_head(page);
1555 if (!page_cache_get_speculative(head))
Nick Piggina60637c2008-07-25 19:45:31 -07001556 goto repeat;
1557
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001558 /* The page was split under us? */
1559 if (compound_head(page) != head) {
1560 put_page(head);
1561 goto repeat;
1562 }
1563
Nick Piggina60637c2008-07-25 19:45:31 -07001564 /* Has the page moved? */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001565 if (unlikely(page != *slot)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001566 put_page(head);
Nick Piggina60637c2008-07-25 19:45:31 -07001567 goto repeat;
1568 }
1569
Nick Piggin9cbb4cb2011-01-13 15:45:51 -08001570 /*
1571 * must check mapping and index after taking the ref.
1572 * otherwise we can get both false positives and false
1573 * negatives, which is just confusing to the caller.
1574 */
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001575 if (page->mapping == NULL || page_to_pgoff(page) != iter.index) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001576 put_page(page);
Nick Piggin9cbb4cb2011-01-13 15:45:51 -08001577 break;
1578 }
1579
Nick Piggina60637c2008-07-25 19:45:31 -07001580 pages[ret] = page;
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001581 if (++ret == nr_pages)
1582 break;
Jens Axboeebf43502006-04-27 08:46:01 +02001583 }
Nick Piggina60637c2008-07-25 19:45:31 -07001584 rcu_read_unlock();
1585 return ret;
Jens Axboeebf43502006-04-27 08:46:01 +02001586}
David Howellsef71c152007-05-09 02:33:44 -07001587EXPORT_SYMBOL(find_get_pages_contig);
Jens Axboeebf43502006-04-27 08:46:01 +02001588
Randy Dunlap485bb992006-06-23 02:03:49 -07001589/**
1590 * find_get_pages_tag - find and return pages that match @tag
1591 * @mapping: the address_space to search
1592 * @index: the starting page index
1593 * @tag: the tag index
1594 * @nr_pages: the maximum number of pages
1595 * @pages: where the resulting pages are placed
1596 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07001597 * Like find_get_pages, except we only return pages which are tagged with
Randy Dunlap485bb992006-06-23 02:03:49 -07001598 * @tag. We update @index to index the next page for the traversal.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001599 */
1600unsigned find_get_pages_tag(struct address_space *mapping, pgoff_t *index,
1601 int tag, unsigned int nr_pages, struct page **pages)
1602{
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001603 struct radix_tree_iter iter;
1604 void **slot;
1605 unsigned ret = 0;
1606
1607 if (unlikely(!nr_pages))
1608 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001609
Nick Piggina60637c2008-07-25 19:45:31 -07001610 rcu_read_lock();
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001611 radix_tree_for_each_tagged(slot, &mapping->page_tree,
1612 &iter, *index, tag) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001613 struct page *head, *page;
Nick Piggina60637c2008-07-25 19:45:31 -07001614repeat:
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001615 page = radix_tree_deref_slot(slot);
Nick Piggina60637c2008-07-25 19:45:31 -07001616 if (unlikely(!page))
1617 continue;
Hugh Dickins9d8aa4e2011-03-22 16:33:06 -07001618
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001619 if (radix_tree_exception(page)) {
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001620 if (radix_tree_deref_retry(page)) {
Matthew Wilcox2cf938a2016-03-17 14:22:03 -07001621 slot = radix_tree_iter_retry(&iter);
1622 continue;
Hugh Dickins8079b1c2011-08-03 16:21:28 -07001623 }
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001624 /*
Johannes Weiner139b6a62014-05-06 12:50:05 -07001625 * A shadow entry of a recently evicted page.
1626 *
1627 * Those entries should never be tagged, but
1628 * this tree walk is lockless and the tags are
1629 * looked up in bulk, one radix tree node at a
1630 * time, so there is a sizable window for page
1631 * reclaim to evict a page we saw tagged.
1632 *
1633 * Skip over it.
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001634 */
Johannes Weiner139b6a62014-05-06 12:50:05 -07001635 continue;
Hugh Dickinsa2c16d62011-08-03 16:21:19 -07001636 }
Nick Piggina60637c2008-07-25 19:45:31 -07001637
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001638 head = compound_head(page);
1639 if (!page_cache_get_speculative(head))
Nick Piggina60637c2008-07-25 19:45:31 -07001640 goto repeat;
1641
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001642 /* The page was split under us? */
1643 if (compound_head(page) != head) {
1644 put_page(head);
1645 goto repeat;
1646 }
1647
Nick Piggina60637c2008-07-25 19:45:31 -07001648 /* Has the page moved? */
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001649 if (unlikely(page != *slot)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001650 put_page(head);
Nick Piggina60637c2008-07-25 19:45:31 -07001651 goto repeat;
1652 }
1653
1654 pages[ret] = page;
Konstantin Khlebnikov0fc9d102012-03-28 14:42:54 -07001655 if (++ret == nr_pages)
1656 break;
Nick Piggina60637c2008-07-25 19:45:31 -07001657 }
Hugh Dickins5b280c02011-03-22 16:33:07 -07001658
Nick Piggina60637c2008-07-25 19:45:31 -07001659 rcu_read_unlock();
1660
Linus Torvalds1da177e2005-04-16 15:20:36 -07001661 if (ret)
1662 *index = pages[ret - 1]->index + 1;
Nick Piggina60637c2008-07-25 19:45:31 -07001663
Linus Torvalds1da177e2005-04-16 15:20:36 -07001664 return ret;
1665}
David Howellsef71c152007-05-09 02:33:44 -07001666EXPORT_SYMBOL(find_get_pages_tag);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001667
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001668/**
1669 * find_get_entries_tag - find and return entries that match @tag
1670 * @mapping: the address_space to search
1671 * @start: the starting page cache index
1672 * @tag: the tag index
1673 * @nr_entries: the maximum number of entries
1674 * @entries: where the resulting entries are placed
1675 * @indices: the cache indices corresponding to the entries in @entries
1676 *
1677 * Like find_get_entries, except we only return entries which are tagged with
1678 * @tag.
1679 */
1680unsigned find_get_entries_tag(struct address_space *mapping, pgoff_t start,
1681 int tag, unsigned int nr_entries,
1682 struct page **entries, pgoff_t *indices)
1683{
1684 void **slot;
1685 unsigned int ret = 0;
1686 struct radix_tree_iter iter;
1687
1688 if (!nr_entries)
1689 return 0;
1690
1691 rcu_read_lock();
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001692 radix_tree_for_each_tagged(slot, &mapping->page_tree,
1693 &iter, start, tag) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001694 struct page *head, *page;
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001695repeat:
1696 page = radix_tree_deref_slot(slot);
1697 if (unlikely(!page))
1698 continue;
1699 if (radix_tree_exception(page)) {
1700 if (radix_tree_deref_retry(page)) {
Matthew Wilcox2cf938a2016-03-17 14:22:03 -07001701 slot = radix_tree_iter_retry(&iter);
1702 continue;
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001703 }
1704
1705 /*
1706 * A shadow entry of a recently evicted page, a swap
1707 * entry from shmem/tmpfs or a DAX entry. Return it
1708 * without attempting to raise page count.
1709 */
1710 goto export;
1711 }
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001712
1713 head = compound_head(page);
1714 if (!page_cache_get_speculative(head))
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001715 goto repeat;
1716
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001717 /* The page was split under us? */
1718 if (compound_head(page) != head) {
1719 put_page(head);
1720 goto repeat;
1721 }
1722
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001723 /* Has the page moved? */
1724 if (unlikely(page != *slot)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07001725 put_page(head);
Ross Zwisler7e7f7742016-01-22 15:10:44 -08001726 goto repeat;
1727 }
1728export:
1729 indices[ret] = iter.index;
1730 entries[ret] = page;
1731 if (++ret == nr_entries)
1732 break;
1733 }
1734 rcu_read_unlock();
1735 return ret;
1736}
1737EXPORT_SYMBOL(find_get_entries_tag);
1738
Wu Fengguang76d42bd2006-06-25 05:48:43 -07001739/*
1740 * CD/DVDs are error prone. When a medium error occurs, the driver may fail
1741 * a _large_ part of the i/o request. Imagine the worst scenario:
1742 *
1743 * ---R__________________________________________B__________
1744 * ^ reading here ^ bad block(assume 4k)
1745 *
1746 * read(R) => miss => readahead(R...B) => media error => frustrating retries
1747 * => failing the whole request => read(R) => read(R+1) =>
1748 * readahead(R+1...B+1) => bang => read(R+2) => read(R+3) =>
1749 * readahead(R+3...B+2) => bang => read(R+3) => read(R+4) =>
1750 * readahead(R+4...B+3) => bang => read(R+4) => read(R+5) => ......
1751 *
1752 * It is going insane. Fix it by quickly scaling down the readahead size.
1753 */
1754static void shrink_readahead_size_eio(struct file *filp,
1755 struct file_ra_state *ra)
1756{
Wu Fengguang76d42bd2006-06-25 05:48:43 -07001757 ra->ra_pages /= 4;
Wu Fengguang76d42bd2006-06-25 05:48:43 -07001758}
1759
Randy Dunlap485bb992006-06-23 02:03:49 -07001760/**
Christoph Hellwig36e78912008-02-08 04:21:24 -08001761 * do_generic_file_read - generic file read routine
Randy Dunlap485bb992006-06-23 02:03:49 -07001762 * @filp: the file to read
1763 * @ppos: current file position
Al Viro6e58e792014-02-03 17:07:03 -05001764 * @iter: data destination
1765 * @written: already copied
Randy Dunlap485bb992006-06-23 02:03:49 -07001766 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07001767 * This is a generic file read routine, and uses the
Randy Dunlap485bb992006-06-23 02:03:49 -07001768 * mapping->a_ops->readpage() function for the actual low-level stuff.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001769 *
1770 * This is really ugly. But the goto's actually try to clarify some
1771 * of the logic when it comes to error handling etc.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001772 */
Al Viro6e58e792014-02-03 17:07:03 -05001773static ssize_t do_generic_file_read(struct file *filp, loff_t *ppos,
1774 struct iov_iter *iter, ssize_t written)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001775{
Christoph Hellwig36e78912008-02-08 04:21:24 -08001776 struct address_space *mapping = filp->f_mapping;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001777 struct inode *inode = mapping->host;
Christoph Hellwig36e78912008-02-08 04:21:24 -08001778 struct file_ra_state *ra = &filp->f_ra;
Fengguang Wu57f6b962007-10-16 01:24:37 -07001779 pgoff_t index;
1780 pgoff_t last_index;
1781 pgoff_t prev_index;
1782 unsigned long offset; /* offset into pagecache page */
Jan Karaec0f1632007-05-06 14:49:25 -07001783 unsigned int prev_offset;
Al Viro6e58e792014-02-03 17:07:03 -05001784 int error = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001785
Wei Fangc2a97372016-10-07 17:01:52 -07001786 if (unlikely(*ppos >= inode->i_sb->s_maxbytes))
Linus Torvaldsd05c5f72016-12-14 12:45:25 -08001787 return 0;
Wei Fangc2a97372016-10-07 17:01:52 -07001788 iov_iter_truncate(iter, inode->i_sb->s_maxbytes);
1789
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001790 index = *ppos >> PAGE_SHIFT;
1791 prev_index = ra->prev_pos >> PAGE_SHIFT;
1792 prev_offset = ra->prev_pos & (PAGE_SIZE-1);
1793 last_index = (*ppos + iter->count + PAGE_SIZE-1) >> PAGE_SHIFT;
1794 offset = *ppos & ~PAGE_MASK;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001795
Linus Torvalds1da177e2005-04-16 15:20:36 -07001796 for (;;) {
1797 struct page *page;
Fengguang Wu57f6b962007-10-16 01:24:37 -07001798 pgoff_t end_index;
NeilBrowna32ea1e2007-07-17 04:03:04 -07001799 loff_t isize;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001800 unsigned long nr, ret;
1801
Linus Torvalds1da177e2005-04-16 15:20:36 -07001802 cond_resched();
Linus Torvalds1da177e2005-04-16 15:20:36 -07001803find_page:
Michal Hocko5abf1862017-02-03 13:13:29 -08001804 if (fatal_signal_pending(current)) {
1805 error = -EINTR;
1806 goto out;
1807 }
1808
Linus Torvalds1da177e2005-04-16 15:20:36 -07001809 page = find_get_page(mapping, index);
Fengguang Wu3ea89ee2007-07-19 01:48:02 -07001810 if (!page) {
Rusty Russellcf914a72007-07-19 01:48:08 -07001811 page_cache_sync_readahead(mapping,
Fengguang Wu7ff81072007-10-16 01:24:35 -07001812 ra, filp,
Fengguang Wu3ea89ee2007-07-19 01:48:02 -07001813 index, last_index - index);
1814 page = find_get_page(mapping, index);
1815 if (unlikely(page == NULL))
1816 goto no_cached_page;
1817 }
1818 if (PageReadahead(page)) {
Rusty Russellcf914a72007-07-19 01:48:08 -07001819 page_cache_async_readahead(mapping,
Fengguang Wu7ff81072007-10-16 01:24:35 -07001820 ra, filp, page,
Fengguang Wu3ea89ee2007-07-19 01:48:02 -07001821 index, last_index - index);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001822 }
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001823 if (!PageUptodate(page)) {
Mel Gormanebded022016-03-15 14:55:39 -07001824 /*
1825 * See comment in do_read_cache_page on why
1826 * wait_on_page_locked is used to avoid unnecessarily
1827 * serialisations and why it's safe.
1828 */
Bart Van Asschec4b209a2016-10-07 16:58:33 -07001829 error = wait_on_page_locked_killable(page);
1830 if (unlikely(error))
1831 goto readpage_error;
Mel Gormanebded022016-03-15 14:55:39 -07001832 if (PageUptodate(page))
1833 goto page_ok;
1834
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001835 if (inode->i_blkbits == PAGE_SHIFT ||
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001836 !mapping->a_ops->is_partially_uptodate)
1837 goto page_not_up_to_date;
Eryu Guan6d6d36b2016-11-01 15:43:07 +08001838 /* pipes can't handle partially uptodate pages */
1839 if (unlikely(iter->type & ITER_PIPE))
1840 goto page_not_up_to_date;
Nick Piggin529ae9a2008-08-02 12:01:03 +02001841 if (!trylock_page(page))
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001842 goto page_not_up_to_date;
Dave Hansen8d056cb2010-11-11 14:05:15 -08001843 /* Did it get truncated before we got the lock? */
1844 if (!page->mapping)
1845 goto page_not_up_to_date_locked;
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001846 if (!mapping->a_ops->is_partially_uptodate(page,
Al Viro6e58e792014-02-03 17:07:03 -05001847 offset, iter->count))
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001848 goto page_not_up_to_date_locked;
1849 unlock_page(page);
1850 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001851page_ok:
NeilBrowna32ea1e2007-07-17 04:03:04 -07001852 /*
1853 * i_size must be checked after we know the page is Uptodate.
1854 *
1855 * Checking i_size after the check allows us to calculate
1856 * the correct value for "nr", which means the zero-filled
1857 * part of the page is not copied back to userspace (unless
1858 * another truncate extends the file - this is desired though).
1859 */
1860
1861 isize = i_size_read(inode);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001862 end_index = (isize - 1) >> PAGE_SHIFT;
NeilBrowna32ea1e2007-07-17 04:03:04 -07001863 if (unlikely(!isize || index > end_index)) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001864 put_page(page);
NeilBrowna32ea1e2007-07-17 04:03:04 -07001865 goto out;
1866 }
1867
1868 /* nr is the maximum number of bytes to copy from this page */
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001869 nr = PAGE_SIZE;
NeilBrowna32ea1e2007-07-17 04:03:04 -07001870 if (index == end_index) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001871 nr = ((isize - 1) & ~PAGE_MASK) + 1;
NeilBrowna32ea1e2007-07-17 04:03:04 -07001872 if (nr <= offset) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001873 put_page(page);
NeilBrowna32ea1e2007-07-17 04:03:04 -07001874 goto out;
1875 }
1876 }
1877 nr = nr - offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001878
1879 /* If users can be writing to this page using arbitrary
1880 * virtual addresses, take care about potential aliasing
1881 * before reading the page on the kernel side.
1882 */
1883 if (mapping_writably_mapped(mapping))
1884 flush_dcache_page(page);
1885
1886 /*
Jan Karaec0f1632007-05-06 14:49:25 -07001887 * When a sequential read accesses a page several times,
1888 * only mark it as accessed the first time.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001889 */
Jan Karaec0f1632007-05-06 14:49:25 -07001890 if (prev_index != index || offset != prev_offset)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001891 mark_page_accessed(page);
1892 prev_index = index;
1893
1894 /*
1895 * Ok, we have the page, and it's up-to-date, so
1896 * now we can copy it to user space...
Linus Torvalds1da177e2005-04-16 15:20:36 -07001897 */
Al Viro6e58e792014-02-03 17:07:03 -05001898
1899 ret = copy_page_to_iter(page, offset, nr, iter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001900 offset += ret;
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001901 index += offset >> PAGE_SHIFT;
1902 offset &= ~PAGE_MASK;
Jan Kara6ce745e2007-05-06 14:49:26 -07001903 prev_offset = offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001904
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001905 put_page(page);
Al Viro6e58e792014-02-03 17:07:03 -05001906 written += ret;
1907 if (!iov_iter_count(iter))
1908 goto out;
1909 if (ret < nr) {
1910 error = -EFAULT;
1911 goto out;
1912 }
1913 continue;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001914
1915page_not_up_to_date:
1916 /* Get exclusive access to the page ... */
Oleg Nesterov85462322008-06-08 21:20:43 +04001917 error = lock_page_killable(page);
1918 if (unlikely(error))
1919 goto readpage_error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001920
Hisashi Hifumi8ab22b92008-07-28 15:46:36 -07001921page_not_up_to_date_locked:
Nick Pigginda6052f2006-09-25 23:31:35 -07001922 /* Did it get truncated before we got the lock? */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001923 if (!page->mapping) {
1924 unlock_page(page);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001925 put_page(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001926 continue;
1927 }
1928
1929 /* Did somebody else fill it already? */
1930 if (PageUptodate(page)) {
1931 unlock_page(page);
1932 goto page_ok;
1933 }
1934
1935readpage:
Jeff Moyer91803b42010-05-26 11:49:40 -04001936 /*
1937 * A previous I/O error may have been due to temporary
1938 * failures, eg. multipath errors.
1939 * PG_error will be set again if readpage fails.
1940 */
1941 ClearPageError(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001942 /* Start the actual read. The read will unlock the page. */
1943 error = mapping->a_ops->readpage(filp, page);
1944
Zach Brown994fc28c2005-12-15 14:28:17 -08001945 if (unlikely(error)) {
1946 if (error == AOP_TRUNCATED_PAGE) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001947 put_page(page);
Al Viro6e58e792014-02-03 17:07:03 -05001948 error = 0;
Zach Brown994fc28c2005-12-15 14:28:17 -08001949 goto find_page;
1950 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001951 goto readpage_error;
Zach Brown994fc28c2005-12-15 14:28:17 -08001952 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001953
1954 if (!PageUptodate(page)) {
Oleg Nesterov85462322008-06-08 21:20:43 +04001955 error = lock_page_killable(page);
1956 if (unlikely(error))
1957 goto readpage_error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001958 if (!PageUptodate(page)) {
1959 if (page->mapping == NULL) {
1960 /*
Christoph Hellwig2ecdc822010-01-26 17:27:20 +01001961 * invalidate_mapping_pages got it
Linus Torvalds1da177e2005-04-16 15:20:36 -07001962 */
1963 unlock_page(page);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001964 put_page(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001965 goto find_page;
1966 }
1967 unlock_page(page);
Fengguang Wu7ff81072007-10-16 01:24:35 -07001968 shrink_readahead_size_eio(filp, ra);
Oleg Nesterov85462322008-06-08 21:20:43 +04001969 error = -EIO;
1970 goto readpage_error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001971 }
1972 unlock_page(page);
1973 }
1974
Linus Torvalds1da177e2005-04-16 15:20:36 -07001975 goto page_ok;
1976
1977readpage_error:
1978 /* UHHUH! A synchronous read error occurred. Report it */
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001979 put_page(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001980 goto out;
1981
1982no_cached_page:
1983 /*
1984 * Ok, it wasn't cached, so we need to create a new
1985 * page..
1986 */
Nick Piggineb2be182007-10-16 01:24:57 -07001987 page = page_cache_alloc_cold(mapping);
1988 if (!page) {
Al Viro6e58e792014-02-03 17:07:03 -05001989 error = -ENOMEM;
Nick Piggineb2be182007-10-16 01:24:57 -07001990 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001991 }
Michal Hocko6afdb852015-06-24 16:58:06 -07001992 error = add_to_page_cache_lru(page, mapping, index,
Michal Hockoc62d2552015-11-06 16:28:49 -08001993 mapping_gfp_constraint(mapping, GFP_KERNEL));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001994 if (error) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001995 put_page(page);
Al Viro6e58e792014-02-03 17:07:03 -05001996 if (error == -EEXIST) {
1997 error = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001998 goto find_page;
Al Viro6e58e792014-02-03 17:07:03 -05001999 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002000 goto out;
2001 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002002 goto readpage;
2003 }
2004
2005out:
Fengguang Wu7ff81072007-10-16 01:24:35 -07002006 ra->prev_pos = prev_index;
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002007 ra->prev_pos <<= PAGE_SHIFT;
Fengguang Wu7ff81072007-10-16 01:24:35 -07002008 ra->prev_pos |= prev_offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002009
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002010 *ppos = ((loff_t)index << PAGE_SHIFT) + offset;
Krishna Kumar0c6aa262008-10-15 22:01:13 -07002011 file_accessed(filp);
Al Viro6e58e792014-02-03 17:07:03 -05002012 return written ? written : error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002013}
2014
Randy Dunlap485bb992006-06-23 02:03:49 -07002015/**
Al Viro6abd2322014-04-04 14:20:57 -04002016 * generic_file_read_iter - generic filesystem read routine
Randy Dunlap485bb992006-06-23 02:03:49 -07002017 * @iocb: kernel I/O control block
Al Viro6abd2322014-04-04 14:20:57 -04002018 * @iter: destination for the data read
Randy Dunlap485bb992006-06-23 02:03:49 -07002019 *
Al Viro6abd2322014-04-04 14:20:57 -04002020 * This is the "read_iter()" routine for all filesystems
Linus Torvalds1da177e2005-04-16 15:20:36 -07002021 * that can use the page cache directly.
2022 */
2023ssize_t
Al Viroed978a82014-03-05 22:53:04 -05002024generic_file_read_iter(struct kiocb *iocb, struct iov_iter *iter)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002025{
Al Viroed978a82014-03-05 22:53:04 -05002026 struct file *file = iocb->ki_filp;
2027 ssize_t retval = 0;
Nicolai Stangee7080a42016-03-25 14:22:14 -07002028 size_t count = iov_iter_count(iter);
2029
2030 if (!count)
2031 goto out; /* skip atime */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002032
Al Viro2ba48ce2015-04-09 13:52:01 -04002033 if (iocb->ki_flags & IOCB_DIRECT) {
Al Viroed978a82014-03-05 22:53:04 -05002034 struct address_space *mapping = file->f_mapping;
2035 struct inode *inode = mapping->host;
Christoph Hellwig0d5b0cf2016-10-03 09:48:08 +11002036 struct iov_iter data = *iter;
Badari Pulavarty543ade12006-09-30 23:28:48 -07002037 loff_t size;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002038
Linus Torvalds1da177e2005-04-16 15:20:36 -07002039 size = i_size_read(inode);
Christoph Hellwigc64fb5c2016-04-07 08:51:55 -07002040 retval = filemap_write_and_wait_range(mapping, iocb->ki_pos,
2041 iocb->ki_pos + count - 1);
Christoph Hellwig0d5b0cf2016-10-03 09:48:08 +11002042 if (retval < 0)
2043 goto out;
Al Viroed978a82014-03-05 22:53:04 -05002044
Christoph Hellwig0d5b0cf2016-10-03 09:48:08 +11002045 file_accessed(file);
2046
2047 retval = mapping->a_ops->direct_IO(iocb, &data);
Al Viroc3a69022016-10-10 13:26:27 -04002048 if (retval >= 0) {
Christoph Hellwigc64fb5c2016-04-07 08:51:55 -07002049 iocb->ki_pos += retval;
Al Viroed978a82014-03-05 22:53:04 -05002050 iov_iter_advance(iter, retval);
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00002051 }
Josef Bacik66f998f2010-05-23 11:00:54 -04002052
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00002053 /*
2054 * Btrfs can have a short DIO read if we encounter
2055 * compressed extents, so if there was an error, or if
2056 * we've already read everything we wanted to, or if
2057 * there was a short read because we hit EOF, go ahead
2058 * and return. Otherwise fallthrough to buffered io for
Matthew Wilcoxfbbbad42015-02-16 15:58:53 -08002059 * the rest of the read. Buffered reads will not work for
2060 * DAX files, so don't bother trying.
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00002061 */
Christoph Hellwigc64fb5c2016-04-07 08:51:55 -07002062 if (retval < 0 || !iov_iter_count(iter) || iocb->ki_pos >= size ||
Christoph Hellwig0d5b0cf2016-10-03 09:48:08 +11002063 IS_DAX(inode))
Steven Whitehouse9fe55ee2014-01-24 14:42:22 +00002064 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002065 }
2066
Christoph Hellwigc64fb5c2016-04-07 08:51:55 -07002067 retval = do_generic_file_read(file, &iocb->ki_pos, iter, retval);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002068out:
2069 return retval;
2070}
Al Viroed978a82014-03-05 22:53:04 -05002071EXPORT_SYMBOL(generic_file_read_iter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002072
Linus Torvalds1da177e2005-04-16 15:20:36 -07002073#ifdef CONFIG_MMU
Randy Dunlap485bb992006-06-23 02:03:49 -07002074/**
2075 * page_cache_read - adds requested page to the page cache if not already there
2076 * @file: file to read
2077 * @offset: page index
Randy Dunlap62eb3202016-02-11 16:12:58 -08002078 * @gfp_mask: memory allocation flags
Randy Dunlap485bb992006-06-23 02:03:49 -07002079 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07002080 * This adds the requested page to the page cache if it isn't already there,
2081 * and schedules an I/O to read in its contents from disk.
2082 */
Michal Hockoc20cd452016-01-14 15:20:12 -08002083static int page_cache_read(struct file *file, pgoff_t offset, gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002084{
2085 struct address_space *mapping = file->f_mapping;
Paul McQuade99dadfd2014-10-09 15:29:03 -07002086 struct page *page;
Zach Brown994fc28c2005-12-15 14:28:17 -08002087 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002088
Zach Brown994fc28c2005-12-15 14:28:17 -08002089 do {
Michal Hockoc20cd452016-01-14 15:20:12 -08002090 page = __page_cache_alloc(gfp_mask|__GFP_COLD);
Zach Brown994fc28c2005-12-15 14:28:17 -08002091 if (!page)
2092 return -ENOMEM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002093
Michal Hockoc20cd452016-01-14 15:20:12 -08002094 ret = add_to_page_cache_lru(page, mapping, offset, gfp_mask & GFP_KERNEL);
Zach Brown994fc28c2005-12-15 14:28:17 -08002095 if (ret == 0)
2096 ret = mapping->a_ops->readpage(file, page);
2097 else if (ret == -EEXIST)
2098 ret = 0; /* losing race to add is OK */
2099
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002100 put_page(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002101
Zach Brown994fc28c2005-12-15 14:28:17 -08002102 } while (ret == AOP_TRUNCATED_PAGE);
Paul McQuade99dadfd2014-10-09 15:29:03 -07002103
Zach Brown994fc28c2005-12-15 14:28:17 -08002104 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002105}
2106
2107#define MMAP_LOTSAMISS (100)
2108
Linus Torvaldsef00e082009-06-16 15:31:25 -07002109/*
2110 * Synchronous readahead happens when we don't even find
2111 * a page in the page cache at all.
2112 */
2113static void do_sync_mmap_readahead(struct vm_area_struct *vma,
2114 struct file_ra_state *ra,
2115 struct file *file,
2116 pgoff_t offset)
2117{
Linus Torvaldsef00e082009-06-16 15:31:25 -07002118 struct address_space *mapping = file->f_mapping;
2119
2120 /* If we don't want any read-ahead, don't bother */
Joe Perches64363aa2013-07-08 16:00:18 -07002121 if (vma->vm_flags & VM_RAND_READ)
Linus Torvaldsef00e082009-06-16 15:31:25 -07002122 return;
Wu Fengguang275b12b2011-05-24 17:12:28 -07002123 if (!ra->ra_pages)
2124 return;
Linus Torvaldsef00e082009-06-16 15:31:25 -07002125
Joe Perches64363aa2013-07-08 16:00:18 -07002126 if (vma->vm_flags & VM_SEQ_READ) {
Wu Fengguang7ffc59b2009-06-16 15:31:38 -07002127 page_cache_sync_readahead(mapping, ra, file, offset,
2128 ra->ra_pages);
Linus Torvaldsef00e082009-06-16 15:31:25 -07002129 return;
2130 }
2131
Andi Kleen207d04b2011-05-24 17:12:29 -07002132 /* Avoid banging the cache line if not needed */
2133 if (ra->mmap_miss < MMAP_LOTSAMISS * 10)
Linus Torvaldsef00e082009-06-16 15:31:25 -07002134 ra->mmap_miss++;
2135
2136 /*
2137 * Do we miss much more than hit in this file? If so,
2138 * stop bothering with read-ahead. It will only hurt.
2139 */
2140 if (ra->mmap_miss > MMAP_LOTSAMISS)
2141 return;
2142
Wu Fengguangd30a1102009-06-16 15:31:30 -07002143 /*
2144 * mmap read-around
2145 */
Roman Gushchin600e19a2015-11-05 18:47:08 -08002146 ra->start = max_t(long, 0, offset - ra->ra_pages / 2);
2147 ra->size = ra->ra_pages;
2148 ra->async_size = ra->ra_pages / 4;
Wu Fengguang275b12b2011-05-24 17:12:28 -07002149 ra_submit(ra, mapping, file);
Linus Torvaldsef00e082009-06-16 15:31:25 -07002150}
2151
2152/*
2153 * Asynchronous readahead happens when we find the page and PG_readahead,
2154 * so we want to possibly extend the readahead further..
2155 */
2156static void do_async_mmap_readahead(struct vm_area_struct *vma,
2157 struct file_ra_state *ra,
2158 struct file *file,
2159 struct page *page,
2160 pgoff_t offset)
2161{
2162 struct address_space *mapping = file->f_mapping;
2163
2164 /* If we don't want any read-ahead, don't bother */
Joe Perches64363aa2013-07-08 16:00:18 -07002165 if (vma->vm_flags & VM_RAND_READ)
Linus Torvaldsef00e082009-06-16 15:31:25 -07002166 return;
2167 if (ra->mmap_miss > 0)
2168 ra->mmap_miss--;
2169 if (PageReadahead(page))
Wu Fengguang2fad6f52009-06-16 15:31:29 -07002170 page_cache_async_readahead(mapping, ra, file,
2171 page, offset, ra->ra_pages);
Linus Torvaldsef00e082009-06-16 15:31:25 -07002172}
2173
Randy Dunlap485bb992006-06-23 02:03:49 -07002174/**
Nick Piggin54cb8822007-07-19 01:46:59 -07002175 * filemap_fault - read in file data for page fault handling
Nick Piggind0217ac2007-07-19 01:47:03 -07002176 * @vmf: struct vm_fault containing details of the fault
Randy Dunlap485bb992006-06-23 02:03:49 -07002177 *
Nick Piggin54cb8822007-07-19 01:46:59 -07002178 * filemap_fault() is invoked via the vma operations vector for a
Linus Torvalds1da177e2005-04-16 15:20:36 -07002179 * mapped memory region to read in file data during a page fault.
2180 *
2181 * The goto's are kind of ugly, but this streamlines the normal case of having
2182 * it in the page cache, and handles the special cases reasonably without
2183 * having a lot of duplicated code.
Paul Cassella9a95f3c2014-08-06 16:07:24 -07002184 *
2185 * vma->vm_mm->mmap_sem must be held on entry.
2186 *
2187 * If our return value has VM_FAULT_RETRY set, it's because
2188 * lock_page_or_retry() returned 0.
2189 * The mmap_sem has usually been released in this case.
2190 * See __lock_page_or_retry() for the exception.
2191 *
2192 * If our return value does not have VM_FAULT_RETRY set, the mmap_sem
2193 * has not been released.
2194 *
2195 * We never return with VM_FAULT_RETRY and a bit from VM_FAULT_ERROR set.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002196 */
Dave Jiang11bac802017-02-24 14:56:41 -08002197int filemap_fault(struct vm_fault *vmf)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002198{
2199 int error;
Dave Jiang11bac802017-02-24 14:56:41 -08002200 struct file *file = vmf->vma->vm_file;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002201 struct address_space *mapping = file->f_mapping;
2202 struct file_ra_state *ra = &file->f_ra;
2203 struct inode *inode = mapping->host;
Linus Torvaldsef00e082009-06-16 15:31:25 -07002204 pgoff_t offset = vmf->pgoff;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002205 struct page *page;
Kirill A. Shutemov99e3e532014-04-07 15:37:21 -07002206 loff_t size;
Nick Piggin83c54072007-07-19 01:47:05 -07002207 int ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002208
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002209 size = round_up(i_size_read(inode), PAGE_SIZE);
2210 if (offset >= size >> PAGE_SHIFT)
Linus Torvalds5307cc12007-10-31 09:19:46 -07002211 return VM_FAULT_SIGBUS;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002212
Linus Torvalds1da177e2005-04-16 15:20:36 -07002213 /*
Johannes Weiner49426422013-10-16 13:46:59 -07002214 * Do we have something in the page cache already?
Linus Torvalds1da177e2005-04-16 15:20:36 -07002215 */
Linus Torvaldsef00e082009-06-16 15:31:25 -07002216 page = find_get_page(mapping, offset);
Shaohua Li45cac652012-10-08 16:32:19 -07002217 if (likely(page) && !(vmf->flags & FAULT_FLAG_TRIED)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002218 /*
Linus Torvaldsef00e082009-06-16 15:31:25 -07002219 * We found the page, so try async readahead before
2220 * waiting for the lock.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002221 */
Dave Jiang11bac802017-02-24 14:56:41 -08002222 do_async_mmap_readahead(vmf->vma, ra, file, page, offset);
Shaohua Li45cac652012-10-08 16:32:19 -07002223 } else if (!page) {
Linus Torvaldsef00e082009-06-16 15:31:25 -07002224 /* No page in the page cache at all */
Dave Jiang11bac802017-02-24 14:56:41 -08002225 do_sync_mmap_readahead(vmf->vma, ra, file, offset);
Linus Torvaldsef00e082009-06-16 15:31:25 -07002226 count_vm_event(PGMAJFAULT);
Dave Jiang11bac802017-02-24 14:56:41 -08002227 mem_cgroup_count_vm_event(vmf->vma->vm_mm, PGMAJFAULT);
Linus Torvaldsef00e082009-06-16 15:31:25 -07002228 ret = VM_FAULT_MAJOR;
2229retry_find:
Michel Lespinasseb522c942010-10-26 14:21:56 -07002230 page = find_get_page(mapping, offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002231 if (!page)
2232 goto no_cached_page;
2233 }
2234
Dave Jiang11bac802017-02-24 14:56:41 -08002235 if (!lock_page_or_retry(page, vmf->vma->vm_mm, vmf->flags)) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002236 put_page(page);
Michel Lespinassed065bd82010-10-26 14:21:57 -07002237 return ret | VM_FAULT_RETRY;
Michel Lespinassed88c0922010-11-02 13:05:18 -07002238 }
Michel Lespinasseb522c942010-10-26 14:21:56 -07002239
2240 /* Did it get truncated? */
2241 if (unlikely(page->mapping != mapping)) {
2242 unlock_page(page);
2243 put_page(page);
2244 goto retry_find;
2245 }
Sasha Levin309381fea2014-01-23 15:52:54 -08002246 VM_BUG_ON_PAGE(page->index != offset, page);
Michel Lespinasseb522c942010-10-26 14:21:56 -07002247
Linus Torvalds1da177e2005-04-16 15:20:36 -07002248 /*
Nick Piggind00806b2007-07-19 01:46:57 -07002249 * We have a locked page in the page cache, now we need to check
2250 * that it's up-to-date. If not, it is going to be due to an error.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002251 */
Nick Piggind00806b2007-07-19 01:46:57 -07002252 if (unlikely(!PageUptodate(page)))
Linus Torvalds1da177e2005-04-16 15:20:36 -07002253 goto page_not_uptodate;
2254
Linus Torvaldsef00e082009-06-16 15:31:25 -07002255 /*
2256 * Found the page and have a reference on it.
2257 * We must recheck i_size under page lock.
2258 */
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002259 size = round_up(i_size_read(inode), PAGE_SIZE);
2260 if (unlikely(offset >= size >> PAGE_SHIFT)) {
Nick Piggind00806b2007-07-19 01:46:57 -07002261 unlock_page(page);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002262 put_page(page);
Linus Torvalds5307cc12007-10-31 09:19:46 -07002263 return VM_FAULT_SIGBUS;
Nick Piggind00806b2007-07-19 01:46:57 -07002264 }
2265
Nick Piggind0217ac2007-07-19 01:47:03 -07002266 vmf->page = page;
Nick Piggin83c54072007-07-19 01:47:05 -07002267 return ret | VM_FAULT_LOCKED;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002268
Linus Torvalds1da177e2005-04-16 15:20:36 -07002269no_cached_page:
2270 /*
2271 * We're only likely to ever get here if MADV_RANDOM is in
2272 * effect.
2273 */
Michal Hockoc20cd452016-01-14 15:20:12 -08002274 error = page_cache_read(file, offset, vmf->gfp_mask);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002275
2276 /*
2277 * The page we want has now been added to the page cache.
2278 * In the unlikely event that someone removed it in the
2279 * meantime, we'll just come back here and read it again.
2280 */
2281 if (error >= 0)
2282 goto retry_find;
2283
2284 /*
2285 * An error return from page_cache_read can result if the
2286 * system is low on memory, or a problem occurs while trying
2287 * to schedule I/O.
2288 */
2289 if (error == -ENOMEM)
Nick Piggind0217ac2007-07-19 01:47:03 -07002290 return VM_FAULT_OOM;
2291 return VM_FAULT_SIGBUS;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002292
2293page_not_uptodate:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002294 /*
2295 * Umm, take care of errors if the page isn't up-to-date.
2296 * Try to re-read it _once_. We do this synchronously,
2297 * because there really aren't any performance issues here
2298 * and we need to check for errors.
2299 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002300 ClearPageError(page);
Zach Brown994fc28c2005-12-15 14:28:17 -08002301 error = mapping->a_ops->readpage(file, page);
Miklos Szeredi3ef0f722008-05-14 16:05:37 -07002302 if (!error) {
2303 wait_on_page_locked(page);
2304 if (!PageUptodate(page))
2305 error = -EIO;
2306 }
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002307 put_page(page);
Nick Piggind00806b2007-07-19 01:46:57 -07002308
2309 if (!error || error == AOP_TRUNCATED_PAGE)
2310 goto retry_find;
2311
2312 /* Things didn't work out. Return zero to tell the mm layer so. */
2313 shrink_readahead_size_eio(file, ra);
Nick Piggind0217ac2007-07-19 01:47:03 -07002314 return VM_FAULT_SIGBUS;
Nick Piggin54cb8822007-07-19 01:46:59 -07002315}
2316EXPORT_SYMBOL(filemap_fault);
2317
Jan Kara82b0f8c2016-12-14 15:06:58 -08002318void filemap_map_pages(struct vm_fault *vmf,
Kirill A. Shutemovbae473a2016-07-26 15:25:20 -07002319 pgoff_t start_pgoff, pgoff_t end_pgoff)
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002320{
2321 struct radix_tree_iter iter;
2322 void **slot;
Jan Kara82b0f8c2016-12-14 15:06:58 -08002323 struct file *file = vmf->vma->vm_file;
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002324 struct address_space *mapping = file->f_mapping;
Kirill A. Shutemovbae473a2016-07-26 15:25:20 -07002325 pgoff_t last_pgoff = start_pgoff;
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002326 loff_t size;
Kirill A. Shutemov83929372016-07-26 15:26:04 -07002327 struct page *head, *page;
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002328
2329 rcu_read_lock();
Kirill A. Shutemovbae473a2016-07-26 15:25:20 -07002330 radix_tree_for_each_slot(slot, &mapping->page_tree, &iter,
2331 start_pgoff) {
2332 if (iter.index > end_pgoff)
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002333 break;
2334repeat:
2335 page = radix_tree_deref_slot(slot);
2336 if (unlikely(!page))
2337 goto next;
2338 if (radix_tree_exception(page)) {
Matthew Wilcox2cf938a2016-03-17 14:22:03 -07002339 if (radix_tree_deref_retry(page)) {
2340 slot = radix_tree_iter_retry(&iter);
2341 continue;
2342 }
2343 goto next;
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002344 }
2345
Kirill A. Shutemov83929372016-07-26 15:26:04 -07002346 head = compound_head(page);
2347 if (!page_cache_get_speculative(head))
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002348 goto repeat;
2349
Kirill A. Shutemov83929372016-07-26 15:26:04 -07002350 /* The page was split under us? */
2351 if (compound_head(page) != head) {
2352 put_page(head);
2353 goto repeat;
2354 }
2355
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002356 /* Has the page moved? */
2357 if (unlikely(page != *slot)) {
Kirill A. Shutemov83929372016-07-26 15:26:04 -07002358 put_page(head);
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002359 goto repeat;
2360 }
2361
2362 if (!PageUptodate(page) ||
2363 PageReadahead(page) ||
2364 PageHWPoison(page))
2365 goto skip;
2366 if (!trylock_page(page))
2367 goto skip;
2368
2369 if (page->mapping != mapping || !PageUptodate(page))
2370 goto unlock;
2371
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002372 size = round_up(i_size_read(mapping->host), PAGE_SIZE);
2373 if (page->index >= size >> PAGE_SHIFT)
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002374 goto unlock;
2375
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002376 if (file->f_ra.mmap_miss > 0)
2377 file->f_ra.mmap_miss--;
Kirill A. Shutemov7267ec002016-07-26 15:25:23 -07002378
Jan Kara82b0f8c2016-12-14 15:06:58 -08002379 vmf->address += (iter.index - last_pgoff) << PAGE_SHIFT;
2380 if (vmf->pte)
2381 vmf->pte += iter.index - last_pgoff;
Kirill A. Shutemov7267ec002016-07-26 15:25:23 -07002382 last_pgoff = iter.index;
Jan Kara82b0f8c2016-12-14 15:06:58 -08002383 if (alloc_set_pte(vmf, NULL, page))
Kirill A. Shutemov7267ec002016-07-26 15:25:23 -07002384 goto unlock;
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002385 unlock_page(page);
2386 goto next;
2387unlock:
2388 unlock_page(page);
2389skip:
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002390 put_page(page);
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002391next:
Kirill A. Shutemov7267ec002016-07-26 15:25:23 -07002392 /* Huge page is mapped? No need to proceed. */
Jan Kara82b0f8c2016-12-14 15:06:58 -08002393 if (pmd_trans_huge(*vmf->pmd))
Kirill A. Shutemov7267ec002016-07-26 15:25:23 -07002394 break;
Kirill A. Shutemovbae473a2016-07-26 15:25:20 -07002395 if (iter.index == end_pgoff)
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002396 break;
2397 }
2398 rcu_read_unlock();
2399}
2400EXPORT_SYMBOL(filemap_map_pages);
2401
Dave Jiang11bac802017-02-24 14:56:41 -08002402int filemap_page_mkwrite(struct vm_fault *vmf)
Jan Kara4fcf1c62012-06-12 16:20:29 +02002403{
2404 struct page *page = vmf->page;
Dave Jiang11bac802017-02-24 14:56:41 -08002405 struct inode *inode = file_inode(vmf->vma->vm_file);
Jan Kara4fcf1c62012-06-12 16:20:29 +02002406 int ret = VM_FAULT_LOCKED;
2407
Jan Kara14da9202012-06-12 16:20:37 +02002408 sb_start_pagefault(inode->i_sb);
Dave Jiang11bac802017-02-24 14:56:41 -08002409 file_update_time(vmf->vma->vm_file);
Jan Kara4fcf1c62012-06-12 16:20:29 +02002410 lock_page(page);
2411 if (page->mapping != inode->i_mapping) {
2412 unlock_page(page);
2413 ret = VM_FAULT_NOPAGE;
2414 goto out;
2415 }
Jan Kara14da9202012-06-12 16:20:37 +02002416 /*
2417 * We mark the page dirty already here so that when freeze is in
2418 * progress, we are guaranteed that writeback during freezing will
2419 * see the dirty page and writeprotect it again.
2420 */
2421 set_page_dirty(page);
Darrick J. Wong1d1d1a72013-02-21 16:42:51 -08002422 wait_for_stable_page(page);
Jan Kara4fcf1c62012-06-12 16:20:29 +02002423out:
Jan Kara14da9202012-06-12 16:20:37 +02002424 sb_end_pagefault(inode->i_sb);
Jan Kara4fcf1c62012-06-12 16:20:29 +02002425 return ret;
2426}
2427EXPORT_SYMBOL(filemap_page_mkwrite);
2428
Alexey Dobriyanf0f37e22009-09-27 22:29:37 +04002429const struct vm_operations_struct generic_file_vm_ops = {
Nick Piggin54cb8822007-07-19 01:46:59 -07002430 .fault = filemap_fault,
Kirill A. Shutemovf1820362014-04-07 15:37:19 -07002431 .map_pages = filemap_map_pages,
Jan Kara4fcf1c62012-06-12 16:20:29 +02002432 .page_mkwrite = filemap_page_mkwrite,
Linus Torvalds1da177e2005-04-16 15:20:36 -07002433};
2434
2435/* This is used for a general mmap of a disk file */
2436
2437int generic_file_mmap(struct file * file, struct vm_area_struct * vma)
2438{
2439 struct address_space *mapping = file->f_mapping;
2440
2441 if (!mapping->a_ops->readpage)
2442 return -ENOEXEC;
2443 file_accessed(file);
2444 vma->vm_ops = &generic_file_vm_ops;
2445 return 0;
2446}
Linus Torvalds1da177e2005-04-16 15:20:36 -07002447
2448/*
2449 * This is for filesystems which do not implement ->writepage.
2450 */
2451int generic_file_readonly_mmap(struct file *file, struct vm_area_struct *vma)
2452{
2453 if ((vma->vm_flags & VM_SHARED) && (vma->vm_flags & VM_MAYWRITE))
2454 return -EINVAL;
2455 return generic_file_mmap(file, vma);
2456}
2457#else
2458int generic_file_mmap(struct file * file, struct vm_area_struct * vma)
2459{
2460 return -ENOSYS;
2461}
2462int generic_file_readonly_mmap(struct file * file, struct vm_area_struct * vma)
2463{
2464 return -ENOSYS;
2465}
2466#endif /* CONFIG_MMU */
2467
2468EXPORT_SYMBOL(generic_file_mmap);
2469EXPORT_SYMBOL(generic_file_readonly_mmap);
2470
Sasha Levin67f9fd92014-04-03 14:48:18 -07002471static struct page *wait_on_page_read(struct page *page)
2472{
2473 if (!IS_ERR(page)) {
2474 wait_on_page_locked(page);
2475 if (!PageUptodate(page)) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002476 put_page(page);
Sasha Levin67f9fd92014-04-03 14:48:18 -07002477 page = ERR_PTR(-EIO);
2478 }
2479 }
2480 return page;
2481}
2482
Mel Gorman32b63522016-03-15 14:55:36 -07002483static struct page *do_read_cache_page(struct address_space *mapping,
Fengguang Wu57f6b962007-10-16 01:24:37 -07002484 pgoff_t index,
Hugh Dickins5e5358e2011-07-25 17:12:23 -07002485 int (*filler)(void *, struct page *),
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002486 void *data,
2487 gfp_t gfp)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002488{
Nick Piggineb2be182007-10-16 01:24:57 -07002489 struct page *page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002490 int err;
2491repeat:
2492 page = find_get_page(mapping, index);
2493 if (!page) {
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002494 page = __page_cache_alloc(gfp | __GFP_COLD);
Nick Piggineb2be182007-10-16 01:24:57 -07002495 if (!page)
2496 return ERR_PTR(-ENOMEM);
Dave Kleikampe6f67b82011-12-21 11:05:48 -06002497 err = add_to_page_cache_lru(page, mapping, index, gfp);
Nick Piggineb2be182007-10-16 01:24:57 -07002498 if (unlikely(err)) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002499 put_page(page);
Nick Piggineb2be182007-10-16 01:24:57 -07002500 if (err == -EEXIST)
2501 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002502 /* Presumably ENOMEM for radix tree node */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002503 return ERR_PTR(err);
2504 }
Mel Gorman32b63522016-03-15 14:55:36 -07002505
2506filler:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002507 err = filler(data, page);
2508 if (err < 0) {
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002509 put_page(page);
Mel Gorman32b63522016-03-15 14:55:36 -07002510 return ERR_PTR(err);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002511 }
Mel Gorman32b63522016-03-15 14:55:36 -07002512
2513 page = wait_on_page_read(page);
2514 if (IS_ERR(page))
2515 return page;
2516 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002517 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002518 if (PageUptodate(page))
2519 goto out;
2520
Mel Gormanebded022016-03-15 14:55:39 -07002521 /*
2522 * Page is not up to date and may be locked due one of the following
2523 * case a: Page is being filled and the page lock is held
2524 * case b: Read/write error clearing the page uptodate status
2525 * case c: Truncation in progress (page locked)
2526 * case d: Reclaim in progress
2527 *
2528 * Case a, the page will be up to date when the page is unlocked.
2529 * There is no need to serialise on the page lock here as the page
2530 * is pinned so the lock gives no additional protection. Even if the
2531 * the page is truncated, the data is still valid if PageUptodate as
2532 * it's a race vs truncate race.
2533 * Case b, the page will not be up to date
2534 * Case c, the page may be truncated but in itself, the data may still
2535 * be valid after IO completes as it's a read vs truncate race. The
2536 * operation must restart if the page is not uptodate on unlock but
2537 * otherwise serialising on page lock to stabilise the mapping gives
2538 * no additional guarantees to the caller as the page lock is
2539 * released before return.
2540 * Case d, similar to truncation. If reclaim holds the page lock, it
2541 * will be a race with remove_mapping that determines if the mapping
2542 * is valid on unlock but otherwise the data is valid and there is
2543 * no need to serialise with page lock.
2544 *
2545 * As the page lock gives no additional guarantee, we optimistically
2546 * wait on the page to be unlocked and check if it's up to date and
2547 * use the page if it is. Otherwise, the page lock is required to
2548 * distinguish between the different cases. The motivation is that we
2549 * avoid spurious serialisations and wakeups when multiple processes
2550 * wait on the same page for IO to complete.
2551 */
2552 wait_on_page_locked(page);
2553 if (PageUptodate(page))
2554 goto out;
2555
2556 /* Distinguish between all the cases under the safety of the lock */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002557 lock_page(page);
Mel Gormanebded022016-03-15 14:55:39 -07002558
2559 /* Case c or d, restart the operation */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002560 if (!page->mapping) {
2561 unlock_page(page);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002562 put_page(page);
Mel Gorman32b63522016-03-15 14:55:36 -07002563 goto repeat;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002564 }
Mel Gormanebded022016-03-15 14:55:39 -07002565
2566 /* Someone else locked and filled the page in a very small window */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002567 if (PageUptodate(page)) {
2568 unlock_page(page);
2569 goto out;
2570 }
Mel Gorman32b63522016-03-15 14:55:36 -07002571 goto filler;
2572
David Howellsc855ff32007-05-09 13:42:20 +01002573out:
Nick Piggin6fe69002007-05-06 14:49:04 -07002574 mark_page_accessed(page);
2575 return page;
2576}
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002577
2578/**
Sasha Levin67f9fd92014-04-03 14:48:18 -07002579 * read_cache_page - read into page cache, fill it if needed
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002580 * @mapping: the page's address_space
2581 * @index: the page index
2582 * @filler: function to perform the read
Hugh Dickins5e5358e2011-07-25 17:12:23 -07002583 * @data: first arg to filler(data, page) function, often left as NULL
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002584 *
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002585 * Read into the page cache. If a page already exists, and PageUptodate() is
Sasha Levin67f9fd92014-04-03 14:48:18 -07002586 * not set, try to fill the page and wait for it to become unlocked.
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002587 *
2588 * If the page does not get brought uptodate, return -EIO.
2589 */
Sasha Levin67f9fd92014-04-03 14:48:18 -07002590struct page *read_cache_page(struct address_space *mapping,
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002591 pgoff_t index,
Hugh Dickins5e5358e2011-07-25 17:12:23 -07002592 int (*filler)(void *, struct page *),
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002593 void *data)
2594{
2595 return do_read_cache_page(mapping, index, filler, data, mapping_gfp_mask(mapping));
2596}
Sasha Levin67f9fd92014-04-03 14:48:18 -07002597EXPORT_SYMBOL(read_cache_page);
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002598
2599/**
2600 * read_cache_page_gfp - read into page cache, using specified page allocation flags.
2601 * @mapping: the page's address_space
2602 * @index: the page index
2603 * @gfp: the page allocator flags to use if allocating
2604 *
2605 * This is the same as "read_mapping_page(mapping, index, NULL)", but with
Dave Kleikampe6f67b82011-12-21 11:05:48 -06002606 * any new page allocations done using the specified allocation flags.
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002607 *
2608 * If the page does not get brought uptodate, return -EIO.
2609 */
2610struct page *read_cache_page_gfp(struct address_space *mapping,
2611 pgoff_t index,
2612 gfp_t gfp)
2613{
2614 filler_t *filler = (filler_t *)mapping->a_ops->readpage;
2615
Sasha Levin67f9fd92014-04-03 14:48:18 -07002616 return do_read_cache_page(mapping, index, filler, NULL, gfp);
Linus Torvalds0531b2a2010-01-27 09:20:03 -08002617}
2618EXPORT_SYMBOL(read_cache_page_gfp);
2619
Nick Piggin2f718ff2007-10-16 01:24:59 -07002620/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07002621 * Performs necessary checks before doing a write
2622 *
Randy Dunlap485bb992006-06-23 02:03:49 -07002623 * Can adjust writing position or amount of bytes to write.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002624 * Returns appropriate error code that caller should return or
2625 * zero in case that write should be allowed.
2626 */
Al Viro3309dd02015-04-09 12:55:47 -04002627inline ssize_t generic_write_checks(struct kiocb *iocb, struct iov_iter *from)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002628{
Al Viro3309dd02015-04-09 12:55:47 -04002629 struct file *file = iocb->ki_filp;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002630 struct inode *inode = file->f_mapping->host;
Jiri Slaby59e99e52010-03-05 13:41:44 -08002631 unsigned long limit = rlimit(RLIMIT_FSIZE);
Al Viro3309dd02015-04-09 12:55:47 -04002632 loff_t pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002633
Al Viro3309dd02015-04-09 12:55:47 -04002634 if (!iov_iter_count(from))
2635 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002636
Al Viro0fa6b002015-04-04 04:05:48 -04002637 /* FIXME: this is for backwards compatibility with 2.4 */
Al Viro2ba48ce2015-04-09 13:52:01 -04002638 if (iocb->ki_flags & IOCB_APPEND)
Al Viro3309dd02015-04-09 12:55:47 -04002639 iocb->ki_pos = i_size_read(inode);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002640
Al Viro3309dd02015-04-09 12:55:47 -04002641 pos = iocb->ki_pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002642
Al Viro0fa6b002015-04-04 04:05:48 -04002643 if (limit != RLIM_INFINITY) {
Al Viro3309dd02015-04-09 12:55:47 -04002644 if (iocb->ki_pos >= limit) {
Al Viro0fa6b002015-04-04 04:05:48 -04002645 send_sig(SIGXFSZ, current, 0);
2646 return -EFBIG;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002647 }
Al Viro3309dd02015-04-09 12:55:47 -04002648 iov_iter_truncate(from, limit - (unsigned long)pos);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002649 }
2650
2651 /*
2652 * LFS rule
2653 */
Al Viro3309dd02015-04-09 12:55:47 -04002654 if (unlikely(pos + iov_iter_count(from) > MAX_NON_LFS &&
Linus Torvalds1da177e2005-04-16 15:20:36 -07002655 !(file->f_flags & O_LARGEFILE))) {
Al Viro3309dd02015-04-09 12:55:47 -04002656 if (pos >= MAX_NON_LFS)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002657 return -EFBIG;
Al Viro3309dd02015-04-09 12:55:47 -04002658 iov_iter_truncate(from, MAX_NON_LFS - (unsigned long)pos);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002659 }
2660
2661 /*
2662 * Are we about to exceed the fs block limit ?
2663 *
2664 * If we have written data it becomes a short write. If we have
2665 * exceeded without writing data we send a signal and return EFBIG.
2666 * Linus frestrict idea will clean these up nicely..
2667 */
Al Viro3309dd02015-04-09 12:55:47 -04002668 if (unlikely(pos >= inode->i_sb->s_maxbytes))
2669 return -EFBIG;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002670
Al Viro3309dd02015-04-09 12:55:47 -04002671 iov_iter_truncate(from, inode->i_sb->s_maxbytes - pos);
2672 return iov_iter_count(from);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002673}
2674EXPORT_SYMBOL(generic_write_checks);
2675
Nick Pigginafddba42007-10-16 01:25:01 -07002676int pagecache_write_begin(struct file *file, struct address_space *mapping,
2677 loff_t pos, unsigned len, unsigned flags,
2678 struct page **pagep, void **fsdata)
2679{
2680 const struct address_space_operations *aops = mapping->a_ops;
2681
Nick Piggin4e02ed42008-10-29 14:00:55 -07002682 return aops->write_begin(file, mapping, pos, len, flags,
Nick Pigginafddba42007-10-16 01:25:01 -07002683 pagep, fsdata);
Nick Pigginafddba42007-10-16 01:25:01 -07002684}
2685EXPORT_SYMBOL(pagecache_write_begin);
2686
2687int pagecache_write_end(struct file *file, struct address_space *mapping,
2688 loff_t pos, unsigned len, unsigned copied,
2689 struct page *page, void *fsdata)
2690{
2691 const struct address_space_operations *aops = mapping->a_ops;
Nick Pigginafddba42007-10-16 01:25:01 -07002692
Nick Piggin4e02ed42008-10-29 14:00:55 -07002693 return aops->write_end(file, mapping, pos, len, copied, page, fsdata);
Nick Pigginafddba42007-10-16 01:25:01 -07002694}
2695EXPORT_SYMBOL(pagecache_write_end);
2696
Linus Torvalds1da177e2005-04-16 15:20:36 -07002697ssize_t
Christoph Hellwig1af5bb42016-04-07 08:51:56 -07002698generic_file_direct_write(struct kiocb *iocb, struct iov_iter *from)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002699{
2700 struct file *file = iocb->ki_filp;
2701 struct address_space *mapping = file->f_mapping;
2702 struct inode *inode = mapping->host;
Christoph Hellwig1af5bb42016-04-07 08:51:56 -07002703 loff_t pos = iocb->ki_pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002704 ssize_t written;
Christoph Hellwiga969e902008-07-23 21:27:04 -07002705 size_t write_len;
2706 pgoff_t end;
Al Viro26978b82014-03-10 14:08:45 -04002707 struct iov_iter data;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002708
Al Viro0c949332014-03-22 06:51:37 -04002709 write_len = iov_iter_count(from);
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002710 end = (pos + write_len - 1) >> PAGE_SHIFT;
Christoph Hellwiga969e902008-07-23 21:27:04 -07002711
Nick Piggin48b47c52009-01-06 14:40:22 -08002712 written = filemap_write_and_wait_range(mapping, pos, pos + write_len - 1);
Christoph Hellwiga969e902008-07-23 21:27:04 -07002713 if (written)
2714 goto out;
2715
2716 /*
2717 * After a write we want buffered reads to be sure to go to disk to get
2718 * the new data. We invalidate clean cached page from the region we're
2719 * about to write. We do this *before* the write so that we can return
Hisashi Hifumi6ccfa802008-09-02 14:35:40 -07002720 * without clobbering -EIOCBQUEUED from ->direct_IO().
Christoph Hellwiga969e902008-07-23 21:27:04 -07002721 */
2722 if (mapping->nrpages) {
2723 written = invalidate_inode_pages2_range(mapping,
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002724 pos >> PAGE_SHIFT, end);
Hisashi Hifumi6ccfa802008-09-02 14:35:40 -07002725 /*
2726 * If a page can not be invalidated, return 0 to fall back
2727 * to buffered write.
2728 */
2729 if (written) {
2730 if (written == -EBUSY)
2731 return 0;
Christoph Hellwiga969e902008-07-23 21:27:04 -07002732 goto out;
Hisashi Hifumi6ccfa802008-09-02 14:35:40 -07002733 }
Christoph Hellwiga969e902008-07-23 21:27:04 -07002734 }
2735
Al Viro26978b82014-03-10 14:08:45 -04002736 data = *from;
Christoph Hellwigc8b8e322016-04-07 08:51:58 -07002737 written = mapping->a_ops->direct_IO(iocb, &data);
Christoph Hellwiga969e902008-07-23 21:27:04 -07002738
2739 /*
2740 * Finally, try again to invalidate clean pages which might have been
2741 * cached by non-direct readahead, or faulted in by get_user_pages()
2742 * if the source of the write was an mmap'ed region of the file
2743 * we're writing. Either one is a pretty crazy thing to do,
2744 * so we don't support it 100%. If this invalidation
2745 * fails, tough, the write still worked...
2746 */
2747 if (mapping->nrpages) {
2748 invalidate_inode_pages2_range(mapping,
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002749 pos >> PAGE_SHIFT, end);
Christoph Hellwiga969e902008-07-23 21:27:04 -07002750 }
2751
Linus Torvalds1da177e2005-04-16 15:20:36 -07002752 if (written > 0) {
Namhyung Kim01166512010-10-26 14:21:58 -07002753 pos += written;
Al Virof8579f82014-03-03 22:03:20 -05002754 iov_iter_advance(from, written);
Namhyung Kim01166512010-10-26 14:21:58 -07002755 if (pos > i_size_read(inode) && !S_ISBLK(inode->i_mode)) {
2756 i_size_write(inode, pos);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002757 mark_inode_dirty(inode);
2758 }
Al Viro5cb6c6c2014-02-11 20:58:20 -05002759 iocb->ki_pos = pos;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002760 }
Christoph Hellwiga969e902008-07-23 21:27:04 -07002761out:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002762 return written;
2763}
2764EXPORT_SYMBOL(generic_file_direct_write);
2765
Nick Piggineb2be182007-10-16 01:24:57 -07002766/*
2767 * Find or create a page at the given pagecache position. Return the locked
2768 * page. This function is specifically for buffered writes.
2769 */
Nick Piggin54566b22009-01-04 12:00:53 -08002770struct page *grab_cache_page_write_begin(struct address_space *mapping,
2771 pgoff_t index, unsigned flags)
Nick Piggineb2be182007-10-16 01:24:57 -07002772{
Nick Piggineb2be182007-10-16 01:24:57 -07002773 struct page *page;
Johannes Weinerbbddabe2016-05-20 16:56:28 -07002774 int fgp_flags = FGP_LOCK|FGP_WRITE|FGP_CREAT;
Johannes Weiner0faa70c2012-01-10 15:07:53 -08002775
Nick Piggin54566b22009-01-04 12:00:53 -08002776 if (flags & AOP_FLAG_NOFS)
Mel Gorman2457aec2014-06-04 16:10:31 -07002777 fgp_flags |= FGP_NOFS;
Nick Piggineb2be182007-10-16 01:24:57 -07002778
Mel Gorman2457aec2014-06-04 16:10:31 -07002779 page = pagecache_get_page(mapping, index, fgp_flags,
Michal Hocko45f87de2014-12-29 20:30:35 +01002780 mapping_gfp_mask(mapping));
Mel Gorman2457aec2014-06-04 16:10:31 -07002781 if (page)
2782 wait_for_stable_page(page);
2783
Nick Piggineb2be182007-10-16 01:24:57 -07002784 return page;
2785}
Nick Piggin54566b22009-01-04 12:00:53 -08002786EXPORT_SYMBOL(grab_cache_page_write_begin);
Nick Piggineb2be182007-10-16 01:24:57 -07002787
Al Viro3b93f912014-02-11 21:34:08 -05002788ssize_t generic_perform_write(struct file *file,
Nick Pigginafddba42007-10-16 01:25:01 -07002789 struct iov_iter *i, loff_t pos)
2790{
2791 struct address_space *mapping = file->f_mapping;
2792 const struct address_space_operations *a_ops = mapping->a_ops;
2793 long status = 0;
2794 ssize_t written = 0;
Nick Piggin674b8922007-10-16 01:25:03 -07002795 unsigned int flags = 0;
2796
2797 /*
2798 * Copies from kernel address space cannot fail (NFSD is a big user).
2799 */
Al Viro777eda22014-12-17 04:46:46 -05002800 if (!iter_is_iovec(i))
Nick Piggin674b8922007-10-16 01:25:03 -07002801 flags |= AOP_FLAG_UNINTERRUPTIBLE;
Nick Pigginafddba42007-10-16 01:25:01 -07002802
2803 do {
2804 struct page *page;
Nick Pigginafddba42007-10-16 01:25:01 -07002805 unsigned long offset; /* Offset into pagecache page */
2806 unsigned long bytes; /* Bytes to write to page */
2807 size_t copied; /* Bytes copied from user */
2808 void *fsdata;
2809
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002810 offset = (pos & (PAGE_SIZE - 1));
2811 bytes = min_t(unsigned long, PAGE_SIZE - offset,
Nick Pigginafddba42007-10-16 01:25:01 -07002812 iov_iter_count(i));
2813
2814again:
Linus Torvalds00a3d662015-10-07 08:32:38 +01002815 /*
2816 * Bring in the user page that we will copy from _first_.
2817 * Otherwise there's a nasty deadlock on copying from the
2818 * same page as we're writing to, without it being marked
2819 * up-to-date.
2820 *
2821 * Not only is this an optimisation, but it is also required
2822 * to check that the address is actually valid, when atomic
2823 * usercopies are used, below.
2824 */
2825 if (unlikely(iov_iter_fault_in_readable(i, bytes))) {
2826 status = -EFAULT;
2827 break;
2828 }
2829
Jan Kara296291c2015-10-22 13:32:21 -07002830 if (fatal_signal_pending(current)) {
2831 status = -EINTR;
2832 break;
2833 }
2834
Nick Piggin674b8922007-10-16 01:25:03 -07002835 status = a_ops->write_begin(file, mapping, pos, bytes, flags,
Nick Pigginafddba42007-10-16 01:25:01 -07002836 &page, &fsdata);
Mel Gorman2457aec2014-06-04 16:10:31 -07002837 if (unlikely(status < 0))
Nick Pigginafddba42007-10-16 01:25:01 -07002838 break;
2839
anfei zhou931e80e2010-02-02 13:44:02 -08002840 if (mapping_writably_mapped(mapping))
2841 flush_dcache_page(page);
Linus Torvalds00a3d662015-10-07 08:32:38 +01002842
Nick Pigginafddba42007-10-16 01:25:01 -07002843 copied = iov_iter_copy_from_user_atomic(page, i, offset, bytes);
Nick Pigginafddba42007-10-16 01:25:01 -07002844 flush_dcache_page(page);
2845
2846 status = a_ops->write_end(file, mapping, pos, bytes, copied,
2847 page, fsdata);
2848 if (unlikely(status < 0))
2849 break;
2850 copied = status;
2851
2852 cond_resched();
2853
Nick Piggin124d3b72008-02-02 15:01:17 +01002854 iov_iter_advance(i, copied);
Nick Pigginafddba42007-10-16 01:25:01 -07002855 if (unlikely(copied == 0)) {
2856 /*
2857 * If we were unable to copy any data at all, we must
2858 * fall back to a single segment length write.
2859 *
2860 * If we didn't fallback here, we could livelock
2861 * because not all segments in the iov can be copied at
2862 * once without a pagefault.
2863 */
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002864 bytes = min_t(unsigned long, PAGE_SIZE - offset,
Nick Pigginafddba42007-10-16 01:25:01 -07002865 iov_iter_single_seg_count(i));
2866 goto again;
2867 }
Nick Pigginafddba42007-10-16 01:25:01 -07002868 pos += copied;
2869 written += copied;
2870
2871 balance_dirty_pages_ratelimited(mapping);
Nick Pigginafddba42007-10-16 01:25:01 -07002872 } while (iov_iter_count(i));
2873
2874 return written ? written : status;
2875}
Al Viro3b93f912014-02-11 21:34:08 -05002876EXPORT_SYMBOL(generic_perform_write);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002877
Jan Karae4dd9de2009-08-17 18:10:06 +02002878/**
Al Viro81742022014-04-03 03:17:43 -04002879 * __generic_file_write_iter - write data to a file
Jan Karae4dd9de2009-08-17 18:10:06 +02002880 * @iocb: IO state structure (file, offset, etc.)
Al Viro81742022014-04-03 03:17:43 -04002881 * @from: iov_iter with data to write
Jan Karae4dd9de2009-08-17 18:10:06 +02002882 *
2883 * This function does all the work needed for actually writing data to a
2884 * file. It does all basic checks, removes SUID from the file, updates
2885 * modification times and calls proper subroutines depending on whether we
2886 * do direct IO or a standard buffered write.
2887 *
2888 * It expects i_mutex to be grabbed unless we work on a block device or similar
2889 * object which does not need locking at all.
2890 *
2891 * This function does *not* take care of syncing data in case of O_SYNC write.
2892 * A caller has to handle it. This is mainly due to the fact that we want to
2893 * avoid syncing under i_mutex.
2894 */
Al Viro81742022014-04-03 03:17:43 -04002895ssize_t __generic_file_write_iter(struct kiocb *iocb, struct iov_iter *from)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002896{
2897 struct file *file = iocb->ki_filp;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002898 struct address_space * mapping = file->f_mapping;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002899 struct inode *inode = mapping->host;
Al Viro3b93f912014-02-11 21:34:08 -05002900 ssize_t written = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002901 ssize_t err;
Al Viro3b93f912014-02-11 21:34:08 -05002902 ssize_t status;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002903
Linus Torvalds1da177e2005-04-16 15:20:36 -07002904 /* We can write back this queue in page reclaim */
Christoph Hellwigde1414a2015-01-14 10:42:36 +01002905 current->backing_dev_info = inode_to_bdi(inode);
Jan Kara5fa8e0a2015-05-21 16:05:53 +02002906 err = file_remove_privs(file);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002907 if (err)
2908 goto out;
2909
Josef Bacikc3b2da32012-03-26 09:59:21 -04002910 err = file_update_time(file);
2911 if (err)
2912 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002913
Al Viro2ba48ce2015-04-09 13:52:01 -04002914 if (iocb->ki_flags & IOCB_DIRECT) {
Al Viro0b8def92015-04-07 10:22:53 -04002915 loff_t pos, endbyte;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002916
Christoph Hellwig1af5bb42016-04-07 08:51:56 -07002917 written = generic_file_direct_write(iocb, from);
Matthew Wilcoxfbbbad42015-02-16 15:58:53 -08002918 /*
2919 * If the write stopped short of completing, fall back to
2920 * buffered writes. Some filesystems do this for writes to
2921 * holes, for example. For DAX files, a buffered write will
2922 * not succeed (even if it did, DAX does not handle dirty
2923 * page-cache pages correctly).
2924 */
Al Viro0b8def92015-04-07 10:22:53 -04002925 if (written < 0 || !iov_iter_count(from) || IS_DAX(inode))
Linus Torvalds1da177e2005-04-16 15:20:36 -07002926 goto out;
Al Viro3b93f912014-02-11 21:34:08 -05002927
Al Viro0b8def92015-04-07 10:22:53 -04002928 status = generic_perform_write(file, from, pos = iocb->ki_pos);
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002929 /*
Al Viro3b93f912014-02-11 21:34:08 -05002930 * If generic_perform_write() returned a synchronous error
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002931 * then we want to return the number of bytes which were
2932 * direct-written, or the error code if that was zero. Note
2933 * that this differs from normal direct-io semantics, which
2934 * will return -EFOO even if some bytes were written.
2935 */
Al Viro60bb4522014-08-08 12:39:16 -04002936 if (unlikely(status < 0)) {
Al Viro3b93f912014-02-11 21:34:08 -05002937 err = status;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002938 goto out;
2939 }
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002940 /*
2941 * We need to ensure that the page cache pages are written to
2942 * disk and invalidated to preserve the expected O_DIRECT
2943 * semantics.
2944 */
Al Viro3b93f912014-02-11 21:34:08 -05002945 endbyte = pos + status - 1;
Al Viro0b8def92015-04-07 10:22:53 -04002946 err = filemap_write_and_wait_range(mapping, pos, endbyte);
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002947 if (err == 0) {
Al Viro0b8def92015-04-07 10:22:53 -04002948 iocb->ki_pos = endbyte + 1;
Al Viro3b93f912014-02-11 21:34:08 -05002949 written += status;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002950 invalidate_mapping_pages(mapping,
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03002951 pos >> PAGE_SHIFT,
2952 endbyte >> PAGE_SHIFT);
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002953 } else {
2954 /*
2955 * We don't know how much we wrote, so just return
2956 * the number of bytes which were direct-written
2957 */
2958 }
2959 } else {
Al Viro0b8def92015-04-07 10:22:53 -04002960 written = generic_perform_write(file, from, iocb->ki_pos);
2961 if (likely(written > 0))
2962 iocb->ki_pos += written;
Jeff Moyerfb5527e2006-10-19 23:28:13 -07002963 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002964out:
2965 current->backing_dev_info = NULL;
2966 return written ? written : err;
2967}
Al Viro81742022014-04-03 03:17:43 -04002968EXPORT_SYMBOL(__generic_file_write_iter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002969
Jan Karae4dd9de2009-08-17 18:10:06 +02002970/**
Al Viro81742022014-04-03 03:17:43 -04002971 * generic_file_write_iter - write data to a file
Jan Karae4dd9de2009-08-17 18:10:06 +02002972 * @iocb: IO state structure
Al Viro81742022014-04-03 03:17:43 -04002973 * @from: iov_iter with data to write
Jan Karae4dd9de2009-08-17 18:10:06 +02002974 *
Al Viro81742022014-04-03 03:17:43 -04002975 * This is a wrapper around __generic_file_write_iter() to be used by most
Jan Karae4dd9de2009-08-17 18:10:06 +02002976 * filesystems. It takes care of syncing the file in case of O_SYNC file
2977 * and acquires i_mutex as needed.
2978 */
Al Viro81742022014-04-03 03:17:43 -04002979ssize_t generic_file_write_iter(struct kiocb *iocb, struct iov_iter *from)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002980{
2981 struct file *file = iocb->ki_filp;
Jan Kara148f9482009-08-17 19:52:36 +02002982 struct inode *inode = file->f_mapping->host;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002983 ssize_t ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002984
Al Viro59551022016-01-22 15:40:57 -05002985 inode_lock(inode);
Al Viro3309dd02015-04-09 12:55:47 -04002986 ret = generic_write_checks(iocb, from);
2987 if (ret > 0)
Al Viro5f380c72015-04-07 11:28:12 -04002988 ret = __generic_file_write_iter(iocb, from);
Al Viro59551022016-01-22 15:40:57 -05002989 inode_unlock(inode);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002990
Christoph Hellwige2592212016-04-07 08:52:01 -07002991 if (ret > 0)
2992 ret = generic_write_sync(iocb, ret);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002993 return ret;
2994}
Al Viro81742022014-04-03 03:17:43 -04002995EXPORT_SYMBOL(generic_file_write_iter);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002996
David Howellscf9a2ae2006-08-29 19:05:54 +01002997/**
2998 * try_to_release_page() - release old fs-specific metadata on a page
2999 *
3000 * @page: the page which the kernel is trying to free
3001 * @gfp_mask: memory allocation flags (and I/O mode)
3002 *
3003 * The address_space is to try to release any data against the page
3004 * (presumably at page->private). If the release was successful, return `1'.
3005 * Otherwise return zero.
3006 *
David Howells266cf652009-04-03 16:42:36 +01003007 * This may also be called if PG_fscache is set on a page, indicating that the
3008 * page is known to the local caching routines.
3009 *
David Howellscf9a2ae2006-08-29 19:05:54 +01003010 * The @gfp_mask argument specifies whether I/O may be performed to release
Mel Gorman71baba42015-11-06 16:28:28 -08003011 * this page (__GFP_IO), and whether the call may block (__GFP_RECLAIM & __GFP_FS).
David Howellscf9a2ae2006-08-29 19:05:54 +01003012 *
David Howellscf9a2ae2006-08-29 19:05:54 +01003013 */
3014int try_to_release_page(struct page *page, gfp_t gfp_mask)
3015{
3016 struct address_space * const mapping = page->mapping;
3017
3018 BUG_ON(!PageLocked(page));
3019 if (PageWriteback(page))
3020 return 0;
3021
3022 if (mapping && mapping->a_ops->releasepage)
3023 return mapping->a_ops->releasepage(page, gfp_mask);
3024 return try_to_free_buffers(page);
3025}
3026
3027EXPORT_SYMBOL(try_to_release_page);