nilfs_free_segments(9)

💅 nilfs_free_segments — Kernel API Manual 💅

okay so section 9 bestie, welcome to the Kernel API Manual — this page is about nilfs_free_segments, and it’s giving cleanup icon energy. literally obsessed. 🧚✨

---

🌸 NAME 🌸

nilfs_free_segments — frees the segments given by an array of segment numbers. no cap, that’s the whole name-vibe, periodt. 💖

✨ SYNOPSIS ✨

here’s the signature, exactly as it shows up — copy/paste safe, fr fr:

int nilfs_free_segments (struct the_nilfs *nilfs , __u64 *segnumv ,
       size_t nsegs );

🎀 ARGUMENTS 🎀

• nilfs — the nilfs object. your main character 🫶
• segnumv — array of segment numbers to be freed. yes bestie, the whole array 💅
• nsegs — number of segments to be freed in segnumv. count ’em 👑

📝 DESCRIPTION 📝

okay so here’s the tea: nilfs_free_segments wraps nilfs_sufile_freev and nilfs_sufile_cancel_freev, and it edits the segment usage metadata file (sufile) to free all segments given by segnumv and nsegs at once. one shot, all the segments, slay. ✨

if it fails midway, it cancels the changes so that none of the segments are freed. highkey all-or-nothing, no half-freed mess. 😭

if nsegs is 0, this function does nothing. it’s a vibe check and then a nap. 💤

the freeing of segments is not finalized until the writing of a log with a super root block containing this sufile change is complete, and it can be canceled with nilfs_sufile_cancel_freev until then. so yeah: not done until that log finishes writing. 🔥

💖 RETURN 💖

0 on success, or one of the following negative error codes on failure:

• -EINVAL — Invalid segment number.
• -EIO — I/O error (including metadata corruption).
• -ENOMEM — Insufficient memory available.

🔥 SEE ALSO 🔥

Kernel file ./fs/nilfs2/segment.c — and these linked besties, in order, iykyk:

• nilfs_transaction_begin(9)
• nilfs_transaction_commit(9)
• nilfs_segctor_reset_segment_buffer(9)
• nilfs_segctor_zeropad_segsum(9)
• nilfs_write_root_mdt_inode(9)
• nilfs_segctor_begin_construction(9)
• nilfs_prepare_write_logs(9)
• nilfs_segctor_start_timer(9)
• nilfs_construct_segment(9)
• nilfs_construct_dsync_segment(9)
• nilfs_segctor_accept(9)
• nilfs_segctor_notify(9)
• nilfs_segctor_construct(9)
• nilfs_log_write_required(9)
• nilfs_segctor_thread(9)
• nilfs_segctor_destroy(9)
• nilfs_attach_log_writer(9)
• nilfs_detach_log_writer(9)

sign-off: from ./fs/nilfs2, dated October 2026, answering to the name nilfs_free_segments(9) — mwah 💋✨