drivers/base/syscore.c

Source file repositories/reference/linux-study-clean/drivers/base/syscore.c

File Facts

System
Linux kernel
Corpus path
drivers/base/syscore.c
Extension
.c
Size
3413 bytes
Lines
133
Domain
Driver Families
Bucket
drivers/base
Inferred role
Driver Families: exported/initcall integration point
Status
integration implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

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

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

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

	list_for_each_entry_continue(syscore, &syscore_list, node)
		if (syscore->ops->resume)
			syscore->ops->resume(syscore->data);

	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 *syscore;

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

	list_for_each_entry(syscore, &syscore_list, node)
		if (syscore->ops->resume) {
			pm_pr_dbg("Calling %pS\n", syscore->ops->resume);
			syscore->ops->resume(syscore->data);
			WARN_ONCE(!irqs_disabled(),
				"Interrupts enabled after %pS\n",
				syscore->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 *syscore;

	mutex_lock(&syscore_lock);

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

	mutex_unlock(&syscore_lock);
}

Annotation

Implementation Notes