vdo_acquire_...ck_reference(9)
π NAME π
ok so welcome to vdo_acquire_recovery_journal_block_reference(9) bestie!! this is a page from the Kernel API Manual, section (9) β yes, the function-name-up-top got chopped to vdo_acquire_...ck_reference(9) when they printed it, but that's just the header being dramatic, the real name is the whole long thing π
vdo_acquire_recovery_journal_block_reference β grab yourself a reference to a recovery journal block when you're coming from somewhere other than the journal itself. like, not the journal's own house, some other address, and you still need to hold a reference. iconic behaviour, no cap π«Ά
β¨ SYNOPSIS β¨
void vdo_acquire_recovery_journal_block_reference (struct
recovery_journal *journal , sequence_number_t sequence_number , enum
vdo_zone_type zone_type , zone_count_t zone_id );
that's it. that's the whole vibe. void, so it doesn't hand you anything back β it just does the thing π
π ARGUMENTS π
journalβ the recovery journal. like, the actual journal we're referencing a block of. your main character π«Άsequence_numberβ the journal sequence number of the referenced block. which block are we hyping up? this number says it.sequence_number_tfr fr.zone_typeβ the type of the zone making the adjustment.enum vdo_zone_type, very official of it β¨zone_idβ the ID of the zone making the adjustment.zone_count_t, because zones are counted, periodt π
so just to be clear: it's journal, sequence number, zone type, zone id. four things. you're giving it four things. and it gives you back void. balanced, as all things should be πΈ
π¦ SEE ALSO π¦
okay this list is long and honestly it ate, so buckle up bestie β every single one of these is a real reference, i'm not skipping a single one, that would be so not slay of me:
- the kernel file
./drivers/md/dm-vdo/recovery-journal.candLock Counters.(9)β yes that's how it's written, "Lock Counters." with the period, don't come for me, the manpage said it first π get_zone_count_ptr(9)get_counter(9)is_journal_zone_locked(9)vdo_release_recovery_journal_block_reference(9)β the breakup anthem to this page's love song πpop_free_list(9)is_block_dirty(9)is_block_empty(9)is_block_full(9)assert_on_journal_thread(9)continue_waiter(9)has_block_waiters(9)suspend_lock_counter(9)check_for_drain_complete(9)notify_recovery_journal_of_read_only_mode(9)enter_journal_read_only_mode(9)vdo_get_recovery_journal_current_sequence_number(9)get_recovery_journal_head(9)compute_recovery_count_byte(9)check_slab_journal_commit_threshold(9)finish_reaping(9)complete_reaping(9)handle_flush_error(9)initialize_journal_state(9)vdo_get_recovery_journal_length(9)reap_recovery_journal_callback(9)initialize_lock_counter(9)set_journal_tail(9)initialize_recovery_block(9)vdo_decode_recovery_journal(9)vdo_free_recovery_journal(9)vdo_initialize_recovery_journal_post_repair(9)vdo_get_journal_block_map_data_blocks_used(9)vdo_get_recovery_journal_thread_id(9)vdo_open_recovery_journal(9)vdo_record_recovery_journal(9)get_block_header(9)set_active_sector(9)advance_tail(9)initialize_lock_count(9)prepare_to_assign_entry(9)schedule_block_write(9)release_journal_block_reference(9)assign_entry(9)recycle_journal_block(9)continue_committed_waiter(9)notify_commit_waiters(9)recycle_journal_blocks(9)complete_write(9)add_queued_recovery_entries(9)write_block(9)write_blocks(9)vdo_add_recovery_journal_entry(9)is_lock_locked(9)reap_recovery_journal(9)vdo_release_journal_entry_lock(9)vdo_drain_recovery_journal(9)resume_lock_counter(9)vdo_resume_recovery_journal(9)vdo_get_recovery_journal_logical_blocks_used(9)vdo_get_recovery_journal_statistics(9)dump_recovery_block(9)vdo_dump_recovery_journal_statistics(9)
sixty-three entries and every one of them still got an invite to the group chat πslayπ
also there's asuspend_lock_counter(9)and aresume_lock_counter(9)in there, bestie. they're a matched set. i don't make the rules, the kernel does π
okay that's the whole page!! short and sweet and full of references, as a treat π
signed off with love from the source dir ./drivers/md/dm-vdo, from the Kernel API Manual (vdo_acquire_...ck_reference(9)), dated October 2026 β i was literally born yesterday and i'm already documented, and that's on periodt β¨ππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms