xref: /linux-6.15/kernel/power/main.c (revision b52124a7)
155716d26SThomas Gleixner // SPDX-License-Identifier: GPL-2.0-only
21da177e4SLinus Torvalds /*
31da177e4SLinus Torvalds  * kernel/power/main.c - PM subsystem core functionality.
41da177e4SLinus Torvalds  *
51da177e4SLinus Torvalds  * Copyright (c) 2003 Patrick Mochel
61da177e4SLinus Torvalds  * Copyright (c) 2003 Open Source Development Lab
71da177e4SLinus Torvalds  */
81da177e4SLinus Torvalds 
9*b52124a7SMario Limonciello #include <linux/acpi.h>
106e5fdeedSPaul Gortmaker #include <linux/export.h>
111da177e4SLinus Torvalds #include <linux/kobject.h>
121da177e4SLinus Torvalds #include <linux/string.h>
13431d452aSZhonghui Fu #include <linux/pm-trace.h>
145e928f77SRafael J. Wysocki #include <linux/workqueue.h>
152a77c46dSShuoX Liu #include <linux/debugfs.h>
162a77c46dSShuoX Liu #include <linux/seq_file.h>
1755f2503cSPingfan Liu #include <linux/suspend.h>
18b5dee313SHarry Pan #include <linux/syscalls.h>
19f49249d5SBen Dooks #include <linux/pm_runtime.h>
201da177e4SLinus Torvalds 
211da177e4SLinus Torvalds #include "power.h"
221da177e4SLinus Torvalds 
23cd51e61cSRafael J. Wysocki #ifdef CONFIG_PM_SLEEP
24cd51e61cSRafael J. Wysocki 
255950e5d5SPeter Zijlstra unsigned int lock_system_sleep(void)
264bf236a3SBart Van Assche {
275950e5d5SPeter Zijlstra 	unsigned int flags = current->flags;
28f5d39b02SPeter Zijlstra 	current->flags |= PF_NOFREEZE;
2955f2503cSPingfan Liu 	mutex_lock(&system_transition_mutex);
305950e5d5SPeter Zijlstra 	return flags;
314bf236a3SBart Van Assche }
324bf236a3SBart Van Assche EXPORT_SYMBOL_GPL(lock_system_sleep);
334bf236a3SBart Van Assche 
345950e5d5SPeter Zijlstra void unlock_system_sleep(unsigned int flags)
354bf236a3SBart Van Assche {
364bf236a3SBart Van Assche 	/*
374bf236a3SBart Van Assche 	 * Don't use freezer_count() because we don't want the call to
384bf236a3SBart Van Assche 	 * try_to_freeze() here.
394bf236a3SBart Van Assche 	 *
404bf236a3SBart Van Assche 	 * Reason:
414bf236a3SBart Van Assche 	 * Fundamentally, we just don't need it, because freezing condition
4255f2503cSPingfan Liu 	 * doesn't come into effect until we release the
4355f2503cSPingfan Liu 	 * system_transition_mutex lock, since the freezer always works with
4455f2503cSPingfan Liu 	 * system_transition_mutex held.
454bf236a3SBart Van Assche 	 *
464bf236a3SBart Van Assche 	 * More importantly, in the case of hibernation,
474bf236a3SBart Van Assche 	 * unlock_system_sleep() gets called in snapshot_read() and
484bf236a3SBart Van Assche 	 * snapshot_write() when the freezing condition is still in effect.
494bf236a3SBart Van Assche 	 * Which means, if we use try_to_freeze() here, it would make them
504bf236a3SBart Van Assche 	 * enter the refrigerator, thus causing hibernation to lockup.
514bf236a3SBart Van Assche 	 */
52f5d39b02SPeter Zijlstra 	if (!(flags & PF_NOFREEZE))
53f5d39b02SPeter Zijlstra 		current->flags &= ~PF_NOFREEZE;
5455f2503cSPingfan Liu 	mutex_unlock(&system_transition_mutex);
554bf236a3SBart Van Assche }
564bf236a3SBart Van Assche EXPORT_SYMBOL_GPL(unlock_system_sleep);
574bf236a3SBart Van Assche 
58b5dee313SHarry Pan void ksys_sync_helper(void)
59b5dee313SHarry Pan {
60c64546b1SHarry Pan 	ktime_t start;
61c64546b1SHarry Pan 	long elapsed_msecs;
62c64546b1SHarry Pan 
63c64546b1SHarry Pan 	start = ktime_get();
64b5dee313SHarry Pan 	ksys_sync();
65c64546b1SHarry Pan 	elapsed_msecs = ktime_to_ms(ktime_sub(ktime_get(), start));
66c64546b1SHarry Pan 	pr_info("Filesystems sync: %ld.%03ld seconds\n",
67c64546b1SHarry Pan 		elapsed_msecs / MSEC_PER_SEC, elapsed_msecs % MSEC_PER_SEC);
68b5dee313SHarry Pan }
69b5dee313SHarry Pan EXPORT_SYMBOL_GPL(ksys_sync_helper);
70b5dee313SHarry Pan 
7182525756SAlan Stern /* Routines for PM-transition notifications */
7282525756SAlan Stern 
7382525756SAlan Stern static BLOCKING_NOTIFIER_HEAD(pm_chain_head);
7482525756SAlan Stern 
7582525756SAlan Stern int register_pm_notifier(struct notifier_block *nb)
7682525756SAlan Stern {
7782525756SAlan Stern 	return blocking_notifier_chain_register(&pm_chain_head, nb);
7882525756SAlan Stern }
7982525756SAlan Stern EXPORT_SYMBOL_GPL(register_pm_notifier);
8082525756SAlan Stern 
8182525756SAlan Stern int unregister_pm_notifier(struct notifier_block *nb)
8282525756SAlan Stern {
8382525756SAlan Stern 	return blocking_notifier_chain_unregister(&pm_chain_head, nb);
8482525756SAlan Stern }
8582525756SAlan Stern EXPORT_SYMBOL_GPL(unregister_pm_notifier);
8682525756SAlan Stern 
87*b52124a7SMario Limonciello void pm_report_hw_sleep_time(u64 t)
88*b52124a7SMario Limonciello {
89*b52124a7SMario Limonciello 	suspend_stats.last_hw_sleep = t;
90*b52124a7SMario Limonciello 	suspend_stats.total_hw_sleep += t;
91*b52124a7SMario Limonciello }
92*b52124a7SMario Limonciello EXPORT_SYMBOL_GPL(pm_report_hw_sleep_time);
93*b52124a7SMario Limonciello 
94*b52124a7SMario Limonciello void pm_report_max_hw_sleep(u64 t)
95*b52124a7SMario Limonciello {
96*b52124a7SMario Limonciello 	suspend_stats.max_hw_sleep = t;
97*b52124a7SMario Limonciello }
98*b52124a7SMario Limonciello EXPORT_SYMBOL_GPL(pm_report_max_hw_sleep);
99*b52124a7SMario Limonciello 
10070d93298SPeter Zijlstra int pm_notifier_call_chain_robust(unsigned long val_up, unsigned long val_down)
10182525756SAlan Stern {
102ea00f4f4SLianwei Wang 	int ret;
103ea00f4f4SLianwei Wang 
10470d93298SPeter Zijlstra 	ret = blocking_notifier_call_chain_robust(&pm_chain_head, val_up, val_down, NULL);
105f0c077a8SAkinobu Mita 
106f0c077a8SAkinobu Mita 	return notifier_to_errno(ret);
10782525756SAlan Stern }
10870d93298SPeter Zijlstra 
109ea00f4f4SLianwei Wang int pm_notifier_call_chain(unsigned long val)
110ea00f4f4SLianwei Wang {
11170d93298SPeter Zijlstra 	return blocking_notifier_call_chain(&pm_chain_head, val, NULL);
112ea00f4f4SLianwei Wang }
11382525756SAlan Stern 
1140e06b4a8SRafael J. Wysocki /* If set, devices may be suspended and resumed asynchronously. */
1150e06b4a8SRafael J. Wysocki int pm_async_enabled = 1;
1160e06b4a8SRafael J. Wysocki 
1170e06b4a8SRafael J. Wysocki static ssize_t pm_async_show(struct kobject *kobj, struct kobj_attribute *attr,
1180e06b4a8SRafael J. Wysocki 			     char *buf)
1190e06b4a8SRafael J. Wysocki {
1200e06b4a8SRafael J. Wysocki 	return sprintf(buf, "%d\n", pm_async_enabled);
1210e06b4a8SRafael J. Wysocki }
1220e06b4a8SRafael J. Wysocki 
1230e06b4a8SRafael J. Wysocki static ssize_t pm_async_store(struct kobject *kobj, struct kobj_attribute *attr,
1240e06b4a8SRafael J. Wysocki 			      const char *buf, size_t n)
1250e06b4a8SRafael J. Wysocki {
1260e06b4a8SRafael J. Wysocki 	unsigned long val;
1270e06b4a8SRafael J. Wysocki 
128883ee4f7SDaniel Walter 	if (kstrtoul(buf, 10, &val))
1290e06b4a8SRafael J. Wysocki 		return -EINVAL;
1300e06b4a8SRafael J. Wysocki 
1310e06b4a8SRafael J. Wysocki 	if (val > 1)
1320e06b4a8SRafael J. Wysocki 		return -EINVAL;
1330e06b4a8SRafael J. Wysocki 
1340e06b4a8SRafael J. Wysocki 	pm_async_enabled = val;
1350e06b4a8SRafael J. Wysocki 	return n;
1360e06b4a8SRafael J. Wysocki }
1370e06b4a8SRafael J. Wysocki 
1380e06b4a8SRafael J. Wysocki power_attr(pm_async);
1390e06b4a8SRafael J. Wysocki 
140406e7938SRafael J. Wysocki #ifdef CONFIG_SUSPEND
141406e7938SRafael J. Wysocki static ssize_t mem_sleep_show(struct kobject *kobj, struct kobj_attribute *attr,
142406e7938SRafael J. Wysocki 			      char *buf)
143406e7938SRafael J. Wysocki {
144406e7938SRafael J. Wysocki 	char *s = buf;
145406e7938SRafael J. Wysocki 	suspend_state_t i;
146406e7938SRafael J. Wysocki 
1479ea4dcf4SDan Williams 	for (i = PM_SUSPEND_MIN; i < PM_SUSPEND_MAX; i++) {
1489ea4dcf4SDan Williams 		if (i >= PM_SUSPEND_MEM && cxl_mem_active())
1499ea4dcf4SDan Williams 			continue;
150406e7938SRafael J. Wysocki 		if (mem_sleep_states[i]) {
151406e7938SRafael J. Wysocki 			const char *label = mem_sleep_states[i];
152406e7938SRafael J. Wysocki 
153406e7938SRafael J. Wysocki 			if (mem_sleep_current == i)
154406e7938SRafael J. Wysocki 				s += sprintf(s, "[%s] ", label);
155406e7938SRafael J. Wysocki 			else
156406e7938SRafael J. Wysocki 				s += sprintf(s, "%s ", label);
157406e7938SRafael J. Wysocki 		}
1589ea4dcf4SDan Williams 	}
159406e7938SRafael J. Wysocki 
160406e7938SRafael J. Wysocki 	/* Convert the last space to a newline if needed. */
161406e7938SRafael J. Wysocki 	if (s != buf)
162406e7938SRafael J. Wysocki 		*(s-1) = '\n';
163406e7938SRafael J. Wysocki 
164406e7938SRafael J. Wysocki 	return (s - buf);
165406e7938SRafael J. Wysocki }
166406e7938SRafael J. Wysocki 
167406e7938SRafael J. Wysocki static suspend_state_t decode_suspend_state(const char *buf, size_t n)
168406e7938SRafael J. Wysocki {
169406e7938SRafael J. Wysocki 	suspend_state_t state;
170406e7938SRafael J. Wysocki 	char *p;
171406e7938SRafael J. Wysocki 	int len;
172406e7938SRafael J. Wysocki 
173406e7938SRafael J. Wysocki 	p = memchr(buf, '\n', n);
174406e7938SRafael J. Wysocki 	len = p ? p - buf : n;
175406e7938SRafael J. Wysocki 
176406e7938SRafael J. Wysocki 	for (state = PM_SUSPEND_MIN; state < PM_SUSPEND_MAX; state++) {
177406e7938SRafael J. Wysocki 		const char *label = mem_sleep_states[state];
178406e7938SRafael J. Wysocki 
179406e7938SRafael J. Wysocki 		if (label && len == strlen(label) && !strncmp(buf, label, len))
180406e7938SRafael J. Wysocki 			return state;
181406e7938SRafael J. Wysocki 	}
182406e7938SRafael J. Wysocki 
183406e7938SRafael J. Wysocki 	return PM_SUSPEND_ON;
184406e7938SRafael J. Wysocki }
185406e7938SRafael J. Wysocki 
186406e7938SRafael J. Wysocki static ssize_t mem_sleep_store(struct kobject *kobj, struct kobj_attribute *attr,
187406e7938SRafael J. Wysocki 			       const char *buf, size_t n)
188406e7938SRafael J. Wysocki {
189406e7938SRafael J. Wysocki 	suspend_state_t state;
190406e7938SRafael J. Wysocki 	int error;
191406e7938SRafael J. Wysocki 
192406e7938SRafael J. Wysocki 	error = pm_autosleep_lock();
193406e7938SRafael J. Wysocki 	if (error)
194406e7938SRafael J. Wysocki 		return error;
195406e7938SRafael J. Wysocki 
196406e7938SRafael J. Wysocki 	if (pm_autosleep_state() > PM_SUSPEND_ON) {
197406e7938SRafael J. Wysocki 		error = -EBUSY;
198406e7938SRafael J. Wysocki 		goto out;
199406e7938SRafael J. Wysocki 	}
200406e7938SRafael J. Wysocki 
201406e7938SRafael J. Wysocki 	state = decode_suspend_state(buf, n);
202406e7938SRafael J. Wysocki 	if (state < PM_SUSPEND_MAX && state > PM_SUSPEND_ON)
203406e7938SRafael J. Wysocki 		mem_sleep_current = state;
204406e7938SRafael J. Wysocki 	else
205406e7938SRafael J. Wysocki 		error = -EINVAL;
206406e7938SRafael J. Wysocki 
207406e7938SRafael J. Wysocki  out:
208406e7938SRafael J. Wysocki 	pm_autosleep_unlock();
209406e7938SRafael J. Wysocki 	return error ? error : n;
210406e7938SRafael J. Wysocki }
211406e7938SRafael J. Wysocki 
212406e7938SRafael J. Wysocki power_attr(mem_sleep);
213c052bf82SJonas Meurer 
214c052bf82SJonas Meurer /*
215c052bf82SJonas Meurer  * sync_on_suspend: invoke ksys_sync_helper() before suspend.
216c052bf82SJonas Meurer  *
217c052bf82SJonas Meurer  * show() returns whether ksys_sync_helper() is invoked before suspend.
218c052bf82SJonas Meurer  * store() accepts 0 or 1.  0 disables ksys_sync_helper() and 1 enables it.
219c052bf82SJonas Meurer  */
220c052bf82SJonas Meurer bool sync_on_suspend_enabled = !IS_ENABLED(CONFIG_SUSPEND_SKIP_SYNC);
221c052bf82SJonas Meurer 
222c052bf82SJonas Meurer static ssize_t sync_on_suspend_show(struct kobject *kobj,
223c052bf82SJonas Meurer 				   struct kobj_attribute *attr, char *buf)
224c052bf82SJonas Meurer {
225c052bf82SJonas Meurer 	return sprintf(buf, "%d\n", sync_on_suspend_enabled);
226c052bf82SJonas Meurer }
227c052bf82SJonas Meurer 
228c052bf82SJonas Meurer static ssize_t sync_on_suspend_store(struct kobject *kobj,
229c052bf82SJonas Meurer 				    struct kobj_attribute *attr,
230c052bf82SJonas Meurer 				    const char *buf, size_t n)
231c052bf82SJonas Meurer {
232c052bf82SJonas Meurer 	unsigned long val;
233c052bf82SJonas Meurer 
234c052bf82SJonas Meurer 	if (kstrtoul(buf, 10, &val))
235c052bf82SJonas Meurer 		return -EINVAL;
236c052bf82SJonas Meurer 
237c052bf82SJonas Meurer 	if (val > 1)
238c052bf82SJonas Meurer 		return -EINVAL;
239c052bf82SJonas Meurer 
240c052bf82SJonas Meurer 	sync_on_suspend_enabled = !!val;
241c052bf82SJonas Meurer 	return n;
242c052bf82SJonas Meurer }
243c052bf82SJonas Meurer 
244c052bf82SJonas Meurer power_attr(sync_on_suspend);
245406e7938SRafael J. Wysocki #endif /* CONFIG_SUSPEND */
246406e7938SRafael J. Wysocki 
247e516a1dbSRafael J. Wysocki #ifdef CONFIG_PM_SLEEP_DEBUG
2480e7d56e3SRafael J. Wysocki int pm_test_level = TEST_NONE;
2490e7d56e3SRafael J. Wysocki 
2500e7d56e3SRafael J. Wysocki static const char * const pm_tests[__TEST_AFTER_LAST] = {
2510e7d56e3SRafael J. Wysocki 	[TEST_NONE] = "none",
2520e7d56e3SRafael J. Wysocki 	[TEST_CORE] = "core",
2530e7d56e3SRafael J. Wysocki 	[TEST_CPUS] = "processors",
2540e7d56e3SRafael J. Wysocki 	[TEST_PLATFORM] = "platform",
2550e7d56e3SRafael J. Wysocki 	[TEST_DEVICES] = "devices",
2560e7d56e3SRafael J. Wysocki 	[TEST_FREEZER] = "freezer",
2570e7d56e3SRafael J. Wysocki };
2580e7d56e3SRafael J. Wysocki 
259039a75c6SRafael J. Wysocki static ssize_t pm_test_show(struct kobject *kobj, struct kobj_attribute *attr,
260039a75c6SRafael J. Wysocki 				char *buf)
2610e7d56e3SRafael J. Wysocki {
2620e7d56e3SRafael J. Wysocki 	char *s = buf;
2630e7d56e3SRafael J. Wysocki 	int level;
2640e7d56e3SRafael J. Wysocki 
2650e7d56e3SRafael J. Wysocki 	for (level = TEST_FIRST; level <= TEST_MAX; level++)
2660e7d56e3SRafael J. Wysocki 		if (pm_tests[level]) {
2670e7d56e3SRafael J. Wysocki 			if (level == pm_test_level)
2680e7d56e3SRafael J. Wysocki 				s += sprintf(s, "[%s] ", pm_tests[level]);
2690e7d56e3SRafael J. Wysocki 			else
2700e7d56e3SRafael J. Wysocki 				s += sprintf(s, "%s ", pm_tests[level]);
2710e7d56e3SRafael J. Wysocki 		}
2720e7d56e3SRafael J. Wysocki 
2730e7d56e3SRafael J. Wysocki 	if (s != buf)
2740e7d56e3SRafael J. Wysocki 		/* convert the last space to a newline */
2750e7d56e3SRafael J. Wysocki 		*(s-1) = '\n';
2760e7d56e3SRafael J. Wysocki 
2770e7d56e3SRafael J. Wysocki 	return (s - buf);
2780e7d56e3SRafael J. Wysocki }
2790e7d56e3SRafael J. Wysocki 
280039a75c6SRafael J. Wysocki static ssize_t pm_test_store(struct kobject *kobj, struct kobj_attribute *attr,
281039a75c6SRafael J. Wysocki 				const char *buf, size_t n)
2820e7d56e3SRafael J. Wysocki {
2835950e5d5SPeter Zijlstra 	unsigned int sleep_flags;
2840e7d56e3SRafael J. Wysocki 	const char * const *s;
2855950e5d5SPeter Zijlstra 	int error = -EINVAL;
2860e7d56e3SRafael J. Wysocki 	int level;
2870e7d56e3SRafael J. Wysocki 	char *p;
2880e7d56e3SRafael J. Wysocki 	int len;
2890e7d56e3SRafael J. Wysocki 
2900e7d56e3SRafael J. Wysocki 	p = memchr(buf, '\n', n);
2910e7d56e3SRafael J. Wysocki 	len = p ? p - buf : n;
2920e7d56e3SRafael J. Wysocki 
2935950e5d5SPeter Zijlstra 	sleep_flags = lock_system_sleep();
2940e7d56e3SRafael J. Wysocki 
2950e7d56e3SRafael J. Wysocki 	level = TEST_FIRST;
2960e7d56e3SRafael J. Wysocki 	for (s = &pm_tests[level]; level <= TEST_MAX; s++, level++)
2970e7d56e3SRafael J. Wysocki 		if (*s && len == strlen(*s) && !strncmp(buf, *s, len)) {
2980e7d56e3SRafael J. Wysocki 			pm_test_level = level;
2990e7d56e3SRafael J. Wysocki 			error = 0;
3000e7d56e3SRafael J. Wysocki 			break;
3010e7d56e3SRafael J. Wysocki 		}
3020e7d56e3SRafael J. Wysocki 
3035950e5d5SPeter Zijlstra 	unlock_system_sleep(sleep_flags);
3040e7d56e3SRafael J. Wysocki 
3050e7d56e3SRafael J. Wysocki 	return error ? error : n;
3060e7d56e3SRafael J. Wysocki }
3070e7d56e3SRafael J. Wysocki 
3080e7d56e3SRafael J. Wysocki power_attr(pm_test);
309e516a1dbSRafael J. Wysocki #endif /* CONFIG_PM_SLEEP_DEBUG */
3100e7d56e3SRafael J. Wysocki 
3112a77c46dSShuoX Liu static char *suspend_step_name(enum suspend_stat_step step)
3122a77c46dSShuoX Liu {
3132a77c46dSShuoX Liu 	switch (step) {
3142a77c46dSShuoX Liu 	case SUSPEND_FREEZE:
3152a77c46dSShuoX Liu 		return "freeze";
3162a77c46dSShuoX Liu 	case SUSPEND_PREPARE:
3172a77c46dSShuoX Liu 		return "prepare";
3182a77c46dSShuoX Liu 	case SUSPEND_SUSPEND:
3192a77c46dSShuoX Liu 		return "suspend";
3202a77c46dSShuoX Liu 	case SUSPEND_SUSPEND_NOIRQ:
3212a77c46dSShuoX Liu 		return "suspend_noirq";
3222a77c46dSShuoX Liu 	case SUSPEND_RESUME_NOIRQ:
3232a77c46dSShuoX Liu 		return "resume_noirq";
3242a77c46dSShuoX Liu 	case SUSPEND_RESUME:
3252a77c46dSShuoX Liu 		return "resume";
3262a77c46dSShuoX Liu 	default:
3272a77c46dSShuoX Liu 		return "";
3282a77c46dSShuoX Liu 	}
3292a77c46dSShuoX Liu }
3302a77c46dSShuoX Liu 
331*b52124a7SMario Limonciello #define suspend_attr(_name, format_str)				\
3322c8db5beSKalesh Singh static ssize_t _name##_show(struct kobject *kobj,		\
3332c8db5beSKalesh Singh 		struct kobj_attribute *attr, char *buf)		\
3342c8db5beSKalesh Singh {								\
335*b52124a7SMario Limonciello 	return sprintf(buf, format_str, suspend_stats._name);	\
3362c8db5beSKalesh Singh }								\
3372c8db5beSKalesh Singh static struct kobj_attribute _name = __ATTR_RO(_name)
3382c8db5beSKalesh Singh 
339*b52124a7SMario Limonciello suspend_attr(success, "%d\n");
340*b52124a7SMario Limonciello suspend_attr(fail, "%d\n");
341*b52124a7SMario Limonciello suspend_attr(failed_freeze, "%d\n");
342*b52124a7SMario Limonciello suspend_attr(failed_prepare, "%d\n");
343*b52124a7SMario Limonciello suspend_attr(failed_suspend, "%d\n");
344*b52124a7SMario Limonciello suspend_attr(failed_suspend_late, "%d\n");
345*b52124a7SMario Limonciello suspend_attr(failed_suspend_noirq, "%d\n");
346*b52124a7SMario Limonciello suspend_attr(failed_resume, "%d\n");
347*b52124a7SMario Limonciello suspend_attr(failed_resume_early, "%d\n");
348*b52124a7SMario Limonciello suspend_attr(failed_resume_noirq, "%d\n");
349*b52124a7SMario Limonciello suspend_attr(last_hw_sleep, "%llu\n");
350*b52124a7SMario Limonciello suspend_attr(total_hw_sleep, "%llu\n");
351*b52124a7SMario Limonciello suspend_attr(max_hw_sleep, "%llu\n");
3522c8db5beSKalesh Singh 
3532c8db5beSKalesh Singh static ssize_t last_failed_dev_show(struct kobject *kobj,
3542c8db5beSKalesh Singh 		struct kobj_attribute *attr, char *buf)
3552c8db5beSKalesh Singh {
3562c8db5beSKalesh Singh 	int index;
3572c8db5beSKalesh Singh 	char *last_failed_dev = NULL;
3582c8db5beSKalesh Singh 
3592c8db5beSKalesh Singh 	index = suspend_stats.last_failed_dev + REC_FAILED_NUM - 1;
3602c8db5beSKalesh Singh 	index %= REC_FAILED_NUM;
3612c8db5beSKalesh Singh 	last_failed_dev = suspend_stats.failed_devs[index];
3622c8db5beSKalesh Singh 
3632c8db5beSKalesh Singh 	return sprintf(buf, "%s\n", last_failed_dev);
3642c8db5beSKalesh Singh }
3652c8db5beSKalesh Singh static struct kobj_attribute last_failed_dev = __ATTR_RO(last_failed_dev);
3662c8db5beSKalesh Singh 
3672c8db5beSKalesh Singh static ssize_t last_failed_errno_show(struct kobject *kobj,
3682c8db5beSKalesh Singh 		struct kobj_attribute *attr, char *buf)
3692c8db5beSKalesh Singh {
3702c8db5beSKalesh Singh 	int index;
3712c8db5beSKalesh Singh 	int last_failed_errno;
3722c8db5beSKalesh Singh 
3732c8db5beSKalesh Singh 	index = suspend_stats.last_failed_errno + REC_FAILED_NUM - 1;
3742c8db5beSKalesh Singh 	index %= REC_FAILED_NUM;
3752c8db5beSKalesh Singh 	last_failed_errno = suspend_stats.errno[index];
3762c8db5beSKalesh Singh 
3772c8db5beSKalesh Singh 	return sprintf(buf, "%d\n", last_failed_errno);
3782c8db5beSKalesh Singh }
3792c8db5beSKalesh Singh static struct kobj_attribute last_failed_errno = __ATTR_RO(last_failed_errno);
3802c8db5beSKalesh Singh 
3812c8db5beSKalesh Singh static ssize_t last_failed_step_show(struct kobject *kobj,
3822c8db5beSKalesh Singh 		struct kobj_attribute *attr, char *buf)
3832c8db5beSKalesh Singh {
3842c8db5beSKalesh Singh 	int index;
3852c8db5beSKalesh Singh 	enum suspend_stat_step step;
3862c8db5beSKalesh Singh 	char *last_failed_step = NULL;
3872c8db5beSKalesh Singh 
3882c8db5beSKalesh Singh 	index = suspend_stats.last_failed_step + REC_FAILED_NUM - 1;
3892c8db5beSKalesh Singh 	index %= REC_FAILED_NUM;
3902c8db5beSKalesh Singh 	step = suspend_stats.failed_steps[index];
3912c8db5beSKalesh Singh 	last_failed_step = suspend_step_name(step);
3922c8db5beSKalesh Singh 
3932c8db5beSKalesh Singh 	return sprintf(buf, "%s\n", last_failed_step);
3942c8db5beSKalesh Singh }
3952c8db5beSKalesh Singh static struct kobj_attribute last_failed_step = __ATTR_RO(last_failed_step);
3962c8db5beSKalesh Singh 
3972c8db5beSKalesh Singh static struct attribute *suspend_attrs[] = {
3982c8db5beSKalesh Singh 	&success.attr,
3992c8db5beSKalesh Singh 	&fail.attr,
4002c8db5beSKalesh Singh 	&failed_freeze.attr,
4012c8db5beSKalesh Singh 	&failed_prepare.attr,
4022c8db5beSKalesh Singh 	&failed_suspend.attr,
4032c8db5beSKalesh Singh 	&failed_suspend_late.attr,
4042c8db5beSKalesh Singh 	&failed_suspend_noirq.attr,
4052c8db5beSKalesh Singh 	&failed_resume.attr,
4062c8db5beSKalesh Singh 	&failed_resume_early.attr,
4072c8db5beSKalesh Singh 	&failed_resume_noirq.attr,
4082c8db5beSKalesh Singh 	&last_failed_dev.attr,
4092c8db5beSKalesh Singh 	&last_failed_errno.attr,
4102c8db5beSKalesh Singh 	&last_failed_step.attr,
411*b52124a7SMario Limonciello 	&last_hw_sleep.attr,
412*b52124a7SMario Limonciello 	&total_hw_sleep.attr,
413*b52124a7SMario Limonciello 	&max_hw_sleep.attr,
4142c8db5beSKalesh Singh 	NULL,
4152c8db5beSKalesh Singh };
4162c8db5beSKalesh Singh 
417*b52124a7SMario Limonciello static umode_t suspend_attr_is_visible(struct kobject *kobj, struct attribute *attr, int idx)
418*b52124a7SMario Limonciello {
419*b52124a7SMario Limonciello 	if (attr != &last_hw_sleep.attr &&
420*b52124a7SMario Limonciello 	    attr != &total_hw_sleep.attr &&
421*b52124a7SMario Limonciello 	    attr != &max_hw_sleep.attr)
422*b52124a7SMario Limonciello 		return 0444;
423*b52124a7SMario Limonciello 
424*b52124a7SMario Limonciello #ifdef CONFIG_ACPI
425*b52124a7SMario Limonciello 	if (acpi_gbl_FADT.flags & ACPI_FADT_LOW_POWER_S0)
426*b52124a7SMario Limonciello 		return 0444;
427*b52124a7SMario Limonciello #endif
428*b52124a7SMario Limonciello 	return 0;
429*b52124a7SMario Limonciello }
430*b52124a7SMario Limonciello 
43115560574SRikard Falkeborn static const struct attribute_group suspend_attr_group = {
4322c8db5beSKalesh Singh 	.name = "suspend_stats",
4332c8db5beSKalesh Singh 	.attrs = suspend_attrs,
434*b52124a7SMario Limonciello 	.is_visible = suspend_attr_is_visible,
4352c8db5beSKalesh Singh };
4362c8db5beSKalesh Singh 
4372c8db5beSKalesh Singh #ifdef CONFIG_DEBUG_FS
4382a77c46dSShuoX Liu static int suspend_stats_show(struct seq_file *s, void *unused)
4392a77c46dSShuoX Liu {
4402a77c46dSShuoX Liu 	int i, index, last_dev, last_errno, last_step;
4412a77c46dSShuoX Liu 
4422a77c46dSShuoX Liu 	last_dev = suspend_stats.last_failed_dev + REC_FAILED_NUM - 1;
4432a77c46dSShuoX Liu 	last_dev %= REC_FAILED_NUM;
4442a77c46dSShuoX Liu 	last_errno = suspend_stats.last_failed_errno + REC_FAILED_NUM - 1;
4452a77c46dSShuoX Liu 	last_errno %= REC_FAILED_NUM;
4462a77c46dSShuoX Liu 	last_step = suspend_stats.last_failed_step + REC_FAILED_NUM - 1;
4472a77c46dSShuoX Liu 	last_step %= REC_FAILED_NUM;
448cf579dfbSRafael J. Wysocki 	seq_printf(s, "%s: %d\n%s: %d\n%s: %d\n%s: %d\n%s: %d\n"
449cf579dfbSRafael J. Wysocki 			"%s: %d\n%s: %d\n%s: %d\n%s: %d\n%s: %d\n",
4502a77c46dSShuoX Liu 			"success", suspend_stats.success,
4512a77c46dSShuoX Liu 			"fail", suspend_stats.fail,
4522a77c46dSShuoX Liu 			"failed_freeze", suspend_stats.failed_freeze,
4532a77c46dSShuoX Liu 			"failed_prepare", suspend_stats.failed_prepare,
4542a77c46dSShuoX Liu 			"failed_suspend", suspend_stats.failed_suspend,
455cf579dfbSRafael J. Wysocki 			"failed_suspend_late",
456cf579dfbSRafael J. Wysocki 				suspend_stats.failed_suspend_late,
4572a77c46dSShuoX Liu 			"failed_suspend_noirq",
4582a77c46dSShuoX Liu 				suspend_stats.failed_suspend_noirq,
4592a77c46dSShuoX Liu 			"failed_resume", suspend_stats.failed_resume,
460cf579dfbSRafael J. Wysocki 			"failed_resume_early",
461cf579dfbSRafael J. Wysocki 				suspend_stats.failed_resume_early,
4622a77c46dSShuoX Liu 			"failed_resume_noirq",
4632a77c46dSShuoX Liu 				suspend_stats.failed_resume_noirq);
4642a77c46dSShuoX Liu 	seq_printf(s,	"failures:\n  last_failed_dev:\t%-s\n",
4652a77c46dSShuoX Liu 			suspend_stats.failed_devs[last_dev]);
4662a77c46dSShuoX Liu 	for (i = 1; i < REC_FAILED_NUM; i++) {
4672a77c46dSShuoX Liu 		index = last_dev + REC_FAILED_NUM - i;
4682a77c46dSShuoX Liu 		index %= REC_FAILED_NUM;
4692a77c46dSShuoX Liu 		seq_printf(s, "\t\t\t%-s\n",
4702a77c46dSShuoX Liu 			suspend_stats.failed_devs[index]);
4712a77c46dSShuoX Liu 	}
4722a77c46dSShuoX Liu 	seq_printf(s,	"  last_failed_errno:\t%-d\n",
4732a77c46dSShuoX Liu 			suspend_stats.errno[last_errno]);
4742a77c46dSShuoX Liu 	for (i = 1; i < REC_FAILED_NUM; i++) {
4752a77c46dSShuoX Liu 		index = last_errno + REC_FAILED_NUM - i;
4762a77c46dSShuoX Liu 		index %= REC_FAILED_NUM;
4772a77c46dSShuoX Liu 		seq_printf(s, "\t\t\t%-d\n",
4782a77c46dSShuoX Liu 			suspend_stats.errno[index]);
4792a77c46dSShuoX Liu 	}
4802a77c46dSShuoX Liu 	seq_printf(s,	"  last_failed_step:\t%-s\n",
4812a77c46dSShuoX Liu 			suspend_step_name(
4822a77c46dSShuoX Liu 				suspend_stats.failed_steps[last_step]));
4832a77c46dSShuoX Liu 	for (i = 1; i < REC_FAILED_NUM; i++) {
4842a77c46dSShuoX Liu 		index = last_step + REC_FAILED_NUM - i;
4852a77c46dSShuoX Liu 		index %= REC_FAILED_NUM;
4862a77c46dSShuoX Liu 		seq_printf(s, "\t\t\t%-s\n",
4872a77c46dSShuoX Liu 			suspend_step_name(
4882a77c46dSShuoX Liu 				suspend_stats.failed_steps[index]));
4892a77c46dSShuoX Liu 	}
4902a77c46dSShuoX Liu 
4912a77c46dSShuoX Liu 	return 0;
4922a77c46dSShuoX Liu }
493943a10f8SYangtao Li DEFINE_SHOW_ATTRIBUTE(suspend_stats);
4942a77c46dSShuoX Liu 
4952a77c46dSShuoX Liu static int __init pm_debugfs_init(void)
4962a77c46dSShuoX Liu {
4972a77c46dSShuoX Liu 	debugfs_create_file("suspend_stats", S_IFREG | S_IRUGO,
498943a10f8SYangtao Li 			NULL, NULL, &suspend_stats_fops);
4992a77c46dSShuoX Liu 	return 0;
5002a77c46dSShuoX Liu }
5012a77c46dSShuoX Liu 
5022a77c46dSShuoX Liu late_initcall(pm_debugfs_init);
5032a77c46dSShuoX Liu #endif /* CONFIG_DEBUG_FS */
5042a77c46dSShuoX Liu 
505ca123102SRafael J. Wysocki #endif /* CONFIG_PM_SLEEP */
506ca123102SRafael J. Wysocki 
507b2df1d4fSRafael J. Wysocki #ifdef CONFIG_PM_SLEEP_DEBUG
508b2df1d4fSRafael J. Wysocki /*
509b2df1d4fSRafael J. Wysocki  * pm_print_times: print time taken by devices to suspend and resume.
510b2df1d4fSRafael J. Wysocki  *
511b2df1d4fSRafael J. Wysocki  * show() returns whether printing of suspend and resume times is enabled.
512b2df1d4fSRafael J. Wysocki  * store() accepts 0 or 1.  0 disables printing and 1 enables it.
513b2df1d4fSRafael J. Wysocki  */
514b2df1d4fSRafael J. Wysocki bool pm_print_times_enabled;
515b2df1d4fSRafael J. Wysocki 
516b2df1d4fSRafael J. Wysocki static ssize_t pm_print_times_show(struct kobject *kobj,
517b2df1d4fSRafael J. Wysocki 				   struct kobj_attribute *attr, char *buf)
518b2df1d4fSRafael J. Wysocki {
519b2df1d4fSRafael J. Wysocki 	return sprintf(buf, "%d\n", pm_print_times_enabled);
520b2df1d4fSRafael J. Wysocki }
521b2df1d4fSRafael J. Wysocki 
522b2df1d4fSRafael J. Wysocki static ssize_t pm_print_times_store(struct kobject *kobj,
523b2df1d4fSRafael J. Wysocki 				    struct kobj_attribute *attr,
524b2df1d4fSRafael J. Wysocki 				    const char *buf, size_t n)
525b2df1d4fSRafael J. Wysocki {
526b2df1d4fSRafael J. Wysocki 	unsigned long val;
527b2df1d4fSRafael J. Wysocki 
528b2df1d4fSRafael J. Wysocki 	if (kstrtoul(buf, 10, &val))
529b2df1d4fSRafael J. Wysocki 		return -EINVAL;
530b2df1d4fSRafael J. Wysocki 
531b2df1d4fSRafael J. Wysocki 	if (val > 1)
532b2df1d4fSRafael J. Wysocki 		return -EINVAL;
533b2df1d4fSRafael J. Wysocki 
534b2df1d4fSRafael J. Wysocki 	pm_print_times_enabled = !!val;
535b2df1d4fSRafael J. Wysocki 	return n;
536b2df1d4fSRafael J. Wysocki }
537b2df1d4fSRafael J. Wysocki 
538b2df1d4fSRafael J. Wysocki power_attr(pm_print_times);
539b2df1d4fSRafael J. Wysocki 
540b2df1d4fSRafael J. Wysocki static inline void pm_print_times_init(void)
541b2df1d4fSRafael J. Wysocki {
542b2df1d4fSRafael J. Wysocki 	pm_print_times_enabled = !!initcall_debug;
543b2df1d4fSRafael J. Wysocki }
544a6f5f0ddSAlexandra Yates 
545a6f5f0ddSAlexandra Yates static ssize_t pm_wakeup_irq_show(struct kobject *kobj,
546a6f5f0ddSAlexandra Yates 					struct kobj_attribute *attr,
547a6f5f0ddSAlexandra Yates 					char *buf)
548a6f5f0ddSAlexandra Yates {
549cb1f65c1SRafael J. Wysocki 	if (!pm_wakeup_irq())
550cb1f65c1SRafael J. Wysocki 		return -ENODATA;
551cb1f65c1SRafael J. Wysocki 
552cb1f65c1SRafael J. Wysocki 	return sprintf(buf, "%u\n", pm_wakeup_irq());
553a6f5f0ddSAlexandra Yates }
554a6f5f0ddSAlexandra Yates 
555a1e9ca69SRafael J. Wysocki power_attr_ro(pm_wakeup_irq);
556a6f5f0ddSAlexandra Yates 
557726fb6b4SSrinivas Pandruvada bool pm_debug_messages_on __read_mostly;
5588d8b2441SRafael J. Wysocki 
5598d8b2441SRafael J. Wysocki static ssize_t pm_debug_messages_show(struct kobject *kobj,
5608d8b2441SRafael J. Wysocki 				      struct kobj_attribute *attr, char *buf)
5618d8b2441SRafael J. Wysocki {
5628d8b2441SRafael J. Wysocki 	return sprintf(buf, "%d\n", pm_debug_messages_on);
5638d8b2441SRafael J. Wysocki }
5648d8b2441SRafael J. Wysocki 
5658d8b2441SRafael J. Wysocki static ssize_t pm_debug_messages_store(struct kobject *kobj,
5668d8b2441SRafael J. Wysocki 				       struct kobj_attribute *attr,
5678d8b2441SRafael J. Wysocki 				       const char *buf, size_t n)
5688d8b2441SRafael J. Wysocki {
5698d8b2441SRafael J. Wysocki 	unsigned long val;
5708d8b2441SRafael J. Wysocki 
5718d8b2441SRafael J. Wysocki 	if (kstrtoul(buf, 10, &val))
5728d8b2441SRafael J. Wysocki 		return -EINVAL;
5738d8b2441SRafael J. Wysocki 
5748d8b2441SRafael J. Wysocki 	if (val > 1)
5758d8b2441SRafael J. Wysocki 		return -EINVAL;
5768d8b2441SRafael J. Wysocki 
5778d8b2441SRafael J. Wysocki 	pm_debug_messages_on = !!val;
5788d8b2441SRafael J. Wysocki 	return n;
5798d8b2441SRafael J. Wysocki }
5808d8b2441SRafael J. Wysocki 
5818d8b2441SRafael J. Wysocki power_attr(pm_debug_messages);
5828d8b2441SRafael J. Wysocki 
583db96a759SChen Yu static int __init pm_debug_messages_setup(char *str)
584db96a759SChen Yu {
585db96a759SChen Yu 	pm_debug_messages_on = true;
586db96a759SChen Yu 	return 1;
587db96a759SChen Yu }
588db96a759SChen Yu __setup("pm_debug_messages", pm_debug_messages_setup);
589db96a759SChen Yu 
590819b1bb3SRafael J. Wysocki #else /* !CONFIG_PM_SLEEP_DEBUG */
591b2df1d4fSRafael J. Wysocki static inline void pm_print_times_init(void) {}
592b2df1d4fSRafael J. Wysocki #endif /* CONFIG_PM_SLEEP_DEBUG */
593b2df1d4fSRafael J. Wysocki 
594d76e15fbSGreg Kroah-Hartman struct kobject *power_kobj;
5951da177e4SLinus Torvalds 
596dbcfa715SRandy Dunlap /*
5970399d4dbSRafael J. Wysocki  * state - control system sleep states.
5981da177e4SLinus Torvalds  *
5990399d4dbSRafael J. Wysocki  * show() returns available sleep state labels, which may be "mem", "standby",
60044348e8aSMauro Carvalho Chehab  * "freeze" and "disk" (hibernation).
60144348e8aSMauro Carvalho Chehab  * See Documentation/admin-guide/pm/sleep-states.rst for a description of
60244348e8aSMauro Carvalho Chehab  * what they mean.
6031da177e4SLinus Torvalds  *
6040399d4dbSRafael J. Wysocki  * store() accepts one of those strings, translates it into the proper
6050399d4dbSRafael J. Wysocki  * enumerated value, and initiates a suspend transition.
6061da177e4SLinus Torvalds  */
607386f275fSKay Sievers static ssize_t state_show(struct kobject *kobj, struct kobj_attribute *attr,
608386f275fSKay Sievers 			  char *buf)
6091da177e4SLinus Torvalds {
6101da177e4SLinus Torvalds 	char *s = buf;
611296699deSRafael J. Wysocki #ifdef CONFIG_SUSPEND
61227ddcc65SRafael J. Wysocki 	suspend_state_t i;
6131da177e4SLinus Torvalds 
61427ddcc65SRafael J. Wysocki 	for (i = PM_SUSPEND_MIN; i < PM_SUSPEND_MAX; i++)
615d431cbc5SRafael J. Wysocki 		if (pm_states[i])
616d431cbc5SRafael J. Wysocki 			s += sprintf(s,"%s ", pm_states[i]);
61727ddcc65SRafael J. Wysocki 
618296699deSRafael J. Wysocki #endif
619a6e15a39SKees Cook 	if (hibernation_available())
620a6e15a39SKees Cook 		s += sprintf(s, "disk ");
621a3d25c27SRafael J. Wysocki 	if (s != buf)
622a3d25c27SRafael J. Wysocki 		/* convert the last space to a newline */
623a3d25c27SRafael J. Wysocki 		*(s-1) = '\n';
6241da177e4SLinus Torvalds 	return (s - buf);
6251da177e4SLinus Torvalds }
6261da177e4SLinus Torvalds 
6277483b4a4SRafael J. Wysocki static suspend_state_t decode_state(const char *buf, size_t n)
6281da177e4SLinus Torvalds {
629296699deSRafael J. Wysocki #ifdef CONFIG_SUSPEND
630d431cbc5SRafael J. Wysocki 	suspend_state_t state;
631296699deSRafael J. Wysocki #endif
6321da177e4SLinus Torvalds 	char *p;
6331da177e4SLinus Torvalds 	int len;
6341da177e4SLinus Torvalds 
6351da177e4SLinus Torvalds 	p = memchr(buf, '\n', n);
6361da177e4SLinus Torvalds 	len = p ? p - buf : n;
6371da177e4SLinus Torvalds 
6387483b4a4SRafael J. Wysocki 	/* Check hibernation first. */
639d30bdfc0SChuhong Yuan 	if (len == 4 && str_has_prefix(buf, "disk"))
6407483b4a4SRafael J. Wysocki 		return PM_SUSPEND_MAX;
641a3d25c27SRafael J. Wysocki 
642296699deSRafael J. Wysocki #ifdef CONFIG_SUSPEND
643d431cbc5SRafael J. Wysocki 	for (state = PM_SUSPEND_MIN; state < PM_SUSPEND_MAX; state++) {
644d431cbc5SRafael J. Wysocki 		const char *label = pm_states[state];
645d431cbc5SRafael J. Wysocki 
646d431cbc5SRafael J. Wysocki 		if (label && len == strlen(label) && !strncmp(buf, label, len))
647d431cbc5SRafael J. Wysocki 			return state;
648d431cbc5SRafael J. Wysocki 	}
649296699deSRafael J. Wysocki #endif
650296699deSRafael J. Wysocki 
6517483b4a4SRafael J. Wysocki 	return PM_SUSPEND_ON;
6527483b4a4SRafael J. Wysocki }
6537483b4a4SRafael J. Wysocki 
6547483b4a4SRafael J. Wysocki static ssize_t state_store(struct kobject *kobj, struct kobj_attribute *attr,
6557483b4a4SRafael J. Wysocki 			   const char *buf, size_t n)
6567483b4a4SRafael J. Wysocki {
6577483b4a4SRafael J. Wysocki 	suspend_state_t state;
6587483b4a4SRafael J. Wysocki 	int error;
6597483b4a4SRafael J. Wysocki 
6607483b4a4SRafael J. Wysocki 	error = pm_autosleep_lock();
6617483b4a4SRafael J. Wysocki 	if (error)
6627483b4a4SRafael J. Wysocki 		return error;
6637483b4a4SRafael J. Wysocki 
6647483b4a4SRafael J. Wysocki 	if (pm_autosleep_state() > PM_SUSPEND_ON) {
6657483b4a4SRafael J. Wysocki 		error = -EBUSY;
6667483b4a4SRafael J. Wysocki 		goto out;
6677483b4a4SRafael J. Wysocki 	}
6687483b4a4SRafael J. Wysocki 
6697483b4a4SRafael J. Wysocki 	state = decode_state(buf, n);
670406e7938SRafael J. Wysocki 	if (state < PM_SUSPEND_MAX) {
671406e7938SRafael J. Wysocki 		if (state == PM_SUSPEND_MEM)
672406e7938SRafael J. Wysocki 			state = mem_sleep_current;
673406e7938SRafael J. Wysocki 
6747483b4a4SRafael J. Wysocki 		error = pm_suspend(state);
675406e7938SRafael J. Wysocki 	} else if (state == PM_SUSPEND_MAX) {
6767483b4a4SRafael J. Wysocki 		error = hibernate();
677406e7938SRafael J. Wysocki 	} else {
6787483b4a4SRafael J. Wysocki 		error = -EINVAL;
679406e7938SRafael J. Wysocki 	}
6807483b4a4SRafael J. Wysocki 
6817483b4a4SRafael J. Wysocki  out:
6827483b4a4SRafael J. Wysocki 	pm_autosleep_unlock();
6831da177e4SLinus Torvalds 	return error ? error : n;
6841da177e4SLinus Torvalds }
6851da177e4SLinus Torvalds 
6861da177e4SLinus Torvalds power_attr(state);
6871da177e4SLinus Torvalds 
688c125e96fSRafael J. Wysocki #ifdef CONFIG_PM_SLEEP
689c125e96fSRafael J. Wysocki /*
690c125e96fSRafael J. Wysocki  * The 'wakeup_count' attribute, along with the functions defined in
691c125e96fSRafael J. Wysocki  * drivers/base/power/wakeup.c, provides a means by which wakeup events can be
692c125e96fSRafael J. Wysocki  * handled in a non-racy way.
693c125e96fSRafael J. Wysocki  *
694c125e96fSRafael J. Wysocki  * If a wakeup event occurs when the system is in a sleep state, it simply is
695c125e96fSRafael J. Wysocki  * woken up.  In turn, if an event that would wake the system up from a sleep
696c125e96fSRafael J. Wysocki  * state occurs when it is undergoing a transition to that sleep state, the
697c125e96fSRafael J. Wysocki  * transition should be aborted.  Moreover, if such an event occurs when the
698c125e96fSRafael J. Wysocki  * system is in the working state, an attempt to start a transition to the
699c125e96fSRafael J. Wysocki  * given sleep state should fail during certain period after the detection of
700c125e96fSRafael J. Wysocki  * the event.  Using the 'state' attribute alone is not sufficient to satisfy
701c125e96fSRafael J. Wysocki  * these requirements, because a wakeup event may occur exactly when 'state'
702c125e96fSRafael J. Wysocki  * is being written to and may be delivered to user space right before it is
703c125e96fSRafael J. Wysocki  * frozen, so the event will remain only partially processed until the system is
704c125e96fSRafael J. Wysocki  * woken up by another event.  In particular, it won't cause the transition to
705c125e96fSRafael J. Wysocki  * a sleep state to be aborted.
706c125e96fSRafael J. Wysocki  *
707c125e96fSRafael J. Wysocki  * This difficulty may be overcome if user space uses 'wakeup_count' before
708c125e96fSRafael J. Wysocki  * writing to 'state'.  It first should read from 'wakeup_count' and store
709c125e96fSRafael J. Wysocki  * the read value.  Then, after carrying out its own preparations for the system
710c125e96fSRafael J. Wysocki  * transition to a sleep state, it should write the stored value to
71125985edcSLucas De Marchi  * 'wakeup_count'.  If that fails, at least one wakeup event has occurred since
712c125e96fSRafael J. Wysocki  * 'wakeup_count' was read and 'state' should not be written to.  Otherwise, it
713c125e96fSRafael J. Wysocki  * is allowed to write to 'state', but the transition will be aborted if there
714c125e96fSRafael J. Wysocki  * are any wakeup events detected after 'wakeup_count' was written to.
715c125e96fSRafael J. Wysocki  */
716c125e96fSRafael J. Wysocki 
717c125e96fSRafael J. Wysocki static ssize_t wakeup_count_show(struct kobject *kobj,
718c125e96fSRafael J. Wysocki 				struct kobj_attribute *attr,
719c125e96fSRafael J. Wysocki 				char *buf)
720c125e96fSRafael J. Wysocki {
721074037ecSRafael J. Wysocki 	unsigned int val;
722c125e96fSRafael J. Wysocki 
7237483b4a4SRafael J. Wysocki 	return pm_get_wakeup_count(&val, true) ?
7247483b4a4SRafael J. Wysocki 		sprintf(buf, "%u\n", val) : -EINTR;
725c125e96fSRafael J. Wysocki }
726c125e96fSRafael J. Wysocki 
727c125e96fSRafael J. Wysocki static ssize_t wakeup_count_store(struct kobject *kobj,
728c125e96fSRafael J. Wysocki 				struct kobj_attribute *attr,
729c125e96fSRafael J. Wysocki 				const char *buf, size_t n)
730c125e96fSRafael J. Wysocki {
731074037ecSRafael J. Wysocki 	unsigned int val;
7327483b4a4SRafael J. Wysocki 	int error;
733c125e96fSRafael J. Wysocki 
7347483b4a4SRafael J. Wysocki 	error = pm_autosleep_lock();
7357483b4a4SRafael J. Wysocki 	if (error)
7367483b4a4SRafael J. Wysocki 		return error;
7377483b4a4SRafael J. Wysocki 
7387483b4a4SRafael J. Wysocki 	if (pm_autosleep_state() > PM_SUSPEND_ON) {
7397483b4a4SRafael J. Wysocki 		error = -EBUSY;
7407483b4a4SRafael J. Wysocki 		goto out;
7417483b4a4SRafael J. Wysocki 	}
7427483b4a4SRafael J. Wysocki 
7437483b4a4SRafael J. Wysocki 	error = -EINVAL;
744074037ecSRafael J. Wysocki 	if (sscanf(buf, "%u", &val) == 1) {
745c125e96fSRafael J. Wysocki 		if (pm_save_wakeup_count(val))
7467483b4a4SRafael J. Wysocki 			error = n;
747bb177fedSJulius Werner 		else
748bb177fedSJulius Werner 			pm_print_active_wakeup_sources();
749c125e96fSRafael J. Wysocki 	}
7507483b4a4SRafael J. Wysocki 
7517483b4a4SRafael J. Wysocki  out:
7527483b4a4SRafael J. Wysocki 	pm_autosleep_unlock();
7537483b4a4SRafael J. Wysocki 	return error;
754c125e96fSRafael J. Wysocki }
755c125e96fSRafael J. Wysocki 
756c125e96fSRafael J. Wysocki power_attr(wakeup_count);
7577483b4a4SRafael J. Wysocki 
7587483b4a4SRafael J. Wysocki #ifdef CONFIG_PM_AUTOSLEEP
7597483b4a4SRafael J. Wysocki static ssize_t autosleep_show(struct kobject *kobj,
7607483b4a4SRafael J. Wysocki 			      struct kobj_attribute *attr,
7617483b4a4SRafael J. Wysocki 			      char *buf)
7627483b4a4SRafael J. Wysocki {
7637483b4a4SRafael J. Wysocki 	suspend_state_t state = pm_autosleep_state();
7647483b4a4SRafael J. Wysocki 
7657483b4a4SRafael J. Wysocki 	if (state == PM_SUSPEND_ON)
7667483b4a4SRafael J. Wysocki 		return sprintf(buf, "off\n");
7677483b4a4SRafael J. Wysocki 
7687483b4a4SRafael J. Wysocki #ifdef CONFIG_SUSPEND
7697483b4a4SRafael J. Wysocki 	if (state < PM_SUSPEND_MAX)
770d431cbc5SRafael J. Wysocki 		return sprintf(buf, "%s\n", pm_states[state] ?
771d431cbc5SRafael J. Wysocki 					pm_states[state] : "error");
7727483b4a4SRafael J. Wysocki #endif
7737483b4a4SRafael J. Wysocki #ifdef CONFIG_HIBERNATION
7747483b4a4SRafael J. Wysocki 	return sprintf(buf, "disk\n");
7757483b4a4SRafael J. Wysocki #else
7767483b4a4SRafael J. Wysocki 	return sprintf(buf, "error");
7777483b4a4SRafael J. Wysocki #endif
7787483b4a4SRafael J. Wysocki }
7797483b4a4SRafael J. Wysocki 
7807483b4a4SRafael J. Wysocki static ssize_t autosleep_store(struct kobject *kobj,
7817483b4a4SRafael J. Wysocki 			       struct kobj_attribute *attr,
7827483b4a4SRafael J. Wysocki 			       const char *buf, size_t n)
7837483b4a4SRafael J. Wysocki {
7847483b4a4SRafael J. Wysocki 	suspend_state_t state = decode_state(buf, n);
7857483b4a4SRafael J. Wysocki 	int error;
7867483b4a4SRafael J. Wysocki 
7877483b4a4SRafael J. Wysocki 	if (state == PM_SUSPEND_ON
788040e5bf6SArve Hjønnevåg 	    && strcmp(buf, "off") && strcmp(buf, "off\n"))
7897483b4a4SRafael J. Wysocki 		return -EINVAL;
7907483b4a4SRafael J. Wysocki 
791406e7938SRafael J. Wysocki 	if (state == PM_SUSPEND_MEM)
792406e7938SRafael J. Wysocki 		state = mem_sleep_current;
793406e7938SRafael J. Wysocki 
7947483b4a4SRafael J. Wysocki 	error = pm_autosleep_set_state(state);
7957483b4a4SRafael J. Wysocki 	return error ? error : n;
7967483b4a4SRafael J. Wysocki }
7977483b4a4SRafael J. Wysocki 
7987483b4a4SRafael J. Wysocki power_attr(autosleep);
7997483b4a4SRafael J. Wysocki #endif /* CONFIG_PM_AUTOSLEEP */
800b86ff982SRafael J. Wysocki 
801b86ff982SRafael J. Wysocki #ifdef CONFIG_PM_WAKELOCKS
802b86ff982SRafael J. Wysocki static ssize_t wake_lock_show(struct kobject *kobj,
803b86ff982SRafael J. Wysocki 			      struct kobj_attribute *attr,
804b86ff982SRafael J. Wysocki 			      char *buf)
805b86ff982SRafael J. Wysocki {
806b86ff982SRafael J. Wysocki 	return pm_show_wakelocks(buf, true);
807b86ff982SRafael J. Wysocki }
808b86ff982SRafael J. Wysocki 
809b86ff982SRafael J. Wysocki static ssize_t wake_lock_store(struct kobject *kobj,
810b86ff982SRafael J. Wysocki 			       struct kobj_attribute *attr,
811b86ff982SRafael J. Wysocki 			       const char *buf, size_t n)
812b86ff982SRafael J. Wysocki {
813b86ff982SRafael J. Wysocki 	int error = pm_wake_lock(buf);
814b86ff982SRafael J. Wysocki 	return error ? error : n;
815b86ff982SRafael J. Wysocki }
816b86ff982SRafael J. Wysocki 
817b86ff982SRafael J. Wysocki power_attr(wake_lock);
818b86ff982SRafael J. Wysocki 
819b86ff982SRafael J. Wysocki static ssize_t wake_unlock_show(struct kobject *kobj,
820b86ff982SRafael J. Wysocki 				struct kobj_attribute *attr,
821b86ff982SRafael J. Wysocki 				char *buf)
822b86ff982SRafael J. Wysocki {
823b86ff982SRafael J. Wysocki 	return pm_show_wakelocks(buf, false);
824b86ff982SRafael J. Wysocki }
825b86ff982SRafael J. Wysocki 
826b86ff982SRafael J. Wysocki static ssize_t wake_unlock_store(struct kobject *kobj,
827b86ff982SRafael J. Wysocki 				 struct kobj_attribute *attr,
828b86ff982SRafael J. Wysocki 				 const char *buf, size_t n)
829b86ff982SRafael J. Wysocki {
830b86ff982SRafael J. Wysocki 	int error = pm_wake_unlock(buf);
831b86ff982SRafael J. Wysocki 	return error ? error : n;
832b86ff982SRafael J. Wysocki }
833b86ff982SRafael J. Wysocki 
834b86ff982SRafael J. Wysocki power_attr(wake_unlock);
835b86ff982SRafael J. Wysocki 
836b86ff982SRafael J. Wysocki #endif /* CONFIG_PM_WAKELOCKS */
837c125e96fSRafael J. Wysocki #endif /* CONFIG_PM_SLEEP */
838c125e96fSRafael J. Wysocki 
839c5c6ba4eSRafael J. Wysocki #ifdef CONFIG_PM_TRACE
840c5c6ba4eSRafael J. Wysocki int pm_trace_enabled;
841c5c6ba4eSRafael J. Wysocki 
842386f275fSKay Sievers static ssize_t pm_trace_show(struct kobject *kobj, struct kobj_attribute *attr,
843386f275fSKay Sievers 			     char *buf)
844c5c6ba4eSRafael J. Wysocki {
845c5c6ba4eSRafael J. Wysocki 	return sprintf(buf, "%d\n", pm_trace_enabled);
846c5c6ba4eSRafael J. Wysocki }
847c5c6ba4eSRafael J. Wysocki 
848c5c6ba4eSRafael J. Wysocki static ssize_t
849386f275fSKay Sievers pm_trace_store(struct kobject *kobj, struct kobj_attribute *attr,
850386f275fSKay Sievers 	       const char *buf, size_t n)
851c5c6ba4eSRafael J. Wysocki {
852c5c6ba4eSRafael J. Wysocki 	int val;
853c5c6ba4eSRafael J. Wysocki 
854c5c6ba4eSRafael J. Wysocki 	if (sscanf(buf, "%d", &val) == 1) {
855c5c6ba4eSRafael J. Wysocki 		pm_trace_enabled = !!val;
8569dceefe4SShuah Khan 		if (pm_trace_enabled) {
8579dceefe4SShuah Khan 			pr_warn("PM: Enabling pm_trace changes system date and time during resume.\n"
8589dceefe4SShuah Khan 				"PM: Correct system time has to be restored manually after resume.\n");
8599dceefe4SShuah Khan 		}
860c5c6ba4eSRafael J. Wysocki 		return n;
861c5c6ba4eSRafael J. Wysocki 	}
862c5c6ba4eSRafael J. Wysocki 	return -EINVAL;
863c5c6ba4eSRafael J. Wysocki }
864c5c6ba4eSRafael J. Wysocki 
865c5c6ba4eSRafael J. Wysocki power_attr(pm_trace);
866d33ac60bSJames Hogan 
867d33ac60bSJames Hogan static ssize_t pm_trace_dev_match_show(struct kobject *kobj,
868d33ac60bSJames Hogan 				       struct kobj_attribute *attr,
869d33ac60bSJames Hogan 				       char *buf)
870d33ac60bSJames Hogan {
871d33ac60bSJames Hogan 	return show_trace_dev_match(buf, PAGE_SIZE);
872d33ac60bSJames Hogan }
873d33ac60bSJames Hogan 
874a1e9ca69SRafael J. Wysocki power_attr_ro(pm_trace_dev_match);
875d33ac60bSJames Hogan 
8760e7d56e3SRafael J. Wysocki #endif /* CONFIG_PM_TRACE */
877c5c6ba4eSRafael J. Wysocki 
878957d1282SLi Fei #ifdef CONFIG_FREEZER
879957d1282SLi Fei static ssize_t pm_freeze_timeout_show(struct kobject *kobj,
880957d1282SLi Fei 				      struct kobj_attribute *attr, char *buf)
881957d1282SLi Fei {
882957d1282SLi Fei 	return sprintf(buf, "%u\n", freeze_timeout_msecs);
883957d1282SLi Fei }
884957d1282SLi Fei 
885957d1282SLi Fei static ssize_t pm_freeze_timeout_store(struct kobject *kobj,
886957d1282SLi Fei 				       struct kobj_attribute *attr,
887957d1282SLi Fei 				       const char *buf, size_t n)
888957d1282SLi Fei {
889957d1282SLi Fei 	unsigned long val;
890957d1282SLi Fei 
891957d1282SLi Fei 	if (kstrtoul(buf, 10, &val))
892957d1282SLi Fei 		return -EINVAL;
893957d1282SLi Fei 
894957d1282SLi Fei 	freeze_timeout_msecs = val;
895957d1282SLi Fei 	return n;
896957d1282SLi Fei }
897957d1282SLi Fei 
898957d1282SLi Fei power_attr(pm_freeze_timeout);
899957d1282SLi Fei 
900957d1282SLi Fei #endif	/* CONFIG_FREEZER*/
901957d1282SLi Fei 
902c5c6ba4eSRafael J. Wysocki static struct attribute * g[] = {
903c5c6ba4eSRafael J. Wysocki 	&state_attr.attr,
9040e7d56e3SRafael J. Wysocki #ifdef CONFIG_PM_TRACE
905c5c6ba4eSRafael J. Wysocki 	&pm_trace_attr.attr,
906d33ac60bSJames Hogan 	&pm_trace_dev_match_attr.attr,
9070e7d56e3SRafael J. Wysocki #endif
9080e06b4a8SRafael J. Wysocki #ifdef CONFIG_PM_SLEEP
9090e06b4a8SRafael J. Wysocki 	&pm_async_attr.attr,
910c125e96fSRafael J. Wysocki 	&wakeup_count_attr.attr,
911406e7938SRafael J. Wysocki #ifdef CONFIG_SUSPEND
912406e7938SRafael J. Wysocki 	&mem_sleep_attr.attr,
913c052bf82SJonas Meurer 	&sync_on_suspend_attr.attr,
914406e7938SRafael J. Wysocki #endif
9157483b4a4SRafael J. Wysocki #ifdef CONFIG_PM_AUTOSLEEP
9167483b4a4SRafael J. Wysocki 	&autosleep_attr.attr,
9177483b4a4SRafael J. Wysocki #endif
918b86ff982SRafael J. Wysocki #ifdef CONFIG_PM_WAKELOCKS
919b86ff982SRafael J. Wysocki 	&wake_lock_attr.attr,
920b86ff982SRafael J. Wysocki 	&wake_unlock_attr.attr,
921b86ff982SRafael J. Wysocki #endif
922b2df1d4fSRafael J. Wysocki #ifdef CONFIG_PM_SLEEP_DEBUG
923e516a1dbSRafael J. Wysocki 	&pm_test_attr.attr,
9244b7760baSSameer Nanda 	&pm_print_times_attr.attr,
925a6f5f0ddSAlexandra Yates 	&pm_wakeup_irq_attr.attr,
9268d8b2441SRafael J. Wysocki 	&pm_debug_messages_attr.attr,
9270e7d56e3SRafael J. Wysocki #endif
9280e06b4a8SRafael J. Wysocki #endif
929957d1282SLi Fei #ifdef CONFIG_FREEZER
930957d1282SLi Fei 	&pm_freeze_timeout_attr.attr,
931957d1282SLi Fei #endif
932c5c6ba4eSRafael J. Wysocki 	NULL,
933c5c6ba4eSRafael J. Wysocki };
9341da177e4SLinus Torvalds 
9351d0c6e59SArvind Yadav static const struct attribute_group attr_group = {
9361da177e4SLinus Torvalds 	.attrs = g,
9371da177e4SLinus Torvalds };
9381da177e4SLinus Torvalds 
9392c8db5beSKalesh Singh static const struct attribute_group *attr_groups[] = {
9402c8db5beSKalesh Singh 	&attr_group,
9412c8db5beSKalesh Singh #ifdef CONFIG_PM_SLEEP
9422c8db5beSKalesh Singh 	&suspend_attr_group,
9432c8db5beSKalesh Singh #endif
9442c8db5beSKalesh Singh 	NULL,
9452c8db5beSKalesh Singh };
9462c8db5beSKalesh Singh 
9475e928f77SRafael J. Wysocki struct workqueue_struct *pm_wq;
9487b199ca2SAlan Stern EXPORT_SYMBOL_GPL(pm_wq);
9495e928f77SRafael J. Wysocki 
9505e928f77SRafael J. Wysocki static int __init pm_start_workqueue(void)
9515e928f77SRafael J. Wysocki {
95258a69cb4STejun Heo 	pm_wq = alloc_workqueue("pm", WQ_FREEZABLE, 0);
9535e928f77SRafael J. Wysocki 
9545e928f77SRafael J. Wysocki 	return pm_wq ? 0 : -ENOMEM;
9555e928f77SRafael J. Wysocki }
9565e928f77SRafael J. Wysocki 
9571da177e4SLinus Torvalds static int __init pm_init(void)
9581da177e4SLinus Torvalds {
9595e928f77SRafael J. Wysocki 	int error = pm_start_workqueue();
9605e928f77SRafael J. Wysocki 	if (error)
9615e928f77SRafael J. Wysocki 		return error;
962ac5c24ecSRafael J. Wysocki 	hibernate_image_size_init();
963ddeb6487SRafael J. Wysocki 	hibernate_reserved_size_init();
964fa7fd6faSSudeep Holla 	pm_states_init();
965d76e15fbSGreg Kroah-Hartman 	power_kobj = kobject_create_and_add("power", NULL);
966d76e15fbSGreg Kroah-Hartman 	if (!power_kobj)
967039a5dcdSGreg Kroah-Hartman 		return -ENOMEM;
9682c8db5beSKalesh Singh 	error = sysfs_create_groups(power_kobj, attr_groups);
9697483b4a4SRafael J. Wysocki 	if (error)
9707483b4a4SRafael J. Wysocki 		return error;
971b2df1d4fSRafael J. Wysocki 	pm_print_times_init();
9727483b4a4SRafael J. Wysocki 	return pm_autosleep_init();
9731da177e4SLinus Torvalds }
9741da177e4SLinus Torvalds 
9751da177e4SLinus Torvalds core_initcall(pm_init);
976