include/linux/suspend.h

1 /* SPDX-License-Identifier: GPL-2.0 */
101  * struct platform_suspend_ops - Callbacks for managing platform dependent
102  *	system sleep states.
104  * @valid: Callback to determine if given system sleep state is supported by
107  *	that it still may be impossible to enter given system sleep state if the
112  * @begin: Initialise a transition to given system sleep state.
120  * @prepare: Prepare the platform for entering the system sleep state indicated
126  *	system cannot enter the desired sleep state (@prepare_late(), @enter(),
129  * @prepare_late: Finish preparing the platform for entering the system sleep
134  *	system cannot enter the desired sleep state (@enter() will not be
137  * @enter: Enter the system sleep state indicated by @begin() or represented by
140  *	error code otherwise, in which case the system cannot enter the desired
143  * @wake: Called when the system has just left a sleep state, right after
150  * @finish: Finish wake-up of the platform.
158  * @suspend_again: Returns whether the system should suspend again (true) or
161  *	suspend_again callback is the place assuming that periodic-wakeup or
162  *	alarm-wakeup is already setup. This allows to execute some codes while
166  *	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
350 static inline int pm_suspend(suspend_state_t state) { return -ENOSYS; }  in pm_suspend()
372  * struct platform_hibernation_ops - hibernation platform support
383  *	the platform that the system has returned to the working state.
399  * @enter: Put the system into the low power state after the hibernation image
404  * @leave: Perform the first stage of the cleanup after the system sleep state
410  * @pre_restore: Prepare system for the restoration from a hibernation image.
464 static inline int hibernate(void) { return -ENOSYS; }  in hibernate()
469 	return -ENOTSUPP;  in hibernate_quiet_exec()
482 #define PM_SUSPEND_PREPARE	0x0003 /* Going to suspend the system */