main.c 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334
  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. #include <linux/module.h>
  11. #include <linux/suspend.h>
  12. #include <linux/kobject.h>
  13. #include <linux/string.h>
  14. #include <linux/delay.h>
  15. #include <linux/errno.h>
  16. #include <linux/init.h>
  17. #include <linux/pm.h>
  18. #include <linux/console.h>
  19. #include <linux/cpu.h>
  20. #include <linux/resume-trace.h>
  21. #include <linux/freezer.h>
  22. #include "power.h"
  23. /*This is just an arbitrary number */
  24. #define FREE_PAGE_NUMBER (100)
  25. DEFINE_MUTEX(pm_mutex);
  26. struct pm_ops *pm_ops;
  27. suspend_disk_method_t pm_disk_mode = PM_DISK_PLATFORM;
  28. /**
  29. * pm_set_ops - Set the global power method table.
  30. * @ops: Pointer to ops structure.
  31. */
  32. void pm_set_ops(struct pm_ops * ops)
  33. {
  34. mutex_lock(&pm_mutex);
  35. pm_ops = ops;
  36. mutex_unlock(&pm_mutex);
  37. }
  38. /**
  39. * suspend_prepare - Do prep work before entering low-power state.
  40. * @state: State we're entering.
  41. *
  42. * This is common code that is called for each state that we're
  43. * entering. Allocate a console, stop all processes, then make sure
  44. * the platform can enter the requested state.
  45. */
  46. static int suspend_prepare(suspend_state_t state)
  47. {
  48. int error;
  49. unsigned int free_pages;
  50. if (!pm_ops || !pm_ops->enter)
  51. return -EPERM;
  52. pm_prepare_console();
  53. error = disable_nonboot_cpus();
  54. if (error)
  55. goto Enable_cpu;
  56. if (freeze_processes()) {
  57. error = -EAGAIN;
  58. goto Thaw;
  59. }
  60. if ((free_pages = nr_free_pages()) < FREE_PAGE_NUMBER) {
  61. pr_debug("PM: free some memory\n");
  62. shrink_all_memory(FREE_PAGE_NUMBER - free_pages);
  63. if (nr_free_pages() < FREE_PAGE_NUMBER) {
  64. error = -ENOMEM;
  65. printk(KERN_ERR "PM: No enough memory\n");
  66. goto Thaw;
  67. }
  68. }
  69. if (pm_ops->prepare) {
  70. if ((error = pm_ops->prepare(state)))
  71. goto Thaw;
  72. }
  73. suspend_console();
  74. if ((error = device_suspend(PMSG_SUSPEND))) {
  75. printk(KERN_ERR "Some devices failed to suspend\n");
  76. goto Finish;
  77. }
  78. return 0;
  79. Finish:
  80. if (pm_ops->finish)
  81. pm_ops->finish(state);
  82. Thaw:
  83. thaw_processes();
  84. Enable_cpu:
  85. enable_nonboot_cpus();
  86. pm_restore_console();
  87. return error;
  88. }
  89. int suspend_enter(suspend_state_t state)
  90. {
  91. int error = 0;
  92. unsigned long flags;
  93. local_irq_save(flags);
  94. if ((error = device_power_down(PMSG_SUSPEND))) {
  95. printk(KERN_ERR "Some devices failed to power down\n");
  96. goto Done;
  97. }
  98. error = pm_ops->enter(state);
  99. device_power_up();
  100. Done:
  101. local_irq_restore(flags);
  102. return error;
  103. }
  104. /**
  105. * suspend_finish - Do final work before exiting suspend sequence.
  106. * @state: State we're coming out of.
  107. *
  108. * Call platform code to clean up, restart processes, and free the
  109. * console that we've allocated. This is not called for suspend-to-disk.
  110. */
  111. static void suspend_finish(suspend_state_t state)
  112. {
  113. device_resume();
  114. resume_console();
  115. thaw_processes();
  116. enable_nonboot_cpus();
  117. if (pm_ops && pm_ops->finish)
  118. pm_ops->finish(state);
  119. pm_restore_console();
  120. }
  121. static const char * const pm_states[PM_SUSPEND_MAX] = {
  122. [PM_SUSPEND_STANDBY] = "standby",
  123. [PM_SUSPEND_MEM] = "mem",
  124. #ifdef CONFIG_SOFTWARE_SUSPEND
  125. [PM_SUSPEND_DISK] = "disk",
  126. #endif
  127. };
  128. static inline int valid_state(suspend_state_t state)
  129. {
  130. /* Suspend-to-disk does not really need low-level support.
  131. * It can work with reboot if needed. */
  132. if (state == PM_SUSPEND_DISK)
  133. return 1;
  134. if (pm_ops && pm_ops->valid && !pm_ops->valid(state))
  135. return 0;
  136. return 1;
  137. }
  138. /**
  139. * enter_state - Do common work of entering low-power state.
  140. * @state: pm_state structure for state we're entering.
  141. *
  142. * Make sure we're the only ones trying to enter a sleep state. Fail
  143. * if someone has beat us to it, since we don't want anything weird to
  144. * happen when we wake up.
  145. * Then, do the setup for suspend, enter the state, and cleaup (after
  146. * we've woken up).
  147. */
  148. static int enter_state(suspend_state_t state)
  149. {
  150. int error;
  151. if (!valid_state(state))
  152. return -ENODEV;
  153. if (!mutex_trylock(&pm_mutex))
  154. return -EBUSY;
  155. if (state == PM_SUSPEND_DISK) {
  156. error = pm_suspend_disk();
  157. goto Unlock;
  158. }
  159. pr_debug("PM: Preparing system for %s sleep\n", pm_states[state]);
  160. if ((error = suspend_prepare(state)))
  161. goto Unlock;
  162. pr_debug("PM: Entering %s sleep\n", pm_states[state]);
  163. error = suspend_enter(state);
  164. pr_debug("PM: Finishing wakeup.\n");
  165. suspend_finish(state);
  166. Unlock:
  167. mutex_unlock(&pm_mutex);
  168. return error;
  169. }
  170. /*
  171. * This is main interface to the outside world. It needs to be
  172. * called from process context.
  173. */
  174. int software_suspend(void)
  175. {
  176. return enter_state(PM_SUSPEND_DISK);
  177. }
  178. /**
  179. * pm_suspend - Externally visible function for suspending system.
  180. * @state: Enumarted value of state to enter.
  181. *
  182. * Determine whether or not value is within range, get state
  183. * structure, and enter (above).
  184. */
  185. int pm_suspend(suspend_state_t state)
  186. {
  187. if (state > PM_SUSPEND_ON && state <= PM_SUSPEND_MAX)
  188. return enter_state(state);
  189. return -EINVAL;
  190. }
  191. EXPORT_SYMBOL(pm_suspend);
  192. decl_subsys(power,NULL,NULL);
  193. /**
  194. * state - control system power state.
  195. *
  196. * show() returns what states are supported, which is hard-coded to
  197. * 'standby' (Power-On Suspend), 'mem' (Suspend-to-RAM), and
  198. * 'disk' (Suspend-to-Disk).
  199. *
  200. * store() accepts one of those strings, translates it into the
  201. * proper enumerated value, and initiates a suspend transition.
  202. */
  203. static ssize_t state_show(struct subsystem * subsys, char * buf)
  204. {
  205. int i;
  206. char * s = buf;
  207. for (i = 0; i < PM_SUSPEND_MAX; i++) {
  208. if (pm_states[i] && valid_state(i))
  209. s += sprintf(s,"%s ", pm_states[i]);
  210. }
  211. s += sprintf(s,"\n");
  212. return (s - buf);
  213. }
  214. static ssize_t state_store(struct subsystem * subsys, const char * buf, size_t n)
  215. {
  216. suspend_state_t state = PM_SUSPEND_STANDBY;
  217. const char * const *s;
  218. char *p;
  219. int error;
  220. int len;
  221. p = memchr(buf, '\n', n);
  222. len = p ? p - buf : n;
  223. for (s = &pm_states[state]; state < PM_SUSPEND_MAX; s++, state++) {
  224. if (*s && !strncmp(buf, *s, len))
  225. break;
  226. }
  227. if (state < PM_SUSPEND_MAX && *s)
  228. error = enter_state(state);
  229. else
  230. error = -EINVAL;
  231. return error ? error : n;
  232. }
  233. power_attr(state);
  234. #ifdef CONFIG_PM_TRACE
  235. int pm_trace_enabled;
  236. static ssize_t pm_trace_show(struct subsystem * subsys, char * buf)
  237. {
  238. return sprintf(buf, "%d\n", pm_trace_enabled);
  239. }
  240. static ssize_t
  241. pm_trace_store(struct subsystem * subsys, const char * buf, size_t n)
  242. {
  243. int val;
  244. if (sscanf(buf, "%d", &val) == 1) {
  245. pm_trace_enabled = !!val;
  246. return n;
  247. }
  248. return -EINVAL;
  249. }
  250. power_attr(pm_trace);
  251. static struct attribute * g[] = {
  252. &state_attr.attr,
  253. &pm_trace_attr.attr,
  254. NULL,
  255. };
  256. #else
  257. static struct attribute * g[] = {
  258. &state_attr.attr,
  259. NULL,
  260. };
  261. #endif /* CONFIG_PM_TRACE */
  262. static struct attribute_group attr_group = {
  263. .attrs = g,
  264. };
  265. static int __init pm_init(void)
  266. {
  267. int error = subsystem_register(&power_subsys);
  268. if (!error)
  269. error = sysfs_create_group(&power_subsys.kset.kobj,&attr_group);
  270. return error;
  271. }
  272. core_initcall(pm_init);