find_lock_page(9)

💖 NAME 💖

okay bestie, this is find_lock_page(9) from the Kernel API Manual — and the whole vibe is: locate, pin and lock a pagecache page. That's the mission. That's the moment. 🎀

🌸 SYNOPSIS 🌸

struct page * find_lock_page (struct address_space *mapping , pgoff_t
       index );

🦋 ARGUMENTS 🦋

• mapping — the address_space to search, iykyk.
• index — the page index, bestie.

✨ DESCRIPTION ✨

So it looks up the page cache entry at mapping & index. If there is a page cache page there, it comes back locked and with an increased refcount — pinned and locked, no cap. Obsessed with a clean handoff. 💅

😴 CONTEXT 😴

May sleep. That's the whole context, bestie — plan accordingly. 😭

🔥 RETURN 🔥

A struct page, or NULL if there is no page in the cache for this index. Simple. Iconic. 💖

👑 SEE ALSO 👑

the whole squad lives around the Kernel file ./include/linux/pagemap.h, plus all these besties:

• filemap_set_wb_err(9)
• filemap_check_wb_err(9)
• filemap_sample_wb_err(9)
• file_sample_sb_err(9)
• mapping_set_error(9)
• mapping_set_large_folios(9)
• mapping_align_index(9)
• mapping_pmd_folio_support(9)
• folio_flush_mapping(9)
• folio_inode(9)
• folio_attach_private(9)
• folio_change_private(9)
• folio_detach_private(9)
• fgf_t(9)
• fgf_set_order(9)
• write_begin_get_folio(9)
• filemap_get_folio(9)
• filemap_lock_folio(9)
• filemap_grab_folio(9)
• find_get_page(9)
• find_or_create_page(9)
• grab_cache_page_nowait(9)
• folio_next_index(9)
• folio_next_pos(9)
• folio_file_page(9)
• folio_contains(9)
• page_pgoff(9)
• folio_pos(9)
• linear_page_delta(9)
• linear_page_index(9)
• linear_anon_page_index(9)
• folio_trylock(9)
• folio_lock(9)
• lock_page(9)
• folio_lock_killable(9)
• filemap_range_needs_writeback(9)
• struct readahead_control(9)
• page_cache_sync_readahead(9)
• page_cache_async_readahead(9)
• readahead_folio(9)
• readahead_pos(9)
• readahead_length(9)
• readahead_index(9)
• readahead_count(9)
• readahead_batch_length(9)
• folio_mkwrite_check_truncate(9)
• i_blocks_per_folio(9)

that's the page, bestie 🫶 — source/version: ./include/linux; date: October 2026. mwah 💋