include/linux/suspend.h

1 /* SPDX-License-Identifier: GPL-2.0 */
103  * struct platform_suspend_ops - Callbacks for managing platform dependent
104  *	system sleep states.
106  * @valid: Callback to determine if given system sleep state is supported by
109  *	that it still may be impossible to enter given system sleep state if the
114  * @begin: Initialise a transition to given system sleep state.
122  * @prepare: Prepare the platform for entering the system sleep state indicated
128  *	system cannot enter the desired sleep state (@prepare_late(), @enter(),
131  * @prepare_late: Finish preparing the platform for entering the system sleep
136  *	system cannot enter the desired sleep state (@enter() will not be
139  * @enter: Enter the system sleep state indicated by @begin() or represented by
142  *	error code otherwise, in which case the system cannot enter the desired
145  * @wake: Called when the system has just left a sleep state, right after
152  * @finish: Finish wake-up of the platform.
160  * @suspend_again: Returns whether the system should suspend again (true) or
163  *	suspend_again callback is the place assuming that periodic-wakeup or
164  *	alarm-wakeup is already setup. This allows to execute some codes while
168  *	the platform that the system has returned to the working state or
210  * suspend_set_ops - set platform dependent suspend operations
243  * pm_suspend_via_firmware - Check if platform firmware will suspend the system.
245  * To be called during system-wide power management transitions to sleep states
246  * or during the subsequent system-wide transitions back to the working state.
249  * the system-wide power management transition (to a sleep state) in progress in
251  * to complete the last (or preceding) transition of the system to a sleep
259  * been carried out during the preceding transition of the system to a sleep
268  * pm_resume_via_firmware - Check if platform firmware has woken up the system.
270  * To be called during system-wide power management transitions from sleep
274  * the beginning of the system-wide power management transition in progress, so
275  * the event that woke up the system from sleep has been handled by the platform
284  * pm_suspend_no_platform - Check if platform may change device power states.
286  * To be called during system-wide power management transitions to sleep states
287  * or during the subsequent system-wide transitions back to the working state.
290  * kernel throughout the system-wide suspend and resume cycle in progress (that
299 /* Suspend-to-idle state machnine. */
302 	S2IDLE_STATE_ENTER,     /* Enter suspend-to-idle. */
303 	S2IDLE_STATE_WAKE,      /* Wake up from suspend-to-idle. */
319  * arch_suspend_disable_irqs - disable IRQs for suspend
328  * arch_suspend_enable_irqs - enable IRQs after suspend
352 static inline int pm_suspend(suspend_state_t state) { return -ENOSYS; }  in pm_suspend()
371  * struct platform_hibernation_ops - hibernation platform support
382  *	the platform that the system has returned to the working state.
398  * @enter: Put the system into the low power state after the hibernation image
403  * @leave: Perform the first stage of the cleanup after the system sleep state
409  * @pre_restore: Prepare system for the restoration from a hibernation image.
466 static inline int hibernate(void) { return -ENOSYS; }  in hibernate()
471 	return -ENOTSUPP;  in hibernate_quiet_exec()
486 #define PM_SUSPEND_PREPARE	0x0003 /* Going to suspend the system */
602  * pm_pr_dbg - print pm sleep debug messages
604  * If pm_debug_messages_on is enabled and the system is entering/leaving