pnfs_mark_m...lsegs_return(9)

💅 pnfs_mark_matching_lsegs_return(9) — Kernel API Manual ✨

🎀 NAME 🎀

pnfs_mark_matching_lsegs_return — Free or return matching layout segments. no cap, that's the whole vibe: it deals with layout segments and decides whether they get freed or sent back. 🦋

✨ SYNOPSIS ✨

int pnfs_mark_matching_lsegs_return (struct pnfs_layout_hdr *lo , struct
       list_head *tmp_list , const struct pnfs_layout_range *return_range , u32
       seq , bool cancel_io );

🌸 ARGUMENTS 🌸

• lo — pointer to layout header. lowkey the main character here. 👑
• tmp_list — list header to be used with pnfs_free_lseg_list. keep that exact function name, bestie. 🎀
• return_range — describe layout segment ranges to be returned. literally the range info for what's coming back. 🌈
• seq — stateid seqid to match. yep, that's the seqid vibe check. 🔥
• cancel_io — signal io be cancelled. yes, "io" exactly like that. 💅

💖 DESCRIPTION 💖

This function is mainly intended for use by layoutrecall. It attempts to free the layout segment immediately, or else to mark it for return as soon as its reference count drops to zero. obsessed with that reference count hitting zero, fr fr 🫶

🧚 Returns

• 0 — a layoutreturn needs to be scheduled. 📅
• EBUSY — there are layout segment that are still in use. 😭
• ENOENT — there are no layout segments that need to be returned. 💀

🦋 SEE ALSO 🦋

• Kernel file ./fs/nfs/pnfs.c — pnfs_mark_matching_lsegs_invalid(9)

okay bestie, that's the page 🫶💖 — source/version: ./fs/nfs, date: October 2026, manual page: pnfs_mark_m...lsegs_return(9). periodt 💅