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 87196ec243SRafael J. Wysocki bool 88196ec243SRafael J. Wysocki depends on SUSPEND || HIBERNATION || XEN_SAVE_RESTORE 89196ec243SRafael J. Wysocki default y 90196ec243SRafael J. Wysocki 91196ec243SRafael J. Wysockiconfig PM_SLEEP_SMP 92196ec243SRafael J. Wysocki bool 93196ec243SRafael J. Wysocki depends on SMP 94196ec243SRafael J. Wysocki depends on ARCH_SUSPEND_POSSIBLE || ARCH_HIBERNATION_POSSIBLE 95196ec243SRafael J. Wysocki depends on PM_SLEEP 96196ec243SRafael J. Wysocki select HOTPLUG 97196ec243SRafael J. Wysocki select HOTPLUG_CPU 98196ec243SRafael J. Wysocki default y 99196ec243SRafael J. Wysocki 100196ec243SRafael J. Wysockiconfig PM_RUNTIME 101196ec243SRafael J. Wysocki bool "Run-time PM core functionality" 102196ec243SRafael J. Wysocki depends on !IA64_HP_SIM 103196ec243SRafael J. Wysocki ---help--- 104196ec243SRafael J. Wysocki Enable functionality allowing I/O devices to be put into energy-saving 105196ec243SRafael J. Wysocki (low power) states at run time (or autosuspended) after a specified 106196ec243SRafael J. Wysocki period of inactivity and woken up in response to a hardware-generated 107196ec243SRafael J. Wysocki wake-up event or a driver's request. 108196ec243SRafael J. Wysocki 109196ec243SRafael J. Wysocki Hardware support is generally required for this functionality to work 110196ec243SRafael J. Wysocki and the bus type drivers of the buses the devices are on are 111196ec243SRafael J. Wysocki responsible for the actual handling of the autosuspend requests and 112196ec243SRafael J. Wysocki wake-up events. 113196ec243SRafael J. Wysocki 114196ec243SRafael J. Wysockiconfig PM 115196ec243SRafael J. Wysocki bool 116196ec243SRafael J. Wysocki depends on PM_SLEEP || PM_RUNTIME 117196ec243SRafael J. Wysocki default y 118196ec243SRafael J. Wysocki 119196ec243SRafael J. Wysockiconfig PM_DEBUG 120196ec243SRafael J. Wysocki bool "Power Management Debug Support" 121196ec243SRafael J. Wysocki depends on PM 122196ec243SRafael J. Wysocki ---help--- 123196ec243SRafael J. Wysocki This option enables various debugging support in the Power Management 124196ec243SRafael J. Wysocki code. This is helpful when debugging and reporting PM bugs, like 125196ec243SRafael J. Wysocki suspend support. 126196ec243SRafael J. Wysocki 127196ec243SRafael J. Wysockiconfig PM_VERBOSE 128196ec243SRafael J. Wysocki bool "Verbose Power Management debugging" 129196ec243SRafael J. Wysocki depends on PM_DEBUG 130196ec243SRafael J. Wysocki default n 131196ec243SRafael J. Wysocki ---help--- 132196ec243SRafael J. Wysocki This option enables verbose messages from the Power Management code. 133196ec243SRafael J. Wysocki 134196ec243SRafael J. Wysockiconfig PM_ADVANCED_DEBUG 135196ec243SRafael J. Wysocki bool "Extra PM attributes in sysfs for low-level debugging/testing" 136196ec243SRafael J. Wysocki depends on PM_DEBUG 137196ec243SRafael J. Wysocki default n 138196ec243SRafael J. Wysocki ---help--- 139196ec243SRafael J. Wysocki Add extra sysfs attributes allowing one to access some Power Management 140196ec243SRafael J. Wysocki fields of device objects from user space. If you are not a kernel 141196ec243SRafael J. Wysocki developer interested in debugging/testing Power Management, say "no". 142196ec243SRafael J. Wysocki 143196ec243SRafael J. Wysockiconfig PM_TEST_SUSPEND 144196ec243SRafael J. Wysocki bool "Test suspend/resume and wakealarm during bootup" 145196ec243SRafael J. Wysocki depends on SUSPEND && PM_DEBUG && RTC_CLASS=y 146196ec243SRafael J. Wysocki ---help--- 147196ec243SRafael J. Wysocki This option will let you suspend your machine during bootup, and 148196ec243SRafael J. Wysocki make it wake up a few seconds later using an RTC wakeup alarm. 149196ec243SRafael J. Wysocki Enable this with a kernel parameter like "test_suspend=mem". 150196ec243SRafael J. Wysocki 151196ec243SRafael J. Wysocki You probably want to have your system's RTC driver statically 152196ec243SRafael J. Wysocki linked, ensuring that it's available when this test runs. 153196ec243SRafael J. Wysocki 154196ec243SRafael J. Wysockiconfig CAN_PM_TRACE 155196ec243SRafael J. Wysocki def_bool y 156*88a6f33eSRafael J. Wysocki depends on PM_DEBUG && PM_SLEEP 157196ec243SRafael J. Wysocki 158196ec243SRafael J. Wysockiconfig PM_TRACE 159196ec243SRafael J. Wysocki bool 160196ec243SRafael J. Wysocki help 161196ec243SRafael J. Wysocki This enables code to save the last PM event point across 162196ec243SRafael J. Wysocki reboot. The architecture needs to support this, x86 for 163196ec243SRafael J. Wysocki example does by saving things in the RTC, see below. 164196ec243SRafael J. Wysocki 165196ec243SRafael J. Wysocki The architecture specific code must provide the extern 166196ec243SRafael J. Wysocki functions from <linux/resume-trace.h> as well as the 167196ec243SRafael J. Wysocki <asm/resume-trace.h> header with a TRACE_RESUME() macro. 168196ec243SRafael J. Wysocki 169196ec243SRafael J. Wysocki The way the information is presented is architecture- 170196ec243SRafael J. Wysocki dependent, x86 will print the information during a 171196ec243SRafael J. Wysocki late_initcall. 172196ec243SRafael J. Wysocki 173196ec243SRafael J. Wysockiconfig PM_TRACE_RTC 174196ec243SRafael J. Wysocki bool "Suspend/resume event tracing" 175196ec243SRafael J. Wysocki depends on CAN_PM_TRACE 176196ec243SRafael J. Wysocki depends on X86 177196ec243SRafael J. Wysocki select PM_TRACE 178196ec243SRafael J. Wysocki default n 179196ec243SRafael J. Wysocki ---help--- 180196ec243SRafael J. Wysocki This enables some cheesy code to save the last PM event point in the 181196ec243SRafael J. Wysocki RTC across reboots, so that you can debug a machine that just hangs 182196ec243SRafael J. Wysocki during suspend (or more commonly, during resume). 183196ec243SRafael J. Wysocki 184196ec243SRafael J. Wysocki To use this debugging feature you should attempt to suspend the 185196ec243SRafael J. Wysocki machine, reboot it and then run 186196ec243SRafael J. Wysocki 187196ec243SRafael J. Wysocki dmesg -s 1000000 | grep 'hash matches' 188196ec243SRafael J. Wysocki 189196ec243SRafael J. Wysocki CAUTION: this option will cause your machine's real-time clock to be 190196ec243SRafael J. Wysocki set to an invalid time after a resume. 191196ec243SRafael J. Wysocki 1927726942fSRalf Baechleconfig APM_EMULATION 1937726942fSRalf Baechle tristate "Advanced Power Management Emulation" 1947726942fSRalf Baechle depends on PM && SYS_SUPPORTS_APM_EMULATION 1957726942fSRalf Baechle help 1967726942fSRalf Baechle APM is a BIOS specification for saving power using several different 1977726942fSRalf Baechle techniques. This is mostly useful for battery powered laptops with 1987726942fSRalf Baechle APM compliant BIOSes. If you say Y here, the system time will be 1997726942fSRalf Baechle reset after a RESUME operation, the /proc/apm device will provide 2007726942fSRalf Baechle battery status information, and user-space programs will receive 2017726942fSRalf Baechle notification of APM "events" (e.g. battery status change). 2027726942fSRalf Baechle 2037726942fSRalf Baechle In order to use APM, you will need supporting software. For location 20453471121SRandy Dunlap and more information, read <file:Documentation/power/pm.txt> and the 2057726942fSRalf Baechle Battery Powered Linux mini-HOWTO, available from 2067726942fSRalf Baechle <http://www.tldp.org/docs.html#howto>. 2077726942fSRalf Baechle 2087726942fSRalf Baechle This driver does not spin down disk drives (see the hdparm(8) 2097726942fSRalf Baechle manpage ("man 8 hdparm") for that), and it doesn't turn off 2107726942fSRalf Baechle VESA-compliant "green" monitors. 2117726942fSRalf Baechle 2127726942fSRalf Baechle Generally, if you don't have a battery in your machine, there isn't 2137726942fSRalf Baechle much point in using this driver and you should say N. If you get 2147726942fSRalf Baechle random kernel OOPSes or reboots that don't seem to be related to 2157726942fSRalf Baechle anything, try disabling/enabling this option (or disabling/enabling 2167726942fSRalf Baechle APM in your BIOS). 2175e928f77SRafael J. Wysocki 21843e60861SMark Brownconfig ARCH_HAS_OPP 21943e60861SMark Brown bool 22043e60861SMark Brown 221e1f60b29SNishanth Menonconfig PM_OPP 222e1f60b29SNishanth Menon bool "Operating Performance Point (OPP) Layer library" 22343e60861SMark Brown depends on ARCH_HAS_OPP 224e1f60b29SNishanth Menon ---help--- 225e1f60b29SNishanth Menon SOCs have a standard set of tuples consisting of frequency and 226e1f60b29SNishanth Menon voltage pairs that the device will support per voltage domain. This 227e1f60b29SNishanth Menon is called Operating Performance Point or OPP. The actual definitions 228e1f60b29SNishanth Menon of OPP varies over silicon within the same family of devices. 229e1f60b29SNishanth Menon 230e1f60b29SNishanth Menon OPP layer organizes the data internally using device pointers 231e1f60b29SNishanth Menon representing individual voltage domains and provides SOC 232e1f60b29SNishanth Menon implementations a ready to use framework to manage OPPs. 233e1f60b29SNishanth Menon For more information, read <file:Documentation/power/opp.txt> 234