[linux.git] / drivers / base / syscore.c

// SPDX-License-Identifier: GPL-2.0
/*
 *  syscore.c - Execution of system core operations.
 *
 *  Copyright (C) 2011 Rafael J. Wysocki <[email protected]>, Novell Inc.
 */

#include <linux/syscore_ops.h>
#include <linux/mutex.h>
#include <linux/module.h>
#include <linux/suspend.h>
#include <trace/events/power.h>

static LIST_HEAD(syscore_ops_list);
static DEFINE_MUTEX(syscore_ops_lock);

/**
 * register_syscore_ops - Register a set of system core operations.
 * @ops: System core operations to register.
 */
void register_syscore_ops(struct syscore_ops *ops)
{
	mutex_lock(&syscore_ops_lock);
	list_add_tail(&ops->node, &syscore_ops_list);
	mutex_unlock(&syscore_ops_lock);
}
EXPORT_SYMBOL_GPL(register_syscore_ops);

/**
 * unregister_syscore_ops - Unregister a set of system core operations.
 * @ops: System core operations to unregister.
 */
void unregister_syscore_ops(struct syscore_ops *ops)
{
	mutex_lock(&syscore_ops_lock);
	list_del(&ops->node);
	mutex_unlock(&syscore_ops_lock);
}
EXPORT_SYMBOL_GPL(unregister_syscore_ops);

#ifdef CONFIG_PM_SLEEP
/**
 * syscore_suspend - Execute all the registered system core suspend callbacks.
 *
 * This function is executed with one CPU on-line and disabled interrupts.
 */
int syscore_suspend(void)
{
	struct syscore_ops *ops;
	int ret = 0;

	trace_suspend_resume(TPS("syscore_suspend"), 0, true);
	pm_pr_dbg("Checking wakeup interrupts\n");

	/* Return error code if there are any wakeup interrupts pending. */
	if (pm_wakeup_pending())
		return -EBUSY;

	WARN_ONCE(!irqs_disabled(),
		"Interrupts enabled before system core suspend.\n");

	list_for_each_entry_reverse(ops, &syscore_ops_list, node)
		if (ops->suspend) {
			pm_pr_dbg("Calling %pS\n", ops->suspend);
			ret = ops->suspend();
			if (ret)
				goto err_out;
			WARN_ONCE(!irqs_disabled(),
				"Interrupts enabled after %pS\n", ops->suspend);
		}

	trace_suspend_resume(TPS("syscore_suspend"), 0, false);
	return 0;

 err_out:
	pr_err("PM: System core suspend callback %pS failed.\n", ops->suspend);

	list_for_each_entry_continue(ops, &syscore_ops_list, node)
		if (ops->resume)
			ops->resume();

	return ret;
}
EXPORT_SYMBOL_GPL(syscore_suspend);

/**
 * syscore_resume - Execute all the registered system core resume callbacks.
 *
 * This function is executed with one CPU on-line and disabled interrupts.
 */
void syscore_resume(void)
{
	struct syscore_ops *ops;

	trace_suspend_resume(TPS("syscore_resume"), 0, true);
	WARN_ONCE(!irqs_disabled(),
		"Interrupts enabled before system core resume.\n");

	list_for_each_entry(ops, &syscore_ops_list, node)
		if (ops->resume) {
			pm_pr_dbg("Calling %pS\n", ops->resume);
			ops->resume();
			WARN_ONCE(!irqs_disabled(),
				"Interrupts enabled after %pS\n", ops->resume);
		}
	trace_suspend_resume(TPS("syscore_resume"), 0, false);
}
EXPORT_SYMBOL_GPL(syscore_resume);
#endif /* CONFIG_PM_SLEEP */

/**
 * syscore_shutdown - Execute all the registered system core shutdown callbacks.
 */
void syscore_shutdown(void)
{
	struct syscore_ops *ops;

	mutex_lock(&syscore_ops_lock);

	list_for_each_entry_reverse(ops, &syscore_ops_list, node)
		if (ops->shutdown) {
			if (initcall_debug)
				pr_info("PM: Calling %pS\n", ops->shutdown);
			ops->shutdown();
		}

	mutex_unlock(&syscore_ops_lock);
}
Commit	Line	Data
989d42e8	1	// SPDX-License-Identifier: GPL-2.0
40dc166c RW	2	/*
	3	* syscore.c - Execution of system core operations.
	4	*
	5	* Copyright (C) 2011 Rafael J. Wysocki <[email protected]>, Novell Inc.
40dc166c RW	6	*/
	7
	8	#include <linux/syscore_ops.h>
	9	#include <linux/mutex.h>
	10	#include <linux/module.h>
