iov_iter_extract_will_pin(9)
π NAME π
okay so bestie, this is the iov_iter_extract_will_pin(9) page from the Kernel API Manual. It's literally here to indicate how pages from the iterator will be retained β that's the whole assignment, no cap. π«Ά
β¨ SYNOPSIS β¨
bool iov_iter_extract_will_pin (const struct iov_iter *iter );
π ARGUMENTS π
iterβ the iterator. That's it. That's the argument. She's the main character here. π
πΈ DESCRIPTION πΈ
so you examine the iterator, right? then you return true or false to tell everyone how β or whether β pages extracted from the iterator are gonna be retained by the extraction function. vibe check via return value, basically. π
true means the pages will have a pin placed in them, and the caller must unpin them. This is a must for DMA/async DIO: it forces fork to forcibly copy a page for the child (because the parent must retain the original page). pin drama, but make it necessary. π₯
false means no measures are taken, and it's fully up to the caller to retain the pages. no pin, no promises, you're on your own bestie. π
π¦ SEE ALSO π¦
- Kernel file
./include/linux/uio.h
that's the whole page, bestie. it lives under ./include/linux, dated October 2026, and the page title is iov_iter_extract_will_pin(9) β periodt. πβ¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms