PM: Convert PM notifiers to out-of-line code
[deliverable/linux.git] / kernel / power / main.c
CommitLineData
1da177e4
LT
1/*
2 * kernel/power/main.c - PM subsystem core functionality.
3 *
4 * Copyright (c) 2003 Patrick Mochel
5 * Copyright (c) 2003 Open Source Development Lab
6 *
7 * This file is released under the GPLv2
8 *
9 */
10
4cf30348 11#include <linux/module.h>
1da177e4
LT
12#include <linux/suspend.h>
13#include <linux/kobject.h>
14#include <linux/string.h>
15#include <linux/delay.h>
16#include <linux/errno.h>
17#include <linux/init.h>
6cc07191 18#include <linux/console.h>
e3920fb4 19#include <linux/cpu.h>
c5c6ba4e 20#include <linux/resume-trace.h>
7dfb7103 21#include <linux/freezer.h>
96177299 22#include <linux/vmstat.h>
232b1432 23#include <linux/syscalls.h>
1da177e4
LT
24
25#include "power.h"
26
a6d70980 27DEFINE_MUTEX(pm_mutex);
1da177e4 28
9f9adecd
LB
29unsigned int pm_flags;
30EXPORT_SYMBOL(pm_flags);
31
82525756
AS
32#ifdef CONFIG_PM_SLEEP
33
34/* Routines for PM-transition notifications */
35
36static BLOCKING_NOTIFIER_HEAD(pm_chain_head);
37
38int register_pm_notifier(struct notifier_block *nb)
39{
40 return blocking_notifier_chain_register(&pm_chain_head, nb);
41}
42EXPORT_SYMBOL_GPL(register_pm_notifier);
43
44int unregister_pm_notifier(struct notifier_block *nb)
45{
46 return blocking_notifier_chain_unregister(&pm_chain_head, nb);
47}
48EXPORT_SYMBOL_GPL(unregister_pm_notifier);
49
50int pm_notifier_call_chain(unsigned long val)
51{
52 return (blocking_notifier_call_chain(&pm_chain_head, val, NULL)
53 == NOTIFY_BAD) ? -EINVAL : 0;
54}
55
56#endif /* CONFIG_PM_SLEEP */
57
0e7d56e3
RW
58#ifdef CONFIG_PM_DEBUG
59int pm_test_level = TEST_NONE;
60
61static int suspend_test(int level)
62{
63 if (pm_test_level == level) {
64 printk(KERN_INFO "suspend debug: Waiting for 5 seconds.\n");
65 mdelay(5000);
66 return 1;
67 }
68 return 0;
69}
70
71static const char * const pm_tests[__TEST_AFTER_LAST] = {
72 [TEST_NONE] = "none",
73 [TEST_CORE] = "core",
74 [TEST_CPUS] = "processors",
75 [TEST_PLATFORM] = "platform",
76 [TEST_DEVICES] = "devices",
77 [TEST_FREEZER] = "freezer",
78};
79
039a75c6
RW
80static ssize_t pm_test_show(struct kobject *kobj, struct kobj_attribute *attr,
81 char *buf)
0e7d56e3
RW
82{
83 char *s = buf;
84 int level;
85
86 for (level = TEST_FIRST; level <= TEST_MAX; level++)
87 if (pm_tests[level]) {
88 if (level == pm_test_level)
89 s += sprintf(s, "[%s] ", pm_tests[level]);
90 else
91 s += sprintf(s, "%s ", pm_tests[level]);
92 }
93
94 if (s != buf)
95 /* convert the last space to a newline */
96 *(s-1) = '\n';
97
98 return (s - buf);
99}
100
039a75c6
RW
101static ssize_t pm_test_store(struct kobject *kobj, struct kobj_attribute *attr,
102 const char *buf, size_t n)
0e7d56e3
RW
103{
104 const char * const *s;
105 int level;
106 char *p;
107 int len;
108 int error = -EINVAL;
109
110 p = memchr(buf, '\n', n);
111 len = p ? p - buf : n;
112
113 mutex_lock(&pm_mutex);
114
115 level = TEST_FIRST;
116 for (s = &pm_tests[level]; level <= TEST_MAX; s++, level++)
117 if (*s && len == strlen(*s) && !strncmp(buf, *s, len)) {
118 pm_test_level = level;
119 error = 0;
120 break;
121 }
122
123 mutex_unlock(&pm_mutex);
124
125 return error ? error : n;
126}
127
128power_attr(pm_test);
129#else /* !CONFIG_PM_DEBUG */
130static inline int suspend_test(int level) { return 0; }
131#endif /* !CONFIG_PM_DEBUG */
132
039a75c6 133
296699de
RW
134#ifdef CONFIG_SUSPEND
135
136/* This is just an arbitrary number */
137#define FREE_PAGE_NUMBER (100)
138
f242d919 139static struct platform_suspend_ops *suspend_ops;
1da177e4
LT
140
141/**
26398a70 142 * suspend_set_ops - Set the global suspend method table.
1da177e4
LT
143 * @ops: Pointer to ops structure.
144 */
145
26398a70 146void suspend_set_ops(struct platform_suspend_ops *ops)
1da177e4 147{
a6d70980 148 mutex_lock(&pm_mutex);
26398a70 149 suspend_ops = ops;
a6d70980 150 mutex_unlock(&pm_mutex);
1da177e4
LT
151}
152
e8c9c502 153/**
26398a70 154 * suspend_valid_only_mem - generic memory-only valid callback
e8c9c502 155 *
26398a70 156 * Platform drivers that implement mem suspend only and only need
e8c9c502
JB
157 * to check for that in their .valid callback can use this instead
158 * of rolling their own .valid callback.
159 */
26398a70 160int suspend_valid_only_mem(suspend_state_t state)
e8c9c502
JB
161{
162 return state == PM_SUSPEND_MEM;
163}
164
1da177e4
LT
165/**
166 * suspend_prepare - Do prep work before entering low-power state.
1da177e4 167 *
6c961dfb
RW
168 * This is common code that is called for each state that we're entering.
169 * Run suspend notifiers, allocate a console and stop all processes.
1da177e4 170 */
6c961dfb 171static int suspend_prepare(void)
1da177e4 172{
e3920fb4 173 int error;
5ae947ec 174 unsigned int free_pages;
1da177e4 175
26398a70 176 if (!suspend_ops || !suspend_ops->enter)
1da177e4
LT
177 return -EPERM;
178
b10d9117
RW
179 error = pm_notifier_call_chain(PM_SUSPEND_PREPARE);
180 if (error)
181 goto Finish;
182
1da177e4
LT
183 pm_prepare_console();
184
185 if (freeze_processes()) {
186 error = -EAGAIN;
187 goto Thaw;
188 }
189
6c961dfb
RW
190 free_pages = global_page_state(NR_FREE_PAGES);
191 if (free_pages < FREE_PAGE_NUMBER) {
5ae947ec
DSL
192 pr_debug("PM: free some memory\n");
193 shrink_all_memory(FREE_PAGE_NUMBER - free_pages);
194 if (nr_free_pages() < FREE_PAGE_NUMBER) {
195 error = -ENOMEM;
196 printk(KERN_ERR "PM: No enough memory\n");
5ae947ec
DSL
197 }
198 }
e3c7db62
RW
199 if (!error)
200 return 0;
201
1da177e4
LT
202 Thaw:
203 thaw_processes();
204 pm_restore_console();
b10d9117
RW
205 Finish:
206 pm_notifier_call_chain(PM_POST_SUSPEND);
1da177e4
LT
207 return error;
208}
209
a53c46dc
JB
210/* default implementation */
211void __attribute__ ((weak)) arch_suspend_disable_irqs(void)
212{
213 local_irq_disable();
214}
215
216/* default implementation */
217void __attribute__ ((weak)) arch_suspend_enable_irqs(void)
218{
219 local_irq_enable();
220}
1da177e4 221
6c961dfb
RW
222/**
223 * suspend_enter - enter the desired system sleep state.
224 * @state: state to enter
225 *
226 * This function should be called after devices have been suspended.
227 */
a065c86e 228static int suspend_enter(suspend_state_t state)
1da177e4
LT
229{
230 int error = 0;
1da177e4 231
a53c46dc
JB
232 arch_suspend_disable_irqs();
233 BUG_ON(!irqs_disabled());
1da177e4
LT
234
235 if ((error = device_power_down(PMSG_SUSPEND))) {
236 printk(KERN_ERR "Some devices failed to power down\n");
237 goto Done;
238 }
0e7d56e3
RW
239
240 if (!suspend_test(TEST_CORE))
241 error = suspend_ops->enter(state);
242
1da177e4
LT
243 device_power_up();
244 Done:
a53c46dc
JB
245 arch_suspend_enable_irqs();
246 BUG_ON(irqs_disabled());
1da177e4
LT
247 return error;
248}
249
6c961dfb
RW
250/**
251 * suspend_devices_and_enter - suspend devices and enter the desired system sleep
252 * state.
253 * @state: state to enter
254 */
255int suspend_devices_and_enter(suspend_state_t state)
256{
257 int error;
258
26398a70 259 if (!suspend_ops)
6c961dfb
RW
260 return -ENOSYS;
261
26398a70
RW
262 if (suspend_ops->set_target) {
263 error = suspend_ops->set_target(state);
6c961dfb
RW
264 if (error)
265 return error;
266 }
267 suspend_console();
268 error = device_suspend(PMSG_SUSPEND);
269 if (error) {
270 printk(KERN_ERR "Some devices failed to suspend\n");
271 goto Resume_console;
272 }
0e7d56e3
RW
273
274 if (suspend_test(TEST_DEVICES))
275 goto Resume_devices;
276
26398a70 277 if (suspend_ops->prepare) {
e6c5eb95 278 error = suspend_ops->prepare();
6c961dfb
RW
279 if (error)
280 goto Resume_devices;
281 }
0e7d56e3
RW
282
283 if (suspend_test(TEST_PLATFORM))
284 goto Finish;
285
6c961dfb 286 error = disable_nonboot_cpus();
0e7d56e3 287 if (!error && !suspend_test(TEST_CPUS))
6c961dfb
RW
288 suspend_enter(state);
289
290 enable_nonboot_cpus();
0e7d56e3 291 Finish:
e6c5eb95
RW
292 if (suspend_ops->finish)
293 suspend_ops->finish();
6c961dfb
RW
294 Resume_devices:
295 device_resume();
296 Resume_console:
297 resume_console();
298 return error;
299}
1da177e4
LT
300
301/**
302 * suspend_finish - Do final work before exiting suspend sequence.
1da177e4
LT
303 *
304 * Call platform code to clean up, restart processes, and free the
305 * console that we've allocated. This is not called for suspend-to-disk.
306 */
6c961dfb 307static void suspend_finish(void)
1da177e4 308{
1da177e4
LT
309 thaw_processes();
310 pm_restore_console();
b10d9117 311 pm_notifier_call_chain(PM_POST_SUSPEND);
1da177e4
LT
312}
313
314
315
316
3b364b8d 317static const char * const pm_states[PM_SUSPEND_MAX] = {
1da177e4
LT
318 [PM_SUSPEND_STANDBY] = "standby",
319 [PM_SUSPEND_MEM] = "mem",
1da177e4
LT
320};
321
123d3c13
PM
322static inline int valid_state(suspend_state_t state)
323{
a3d25c27
RW
324 /* All states need lowlevel support and need to be valid
325 * to the lowlevel implementation, no valid callback
9684e51c 326 * implies that none are valid. */
26398a70 327 if (!suspend_ops || !suspend_ops->valid || !suspend_ops->valid(state))
123d3c13
PM
328 return 0;
329 return 1;
330}
331
1da177e4
LT
332
333/**
334 * enter_state - Do common work of entering low-power state.
335 * @state: pm_state structure for state we're entering.
336 *
337 * Make sure we're the only ones trying to enter a sleep state. Fail
338 * if someone has beat us to it, since we don't want anything weird to
339 * happen when we wake up.
340 * Then, do the setup for suspend, enter the state, and cleaup (after
341 * we've woken up).
342 */
1da177e4
LT
343static int enter_state(suspend_state_t state)
344{
345 int error;
346
123d3c13 347 if (!valid_state(state))
eb9289eb 348 return -ENODEV;
232b1432 349
a6d70980 350 if (!mutex_trylock(&pm_mutex))
1da177e4
LT
351 return -EBUSY;
352
232b1432
RW
353 printk("Syncing filesystems ... ");
354 sys_sync();
355 printk("done.\n");
356
82428b62 357 pr_debug("PM: Preparing system for %s sleep\n", pm_states[state]);
0e7d56e3
RW
358 error = suspend_prepare();
359 if (error)
1da177e4
LT
360 goto Unlock;
361
0e7d56e3
RW
362 if (suspend_test(TEST_FREEZER))
363 goto Finish;
364
82428b62 365 pr_debug("PM: Entering %s sleep\n", pm_states[state]);
6c961dfb 366 error = suspend_devices_and_enter(state);
1da177e4 367
0e7d56e3 368 Finish:
82428b62 369 pr_debug("PM: Finishing wakeup.\n");
6c961dfb 370 suspend_finish();
1da177e4 371 Unlock:
a6d70980 372 mutex_unlock(&pm_mutex);
1da177e4
LT
373 return error;
374}
375
1da177e4
LT
376
377/**
378 * pm_suspend - Externally visible function for suspending system.
a3d25c27 379 * @state: Enumerated value of state to enter.
1da177e4
LT
380 *
381 * Determine whether or not value is within range, get state
382 * structure, and enter (above).
383 */
384
385int pm_suspend(suspend_state_t state)
386{
e2a5b420 387 if (state > PM_SUSPEND_ON && state <= PM_SUSPEND_MAX)
1da177e4
LT
388 return enter_state(state);
389 return -EINVAL;
390}
391
4cf30348 392EXPORT_SYMBOL(pm_suspend);
1da177e4 393
296699de
RW
394#endif /* CONFIG_SUSPEND */
395
d76e15fb 396struct kobject *power_kobj;
1da177e4
LT
397
398/**
399 * state - control system power state.
400 *
401 * show() returns what states are supported, which is hard-coded to
402 * 'standby' (Power-On Suspend), 'mem' (Suspend-to-RAM), and
403 * 'disk' (Suspend-to-Disk).
404 *
405 * store() accepts one of those strings, translates it into the
406 * proper enumerated value, and initiates a suspend transition.
407 */
408
386f275f
KS
409static ssize_t state_show(struct kobject *kobj, struct kobj_attribute *attr,
410 char *buf)
1da177e4 411{
296699de
RW
412 char *s = buf;
413#ifdef CONFIG_SUSPEND
1da177e4 414 int i;
1da177e4
LT
415
416 for (i = 0; i < PM_SUSPEND_MAX; i++) {
123d3c13
PM
417 if (pm_states[i] && valid_state(i))
418 s += sprintf(s,"%s ", pm_states[i]);
1da177e4 419 }
296699de 420#endif
b0cb1a19 421#ifdef CONFIG_HIBERNATION
a3d25c27
RW
422 s += sprintf(s, "%s\n", "disk");
423#else
424 if (s != buf)
425 /* convert the last space to a newline */
426 *(s-1) = '\n';
427#endif
1da177e4
LT
428 return (s - buf);
429}
430
386f275f
KS
431static ssize_t state_store(struct kobject *kobj, struct kobj_attribute *attr,
432 const char *buf, size_t n)
1da177e4 433{
296699de 434#ifdef CONFIG_SUSPEND
1da177e4 435 suspend_state_t state = PM_SUSPEND_STANDBY;
3b364b8d 436 const char * const *s;
296699de 437#endif
1da177e4 438 char *p;
1da177e4 439 int len;
296699de 440 int error = -EINVAL;
1da177e4
LT
441
442 p = memchr(buf, '\n', n);
443 len = p ? p - buf : n;
444
a3d25c27 445 /* First, check if we are requested to hibernate */
8d98a690 446 if (len == 4 && !strncmp(buf, "disk", len)) {
a3d25c27 447 error = hibernate();
296699de 448 goto Exit;
a3d25c27
RW
449 }
450
296699de 451#ifdef CONFIG_SUSPEND
1da177e4 452 for (s = &pm_states[state]; state < PM_SUSPEND_MAX; s++, state++) {
8d98a690 453 if (*s && len == strlen(*s) && !strncmp(buf, *s, len))
1da177e4
LT
454 break;
455 }
47bb7899 456 if (state < PM_SUSPEND_MAX && *s)
1da177e4 457 error = enter_state(state);
296699de
RW
458#endif
459
460 Exit:
1da177e4
LT
461 return error ? error : n;
462}
463
464power_attr(state);
465
c5c6ba4e
RW
466#ifdef CONFIG_PM_TRACE
467int pm_trace_enabled;
468
386f275f
KS
469static ssize_t pm_trace_show(struct kobject *kobj, struct kobj_attribute *attr,
470 char *buf)
c5c6ba4e
RW
471{
472 return sprintf(buf, "%d\n", pm_trace_enabled);
473}
474
475static ssize_t
386f275f
KS
476pm_trace_store(struct kobject *kobj, struct kobj_attribute *attr,
477 const char *buf, size_t n)
c5c6ba4e
RW
478{
479 int val;
480
481 if (sscanf(buf, "%d", &val) == 1) {
482 pm_trace_enabled = !!val;
483 return n;
484 }
485 return -EINVAL;
486}
487
488power_attr(pm_trace);
0e7d56e3 489#endif /* CONFIG_PM_TRACE */
c5c6ba4e
RW
490
491static struct attribute * g[] = {
492 &state_attr.attr,
0e7d56e3 493#ifdef CONFIG_PM_TRACE
c5c6ba4e 494 &pm_trace_attr.attr,
0e7d56e3
RW
495#endif
496#ifdef CONFIG_PM_DEBUG
497 &pm_test_attr.attr,
498#endif
c5c6ba4e
RW
499 NULL,
500};
1da177e4
LT
501
502static struct attribute_group attr_group = {
503 .attrs = g,
504};
505
506
507static int __init pm_init(void)
508{
d76e15fb
GKH
509 power_kobj = kobject_create_and_add("power", NULL);
510 if (!power_kobj)
039a5dcd 511 return -ENOMEM;
d76e15fb 512 return sysfs_create_group(power_kobj, &attr_group);
1da177e4
LT
513}
514
515core_initcall(pm_init);
This page took 0.325435 seconds and 5 git commands to generate.