fault_flag_a..._retry_first(9)

🎀 NAME 🎀

hi bestie!! welcome to the fault_flag_a..._retry_first(9) page of the Kernel API Manual 💖 this one is short and sweet, no cap.

• fault_flag_allow_retry_first — check ALLOW_RETRY the first time ✨

---

✨ SYNOPSIS ✨

okay so here’s the exact signature, copy it like the icon it is:

bool fault_flag_allow_retry_first (enum fault_flag flags );

---

🌸 ARGUMENTS 🌸

• flags — fault flags. that’s the whole argument, bestie 🫶

---

💅 DESCRIPTION 💅

so this is mostly used for places where we want to try to avoid taking the mmap_lock for too long a time when waiting for another condition to change 😌 in which case we can try to be polite and release the mmap_lock in the first round, to avoid potential starvation of other processes that would also want the mmap_lock 🔥

it’s giving “let’s not hog the lock, be considerate” energy, fr fr 💅

---

🎀 RETURN 🎀

• true if the page fault allows retry and this is the first attempt of the fault handling 🦋
• false otherwise 💀

---

🦋 SEE ALSO 🦋

okay bestie, here are all the linked besties, in the original order — no skipping, periodt 👑

• kernel file: ./include/linux/mm.h
• folio_page_idx(9)
• vma_flag_t(9)
• vma_kernel_pagesize(9)
• folio_order(9)
• folio_reset_order(9)
• folio_mapcount(9)
• folio_mapped(9)
• thp_order(9)
• thp_size(9)
• folio_get(9)
• folio_put(9)
• folio_put_refs(9)
• folios_put(9)
• vma_flags_is_cow_mapping(9)
• vma_is_cow_mapping(9)
• vma_desc_is_cow_mapping(9)
• folio_pfn(9)
• folio_mk_pte(9)
• folio_mk_pmd(9)
• folio_mk_pud(9)
• folio_maybe_dma_pinned(9)
• is_zero_page(9)
• is_zero_folio(9)
• folio_nr_pages(9)
• folio_next(9)
• folio_shift(9)
• folio_size(9)
• folio_maybe_mapped_shared(9)
• folio_expected_ref_count(9)
• zap_vma(9)
• ptdesc_address(9)
• ptdesc_set_kernel(9)
• ptdesc_clear_kernel(9)
• ptdesc_test_kernel(9)
• pagetable_alloc(9)
• pagetable_free(9)
• vma_lookup(9)
• vma_start_pgoff(9)
• vma_end_pgoff(9)
• vma_last_pgoff(9)
• vma_start_anon_pgoff(9)
• vma_end_anon_pgoff(9)
• vma_last_anon_pgoff(9)
• mmap_action_remap(9)
• mmap_action_remap_full(9)
• mmap_action_ioremap(9)
• mmap_action_ioremap_full(9)
• mmap_action_simple_ioremap(9)
• mmap_action_map_kernel_pages(9)
• mmap_action_map_kernel_pages_full(9)
• range_is_subset(9)
• range_in_vma(9)
• range_in_vma_desc(9)
• clear_pages(9)

---

okay bye bestie!! 💖 source/version: ./include/linux; date: October 2026; page: fault_flag_a..._retry_first(9) — mwah, slay, hydrate, and don’t hog the lock 🌈✨🫶