xref: /linux/kernel/power/Kconfig (revision cf4fb80ca3d591cae366ae8364e3c3f7a68bd249)
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