1296699deSRafael J. Wysockiconfig SUSPEND 2296699deSRafael J. Wysocki bool "Suspend to RAM and standby" 31eb208aeSRafael J. Wysocki depends on ARCH_SUSPEND_POSSIBLE 4296699deSRafael J. Wysocki default y 5296699deSRafael J. Wysocki ---help--- 6296699deSRafael J. Wysocki Allow the system to enter sleep states in which main memory is 7296699deSRafael J. Wysocki powered and thus its contents are preserved, such as the 8f4cb5700SJohannes Berg suspend-to-RAM state (e.g. the ACPI S3 state). 9296699deSRafael J. Wysocki 10b28f5081SJohannes Bergconfig SUSPEND_FREEZER 11b28f5081SJohannes Berg bool "Enable freezer for suspend to RAM/standby" \ 12b28f5081SJohannes Berg if ARCH_WANTS_FREEZER_CONTROL || BROKEN 13b28f5081SJohannes Berg depends on SUSPEND 14b28f5081SJohannes Berg default y 15b28f5081SJohannes Berg help 16b28f5081SJohannes Berg This allows you to turn off the freezer for suspend. If this is 17b28f5081SJohannes Berg done, no tasks are frozen for suspend to RAM/standby. 18b28f5081SJohannes Berg 19b28f5081SJohannes Berg Turning OFF this setting is NOT recommended! If in doubt, say Y. 20b28f5081SJohannes Berg 21b0cb1a19SRafael J. Wysockiconfig HIBERNATION 22296699deSRafael J. Wysocki bool "Hibernation (aka 'suspend to disk')" 231eb208aeSRafael J. Wysocki depends on SWAP && ARCH_HIBERNATION_POSSIBLE 24f996fc96SBojan Smojver select LZO_COMPRESS 25f996fc96SBojan Smojver select LZO_DECOMPRESS 261da177e4SLinus Torvalds ---help--- 27a7ee2e5fSDavid Brownell Enable the suspend to disk (STD) functionality, which is usually 28a7ee2e5fSDavid Brownell called "hibernation" in user interfaces. STD checkpoints the 29a7ee2e5fSDavid Brownell system and powers it off; and restores that checkpoint on reboot. 301da177e4SLinus Torvalds 3123b168d4SPavel Machek You can suspend your machine with 'echo disk > /sys/power/state' 3223b168d4SPavel Machek after placing resume=/dev/swappartition on the kernel command line 3323b168d4SPavel Machek in your bootloader's configuration file. 3423b168d4SPavel Machek 35c7276fdeSRafael J. Wysocki Alternatively, you can use the additional userland tools available 36c7276fdeSRafael J. Wysocki from <http://suspend.sf.net>. 37c7276fdeSRafael J. Wysocki 38c7276fdeSRafael J. Wysocki In principle it does not require ACPI or APM, although for example 39a7ee2e5fSDavid Brownell ACPI will be used for the final steps when it is available. One 40a7ee2e5fSDavid Brownell of the reasons to use software suspend is that the firmware hooks 41a7ee2e5fSDavid Brownell for suspend states like suspend-to-RAM (STR) often don't work very 42a7ee2e5fSDavid Brownell well with Linux. 43c7276fdeSRafael J. Wysocki 44c7276fdeSRafael J. Wysocki It creates an image which is saved in your active swap. Upon the next 451da177e4SLinus Torvalds boot, pass the 'resume=/dev/swappartition' argument to the kernel to 461da177e4SLinus Torvalds have it detect the saved image, restore memory state from it, and 471da177e4SLinus Torvalds continue to run as before. If you do not want the previous state to 48c7276fdeSRafael J. Wysocki be reloaded, then use the 'noresume' kernel command line argument. 49c7276fdeSRafael J. Wysocki Note, however, that fsck will be run on your filesystems and you will 50c7276fdeSRafael J. Wysocki need to run mkswap against the swap partition used for the suspend. 511da177e4SLinus Torvalds 52c7276fdeSRafael J. Wysocki It also works with swap files to a limited extent (for details see 53c7276fdeSRafael J. Wysocki <file:Documentation/power/swsusp-and-swap-files.txt>). 54c7276fdeSRafael J. Wysocki 55c7276fdeSRafael J. Wysocki Right now you may boot without resuming and resume later but in the 56c7276fdeSRafael J. Wysocki meantime you cannot use the swap partition(s)/file(s) involved in 57c7276fdeSRafael J. Wysocki suspending. Also in this case you must not use the filesystems 58c7276fdeSRafael J. Wysocki that were mounted before the suspend. In particular, you MUST NOT 59c7276fdeSRafael J. Wysocki MOUNT any journaled filesystems mounted before the suspend or they 60c7276fdeSRafael J. Wysocki will get corrupted in a nasty way. 611da177e4SLinus Torvalds 621da177e4SLinus Torvalds For more information take a look at <file:Documentation/power/swsusp.txt>. 631da177e4SLinus Torvalds 641da177e4SLinus Torvaldsconfig PM_STD_PARTITION 651da177e4SLinus Torvalds string "Default resume partition" 66b0cb1a19SRafael J. Wysocki depends on HIBERNATION 671da177e4SLinus Torvalds default "" 681da177e4SLinus Torvalds ---help--- 691da177e4SLinus Torvalds The default resume partition is the partition that the suspend- 701da177e4SLinus Torvalds to-disk implementation will look for a suspended disk image. 711da177e4SLinus Torvalds 721da177e4SLinus Torvalds The partition specified here will be different for almost every user. 731da177e4SLinus Torvalds It should be a valid swap partition (at least for now) that is turned 741da177e4SLinus Torvalds on before suspending. 751da177e4SLinus Torvalds 761da177e4SLinus Torvalds The partition specified can be overridden by specifying: 771da177e4SLinus Torvalds 781da177e4SLinus Torvalds resume=/dev/<other device> 791da177e4SLinus Torvalds 801da177e4SLinus Torvalds which will set the resume partition to the device specified. 811da177e4SLinus Torvalds 821da177e4SLinus Torvalds Note there is currently not a way to specify which device to save the 831da177e4SLinus Torvalds suspended image to. It will simply pick the first available swap 841da177e4SLinus Torvalds device. 851da177e4SLinus Torvalds 86196ec243SRafael J. Wysockiconfig PM_SLEEP 87*cf4fb80cSJan Beulich def_bool y 88196ec243SRafael J. Wysocki depends on SUSPEND || HIBERNATION || XEN_SAVE_RESTORE 89196ec243SRafael J. Wysocki 90196ec243SRafael J. Wysockiconfig PM_SLEEP_SMP 91*cf4fb80cSJan Beulich def_bool y 92196ec243SRafael J. Wysocki depends on SMP 93196ec243SRafael J. Wysocki depends on ARCH_SUSPEND_POSSIBLE || ARCH_HIBERNATION_POSSIBLE 94196ec243SRafael J. Wysocki depends on PM_SLEEP 95196ec243SRafael J. Wysocki select HOTPLUG 96196ec243SRafael J. Wysocki select HOTPLUG_CPU 97196ec243SRafael J. Wysocki 98196ec243SRafael J. Wysockiconfig PM_RUNTIME 99196ec243SRafael J. Wysocki bool "Run-time PM core functionality" 100196ec243SRafael J. Wysocki depends on !IA64_HP_SIM 101196ec243SRafael J. Wysocki ---help--- 102196ec243SRafael J. Wysocki Enable functionality allowing I/O devices to be put into energy-saving 103196ec243SRafael J. Wysocki (low power) states at run time (or autosuspended) after a specified 104196ec243SRafael J. Wysocki period of inactivity and woken up in response to a hardware-generated 105196ec243SRafael J. Wysocki wake-up event or a driver's request. 106196ec243SRafael J. Wysocki 107196ec243SRafael J. Wysocki Hardware support is generally required for this functionality to work 108196ec243SRafael J. Wysocki and the bus type drivers of the buses the devices are on are 109196ec243SRafael J. Wysocki responsible for the actual handling of the autosuspend requests and 110196ec243SRafael J. Wysocki wake-up events. 111196ec243SRafael J. Wysocki 112196ec243SRafael J. Wysockiconfig PM 113*cf4fb80cSJan Beulich def_bool y 114196ec243SRafael J. Wysocki depends on PM_SLEEP || PM_RUNTIME 115196ec243SRafael J. Wysocki 116196ec243SRafael J. Wysockiconfig PM_DEBUG 117196ec243SRafael J. Wysocki bool "Power Management Debug Support" 118196ec243SRafael J. Wysocki depends on PM 119196ec243SRafael J. Wysocki ---help--- 120196ec243SRafael J. Wysocki This option enables various debugging support in the Power Management 121196ec243SRafael J. Wysocki code. This is helpful when debugging and reporting PM bugs, like 122196ec243SRafael J. Wysocki suspend support. 123196ec243SRafael J. Wysocki 124196ec243SRafael J. Wysockiconfig PM_VERBOSE 125196ec243SRafael J. Wysocki bool "Verbose Power Management debugging" 126196ec243SRafael J. Wysocki depends on PM_DEBUG 127196ec243SRafael J. Wysocki ---help--- 128196ec243SRafael J. Wysocki This option enables verbose messages from the Power Management code. 129196ec243SRafael J. Wysocki 130196ec243SRafael J. Wysockiconfig PM_ADVANCED_DEBUG 131196ec243SRafael J. Wysocki bool "Extra PM attributes in sysfs for low-level debugging/testing" 132196ec243SRafael J. Wysocki depends on PM_DEBUG 133196ec243SRafael J. Wysocki ---help--- 134196ec243SRafael J. Wysocki Add extra sysfs attributes allowing one to access some Power Management 135196ec243SRafael J. Wysocki fields of device objects from user space. If you are not a kernel 136196ec243SRafael J. Wysocki developer interested in debugging/testing Power Management, say "no". 137196ec243SRafael J. Wysocki 138196ec243SRafael J. Wysockiconfig PM_TEST_SUSPEND 139196ec243SRafael J. Wysocki bool "Test suspend/resume and wakealarm during bootup" 140196ec243SRafael J. Wysocki depends on SUSPEND && PM_DEBUG && RTC_CLASS=y 141196ec243SRafael J. Wysocki ---help--- 142196ec243SRafael J. Wysocki This option will let you suspend your machine during bootup, and 143196ec243SRafael J. Wysocki make it wake up a few seconds later using an RTC wakeup alarm. 144196ec243SRafael J. Wysocki Enable this with a kernel parameter like "test_suspend=mem". 145196ec243SRafael J. Wysocki 146196ec243SRafael J. Wysocki You probably want to have your system's RTC driver statically 147196ec243SRafael J. Wysocki linked, ensuring that it's available when this test runs. 148196ec243SRafael J. Wysocki 149196ec243SRafael J. Wysockiconfig CAN_PM_TRACE 150196ec243SRafael J. Wysocki def_bool y 15188a6f33eSRafael J. Wysocki depends on PM_DEBUG && PM_SLEEP 152196ec243SRafael J. Wysocki 153196ec243SRafael J. Wysockiconfig PM_TRACE 154196ec243SRafael J. Wysocki bool 155196ec243SRafael J. Wysocki help 156196ec243SRafael J. Wysocki This enables code to save the last PM event point across 157196ec243SRafael J. Wysocki reboot. The architecture needs to support this, x86 for 158196ec243SRafael J. Wysocki example does by saving things in the RTC, see below. 159196ec243SRafael J. Wysocki 160196ec243SRafael J. Wysocki The architecture specific code must provide the extern 161196ec243SRafael J. Wysocki functions from <linux/resume-trace.h> as well as the 162196ec243SRafael J. Wysocki <asm/resume-trace.h> header with a TRACE_RESUME() macro. 163196ec243SRafael J. Wysocki 164196ec243SRafael J. Wysocki The way the information is presented is architecture- 165196ec243SRafael J. Wysocki dependent, x86 will print the information during a 166196ec243SRafael J. Wysocki late_initcall. 167196ec243SRafael J. Wysocki 168196ec243SRafael J. Wysockiconfig PM_TRACE_RTC 169196ec243SRafael J. Wysocki bool "Suspend/resume event tracing" 170196ec243SRafael J. Wysocki depends on CAN_PM_TRACE 171196ec243SRafael J. Wysocki depends on X86 172196ec243SRafael J. Wysocki select PM_TRACE 173196ec243SRafael J. Wysocki ---help--- 174196ec243SRafael J. Wysocki This enables some cheesy code to save the last PM event point in the 175196ec243SRafael J. Wysocki RTC across reboots, so that you can debug a machine that just hangs 176196ec243SRafael J. Wysocki during suspend (or more commonly, during resume). 177196ec243SRafael J. Wysocki 178196ec243SRafael J. Wysocki To use this debugging feature you should attempt to suspend the 179196ec243SRafael J. Wysocki machine, reboot it and then run 180196ec243SRafael J. Wysocki 181196ec243SRafael J. Wysocki dmesg -s 1000000 | grep 'hash matches' 182196ec243SRafael J. Wysocki 183196ec243SRafael J. Wysocki CAUTION: this option will cause your machine's real-time clock to be 184196ec243SRafael J. Wysocki set to an invalid time after a resume. 185196ec243SRafael J. Wysocki 1867726942fSRalf Baechleconfig APM_EMULATION 1877726942fSRalf Baechle tristate "Advanced Power Management Emulation" 1887726942fSRalf Baechle depends on PM && SYS_SUPPORTS_APM_EMULATION 1897726942fSRalf Baechle help 1907726942fSRalf Baechle APM is a BIOS specification for saving power using several different 1917726942fSRalf Baechle techniques. This is mostly useful for battery powered laptops with 1927726942fSRalf Baechle APM compliant BIOSes. If you say Y here, the system time will be 1937726942fSRalf Baechle reset after a RESUME operation, the /proc/apm device will provide 1947726942fSRalf Baechle battery status information, and user-space programs will receive 1957726942fSRalf Baechle notification of APM "events" (e.g. battery status change). 1967726942fSRalf Baechle 1977726942fSRalf Baechle In order to use APM, you will need supporting software. For location 19853471121SRandy Dunlap and more information, read <file:Documentation/power/pm.txt> and the 1997726942fSRalf Baechle Battery Powered Linux mini-HOWTO, available from 2007726942fSRalf Baechle <http://www.tldp.org/docs.html#howto>. 2017726942fSRalf Baechle 2027726942fSRalf Baechle This driver does not spin down disk drives (see the hdparm(8) 2037726942fSRalf Baechle manpage ("man 8 hdparm") for that), and it doesn't turn off 2047726942fSRalf Baechle VESA-compliant "green" monitors. 2057726942fSRalf Baechle 2067726942fSRalf Baechle Generally, if you don't have a battery in your machine, there isn't 2077726942fSRalf Baechle much point in using this driver and you should say N. If you get 2087726942fSRalf Baechle random kernel OOPSes or reboots that don't seem to be related to 2097726942fSRalf Baechle anything, try disabling/enabling this option (or disabling/enabling 2107726942fSRalf Baechle APM in your BIOS). 2115e928f77SRafael J. Wysocki 21243e60861SMark Brownconfig ARCH_HAS_OPP 21343e60861SMark Brown bool 21443e60861SMark Brown 215e1f60b29SNishanth Menonconfig PM_OPP 216e1f60b29SNishanth Menon bool "Operating Performance Point (OPP) Layer library" 21743e60861SMark Brown depends on ARCH_HAS_OPP 218e1f60b29SNishanth Menon ---help--- 219e1f60b29SNishanth Menon SOCs have a standard set of tuples consisting of frequency and 220e1f60b29SNishanth Menon voltage pairs that the device will support per voltage domain. This 221e1f60b29SNishanth Menon is called Operating Performance Point or OPP. The actual definitions 222e1f60b29SNishanth Menon of OPP varies over silicon within the same family of devices. 223e1f60b29SNishanth Menon 224e1f60b29SNishanth Menon OPP layer organizes the data internally using device pointers 225e1f60b29SNishanth Menon representing individual voltage domains and provides SOC 226e1f60b29SNishanth Menon implementations a ready to use framework to manage OPPs. 227e1f60b29SNishanth Menon For more information, read <file:Documentation/power/opp.txt> 228