lpt_gc_lnum(9)

🌸 NAME 🌸

lpt_gc_lnum — garbage collect a LPT LEB. This page is lpt_gc_lnum(9) from the Kernel API Manual, so hiiii bestie, welcome to the LPT cleanup committee. 💅

💖 SYNOPSIS 💖

Here’s the exact signature, no edits, no cap:

int lpt_gc_lnum (struct ubifs_info *c , int lnum );

🎀 ARGUMENTS 🎀

• c — UBIFS file-system description object. It’s the context baddie for this whole operation. 🫶
• lnum — LEB number to garbage collect. This is the LEB getting the ✨dirty✨ treatment.

🌸 DESCRIPTION 🌸

okay so LPT garbage collection is used only for the "big" LPT model — the vibe check is c->big_lpt == 1, periodt. No big-LPT energy, no GC. 💅

Only the “big” LPT model gets this treatment — the check is literally c->big_lpt == 1.

Garbage collection simply involves marking all the nodes in the LEB being garbage-collected as dirty. That’s it — the nodes get marked dirty, no extra plot twist. 🫧

The dirty nodes are written next commit, after which the LEB is free to be reused. So after the next commit, that LEB can be reused; it’s giving “recycled and thriving.” ♻️

Return vibe check: this function returns 0 on success and a negative error code on failure. If it comes back negative, that’s a fail, bestie. 😭

🦋 SEE ALSO 🦋

Kernel file ./fs/ubifs/lpt_commit.c is the source-file main character, and it brought the whole friend group:

• first_dirty_cnode(9)
• next_dirty_cnode(9)
• get_cnodes_to_commit(9)
• upd_ltab(9)
• alloc_lpt_leb(9)
• layout_cnodes(9)
• realloc_lpt_leb(9)
• write_cnodes(9)
• next_pnode_to_dirty(9)
• add_pnode_dirt(9)
• do_make_pnode_dirty(9)
• make_tree_dirty(9)
• need_write_all(9)
• lpt_tgc_start(9)
• lpt_tgc_end(9)
• populate_lsave(9)
• nnode_lookup(9)
• make_nnode_dirty(9)
• make_pnode_dirty(9)
• make_ltab_dirty(9)
• make_lsave_dirty(9)
• make_node_dirty(9)
• get_lpt_node_len(9)
• get_pad_len(9)
• get_lpt_node_type(9)
• is_a_node(9)
• lpt_gc(9)
• ubifs_lpt_start_commit(9)
• free_obsolete_cnodes(9)
• ubifs_lpt_end_commit(9)
• ubifs_lpt_post_commit(9)
• first_nnode(9)
• next_nnode(9)
• ubifs_lpt_free(9)
• dbg_is_all_ff(9)
• dbg_is_nnode_dirty(9)
• dbg_is_pnode_dirty(9)
• dbg_is_ltab_dirty(9)
• dbg_is_lsave_dirty(9)
• dbg_is_node_dirty(9)
• dbg_check_ltab_lnum(9)
• dbg_check_ltab(9)
• dbg_chk_lpt_free_spc(9)
• dbg_chk_lpt_sz(9)
• dump_lpt_leb(9)
• ubifs_dump_lpt_lebs(9)
• dbg_populate_lsave(9)

xoxo from ./fs/ubifs, October 2026, on lpt_gc_lnum(9) — slay and goodbye! 💖✨