printk: ringbuffer: add finalization/extension support
authorJohn Ogness <john.ogness@linutronix.de>
Mon, 14 Sep 2020 12:33:53 +0000 (14:39 +0206)
committerPetr Mladek <pmladek@suse.com>
Tue, 15 Sep 2020 14:35:27 +0000 (16:35 +0200)
commit4cfc7258f876a7feba673ac6d050f525b39cc84c
treec656d70055bc6421b5f61497b879981451af9961
parent10dcb06d40411a73e1ae111717e9a987bb760313
printk: ringbuffer: add finalization/extension support

Add support for extending the newest data block. For this, introduce
a new finalization state (desc_finalized) denoting a committed
descriptor that cannot be extended.

Until a record is finalized, a writer can reopen that record to
append new data. Reopening a record means transitioning from the
desc_committed state back to the desc_reserved state.

A writer can explicitly finalize a record if there is no intention
of extending it. Also, records are automatically finalized when a
new record is reserved. This relieves writers of needing to
explicitly finalize while also making such records available to
readers sooner. (Readers can only traverse finalized records.)

Four new memory barrier pairs are introduced. Two of them are
insignificant additions (data_realloc:A/desc_read:D and
data_realloc:A/data_push_tail:B) because they are alternate path
memory barriers that exactly match the purpose, pairing, and
context of the two existing memory barrier pairs they provide an
alternate path for. The other two new memory barrier pairs are
significant additions:

desc_reopen_last:A / _prb_commit:B - When reopening a descriptor,
    ensure the state transitions back to desc_reserved before
    fully trusting the descriptor data.

_prb_commit:B / desc_reserve:D - When committing a descriptor,
    ensure the state transitions to desc_committed before checking
    the head ID to see if the descriptor needs to be finalized.

Signed-off-by: John Ogness <john.ogness@linutronix.de>
Reviewed-by: Petr Mladek <pmladek@suse.com>
Signed-off-by: Petr Mladek <pmladek@suse.com>
Link: https://lore.kernel.org/r/20200914123354.832-6-john.ogness@linutronix.de
Documentation/admin-guide/kdump/gdbmacros.txt
kernel/printk/printk_ringbuffer.c
kernel/printk/printk_ringbuffer.h
scripts/gdb/linux/dmesg.py