ENUM POSITIVE_AOP_RETURNS(9)

💅 enum positive_aop_returns(9) 💅

okay bestie, welcome to the Kernel API Manual page for enum positive_aop_returns — it's giving “aop return codes with specific semantics” and we are obsessed. no cap, every code here is a little signal to the caller. 💖

🎀 NAME 🎀

enum positive_aop_returns — aop return codes with specific semantics, periodt.

✨ SYNOPSIS ✨

       enum positive_aop_returns {
           AOP_WRITEPAGE_ACTIVATE ,
           AOP_TRUNCATED_PAGE

       };

🌸 Constants 🌸

• AOP_WRITEPAGE_ACTIVATE — informs the caller that page writeback has completed, that the page is still locked, and that it should be considered active. the VM uses this hint to return the page to the active list — it won't be a candidate for writeback again in the near future. other callers must be careful to unlock the page if they get this return. returned by writepage;
• AOP_TRUNCATED_PAGE — the AOP method that was handed a locked page has unlocked it, and the page might have been truncated. the caller should back up to acquiring a new page and trying again. the aop will be taking reasonable precautions not to livelock. if the caller held a page reference, it should drop it before retrying. returned by read_folio.

🌈 Description 🌈

okay so address_space_operation functions return these large constants to indicate special semantics to the caller. they're much larger than the bytes in a page to allow for functions that return the number of bytes operated on in a given page. slay. ✨

👑 SEE ALSO 👑

Kernel file ./include/linux/fs.h: struct address_space(9), struct file_ra_state(9), struct file(9), i_uid_into_vfsuid(9), i_uid_needs_update(9), i_uid_update(9), i_gid_into_vfsgid(9), i_gid_needs_update(9), i_gid_update(9), inode_fsuid_set(9), inode_fsgid_set(9), fsuidgid_has_mapping(9), inode_set_ctime(9), file_write_started(9), file_write_not_started(9), struct renamedata(9), is_mgtime(9), iput_if_not_last(9), is_idmapped_mnt(9), file_start_write(9), file_end_write(9), kiocb_start_write(9), kiocb_end_write(9), name_is_dot_dotdot(9), name_contains_dotdot(9), inode_dio_begin(9), inode_dio_end(9), generic_ci_validate_strict_name(9)

mwah 💋 this page is from ./include/linux and dated October 2026 — enum positive_aop_returns(9) forever, bestie. 🫶