9ce7a258	11	#include <linux/suspend.h>
bb3632c6	12	#include <trace/events/power.h>
40dc166c RW	13
	14	static LIST_HEAD(syscore_ops_list);
	15	static DEFINE_MUTEX(syscore_ops_lock);
	16
	17	/**
	18	* register_syscore_ops - Register a set of system core operations.
	19	* @ops: System core operations to register.
	20	*/
	21	void register_syscore_ops(struct syscore_ops *ops)
	22	{
	23	mutex_lock(&syscore_ops_lock);
	24	list_add_tail(&ops->node, &syscore_ops_list);
	25	mutex_unlock(&syscore_ops_lock);
	26	}
	27	EXPORT_SYMBOL_GPL(register_syscore_ops);
	28
	29	/**
	30	* unregister_syscore_ops - Unregister a set of system core operations.
	31	* @ops: System core operations to unregister.
	32	*/
	33	void unregister_syscore_ops(struct syscore_ops *ops)
	34	{
	35	mutex_lock(&syscore_ops_lock);
	36	list_del(&ops->node);
	37	mutex_unlock(&syscore_ops_lock);
	38	}
	39	EXPORT_SYMBOL_GPL(unregister_syscore_ops);
	40
	41	#ifdef CONFIG_PM_SLEEP
	42	/**
	43	* syscore_suspend - Execute all the registered system core suspend callbacks.
	44	*
	45	* This function is executed with one CPU on-line and disabled interrupts.
	46	*/
	47	int syscore_suspend(void)
	48	{
	49	struct syscore_ops *ops;
	50	int ret = 0;
	51
bb3632c6	52	trace_suspend_resume(TPS("syscore_suspend"), 0, true);
81b14224	53	pm_pr_dbg("Checking wakeup interrupts\n");
88759622 CC	54
88759622 CC	55	/* Return error code if there are any wakeup interrupts pending. */
9ce7a258 TG	56	if (pm_wakeup_pending())
9ce7a258 TG	57	return -EBUSY;
88759622	58
40dc166c RW	59	WARN_ONCE(!irqs_disabled(),
	60	"Interrupts enabled before system core suspend.\n");
	61
	62	list_for_each_entry_reverse(ops, &syscore_ops_list, node)
	63	if (ops->suspend) {
81b14224	64	pm_pr_dbg("Calling %pS\n", ops->suspend);
40dc166c RW	65	ret = ops->suspend();
	66	if (ret)
	67	goto err_out;
	68	WARN_ONCE(!irqs_disabled(),
d75f773c	69	"Interrupts enabled after %pS\n", ops->suspend);
40dc166c RW	70	}
40dc166c RW	71
bb3632c6	72	trace_suspend_resume(TPS("syscore_suspend"), 0, false);
40dc166c RW	73	return 0;
	74
	75	err_out:
d75f773c	76	pr_err("PM: System core suspend callback %pS failed.\n", ops->suspend);
40dc166c RW	77
	78	list_for_each_entry_continue(ops, &syscore_ops_list, node)
	79	if (ops->resume)
	80	ops->resume();
	81
	82	return ret;
	83	}
19234c08	84	EXPORT_SYMBOL_GPL(syscore_suspend);
40dc166c RW	85
	86	/**
	87	* syscore_resume - Execute all the registered system core resume callbacks.
	88	*
	89	* This function is executed with one CPU on-line and disabled interrupts.
	90	*/
	91	void syscore_resume(void)
	92	{
	93	struct syscore_ops *ops;
	94
bb3632c6	95	trace_suspend_resume(TPS("syscore_resume"), 0, true);
40dc166c RW	96	WARN_ONCE(!irqs_disabled(),
	97	"Interrupts enabled before system core resume.\n");
	98
	99	list_for_each_entry(ops, &syscore_ops_list, node)
	100	if (ops->resume) {
81b14224	101	pm_pr_dbg("Calling %pS\n", ops->resume);
40dc166c RW	102	ops->resume();
40dc166c RW	103	WARN_ONCE(!irqs_disabled(),
d75f773c	104	"Interrupts enabled after %pS\n", ops->resume);
40dc166c	105	}
bb3632c6	106	trace_suspend_resume(TPS("syscore_resume"), 0, false);
40dc166c	107	}
19234c08	108	EXPORT_SYMBOL_GPL(syscore_resume);
40dc166c RW	109	#endif /* CONFIG_PM_SLEEP */
	110
	111	/**
	112	* syscore_shutdown - Execute all the registered system core shutdown callbacks.
	113	*/
	114	void syscore_shutdown(void)
	115	{
	116	struct syscore_ops *ops;
	117
	118	mutex_lock(&syscore_ops_lock);
	119
	120	list_for_each_entry_reverse(ops, &syscore_ops_list, node)
	121	if (ops->shutdown) {
	122	if (initcall_debug)
d75f773c	123	pr_info("PM: Calling %pS\n", ops->shutdown);
40dc166c RW	124	ops->shutdown();
	125	}
	126
	127	mutex_unlock(&syscore_ops_lock);
	128	}