log_distance(9)

okay so bestie, this is log_distance(9) from the Kernel API Manual — yes, we're in kernel land now and it's giving main character energy 💅✨. It's all about computing a distance between two journal blocks, and honestly? iconic.

💖 NAME 💖

• log_distance — Compute distance between two journal blocks 🎀

✨ SYNOPSIS ✨

the whole signature is right here, copy it exactly like your life depends on it:

unsigned int log_distance (struct gfs2_sbd *sdp , unsigned int newer ,
unsigned int older );

🫶 ARGUMENTS 🫶

these are the three besties you pass in, no cap:

• sdp — The GFS2 superblock
• newer — The most recent journal block of the pair
• older — The older journal block of the pair

🌸 DESCRIPTION 🌸

so the function does this: Compute the distance (in the journal direction) between two blocks in the journal. that's the vibe. journal direction? yes bestie, direction matters 💫

🎀 RETURN 🎀

• returns the distance in blocks 🔥

🦋 SEE ALSO 🦋

kernel file ./fs/gfs2/log.c is the place to be, and the whole crew is:

• gfs2_struct2blk(9), gfs2_remove_from_ail(9), gfs2_ail1_start_one(9), gfs2_ail1_flush(9), gfs2_ail1_start(9), gfs2_ail1_empty_one(9), gfs2_ail1_empty(9), gfs2_log_is_empty(9), gfs2_log_release_revokes(9), gfs2_log_release(9), __gfs2_log_try_reserve(9), __gfs2_log_reserve(9), gfs2_log_try_reserve(9), gfs2_log_reserve(9), calc_reserved(9), gfs2_flush_revokes(9), gfs2_write_log_header(9), log_write_header(9), gfs2_ail_drain(9), empty_ail1_list(9), gfs2_trans_drain(9), __gfs2_log_flush(9), gfs2_merge_trans(9), gfs2_log_commit(9), gfs2_log_shutdown(9), gfs2_logd(9)

this lil page comes from ./fs/gfs2, dated October 2026, and it's filed under log_distance(9) — bye bestie, go slay those journal blocks 🎀🫶