[PATCH 05/19] printk: Add more context to suspend/resume functions

Marcos Paulo de Souza
2025-12-27T12:17:39Z

The new comments clarifies from where the functions are supposed to be
called.

Signed-off-by: Marcos Paulo de Souza <mpdesouza@suse.com>
---
kernel/printk/printk.c | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/kernel/printk/printk.c b/kernel/printk/printk.c
index 173c14e08afe..85a8b6521d9e 100644
--- a/kernel/printk/printk.c
+++ b/kernel/printk/printk.c
@@ -2734,7 +2734,8 @@ MODULE_PARM_DESC(console_no_auto_verbose, "Disable console loglevel raise to hig
/**
* console_suspend_all - suspend the console subsystem
*
- * This disables printk() while we go into suspend states
+ * This disables printk() while we go into suspend states. Called by the power
+ * management subsystem.
*/
void console_suspend_all(void)
{
@@ -2766,6 +2767,12 @@ void console_suspend_all(void)
synchronize_srcu(&console_srcu);
}

+/**
+ * console_resume_all - resume the console subsystem
+ *
+ * This resumes printk() when the system is being restored. Called by the power
+ * management subsystem.
+ */
void console_resume_all(void)
{
struct console_flush_type ft;
@@ -3553,7 +3560,7 @@ struct tty_driver *console_device(int *index)
/*
* Prevent further output on the passed console device so that (for example)
* serial drivers can suspend console output before suspending a port, and can
- * re-enable output afterwards.
+ * re-enable output afterwards. Called by console drivers.
*/
void console_suspend(struct console *console)
{
@@ -3572,6 +3579,7 @@ void console_suspend(struct console *console)
}
EXPORT_SYMBOL(console_suspend);

+/* Resumes printing on the passed console device. Called by console drivers. */
void console_resume(struct console *console)
{
struct console_flush_type ft;

--
2.52.0