truncate.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797
  1. /*
  2. * mm/truncate.c - code for taking down pages from address_spaces
  3. *
  4. * Copyright (C) 2002, Linus Torvalds
  5. *
  6. * 10Sep2002 Andrew Morton
  7. * Initial version.
  8. */
  9. #include <linux/kernel.h>
  10. #include <linux/backing-dev.h>
  11. #include <linux/gfp.h>
  12. #include <linux/mm.h>
  13. #include <linux/swap.h>
  14. #include <linux/export.h>
  15. #include <linux/pagemap.h>
  16. #include <linux/highmem.h>
  17. #include <linux/pagevec.h>
  18. #include <linux/task_io_accounting_ops.h>
  19. #include <linux/buffer_head.h> /* grr. try_to_release_page,
  20. do_invalidatepage */
  21. #include <linux/cleancache.h>
  22. #include <linux/rmap.h>
  23. #include "internal.h"
  24. static void clear_exceptional_entry(struct address_space *mapping,
  25. pgoff_t index, void *entry)
  26. {
  27. struct radix_tree_node *node;
  28. void **slot;
  29. /* Handled by shmem itself */
  30. if (shmem_mapping(mapping))
  31. return;
  32. spin_lock_irq(&mapping->tree_lock);
  33. /*
  34. * Regular page slots are stabilized by the page lock even
  35. * without the tree itself locked. These unlocked entries
  36. * need verification under the tree lock.
  37. */
  38. if (!__radix_tree_lookup(&mapping->page_tree, index, &node, &slot))
  39. goto unlock;
  40. if (*slot != entry)
  41. goto unlock;
  42. radix_tree_replace_slot(slot, NULL);
  43. mapping->nrshadows--;
  44. if (!node)
  45. goto unlock;
  46. workingset_node_shadows_dec(node);
  47. /*
  48. * Don't track node without shadow entries.
  49. *
  50. * Avoid acquiring the list_lru lock if already untracked.
  51. * The list_empty() test is safe as node->private_list is
  52. * protected by mapping->tree_lock.
  53. */
  54. if (!workingset_node_shadows(node) &&
  55. !list_empty(&node->private_list))
  56. list_lru_del(&workingset_shadow_nodes, &node->private_list);
  57. __radix_tree_delete_node(&mapping->page_tree, node);
  58. unlock:
  59. spin_unlock_irq(&mapping->tree_lock);
  60. }
  61. /**
  62. * do_invalidatepage - invalidate part or all of a page
  63. * @page: the page which is affected
  64. * @offset: start of the range to invalidate
  65. * @length: length of the range to invalidate
  66. *
  67. * do_invalidatepage() is called when all or part of the page has become
  68. * invalidated by a truncate operation.
  69. *
  70. * do_invalidatepage() does not have to release all buffers, but it must
  71. * ensure that no dirty buffer is left outside @offset and that no I/O
  72. * is underway against any of the blocks which are outside the truncation
  73. * point. Because the caller is about to free (and possibly reuse) those
  74. * blocks on-disk.
  75. */
  76. void do_invalidatepage(struct page *page, unsigned int offset,
  77. unsigned int length)
  78. {
  79. void (*invalidatepage)(struct page *, unsigned int, unsigned int);
  80. invalidatepage = page->mapping->a_ops->invalidatepage;
  81. #ifdef CONFIG_BLOCK
  82. if (!invalidatepage)
  83. invalidatepage = block_invalidatepage;
  84. #endif
  85. if (invalidatepage)
  86. (*invalidatepage)(page, offset, length);
  87. }
  88. /*
  89. * If truncate cannot remove the fs-private metadata from the page, the page
  90. * becomes orphaned. It will be left on the LRU and may even be mapped into
  91. * user pagetables if we're racing with filemap_fault().
  92. *
  93. * We need to bale out if page->mapping is no longer equal to the original
  94. * mapping. This happens a) when the VM reclaimed the page while we waited on
  95. * its lock, b) when a concurrent invalidate_mapping_pages got there first and
  96. * c) when tmpfs swizzles a page between a tmpfs inode and swapper_space.
  97. */
  98. static int
  99. truncate_complete_page(struct address_space *mapping, struct page *page)
  100. {
  101. if (page->mapping != mapping)
  102. return -EIO;
  103. if (page_has_private(page))
  104. do_invalidatepage(page, 0, PAGE_CACHE_SIZE);
  105. /*
  106. * Some filesystems seem to re-dirty the page even after
  107. * the VM has canceled the dirty bit (eg ext3 journaling).
  108. * Hence dirty accounting check is placed after invalidation.
  109. */
  110. if (TestClearPageDirty(page))
  111. account_page_cleaned(page, mapping);
  112. ClearPageMappedToDisk(page);
  113. delete_from_page_cache(page);
  114. return 0;
  115. }
  116. /*
  117. * This is for invalidate_mapping_pages(). That function can be called at
  118. * any time, and is not supposed to throw away dirty pages. But pages can
  119. * be marked dirty at any time too, so use remove_mapping which safely
  120. * discards clean, unused pages.
  121. *
  122. * Returns non-zero if the page was successfully invalidated.
  123. */
  124. static int
  125. invalidate_complete_page(struct address_space *mapping, struct page *page)
  126. {
  127. int ret;
  128. if (page->mapping != mapping)
  129. return 0;
  130. if (page_has_private(page) && !try_to_release_page(page, 0))
  131. return 0;
  132. ret = remove_mapping(mapping, page);
  133. return ret;
  134. }
  135. int truncate_inode_page(struct address_space *mapping, struct page *page)
  136. {
  137. if (page_mapped(page)) {
  138. unmap_mapping_range(mapping,
  139. (loff_t)page->index << PAGE_CACHE_SHIFT,
  140. PAGE_CACHE_SIZE, 0);
  141. }
  142. return truncate_complete_page(mapping, page);
  143. }
  144. /*
  145. * Used to get rid of pages on hardware memory corruption.
  146. */
  147. int generic_error_remove_page(struct address_space *mapping, struct page *page)
  148. {
  149. if (!mapping)
  150. return -EINVAL;
  151. /*
  152. * Only punch for normal data pages for now.
  153. * Handling other types like directories would need more auditing.
  154. */
  155. if (!S_ISREG(mapping->host->i_mode))
  156. return -EIO;
  157. return truncate_inode_page(mapping, page);
  158. }
  159. EXPORT_SYMBOL(generic_error_remove_page);
  160. /*
  161. * Safely invalidate one page from its pagecache mapping.
  162. * It only drops clean, unused pages. The page must be locked.
  163. *
  164. * Returns 1 if the page is successfully invalidated, otherwise 0.
  165. */
  166. int invalidate_inode_page(struct page *page)
  167. {
  168. struct address_space *mapping = page_mapping(page);
  169. if (!mapping)
  170. return 0;
  171. if (PageDirty(page) || PageWriteback(page))
  172. return 0;
  173. if (page_mapped(page))
  174. return 0;
  175. return invalidate_complete_page(mapping, page);
  176. }
  177. /**
  178. * truncate_inode_pages_range - truncate range of pages specified by start & end byte offsets
  179. * @mapping: mapping to truncate
  180. * @lstart: offset from which to truncate
  181. * @lend: offset to which to truncate (inclusive)
  182. *
  183. * Truncate the page cache, removing the pages that are between
  184. * specified offsets (and zeroing out partial pages
  185. * if lstart or lend + 1 is not page aligned).
  186. *
  187. * Truncate takes two passes - the first pass is nonblocking. It will not
  188. * block on page locks and it will not block on writeback. The second pass
  189. * will wait. This is to prevent as much IO as possible in the affected region.
  190. * The first pass will remove most pages, so the search cost of the second pass
  191. * is low.
  192. *
  193. * We pass down the cache-hot hint to the page freeing code. Even if the
  194. * mapping is large, it is probably the case that the final pages are the most
  195. * recently touched, and freeing happens in ascending file offset order.
  196. *
  197. * Note that since ->invalidatepage() accepts range to invalidate
  198. * truncate_inode_pages_range is able to handle cases where lend + 1 is not
  199. * page aligned properly.
  200. */
  201. void truncate_inode_pages_range(struct address_space *mapping,
  202. loff_t lstart, loff_t lend)
  203. {
  204. pgoff_t start; /* inclusive */
  205. pgoff_t end; /* exclusive */
  206. unsigned int partial_start; /* inclusive */
  207. unsigned int partial_end; /* exclusive */
  208. struct pagevec pvec;
  209. pgoff_t indices[PAGEVEC_SIZE];
  210. pgoff_t index;
  211. int i;
  212. cleancache_invalidate_inode(mapping);
  213. if (mapping->nrpages == 0 && mapping->nrshadows == 0)
  214. return;
  215. /* Offsets within partial pages */
  216. partial_start = lstart & (PAGE_CACHE_SIZE - 1);
  217. partial_end = (lend + 1) & (PAGE_CACHE_SIZE - 1);
  218. /*
  219. * 'start' and 'end' always covers the range of pages to be fully
  220. * truncated. Partial pages are covered with 'partial_start' at the
  221. * start of the range and 'partial_end' at the end of the range.
  222. * Note that 'end' is exclusive while 'lend' is inclusive.
  223. */
  224. start = (lstart + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
  225. if (lend == -1)
  226. /*
  227. * lend == -1 indicates end-of-file so we have to set 'end'
  228. * to the highest possible pgoff_t and since the type is
  229. * unsigned we're using -1.
  230. */
  231. end = -1;
  232. else
  233. end = (lend + 1) >> PAGE_CACHE_SHIFT;
  234. pagevec_init(&pvec, 0);
  235. index = start;
  236. while (index < end && pagevec_lookup_entries(&pvec, mapping, index,
  237. min(end - index, (pgoff_t)PAGEVEC_SIZE),
  238. indices)) {
  239. for (i = 0; i < pagevec_count(&pvec); i++) {
  240. struct page *page = pvec.pages[i];
  241. /* We rely upon deletion not changing page->index */
  242. index = indices[i];
  243. if (index >= end)
  244. break;
  245. if (radix_tree_exceptional_entry(page)) {
  246. clear_exceptional_entry(mapping, index, page);
  247. continue;
  248. }
  249. if (!trylock_page(page))
  250. continue;
  251. WARN_ON(page->index != index);
  252. if (PageWriteback(page)) {
  253. unlock_page(page);
  254. continue;
  255. }
  256. truncate_inode_page(mapping, page);
  257. unlock_page(page);
  258. }
  259. pagevec_remove_exceptionals(&pvec);
  260. pagevec_release(&pvec);
  261. cond_resched();
  262. index++;
  263. }
  264. if (partial_start) {
  265. struct page *page = find_lock_page(mapping, start - 1);
  266. if (page) {
  267. unsigned int top = PAGE_CACHE_SIZE;
  268. if (start > end) {
  269. /* Truncation within a single page */
  270. top = partial_end;
  271. partial_end = 0;
  272. }
  273. wait_on_page_writeback(page);
  274. zero_user_segment(page, partial_start, top);
  275. cleancache_invalidate_page(mapping, page);
  276. if (page_has_private(page))
  277. do_invalidatepage(page, partial_start,
  278. top - partial_start);
  279. unlock_page(page);
  280. page_cache_release(page);
  281. }
  282. }
  283. if (partial_end) {
  284. struct page *page = find_lock_page(mapping, end);
  285. if (page) {
  286. wait_on_page_writeback(page);
  287. zero_user_segment(page, 0, partial_end);
  288. cleancache_invalidate_page(mapping, page);
  289. if (page_has_private(page))
  290. do_invalidatepage(page, 0,
  291. partial_end);
  292. unlock_page(page);
  293. page_cache_release(page);
  294. }
  295. }
  296. /*
  297. * If the truncation happened within a single page no pages
  298. * will be released, just zeroed, so we can bail out now.
  299. */
  300. if (start >= end)
  301. return;
  302. index = start;
  303. for ( ; ; ) {
  304. cond_resched();
  305. if (!pagevec_lookup_entries(&pvec, mapping, index,
  306. min(end - index, (pgoff_t)PAGEVEC_SIZE), indices)) {
  307. /* If all gone from start onwards, we're done */
  308. if (index == start)
  309. break;
  310. /* Otherwise restart to make sure all gone */
  311. index = start;
  312. continue;
  313. }
  314. if (index == start && indices[0] >= end) {
  315. /* All gone out of hole to be punched, we're done */
  316. pagevec_remove_exceptionals(&pvec);
  317. pagevec_release(&pvec);
  318. break;
  319. }
  320. for (i = 0; i < pagevec_count(&pvec); i++) {
  321. struct page *page = pvec.pages[i];
  322. /* We rely upon deletion not changing page->index */
  323. index = indices[i];
  324. if (index >= end) {
  325. /* Restart punch to make sure all gone */
  326. index = start - 1;
  327. break;
  328. }
  329. if (radix_tree_exceptional_entry(page)) {
  330. clear_exceptional_entry(mapping, index, page);
  331. continue;
  332. }
  333. lock_page(page);
  334. WARN_ON(page->index != index);
  335. wait_on_page_writeback(page);
  336. truncate_inode_page(mapping, page);
  337. unlock_page(page);
  338. }
  339. pagevec_remove_exceptionals(&pvec);
  340. pagevec_release(&pvec);
  341. index++;
  342. }
  343. cleancache_invalidate_inode(mapping);
  344. }
  345. EXPORT_SYMBOL(truncate_inode_pages_range);
  346. /**
  347. * truncate_inode_pages - truncate *all* the pages from an offset
  348. * @mapping: mapping to truncate
  349. * @lstart: offset from which to truncate
  350. *
  351. * Called under (and serialised by) inode->i_mutex.
  352. *
  353. * Note: When this function returns, there can be a page in the process of
  354. * deletion (inside __delete_from_page_cache()) in the specified range. Thus
  355. * mapping->nrpages can be non-zero when this function returns even after
  356. * truncation of the whole mapping.
  357. */
  358. void truncate_inode_pages(struct address_space *mapping, loff_t lstart)
  359. {
  360. truncate_inode_pages_range(mapping, lstart, (loff_t)-1);
  361. }
  362. EXPORT_SYMBOL(truncate_inode_pages);
  363. /**
  364. * truncate_inode_pages_final - truncate *all* pages before inode dies
  365. * @mapping: mapping to truncate
  366. *
  367. * Called under (and serialized by) inode->i_mutex.
  368. *
  369. * Filesystems have to use this in the .evict_inode path to inform the
  370. * VM that this is the final truncate and the inode is going away.
  371. */
  372. void truncate_inode_pages_final(struct address_space *mapping)
  373. {
  374. unsigned long nrshadows;
  375. unsigned long nrpages;
  376. /*
  377. * Page reclaim can not participate in regular inode lifetime
  378. * management (can't call iput()) and thus can race with the
  379. * inode teardown. Tell it when the address space is exiting,
  380. * so that it does not install eviction information after the
  381. * final truncate has begun.
  382. */
  383. mapping_set_exiting(mapping);
  384. /*
  385. * When reclaim installs eviction entries, it increases
  386. * nrshadows first, then decreases nrpages. Make sure we see
  387. * this in the right order or we might miss an entry.
  388. */
  389. nrpages = mapping->nrpages;
  390. smp_rmb();
  391. nrshadows = mapping->nrshadows;
  392. if (nrpages || nrshadows) {
  393. /*
  394. * As truncation uses a lockless tree lookup, cycle
  395. * the tree lock to make sure any ongoing tree
  396. * modification that does not see AS_EXITING is
  397. * completed before starting the final truncate.
  398. */
  399. spin_lock_irq(&mapping->tree_lock);
  400. spin_unlock_irq(&mapping->tree_lock);
  401. truncate_inode_pages(mapping, 0);
  402. }
  403. }
  404. EXPORT_SYMBOL(truncate_inode_pages_final);
  405. /**
  406. * invalidate_mapping_pages - Invalidate all the unlocked pages of one inode
  407. * @mapping: the address_space which holds the pages to invalidate
  408. * @start: the offset 'from' which to invalidate
  409. * @end: the offset 'to' which to invalidate (inclusive)
  410. *
  411. * This function only removes the unlocked pages, if you want to
  412. * remove all the pages of one inode, you must call truncate_inode_pages.
  413. *
  414. * invalidate_mapping_pages() will not block on IO activity. It will not
  415. * invalidate pages which are dirty, locked, under writeback or mapped into
  416. * pagetables.
  417. */
  418. unsigned long invalidate_mapping_pages(struct address_space *mapping,
  419. pgoff_t start, pgoff_t end)
  420. {
  421. pgoff_t indices[PAGEVEC_SIZE];
  422. struct pagevec pvec;
  423. pgoff_t index = start;
  424. unsigned long ret;
  425. unsigned long count = 0;
  426. int i;
  427. pagevec_init(&pvec, 0);
  428. while (index <= end && pagevec_lookup_entries(&pvec, mapping, index,
  429. min(end - index, (pgoff_t)PAGEVEC_SIZE - 1) + 1,
  430. indices)) {
  431. for (i = 0; i < pagevec_count(&pvec); i++) {
  432. struct page *page = pvec.pages[i];
  433. /* We rely upon deletion not changing page->index */
  434. index = indices[i];
  435. if (index > end)
  436. break;
  437. if (radix_tree_exceptional_entry(page)) {
  438. clear_exceptional_entry(mapping, index, page);
  439. continue;
  440. }
  441. if (!trylock_page(page))
  442. continue;
  443. WARN_ON(page->index != index);
  444. ret = invalidate_inode_page(page);
  445. unlock_page(page);
  446. /*
  447. * Invalidation is a hint that the page is no longer
  448. * of interest and try to speed up its reclaim.
  449. */
  450. if (!ret)
  451. deactivate_file_page(page);
  452. count += ret;
  453. }
  454. pagevec_remove_exceptionals(&pvec);
  455. pagevec_release(&pvec);
  456. cond_resched();
  457. index++;
  458. }
  459. return count;
  460. }
  461. EXPORT_SYMBOL(invalidate_mapping_pages);
  462. /*
  463. * This is like invalidate_complete_page(), except it ignores the page's
  464. * refcount. We do this because invalidate_inode_pages2() needs stronger
  465. * invalidation guarantees, and cannot afford to leave pages behind because
  466. * shrink_page_list() has a temp ref on them, or because they're transiently
  467. * sitting in the lru_cache_add() pagevecs.
  468. */
  469. static int
  470. invalidate_complete_page2(struct address_space *mapping, struct page *page)
  471. {
  472. if (page->mapping != mapping)
  473. return 0;
  474. if (page_has_private(page) && !try_to_release_page(page, GFP_KERNEL))
  475. return 0;
  476. spin_lock_irq(&mapping->tree_lock);
  477. if (PageDirty(page))
  478. goto failed;
  479. BUG_ON(page_has_private(page));
  480. __delete_from_page_cache(page, NULL);
  481. spin_unlock_irq(&mapping->tree_lock);
  482. if (mapping->a_ops->freepage)
  483. mapping->a_ops->freepage(page);
  484. page_cache_release(page); /* pagecache ref */
  485. return 1;
  486. failed:
  487. spin_unlock_irq(&mapping->tree_lock);
  488. return 0;
  489. }
  490. static int do_launder_page(struct address_space *mapping, struct page *page)
  491. {
  492. if (!PageDirty(page))
  493. return 0;
  494. if (page->mapping != mapping || mapping->a_ops->launder_page == NULL)
  495. return 0;
  496. return mapping->a_ops->launder_page(page);
  497. }
  498. /**
  499. * invalidate_inode_pages2_range - remove range of pages from an address_space
  500. * @mapping: the address_space
  501. * @start: the page offset 'from' which to invalidate
  502. * @end: the page offset 'to' which to invalidate (inclusive)
  503. *
  504. * Any pages which are found to be mapped into pagetables are unmapped prior to
  505. * invalidation.
  506. *
  507. * Returns -EBUSY if any pages could not be invalidated.
  508. */
  509. int invalidate_inode_pages2_range(struct address_space *mapping,
  510. pgoff_t start, pgoff_t end)
  511. {
  512. pgoff_t indices[PAGEVEC_SIZE];
  513. struct pagevec pvec;
  514. pgoff_t index;
  515. int i;
  516. int ret = 0;
  517. int ret2 = 0;
  518. int did_range_unmap = 0;
  519. cleancache_invalidate_inode(mapping);
  520. pagevec_init(&pvec, 0);
  521. index = start;
  522. while (index <= end && pagevec_lookup_entries(&pvec, mapping, index,
  523. min(end - index, (pgoff_t)PAGEVEC_SIZE - 1) + 1,
  524. indices)) {
  525. for (i = 0; i < pagevec_count(&pvec); i++) {
  526. struct page *page = pvec.pages[i];
  527. /* We rely upon deletion not changing page->index */
  528. index = indices[i];
  529. if (index > end)
  530. break;
  531. if (radix_tree_exceptional_entry(page)) {
  532. clear_exceptional_entry(mapping, index, page);
  533. continue;
  534. }
  535. lock_page(page);
  536. WARN_ON(page->index != index);
  537. if (page->mapping != mapping) {
  538. unlock_page(page);
  539. continue;
  540. }
  541. wait_on_page_writeback(page);
  542. if (page_mapped(page)) {
  543. if (!did_range_unmap) {
  544. /*
  545. * Zap the rest of the file in one hit.
  546. */
  547. unmap_mapping_range(mapping,
  548. (loff_t)index << PAGE_CACHE_SHIFT,
  549. (loff_t)(1 + end - index)
  550. << PAGE_CACHE_SHIFT,
  551. 0);
  552. did_range_unmap = 1;
  553. } else {
  554. /*
  555. * Just zap this page
  556. */
  557. unmap_mapping_range(mapping,
  558. (loff_t)index << PAGE_CACHE_SHIFT,
  559. PAGE_CACHE_SIZE, 0);
  560. }
  561. }
  562. BUG_ON(page_mapped(page));
  563. ret2 = do_launder_page(mapping, page);
  564. if (ret2 == 0) {
  565. if (!invalidate_complete_page2(mapping, page))
  566. ret2 = -EBUSY;
  567. }
  568. if (ret2 < 0)
  569. ret = ret2;
  570. unlock_page(page);
  571. }
  572. pagevec_remove_exceptionals(&pvec);
  573. pagevec_release(&pvec);
  574. cond_resched();
  575. index++;
  576. }
  577. cleancache_invalidate_inode(mapping);
  578. return ret;
  579. }
  580. EXPORT_SYMBOL_GPL(invalidate_inode_pages2_range);
  581. /**
  582. * invalidate_inode_pages2 - remove all pages from an address_space
  583. * @mapping: the address_space
  584. *
  585. * Any pages which are found to be mapped into pagetables are unmapped prior to
  586. * invalidation.
  587. *
  588. * Returns -EBUSY if any pages could not be invalidated.
  589. */
  590. int invalidate_inode_pages2(struct address_space *mapping)
  591. {
  592. return invalidate_inode_pages2_range(mapping, 0, -1);
  593. }
  594. EXPORT_SYMBOL_GPL(invalidate_inode_pages2);
  595. /**
  596. * truncate_pagecache - unmap and remove pagecache that has been truncated
  597. * @inode: inode
  598. * @newsize: new file size
  599. *
  600. * inode's new i_size must already be written before truncate_pagecache
  601. * is called.
  602. *
  603. * This function should typically be called before the filesystem
  604. * releases resources associated with the freed range (eg. deallocates
  605. * blocks). This way, pagecache will always stay logically coherent
  606. * with on-disk format, and the filesystem would not have to deal with
  607. * situations such as writepage being called for a page that has already
  608. * had its underlying blocks deallocated.
  609. */
  610. void truncate_pagecache(struct inode *inode, loff_t newsize)
  611. {
  612. struct address_space *mapping = inode->i_mapping;
  613. loff_t holebegin = round_up(newsize, PAGE_SIZE);
  614. /*
  615. * unmap_mapping_range is called twice, first simply for
  616. * efficiency so that truncate_inode_pages does fewer
  617. * single-page unmaps. However after this first call, and
  618. * before truncate_inode_pages finishes, it is possible for
  619. * private pages to be COWed, which remain after
  620. * truncate_inode_pages finishes, hence the second
  621. * unmap_mapping_range call must be made for correctness.
  622. */
  623. unmap_mapping_range(mapping, holebegin, 0, 1);
  624. truncate_inode_pages(mapping, newsize);
  625. unmap_mapping_range(mapping, holebegin, 0, 1);
  626. }
  627. EXPORT_SYMBOL(truncate_pagecache);
  628. /**
  629. * truncate_setsize - update inode and pagecache for a new file size
  630. * @inode: inode
  631. * @newsize: new file size
  632. *
  633. * truncate_setsize updates i_size and performs pagecache truncation (if
  634. * necessary) to @newsize. It will be typically be called from the filesystem's
  635. * setattr function when ATTR_SIZE is passed in.
  636. *
  637. * Must be called with a lock serializing truncates and writes (generally
  638. * i_mutex but e.g. xfs uses a different lock) and before all filesystem
  639. * specific block truncation has been performed.
  640. */
  641. void truncate_setsize(struct inode *inode, loff_t newsize)
  642. {
  643. loff_t oldsize = inode->i_size;
  644. i_size_write(inode, newsize);
  645. if (newsize > oldsize)
  646. pagecache_isize_extended(inode, oldsize, newsize);
  647. truncate_pagecache(inode, newsize);
  648. }
  649. EXPORT_SYMBOL(truncate_setsize);
  650. /**
  651. * pagecache_isize_extended - update pagecache after extension of i_size
  652. * @inode: inode for which i_size was extended
  653. * @from: original inode size
  654. * @to: new inode size
  655. *
  656. * Handle extension of inode size either caused by extending truncate or by
  657. * write starting after current i_size. We mark the page straddling current
  658. * i_size RO so that page_mkwrite() is called on the nearest write access to
  659. * the page. This way filesystem can be sure that page_mkwrite() is called on
  660. * the page before user writes to the page via mmap after the i_size has been
  661. * changed.
  662. *
  663. * The function must be called after i_size is updated so that page fault
  664. * coming after we unlock the page will already see the new i_size.
  665. * The function must be called while we still hold i_mutex - this not only
  666. * makes sure i_size is stable but also that userspace cannot observe new
  667. * i_size value before we are prepared to store mmap writes at new inode size.
  668. */
  669. void pagecache_isize_extended(struct inode *inode, loff_t from, loff_t to)
  670. {
  671. int bsize = 1 << inode->i_blkbits;
  672. loff_t rounded_from;
  673. struct page *page;
  674. pgoff_t index;
  675. WARN_ON(to > inode->i_size);
  676. if (from >= to || bsize == PAGE_CACHE_SIZE)
  677. return;
  678. /* Page straddling @from will not have any hole block created? */
  679. rounded_from = round_up(from, bsize);
  680. if (to <= rounded_from || !(rounded_from & (PAGE_CACHE_SIZE - 1)))
  681. return;
  682. index = from >> PAGE_CACHE_SHIFT;
  683. page = find_lock_page(inode->i_mapping, index);
  684. /* Page not cached? Nothing to do */
  685. if (!page)
  686. return;
  687. /*
  688. * See clear_page_dirty_for_io() for details why set_page_dirty()
  689. * is needed.
  690. */
  691. if (page_mkclean(page))
  692. set_page_dirty(page);
  693. unlock_page(page);
  694. page_cache_release(page);
  695. }
  696. EXPORT_SYMBOL(pagecache_isize_extended);
  697. /**
  698. * truncate_pagecache_range - unmap and remove pagecache that is hole-punched
  699. * @inode: inode
  700. * @lstart: offset of beginning of hole
  701. * @lend: offset of last byte of hole
  702. *
  703. * This function should typically be called before the filesystem
  704. * releases resources associated with the freed range (eg. deallocates
  705. * blocks). This way, pagecache will always stay logically coherent
  706. * with on-disk format, and the filesystem would not have to deal with
  707. * situations such as writepage being called for a page that has already
  708. * had its underlying blocks deallocated.
  709. */
  710. void truncate_pagecache_range(struct inode *inode, loff_t lstart, loff_t lend)
  711. {
  712. struct address_space *mapping = inode->i_mapping;
  713. loff_t unmap_start = round_up(lstart, PAGE_SIZE);
  714. loff_t unmap_end = round_down(1 + lend, PAGE_SIZE) - 1;
  715. /*
  716. * This rounding is currently just for example: unmap_mapping_range
  717. * expands its hole outwards, whereas we want it to contract the hole
  718. * inwards. However, existing callers of truncate_pagecache_range are
  719. * doing their own page rounding first. Note that unmap_mapping_range
  720. * allows holelen 0 for all, and we allow lend -1 for end of file.
  721. */
  722. /*
  723. * Unlike in truncate_pagecache, unmap_mapping_range is called only
  724. * once (before truncating pagecache), and without "even_cows" flag:
  725. * hole-punching should not remove private COWed pages from the hole.
  726. */
  727. if ((u64)unmap_end > (u64)unmap_start)
  728. unmap_mapping_range(mapping, unmap_start,
  729. 1 + unmap_end - unmap_start, 0);
  730. truncate_inode_pages_range(mapping, lstart, lend);
  731. }
  732. EXPORT_SYMBOL(truncate_pagecache_range);