make_pnode_dirty(9)

make_pnode_dirty(9) 💅

okay bestie, welcome to this page from the Kernel API Manual — we're talking about make_pnode_dirty, and the vibe is exactly: "find a pnode and, if found, make it dirty." ✨ no cap.

💖 NAME 💖

make_pnode_dirty — find a pnode and, if found, make it dirty.

🎀 SYNOPSIS 🎀

int make_pnode_dirty (struct ubifs_info *c , int node_num , int lnum ,
       int offs );

🦋 ARGUMENTS 🦋

• c — the UBIFS file-system description object, aka the main-character struct.
• node_num — the pnode number of the pnode we're making dirty.
• lnum — the LEB number where that pnode was written.
• offs — the offset where that pnode was written.

✨ DESCRIPTION ✨

So this function is used by LPT garbage collection. LPT garbage collection is only for the "big" LPT model, meaning c->big_lpt == 1. Garbage collection simply involves marking all the nodes in the LEB being garbage-collected as dirty. The dirty nodes are written next commit, and after that the LEB is free to be reused. 🌀

It returns 0 on success and a negative error code on failure. Zero is the slay outcome; negative error code is the not-slay outcome. 😭

bestie, keep those return values straight — success is 0, failure is a negative error code.

🌈 SEE ALSO 🌈

The kernel file is ./fs/ubifs/lpt_commit.c, and the whole SEE ALSO squad is here, every single one:

• 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_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_lnum(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)

byeee from source/version ./fs/ubifs, dated October 2026, page make_pnode_dirty(9) 🫶✨