LCOV - code coverage report
Current view: top level - include/linux - suspend.h (source / functions) Hit Total Coverage
Test: coverage.info Lines: 0 13 0.0 %
Date: 2023-04-06 08:38:28 Functions: 0 0 -

          Line data    Source code
       1             : /* SPDX-License-Identifier: GPL-2.0 */
       2             : #ifndef _LINUX_SUSPEND_H
       3             : #define _LINUX_SUSPEND_H
       4             : 
       5             : #include <linux/swap.h>
       6             : #include <linux/notifier.h>
       7             : #include <linux/init.h>
       8             : #include <linux/pm.h>
       9             : #include <linux/mm.h>
      10             : #include <linux/freezer.h>
      11             : #include <asm/errno.h>
      12             : 
      13             : #ifdef CONFIG_VT
      14             : extern void pm_set_vt_switch(int);
      15             : #else
      16             : static inline void pm_set_vt_switch(int do_switch)
      17             : {
      18             : }
      19             : #endif
      20             : 
      21             : #ifdef CONFIG_VT_CONSOLE_SLEEP
      22             : extern void pm_prepare_console(void);
      23             : extern void pm_restore_console(void);
      24             : #else
      25             : static inline void pm_prepare_console(void)
      26             : {
      27             : }
      28             : 
      29             : static inline void pm_restore_console(void)
      30             : {
      31             : }
      32             : #endif
      33             : 
      34             : typedef int __bitwise suspend_state_t;
      35             : 
      36             : #define PM_SUSPEND_ON           ((__force suspend_state_t) 0)
      37             : #define PM_SUSPEND_TO_IDLE      ((__force suspend_state_t) 1)
      38             : #define PM_SUSPEND_STANDBY      ((__force suspend_state_t) 2)
      39             : #define PM_SUSPEND_MEM          ((__force suspend_state_t) 3)
      40             : #define PM_SUSPEND_MIN          PM_SUSPEND_TO_IDLE
      41             : #define PM_SUSPEND_MAX          ((__force suspend_state_t) 4)
      42             : 
      43             : enum suspend_stat_step {
      44             :         SUSPEND_FREEZE = 1,
      45             :         SUSPEND_PREPARE,
      46             :         SUSPEND_SUSPEND,
      47             :         SUSPEND_SUSPEND_LATE,
      48             :         SUSPEND_SUSPEND_NOIRQ,
      49             :         SUSPEND_RESUME_NOIRQ,
      50             :         SUSPEND_RESUME_EARLY,
      51             :         SUSPEND_RESUME
      52             : };
      53             : 
      54             : struct suspend_stats {
      55             :         int     success;
      56             :         int     fail;
      57             :         int     failed_freeze;
      58             :         int     failed_prepare;
      59             :         int     failed_suspend;
      60             :         int     failed_suspend_late;
      61             :         int     failed_suspend_noirq;
      62             :         int     failed_resume;
      63             :         int     failed_resume_early;
      64             :         int     failed_resume_noirq;
      65             : #define REC_FAILED_NUM  2
      66             :         int     last_failed_dev;
      67             :         char    failed_devs[REC_FAILED_NUM][40];
      68             :         int     last_failed_errno;
      69             :         int     errno[REC_FAILED_NUM];
      70             :         int     last_failed_step;
      71             :         enum suspend_stat_step  failed_steps[REC_FAILED_NUM];
      72             : };
      73             : 
      74             : extern struct suspend_stats suspend_stats;
      75             : 
      76             : static inline void dpm_save_failed_dev(const char *name)
      77             : {
      78           0 :         strscpy(suspend_stats.failed_devs[suspend_stats.last_failed_dev],
      79             :                 name,
      80             :                 sizeof(suspend_stats.failed_devs[0]));
      81           0 :         suspend_stats.last_failed_dev++;
      82           0 :         suspend_stats.last_failed_dev %= REC_FAILED_NUM;
      83             : }
      84             : 
      85             : static inline void dpm_save_failed_errno(int err)
      86             : {
      87           0 :         suspend_stats.errno[suspend_stats.last_failed_errno] = err;
      88           0 :         suspend_stats.last_failed_errno++;
      89           0 :         suspend_stats.last_failed_errno %= REC_FAILED_NUM;
      90             : }
      91             : 
      92             : static inline void dpm_save_failed_step(enum suspend_stat_step step)
      93             : {
      94           0 :         suspend_stats.failed_steps[suspend_stats.last_failed_step] = step;
      95           0 :         suspend_stats.last_failed_step++;
      96           0 :         suspend_stats.last_failed_step %= REC_FAILED_NUM;
      97             : }
      98             : 
      99             : /**
     100             :  * struct platform_suspend_ops - Callbacks for managing platform dependent
     101             :  *      system sleep states.
     102             :  *
     103             :  * @valid: Callback to determine if given system sleep state is supported by
     104             :  *      the platform.
     105             :  *      Valid (ie. supported) states are advertised in /sys/power/state.  Note
     106             :  *      that it still may be impossible to enter given system sleep state if the
     107             :  *      conditions aren't right.
     108             :  *      There is the %suspend_valid_only_mem function available that can be
     109             :  *      assigned to this if the platform only supports mem sleep.
     110             :  *
     111             :  * @begin: Initialise a transition to given system sleep state.
     112             :  *      @begin() is executed right prior to suspending devices.  The information
     113             :  *      conveyed to the platform code by @begin() should be disregarded by it as
     114             :  *      soon as @end() is executed.  If @begin() fails (ie. returns nonzero),
     115             :  *      @prepare(), @enter() and @finish() will not be called by the PM core.
     116             :  *      This callback is optional.  However, if it is implemented, the argument
     117             :  *      passed to @enter() is redundant and should be ignored.
     118             :  *
     119             :  * @prepare: Prepare the platform for entering the system sleep state indicated
     120             :  *      by @begin().
     121             :  *      @prepare() is called right after devices have been suspended (ie. the
     122             :  *      appropriate .suspend() method has been executed for each device) and
     123             :  *      before device drivers' late suspend callbacks are executed.  It returns
     124             :  *      0 on success or a negative error code otherwise, in which case the
     125             :  *      system cannot enter the desired sleep state (@prepare_late(), @enter(),
     126             :  *      and @wake() will not be called in that case).
     127             :  *
     128             :  * @prepare_late: Finish preparing the platform for entering the system sleep
     129             :  *      state indicated by @begin().
     130             :  *      @prepare_late is called before disabling nonboot CPUs and after
     131             :  *      device drivers' late suspend callbacks have been executed.  It returns
     132             :  *      0 on success or a negative error code otherwise, in which case the
     133             :  *      system cannot enter the desired sleep state (@enter() will not be
     134             :  *      executed).
     135             :  *
     136             :  * @enter: Enter the system sleep state indicated by @begin() or represented by
     137             :  *      the argument if @begin() is not implemented.
     138             :  *      This callback is mandatory.  It returns 0 on success or a negative
     139             :  *      error code otherwise, in which case the system cannot enter the desired
     140             :  *      sleep state.
     141             :  *
     142             :  * @wake: Called when the system has just left a sleep state, right after
     143             :  *      the nonboot CPUs have been enabled and before device drivers' early
     144             :  *      resume callbacks are executed.
     145             :  *      This callback is optional, but should be implemented by the platforms
     146             :  *      that implement @prepare_late().  If implemented, it is always called
     147             :  *      after @prepare_late and @enter(), even if one of them fails.
     148             :  *
     149             :  * @finish: Finish wake-up of the platform.
     150             :  *      @finish is called right prior to calling device drivers' regular suspend
     151             :  *      callbacks.
     152             :  *      This callback is optional, but should be implemented by the platforms
     153             :  *      that implement @prepare().  If implemented, it is always called after
     154             :  *      @enter() and @wake(), even if any of them fails.  It is executed after
     155             :  *      a failing @prepare.
     156             :  *
     157             :  * @suspend_again: Returns whether the system should suspend again (true) or
     158             :  *      not (false). If the platform wants to poll sensors or execute some
     159             :  *      code during suspended without invoking userspace and most of devices,
     160             :  *      suspend_again callback is the place assuming that periodic-wakeup or
     161             :  *      alarm-wakeup is already setup. This allows to execute some codes while
     162             :  *      being kept suspended in the view of userland and devices.
     163             :  *
     164             :  * @end: Called by the PM core right after resuming devices, to indicate to
     165             :  *      the platform that the system has returned to the working state or
     166             :  *      the transition to the sleep state has been aborted.
     167             :  *      This callback is optional, but should be implemented by the platforms
     168             :  *      that implement @begin().  Accordingly, platforms implementing @begin()
     169             :  *      should also provide a @end() which cleans up transitions aborted before
     170             :  *      @enter().
     171             :  *
     172             :  * @recover: Recover the platform from a suspend failure.
     173             :  *      Called by the PM core if the suspending of devices fails.
     174             :  *      This callback is optional and should only be implemented by platforms
     175             :  *      which require special recovery actions in that situation.
     176             :  */
     177             : struct platform_suspend_ops {
     178             :         int (*valid)(suspend_state_t state);
     179             :         int (*begin)(suspend_state_t state);
     180             :         int (*prepare)(void);
     181             :         int (*prepare_late)(void);
     182             :         int (*enter)(suspend_state_t state);
     183             :         void (*wake)(void);
     184             :         void (*finish)(void);
     185             :         bool (*suspend_again)(void);
     186             :         void (*end)(void);
     187             :         void (*recover)(void);
     188             : };
     189             : 
     190             : struct platform_s2idle_ops {
     191             :         int (*begin)(void);
     192             :         int (*prepare)(void);
     193             :         int (*prepare_late)(void);
     194             :         void (*check)(void);
     195             :         bool (*wake)(void);
     196             :         void (*restore_early)(void);
     197             :         void (*restore)(void);
     198             :         void (*end)(void);
     199             : };
     200             : 
     201             : #ifdef CONFIG_SUSPEND
     202             : extern suspend_state_t mem_sleep_current;
     203             : extern suspend_state_t mem_sleep_default;
     204             : 
     205             : /**
     206             :  * suspend_set_ops - set platform dependent suspend operations
     207             :  * @ops: The new suspend operations to set.
     208             :  */
     209             : extern void suspend_set_ops(const struct platform_suspend_ops *ops);
     210             : extern int suspend_valid_only_mem(suspend_state_t state);
     211             : 
     212             : extern unsigned int pm_suspend_global_flags;
     213             : 
     214             : #define PM_SUSPEND_FLAG_FW_SUSPEND      BIT(0)
     215             : #define PM_SUSPEND_FLAG_FW_RESUME       BIT(1)
     216             : #define PM_SUSPEND_FLAG_NO_PLATFORM     BIT(2)
     217             : 
     218             : static inline void pm_suspend_clear_flags(void)
     219             : {
     220           0 :         pm_suspend_global_flags = 0;
     221             : }
     222             : 
     223             : static inline void pm_set_suspend_via_firmware(void)
     224             : {
     225             :         pm_suspend_global_flags |= PM_SUSPEND_FLAG_FW_SUSPEND;
     226             : }
     227             : 
     228             : static inline void pm_set_resume_via_firmware(void)
     229             : {
     230             :         pm_suspend_global_flags |= PM_SUSPEND_FLAG_FW_RESUME;
     231             : }
     232             : 
     233             : static inline void pm_set_suspend_no_platform(void)
     234             : {
     235           0 :         pm_suspend_global_flags |= PM_SUSPEND_FLAG_NO_PLATFORM;
     236             : }
     237             : 
     238             : /**
     239             :  * pm_suspend_via_firmware - Check if platform firmware will suspend the system.
     240             :  *
     241             :  * To be called during system-wide power management transitions to sleep states
     242             :  * or during the subsequent system-wide transitions back to the working state.
     243             :  *
     244             :  * Return 'true' if the platform firmware is going to be invoked at the end of
     245             :  * the system-wide power management transition (to a sleep state) in progress in
     246             :  * order to complete it, or if the platform firmware has been invoked in order
     247             :  * to complete the last (or preceding) transition of the system to a sleep
     248             :  * state.
     249             :  *
     250             :  * This matters if the caller needs or wants to carry out some special actions
     251             :  * depending on whether or not control will be passed to the platform firmware
     252             :  * subsequently (for example, the device may need to be reset before letting the
     253             :  * platform firmware manipulate it, which is not necessary when the platform
     254             :  * firmware is not going to be invoked) or when such special actions may have
     255             :  * been carried out during the preceding transition of the system to a sleep
     256             :  * state (as they may need to be taken into account).
     257             :  */
     258             : static inline bool pm_suspend_via_firmware(void)
     259             : {
     260             :         return !!(pm_suspend_global_flags & PM_SUSPEND_FLAG_FW_SUSPEND);
     261             : }
     262             : 
     263             : /**
     264             :  * pm_resume_via_firmware - Check if platform firmware has woken up the system.
     265             :  *
     266             :  * To be called during system-wide power management transitions from sleep
     267             :  * states.
     268             :  *
     269             :  * Return 'true' if the platform firmware has passed control to the kernel at
     270             :  * the beginning of the system-wide power management transition in progress, so
     271             :  * the event that woke up the system from sleep has been handled by the platform
     272             :  * firmware.
     273             :  */
     274             : static inline bool pm_resume_via_firmware(void)
     275             : {
     276           0 :         return !!(pm_suspend_global_flags & PM_SUSPEND_FLAG_FW_RESUME);
     277             : }
     278             : 
     279             : /**
     280             :  * pm_suspend_no_platform - Check if platform may change device power states.
     281             :  *
     282             :  * To be called during system-wide power management transitions to sleep states
     283             :  * or during the subsequent system-wide transitions back to the working state.
     284             :  *
     285             :  * Return 'true' if the power states of devices remain under full control of the
     286             :  * kernel throughout the system-wide suspend and resume cycle in progress (that
     287             :  * is, if a device is put into a certain power state during suspend, it can be
     288             :  * expected to remain in that state during resume).
     289             :  */
     290             : static inline bool pm_suspend_no_platform(void)
     291             : {
     292           0 :         return !!(pm_suspend_global_flags & PM_SUSPEND_FLAG_NO_PLATFORM);
     293             : }
     294             : 
     295             : /* Suspend-to-idle state machnine. */
     296             : enum s2idle_states {
     297             :         S2IDLE_STATE_NONE,      /* Not suspended/suspending. */
     298             :         S2IDLE_STATE_ENTER,     /* Enter suspend-to-idle. */
     299             :         S2IDLE_STATE_WAKE,      /* Wake up from suspend-to-idle. */
     300             : };
     301             : 
     302             : extern enum s2idle_states __read_mostly s2idle_state;
     303             : 
     304             : static inline bool idle_should_enter_s2idle(void)
     305             : {
     306             :         return unlikely(s2idle_state == S2IDLE_STATE_ENTER);
     307             : }
     308             : 
     309             : extern bool pm_suspend_default_s2idle(void);
     310             : extern void __init pm_states_init(void);
     311             : extern void s2idle_set_ops(const struct platform_s2idle_ops *ops);
     312             : extern void s2idle_wake(void);
     313             : 
     314             : /**
     315             :  * arch_suspend_disable_irqs - disable IRQs for suspend
     316             :  *
     317             :  * Disables IRQs (in the default case). This is a weak symbol in the common
     318             :  * code and thus allows architectures to override it if more needs to be
     319             :  * done. Not called for suspend to disk.
     320             :  */
     321             : extern void arch_suspend_disable_irqs(void);
     322             : 
     323             : /**
     324             :  * arch_suspend_enable_irqs - enable IRQs after suspend
     325             :  *
     326             :  * Enables IRQs (in the default case). This is a weak symbol in the common
     327             :  * code and thus allows architectures to override it if more needs to be
     328             :  * done. Not called for suspend to disk.
     329             :  */
     330             : extern void arch_suspend_enable_irqs(void);
     331             : 
     332             : extern int pm_suspend(suspend_state_t state);
     333             : extern bool sync_on_suspend_enabled;
     334             : #else /* !CONFIG_SUSPEND */
     335             : #define suspend_valid_only_mem  NULL
     336             : 
     337             : static inline void pm_suspend_clear_flags(void) {}
     338             : static inline void pm_set_suspend_via_firmware(void) {}
     339             : static inline void pm_set_resume_via_firmware(void) {}
     340             : static inline bool pm_suspend_via_firmware(void) { return false; }
     341             : static inline bool pm_resume_via_firmware(void) { return false; }
     342             : static inline bool pm_suspend_no_platform(void) { return false; }
     343             : static inline bool pm_suspend_default_s2idle(void) { return false; }
     344             : 
     345             : static inline void suspend_set_ops(const struct platform_suspend_ops *ops) {}
     346             : static inline int pm_suspend(suspend_state_t state) { return -ENOSYS; }
     347             : static inline bool sync_on_suspend_enabled(void) { return true; }
     348             : static inline bool idle_should_enter_s2idle(void) { return false; }
     349             : static inline void __init pm_states_init(void) {}
     350             : static inline void s2idle_set_ops(const struct platform_s2idle_ops *ops) {}
     351             : static inline void s2idle_wake(void) {}
     352             : #endif /* !CONFIG_SUSPEND */
     353             : 
     354             : /* struct pbe is used for creating lists of pages that should be restored
     355             :  * atomically during the resume from disk, because the page frames they have
     356             :  * occupied before the suspend are in use.
     357             :  */
     358             : struct pbe {
     359             :         void *address;          /* address of the copy */
     360             :         void *orig_address;     /* original address of a page */
     361             :         struct pbe *next;
     362             : };
     363             : 
     364             : /* mm/page_alloc.c */
     365             : extern void mark_free_pages(struct zone *zone);
     366             : 
     367             : /**
     368             :  * struct platform_hibernation_ops - hibernation platform support
     369             :  *
     370             :  * The methods in this structure allow a platform to carry out special
     371             :  * operations required by it during a hibernation transition.
     372             :  *
     373             :  * All the methods below, except for @recover(), must be implemented.
     374             :  *
     375             :  * @begin: Tell the platform driver that we're starting hibernation.
     376             :  *      Called right after shrinking memory and before freezing devices.
     377             :  *
     378             :  * @end: Called by the PM core right after resuming devices, to indicate to
     379             :  *      the platform that the system has returned to the working state.
     380             :  *
     381             :  * @pre_snapshot: Prepare the platform for creating the hibernation image.
     382             :  *      Called right after devices have been frozen and before the nonboot
     383             :  *      CPUs are disabled (runs with IRQs on).
     384             :  *
     385             :  * @finish: Restore the previous state of the platform after the hibernation
     386             :  *      image has been created *or* put the platform into the normal operation
     387             :  *      mode after the hibernation (the same method is executed in both cases).
     388             :  *      Called right after the nonboot CPUs have been enabled and before
     389             :  *      thawing devices (runs with IRQs on).
     390             :  *
     391             :  * @prepare: Prepare the platform for entering the low power state.
     392             :  *      Called right after the hibernation image has been saved and before
     393             :  *      devices are prepared for entering the low power state.
     394             :  *
     395             :  * @enter: Put the system into the low power state after the hibernation image
     396             :  *      has been saved to disk.
     397             :  *      Called after the nonboot CPUs have been disabled and all of the low
     398             :  *      level devices have been shut down (runs with IRQs off).
     399             :  *
     400             :  * @leave: Perform the first stage of the cleanup after the system sleep state
     401             :  *      indicated by @set_target() has been left.
     402             :  *      Called right after the control has been passed from the boot kernel to
     403             :  *      the image kernel, before the nonboot CPUs are enabled and before devices
     404             :  *      are resumed.  Executed with interrupts disabled.
     405             :  *
     406             :  * @pre_restore: Prepare system for the restoration from a hibernation image.
     407             :  *      Called right after devices have been frozen and before the nonboot
     408             :  *      CPUs are disabled (runs with IRQs on).
     409             :  *
     410             :  * @restore_cleanup: Clean up after a failing image restoration.
     411             :  *      Called right after the nonboot CPUs have been enabled and before
     412             :  *      thawing devices (runs with IRQs on).
     413             :  *
     414             :  * @recover: Recover the platform from a failure to suspend devices.
     415             :  *      Called by the PM core if the suspending of devices during hibernation
     416             :  *      fails.  This callback is optional and should only be implemented by
     417             :  *      platforms which require special recovery actions in that situation.
     418             :  */
     419             : struct platform_hibernation_ops {
     420             :         int (*begin)(pm_message_t stage);
     421             :         void (*end)(void);
     422             :         int (*pre_snapshot)(void);
     423             :         void (*finish)(void);
     424             :         int (*prepare)(void);
     425             :         int (*enter)(void);
     426             :         void (*leave)(void);
     427             :         int (*pre_restore)(void);
     428             :         void (*restore_cleanup)(void);
     429             :         void (*recover)(void);
     430             : };
     431             : 
     432             : #ifdef CONFIG_HIBERNATION
     433             : /* kernel/power/snapshot.c */
     434             : extern void register_nosave_region(unsigned long b, unsigned long e);
     435             : extern int swsusp_page_is_forbidden(struct page *);
     436             : extern void swsusp_set_page_free(struct page *);
     437             : extern void swsusp_unset_page_free(struct page *);
     438             : extern unsigned long get_safe_page(gfp_t gfp_mask);
     439             : extern asmlinkage int swsusp_arch_suspend(void);
     440             : extern asmlinkage int swsusp_arch_resume(void);
     441             : 
     442             : extern u32 swsusp_hardware_signature;
     443             : extern void hibernation_set_ops(const struct platform_hibernation_ops *ops);
     444             : extern int hibernate(void);
     445             : extern bool system_entering_hibernation(void);
     446             : extern bool hibernation_available(void);
     447             : asmlinkage int swsusp_save(void);
     448             : extern struct pbe *restore_pblist;
     449             : int pfn_is_nosave(unsigned long pfn);
     450             : 
     451             : int hibernate_quiet_exec(int (*func)(void *data), void *data);
     452             : #else /* CONFIG_HIBERNATION */
     453             : static inline void register_nosave_region(unsigned long b, unsigned long e) {}
     454             : static inline int swsusp_page_is_forbidden(struct page *p) { return 0; }
     455             : static inline void swsusp_set_page_free(struct page *p) {}
     456             : static inline void swsusp_unset_page_free(struct page *p) {}
     457             : 
     458             : static inline void hibernation_set_ops(const struct platform_hibernation_ops *ops) {}
     459             : static inline int hibernate(void) { return -ENOSYS; }
     460             : static inline bool system_entering_hibernation(void) { return false; }
     461             : static inline bool hibernation_available(void) { return false; }
     462             : 
     463             : static inline int hibernate_quiet_exec(int (*func)(void *data), void *data) {
     464             :         return -ENOTSUPP;
     465             : }
     466             : #endif /* CONFIG_HIBERNATION */
     467             : 
     468             : #ifdef CONFIG_HIBERNATION_SNAPSHOT_DEV
     469             : int is_hibernate_resume_dev(dev_t dev);
     470             : #else
     471             : static inline int is_hibernate_resume_dev(dev_t dev) { return 0; }
     472             : #endif
     473             : 
     474             : /* Hibernation and suspend events */
     475             : #define PM_HIBERNATION_PREPARE  0x0001 /* Going to hibernate */
     476             : #define PM_POST_HIBERNATION     0x0002 /* Hibernation finished */
     477             : #define PM_SUSPEND_PREPARE      0x0003 /* Going to suspend the system */
     478             : #define PM_POST_SUSPEND         0x0004 /* Suspend finished */
     479             : #define PM_RESTORE_PREPARE      0x0005 /* Going to restore a saved image */
     480             : #define PM_POST_RESTORE         0x0006 /* Restore failed */
     481             : 
     482             : extern struct mutex system_transition_mutex;
     483             : 
     484             : #ifdef CONFIG_PM_SLEEP
     485             : void save_processor_state(void);
     486             : void restore_processor_state(void);
     487             : 
     488             : /* kernel/power/main.c */
     489             : extern int register_pm_notifier(struct notifier_block *nb);
     490             : extern int unregister_pm_notifier(struct notifier_block *nb);
     491             : extern void ksys_sync_helper(void);
     492             : 
     493             : #define pm_notifier(fn, pri) {                          \
     494             :         static struct notifier_block fn##_nb =                  \
     495             :                 { .notifier_call = fn, .priority = pri };       \
     496             :         register_pm_notifier(&fn##_nb);                     \
     497             : }
     498             : 
     499             : /* drivers/base/power/wakeup.c */
     500             : extern bool events_check_enabled;
     501             : extern suspend_state_t pm_suspend_target_state;
     502             : 
     503             : extern bool pm_wakeup_pending(void);
     504             : extern void pm_system_wakeup(void);
     505             : extern void pm_system_cancel_wakeup(void);
     506             : extern void pm_wakeup_clear(unsigned int irq_number);
     507             : extern void pm_system_irq_wakeup(unsigned int irq_number);
     508             : extern unsigned int pm_wakeup_irq(void);
     509             : extern bool pm_get_wakeup_count(unsigned int *count, bool block);
     510             : extern bool pm_save_wakeup_count(unsigned int count);
     511             : extern void pm_wakep_autosleep_enabled(bool set);
     512             : extern void pm_print_active_wakeup_sources(void);
     513             : 
     514             : extern unsigned int lock_system_sleep(void);
     515             : extern void unlock_system_sleep(unsigned int);
     516             : 
     517             : #else /* !CONFIG_PM_SLEEP */
     518             : 
     519             : static inline int register_pm_notifier(struct notifier_block *nb)
     520             : {
     521             :         return 0;
     522             : }
     523             : 
     524             : static inline int unregister_pm_notifier(struct notifier_block *nb)
     525             : {
     526             :         return 0;
     527             : }
     528             : 
     529             : static inline void ksys_sync_helper(void) {}
     530             : 
     531             : #define pm_notifier(fn, pri)    do { (void)(fn); } while (0)
     532             : 
     533             : static inline bool pm_wakeup_pending(void) { return false; }
     534             : static inline void pm_system_wakeup(void) {}
     535             : static inline void pm_wakeup_clear(bool reset) {}
     536             : static inline void pm_system_irq_wakeup(unsigned int irq_number) {}
     537             : 
     538             : static inline unsigned int lock_system_sleep(void) { return 0; }
     539             : static inline void unlock_system_sleep(unsigned int flags) {}
     540             : 
     541             : #endif /* !CONFIG_PM_SLEEP */
     542             : 
     543             : #ifdef CONFIG_PM_SLEEP_DEBUG
     544             : extern bool pm_print_times_enabled;
     545             : extern bool pm_debug_messages_on;
     546             : static inline int pm_dyn_debug_messages_on(void)
     547             : {
     548             : #ifdef CONFIG_DYNAMIC_DEBUG
     549             :         return 1;
     550             : #else
     551             :         return 0;
     552             : #endif
     553             : }
     554             : #ifndef pr_fmt
     555             : #define pr_fmt(fmt) "PM: " fmt
     556             : #endif
     557             : #define __pm_pr_dbg(fmt, ...)                                   \
     558             :         do {                                                    \
     559             :                 if (pm_debug_messages_on)                       \
     560             :                         printk(KERN_DEBUG pr_fmt(fmt), ##__VA_ARGS__);  \
     561             :                 else if (pm_dyn_debug_messages_on())            \
     562             :                         pr_debug(fmt, ##__VA_ARGS__);   \
     563             :         } while (0)
     564             : #define __pm_deferred_pr_dbg(fmt, ...)                          \
     565             :         do {                                                    \
     566             :                 if (pm_debug_messages_on)                       \
     567             :                         printk_deferred(KERN_DEBUG pr_fmt(fmt), ##__VA_ARGS__); \
     568             :         } while (0)
     569             : #else
     570             : #define pm_print_times_enabled  (false)
     571             : #define pm_debug_messages_on    (false)
     572             : 
     573             : #include <linux/printk.h>
     574             : 
     575             : #define __pm_pr_dbg(fmt, ...) \
     576             :         no_printk(KERN_DEBUG pr_fmt(fmt), ##__VA_ARGS__)
     577             : #define __pm_deferred_pr_dbg(fmt, ...) \
     578             :         no_printk(KERN_DEBUG pr_fmt(fmt), ##__VA_ARGS__)
     579             : #endif
     580             : 
     581             : /**
     582             :  * pm_pr_dbg - print pm sleep debug messages
     583             :  *
     584             :  * If pm_debug_messages_on is enabled, print message.
     585             :  * If pm_debug_messages_on is disabled and CONFIG_DYNAMIC_DEBUG is enabled,
     586             :  *      print message only from instances explicitly enabled on dynamic debug's
     587             :  *      control.
     588             :  * If pm_debug_messages_on is disabled and CONFIG_DYNAMIC_DEBUG is disabled,
     589             :  *      don't print message.
     590             :  */
     591             : #define pm_pr_dbg(fmt, ...) \
     592             :         __pm_pr_dbg(fmt, ##__VA_ARGS__)
     593             : 
     594             : #define pm_deferred_pr_dbg(fmt, ...) \
     595             :         __pm_deferred_pr_dbg(fmt, ##__VA_ARGS__)
     596             : 
     597             : #ifdef CONFIG_PM_AUTOSLEEP
     598             : 
     599             : /* kernel/power/autosleep.c */
     600             : void queue_up_suspend_work(void);
     601             : 
     602             : #else /* !CONFIG_PM_AUTOSLEEP */
     603             : 
     604             : static inline void queue_up_suspend_work(void) {}
     605             : 
     606             : #endif /* !CONFIG_PM_AUTOSLEEP */
     607             : 
     608             : #endif /* _LINUX_SUSPEND_H */

Generated by: LCOV version 1.14