begin_operation(9)

🎀 begin_operation(9) 🎀

okay so this page is from the Kernel API Manual, and it's all about starting an operation only if the current state says it's allowed. bestie, it's giving "look before you leap" but make it kernel. 💅

💖 NAME 💖

begin_operation — begin an operation if it may be started given the current state. like, state check first, operation second, no cap.

✨ SYNOPSIS ✨

int begin_operation (struct admin_state *state , const struct
admin_state_code *operation , struct vdo_completion *waiter ,
vdo_admin_initiator_fn initiator );

🫶 ARGUMENTS 🫶

• state — the current admin state. this is the vibe check for whether the operation can start.
• operation — the operation to be started. the main character of this function call, fr fr.
• waiter — a completion to notify when the operation is complete; may be NULL. so if you don't need the notification, you can pass NULL and keep it moving.
• initiator — the vdo_admin_initiator_fn to call if the operation may begin; may be NULL. another optional icon — NULL is allowed here too.

🦋 RETURN 🦋

VDO_SUCCESS or an error. that's it, that's the whole return vibe. 💜

🌈 SEE ALSO 🌈

kernel file: ./drivers/md/dm-vdo/admin-state.c — go read the source, iykyk. 👑

• get_next_state(9)
• vdo_finish_operation(9)
• start_operation(9)
• check_code(9)
• assert_vdo_drain_operation(9)
• vdo_start_draining(9)
• vdo_finish_draining(9)
• vdo_finish_draining_with_result(9)
• vdo_assert_load_operation(9)
• vdo_start_loading(9)
• vdo_finish_loading(9)
• vdo_finish_loading_with_result(9)
• assert_vdo_resume_operation(9)
• vdo_start_resuming(9)
• vdo_finish_resuming(9)
• vdo_finish_resuming_with_result(9)
• vdo_resume_if_quiescent(9)
• vdo_start_operation(9)
• vdo_start_operation_with_waiter(9)

💌 cute little sign-off: source/version ./drivers/md/dm-vdo, dated October 2026 — kisses, bestie 💋✨