done_seqretry_irqrestore(9)

🎀 done_seqretry_irqrestore(9) 🎀

okay bestie, welcome to the Kernel API Manual — today’s main character is done_seqretry_irqrestore(9), and she is here to close out a seqlock reader section. 💅

💖 NAME 💖

done_seqretry_irqrestore — end a seqlock_t lockless reader, or a non-interruptible locking reader section. that’s the whole name vibe, no cap. 🦋

✨ SYNOPSIS ✨

void done_seqretry_irqrestore (seqlock_t *lock , int seq , unsigned long
       flags );

🫶 ARGUMENTS 🫶

• lock — pointer to seqlock_t. that’s the lock, bestie.
• seq — count, from read_seqbegin_or_lock_irqsave. keep it close.
• flags — caller’s saved local interrupt state in case of a locking reader, also from read_seqbegin_or_lock_irqsave. same origin story as seq, periodt.

🌸 DESCRIPTION 🌸

This is the _irqrestore variant of done_seqretry. the way that matters: the read section must’ve been opened with read_seqbegin_or_lock_irqsave, and validated by need_seqretry. that’s the required combo — no random validation, no skipping steps. 💀

🦋 SEE ALSO 🦋

Kernel file: ./include/linux/seqlock.h — the source file bestie.

the whole seqlock friend group is here:

• seqcount_init(9)
• SEQCNT_ZERO(9)
• __read_seqcount_begin(9)
• raw_read_seqcount_begin(9)
• read_seqcount_begin(9)
• raw_read_seqcount(9)
• raw_seqcount_try_begin(9)
• raw_seqcount_begin(9)
• __read_seqcount_retry(9)
• read_seqcount_retry(9)
• raw_write_seqcount_begin(9)
• raw_write_seqcount_end(9)
• write_seqcount_begin_nested(9)
• write_seqcount_begin(9)
• write_seqcount_end(9)
• raw_write_seqcount_barrier(9)
• write_seqcount_invalidate(9)
• SEQCNT_LATCH_ZERO(9)
• seqcount_latch_init(9)
• raw_read_seqcount_latch(9)
• read_seqcount_latch(9)
• raw_read_seqcount_latch_retry(9)
• read_seqcount_latch_retry(9)
• raw_write_seqcount_latch(9)
• write_seqcount_latch_begin(9)
• write_seqcount_latch(9)
• write_seqcount_latch_end(9)
• seqlock_init(9)
• DEFINE_SEQLOCK(9)
• read_seqbegin(9)
• read_seqretry(9)
• write_seqlock(9)
• write_sequnlock(9)
• write_seqlock_bh(9)
• write_sequnlock_bh(9)
• write_seqlock_irq(9)
• write_sequnlock_irq(9)
• write_seqlock_irqsave(9)
• write_sequnlock_irqrestore(9)
• read_seqlock_excl(9)
• read_sequnlock_excl(9)
• read_seqlock_excl_bh(9)
• read_sequnlock_excl_bh(9)
• read_seqlock_excl_irq(9)
• read_sequnlock_excl_irq(9)
• read_seqlock_excl_irqsave(9)
• read_sequnlock_excl_irqrestore(9)
• read_seqbegin_or_lock(9)
• need_seqretry(9)
• done_seqretry(9)
• read_seqbegin_or_lock_irqsave(9)
• scoped_seqlock_read(9)

okay that’s the page! source/version situation: it comes from ./include/linux, dated October 2026, and the manual name is still done_seqretry_irqrestore(9). stay hydrated and lock safely 💜🫶