1 // SPDX-License-Identifier: GPL-2.0+
3 * Buffer/page management specific to NILFS
5 * Copyright (C) 2005-2008 Nippon Telegraph and Telephone Corporation.
7 * Written by Ryusuke Konishi and Seiji Kihara.
10 #include <linux/pagemap.h>
11 #include <linux/writeback.h>
12 #include <linux/swap.h>
13 #include <linux/bitops.h>
14 #include <linux/page-flags.h>
15 #include <linux/list.h>
16 #include <linux/highmem.h>
17 #include <linux/pagevec.h>
18 #include <linux/gfp.h>
24 #define NILFS_BUFFER_INHERENT_BITS \
25 (BIT(BH_Uptodate) | BIT(BH_Mapped) | BIT(BH_NILFS_Node) | \
26 BIT(BH_NILFS_Volatile) | BIT(BH_NILFS_Checked))
28 static struct buffer_head *__nilfs_get_folio_block(struct folio *folio,
29 unsigned long block, pgoff_t index, int blkbits,
30 unsigned long b_state)
33 unsigned long first_block;
34 struct buffer_head *bh = folio_buffers(folio);
37 bh = create_empty_buffers(folio, 1 << blkbits, b_state);
39 first_block = (unsigned long)index << (PAGE_SHIFT - blkbits);
40 bh = get_nth_bh(bh, block - first_block);
46 struct buffer_head *nilfs_grab_buffer(struct inode *inode,
47 struct address_space *mapping,
49 unsigned long b_state)
51 int blkbits = inode->i_blkbits;
52 pgoff_t index = blkoff >> (PAGE_SHIFT - blkbits);
54 struct buffer_head *bh;
56 folio = filemap_grab_folio(mapping, index);
60 bh = __nilfs_get_folio_block(folio, blkoff, index, blkbits, b_state);
66 bh->b_bdev = inode->i_sb->s_bdev;
71 * nilfs_forget_buffer - discard dirty state
72 * @bh: buffer head of the buffer to be discarded
74 void nilfs_forget_buffer(struct buffer_head *bh)
76 struct folio *folio = bh->b_folio;
77 const unsigned long clear_bits =
78 (BIT(BH_Uptodate) | BIT(BH_Dirty) | BIT(BH_Mapped) |
79 BIT(BH_Async_Write) | BIT(BH_NILFS_Volatile) |
80 BIT(BH_NILFS_Checked) | BIT(BH_NILFS_Redirected) |
84 set_mask_bits(&bh->b_state, clear_bits, 0);
85 if (nilfs_folio_buffers_clean(folio))
86 __nilfs_clear_folio_dirty(folio);
89 folio_clear_uptodate(folio);
90 folio_clear_mappedtodisk(folio);
96 * nilfs_copy_buffer -- copy buffer data and flags
97 * @dbh: destination buffer
100 void nilfs_copy_buffer(struct buffer_head *dbh, struct buffer_head *sbh)
104 struct folio *sfolio = sbh->b_folio, *dfolio = dbh->b_folio;
105 struct buffer_head *bh;
107 saddr = kmap_local_folio(sfolio, bh_offset(sbh));
108 daddr = kmap_local_folio(dfolio, bh_offset(dbh));
109 memcpy(daddr, saddr, sbh->b_size);
113 dbh->b_state = sbh->b_state & NILFS_BUFFER_INHERENT_BITS;
114 dbh->b_blocknr = sbh->b_blocknr;
115 dbh->b_bdev = sbh->b_bdev;
118 bits = sbh->b_state & (BIT(BH_Uptodate) | BIT(BH_Mapped));
119 while ((bh = bh->b_this_page) != dbh) {
124 if (bits & BIT(BH_Uptodate))
125 folio_mark_uptodate(dfolio);
127 folio_clear_uptodate(dfolio);
128 if (bits & BIT(BH_Mapped))
129 folio_set_mappedtodisk(dfolio);
131 folio_clear_mappedtodisk(dfolio);
135 * nilfs_folio_buffers_clean - Check if a folio has dirty buffers or not.
136 * @folio: Folio to be checked.
138 * Return: false if the folio has dirty buffers, true otherwise.
140 bool nilfs_folio_buffers_clean(struct folio *folio)
142 struct buffer_head *bh, *head;
144 bh = head = folio_buffers(folio);
146 if (buffer_dirty(bh))
148 bh = bh->b_this_page;
149 } while (bh != head);
153 void nilfs_folio_bug(struct folio *folio)
155 struct buffer_head *bh, *head;
156 struct address_space *m;
159 if (unlikely(!folio)) {
160 printk(KERN_CRIT "NILFS_FOLIO_BUG(NULL)\n");
165 ino = m ? m->host->i_ino : 0;
167 printk(KERN_CRIT "NILFS_FOLIO_BUG(%p): cnt=%d index#=%llu flags=0x%lx "
168 "mapping=%p ino=%lu\n",
169 folio, folio_ref_count(folio),
170 (unsigned long long)folio->index, folio->flags, m, ino);
172 head = folio_buffers(folio);
179 " BH[%d] %p: cnt=%d block#=%llu state=0x%lx\n",
180 i++, bh, atomic_read(&bh->b_count),
181 (unsigned long long)bh->b_blocknr, bh->b_state);
182 bh = bh->b_this_page;
183 } while (bh != head);
188 * nilfs_copy_folio -- copy the folio with buffers
189 * @dst: destination folio
191 * @copy_dirty: flag whether to copy dirty states on the folio's buffer heads.
193 * This function is for both data folios and btnode folios. The dirty flag
194 * should be treated by caller. The folio must not be under i/o.
195 * Both src and dst folio must be locked
197 static void nilfs_copy_folio(struct folio *dst, struct folio *src,
200 struct buffer_head *dbh, *dbufs, *sbh;
201 unsigned long mask = NILFS_BUFFER_INHERENT_BITS;
203 BUG_ON(folio_test_writeback(dst));
205 sbh = folio_buffers(src);
206 dbh = folio_buffers(dst);
208 dbh = create_empty_buffers(dst, sbh->b_size, 0);
211 mask |= BIT(BH_Dirty);
217 dbh->b_state = sbh->b_state & mask;
218 dbh->b_blocknr = sbh->b_blocknr;
219 dbh->b_bdev = sbh->b_bdev;
220 sbh = sbh->b_this_page;
221 dbh = dbh->b_this_page;
222 } while (dbh != dbufs);
224 folio_copy(dst, src);
226 if (folio_test_uptodate(src) && !folio_test_uptodate(dst))
227 folio_mark_uptodate(dst);
228 else if (!folio_test_uptodate(src) && folio_test_uptodate(dst))
229 folio_clear_uptodate(dst);
230 if (folio_test_mappedtodisk(src) && !folio_test_mappedtodisk(dst))
231 folio_set_mappedtodisk(dst);
232 else if (!folio_test_mappedtodisk(src) && folio_test_mappedtodisk(dst))
233 folio_clear_mappedtodisk(dst);
238 sbh = sbh->b_this_page;
239 dbh = dbh->b_this_page;
240 } while (dbh != dbufs);
243 int nilfs_copy_dirty_pages(struct address_space *dmap,
244 struct address_space *smap)
246 struct folio_batch fbatch;
251 folio_batch_init(&fbatch);
253 if (!filemap_get_folios_tag(smap, &index, (pgoff_t)-1,
254 PAGECACHE_TAG_DIRTY, &fbatch))
257 for (i = 0; i < folio_batch_count(&fbatch); i++) {
258 struct folio *folio = fbatch.folios[i], *dfolio;
261 if (unlikely(!folio_test_dirty(folio)))
262 NILFS_FOLIO_BUG(folio, "inconsistent dirty state");
264 dfolio = filemap_grab_folio(dmap, folio->index);
265 if (IS_ERR(dfolio)) {
266 /* No empty page is added to the page cache */
268 err = PTR_ERR(dfolio);
271 if (unlikely(!folio_buffers(folio)))
272 NILFS_FOLIO_BUG(folio,
273 "found empty page in dat page cache");
275 nilfs_copy_folio(dfolio, folio, true);
276 filemap_dirty_folio(folio_mapping(dfolio), dfolio);
278 folio_unlock(dfolio);
282 folio_batch_release(&fbatch);
291 * nilfs_copy_back_pages -- copy back pages to original cache from shadow cache
292 * @dmap: destination page cache
293 * @smap: source page cache
295 * No pages must be added to the cache during this process.
296 * This must be ensured by the caller.
298 void nilfs_copy_back_pages(struct address_space *dmap,
299 struct address_space *smap)
301 struct folio_batch fbatch;
305 folio_batch_init(&fbatch);
307 n = filemap_get_folios(smap, &start, ~0UL, &fbatch);
311 for (i = 0; i < folio_batch_count(&fbatch); i++) {
312 struct folio *folio = fbatch.folios[i], *dfolio;
313 pgoff_t index = folio->index;
316 dfolio = filemap_lock_folio(dmap, index);
317 if (!IS_ERR(dfolio)) {
318 /* overwrite existing folio in the destination cache */
319 WARN_ON(folio_test_dirty(dfolio));
320 nilfs_copy_folio(dfolio, folio, false);
321 folio_unlock(dfolio);
323 /* Do we not need to remove folio from smap here? */
327 /* move the folio to the destination cache */
328 xa_lock_irq(&smap->i_pages);
329 f = __xa_erase(&smap->i_pages, index);
332 xa_unlock_irq(&smap->i_pages);
334 xa_lock_irq(&dmap->i_pages);
335 f = __xa_store(&dmap->i_pages, index, folio, GFP_NOFS);
337 /* Probably -ENOMEM */
338 folio->mapping = NULL;
341 folio->mapping = dmap;
343 if (folio_test_dirty(folio))
344 __xa_set_mark(&dmap->i_pages, index,
345 PAGECACHE_TAG_DIRTY);
347 xa_unlock_irq(&dmap->i_pages);
351 folio_batch_release(&fbatch);
358 * nilfs_clear_dirty_pages - discard dirty pages in address space
359 * @mapping: address space with dirty pages for discarding
361 void nilfs_clear_dirty_pages(struct address_space *mapping)
363 struct folio_batch fbatch;
367 folio_batch_init(&fbatch);
369 while (filemap_get_folios_tag(mapping, &index, (pgoff_t)-1,
370 PAGECACHE_TAG_DIRTY, &fbatch)) {
371 for (i = 0; i < folio_batch_count(&fbatch); i++) {
372 struct folio *folio = fbatch.folios[i];
377 * This folio may have been removed from the address
378 * space by truncation or invalidation when the lock
379 * was acquired. Skip processing in that case.
381 if (likely(folio->mapping == mapping))
382 nilfs_clear_folio_dirty(folio);
386 folio_batch_release(&fbatch);
392 * nilfs_clear_folio_dirty - discard dirty folio
393 * @folio: dirty folio that will be discarded
395 * nilfs_clear_folio_dirty() clears working states including dirty state for
396 * the folio and its buffers. If the folio has buffers, clear only if it is
397 * confirmed that none of the buffer heads are busy (none have valid
398 * references and none are locked).
400 void nilfs_clear_folio_dirty(struct folio *folio)
402 struct buffer_head *bh, *head;
404 BUG_ON(!folio_test_locked(folio));
406 head = folio_buffers(folio);
408 const unsigned long clear_bits =
409 (BIT(BH_Uptodate) | BIT(BH_Dirty) | BIT(BH_Mapped) |
410 BIT(BH_Async_Write) | BIT(BH_NILFS_Volatile) |
411 BIT(BH_NILFS_Checked) | BIT(BH_NILFS_Redirected) |
413 bool busy, invalidated = false;
419 if (atomic_read(&bh->b_count) | buffer_locked(bh)) {
423 } while (bh = bh->b_this_page, bh != head);
428 invalidate_bh_lrus();
430 goto recheck_buffers;
436 set_mask_bits(&bh->b_state, clear_bits, 0);
438 } while (bh = bh->b_this_page, bh != head);
441 folio_clear_uptodate(folio);
442 folio_clear_mappedtodisk(folio);
443 folio_clear_checked(folio);
444 __nilfs_clear_folio_dirty(folio);
447 unsigned int nilfs_page_count_clean_buffers(struct folio *folio,
448 unsigned int from, unsigned int to)
450 unsigned int block_start, block_end;
451 struct buffer_head *bh, *head;
454 for (bh = head = folio_buffers(folio), block_start = 0;
455 bh != head || !block_start;
456 block_start = block_end, bh = bh->b_this_page) {
457 block_end = block_start + bh->b_size;
458 if (block_end > from && block_start < to && !buffer_dirty(bh))
465 * NILFS2 needs clear_page_dirty() in the following two cases:
467 * 1) For B-tree node pages and data pages of DAT file, NILFS2 clears dirty
468 * flag of pages when it copies back pages from shadow cache to the
471 * 2) Some B-tree operations like insertion or deletion may dispose buffers
472 * in dirty state, and this needs to cancel the dirty state of their pages.
474 void __nilfs_clear_folio_dirty(struct folio *folio)
476 struct address_space *mapping = folio->mapping;
479 xa_lock_irq(&mapping->i_pages);
480 if (folio_test_dirty(folio)) {
481 __xa_clear_mark(&mapping->i_pages, folio->index,
482 PAGECACHE_TAG_DIRTY);
483 xa_unlock_irq(&mapping->i_pages);
484 folio_clear_dirty_for_io(folio);
487 xa_unlock_irq(&mapping->i_pages);
490 folio_clear_dirty(folio);
494 * nilfs_find_uncommitted_extent - find extent of uncommitted data
496 * @start_blk: start block offset (in)
497 * @blkoff: start offset of the found extent (out)
499 * This function searches an extent of buffers marked "delayed" which
500 * starts from a block offset equal to or larger than @start_blk. If
501 * such an extent was found, this will store the start offset in
502 * @blkoff and return its length in blocks.
504 * Return: Length in blocks of found extent, 0 otherwise.
506 unsigned long nilfs_find_uncommitted_extent(struct inode *inode,
510 unsigned int i, nr_folios;
512 unsigned long length = 0;
513 struct folio_batch fbatch;
516 if (inode->i_mapping->nrpages == 0)
519 index = start_blk >> (PAGE_SHIFT - inode->i_blkbits);
521 folio_batch_init(&fbatch);
524 nr_folios = filemap_get_folios_contig(inode->i_mapping, &index, ULONG_MAX,
531 folio = fbatch.folios[i];
534 if (folio_buffers(folio)) {
535 struct buffer_head *bh, *head;
538 b = folio->index << (PAGE_SHIFT - inode->i_blkbits);
539 bh = head = folio_buffers(folio);
543 if (buffer_delay(bh)) {
547 } else if (length > 0) {
550 } while (++b, bh = bh->b_this_page, bh != head);
557 } while (++i < nr_folios);
559 folio_batch_release(&fbatch);
565 folio_batch_release(&fbatch);