iput_if_not_last(9)

💅 iput_if_not_last — from the Kernel API Manual, bestie 🎀

okay so real talk, this one lives in the <pink>Kernel API Manual</pink> and it's called iput_if_not_last — yes that's the man page name, and yes it's exactly what it sounds like it is, no cap.

---

🌸 NAME 🌸

iput_if_not_last — drop an inode reference only if it is not the last one 💅

---

✨ SYNOPSIS ✨

bool iput_if_not_last (struct inode *inode );

that's it. that's the whole vibe check. 🦋

---

🎀 ARGUMENTS 🎀

• inode — the inode to put 🫶 (like, the star of the show)

---

🌈 DESCRIPTION 🌈

so here's the tea, bestie: it returns true if the reference was dropped — slay — and false if this was the last reference 🤭 in which case the caller must arrange for the final iput in a safe context. periodt. no shortcuts, the rules are the rules 💀

lowkey important: if you get false back, that's your cue — you gotta line up the final iput somewhere safe. don't just leave it hanging, that's not the move 🙈

---

👑 SEE ALSO 👑

Kernel file ./include/linux/fs.h and honestly the whole friend group:

• enum positive_aop_returns(9)
• 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)
• 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)

---

and that's the whole page, bestie 🧚 thanks for reading, mwah 💖

source: ./include/linux ⭐ dated: October 2026 — catch you in the next man page, ily 💜