linux/Documentation/driver-api
Rafael J. Wysocki 0d4b54c6fe PM / core: Add LEAVE_SUSPENDED driver flag
Define and document a new driver flag, DPM_FLAG_LEAVE_SUSPENDED, to
instruct the PM core and middle-layer (bus type, PM domain, etc.)
code that it is desirable to leave the device in runtime suspend
after system-wide transitions to the working state (for example,
the device may be slow to resume and it may be better to avoid
resuming it right away).

Generally, the middle-layer code involved in the handling of the
device is expected to indicate to the PM core whether or not the
device may be left in suspend with the help of the device's
power.may_skip_resume status bit.  That has to happen in the "noirq"
phase of the preceding system suspend (or analogous) transition.
The middle layer is then responsible for handling the device as
appropriate in its "noirq" resume callback which is executed
regardless of whether or not the device may be left suspended, but
the other resume callbacks (except for ->complete) will be skipped
automatically by the core if the device really can be left in
suspend.

The additional power.must_resume status bit introduced for the
implementation of this mechanisn is used internally by the PM core
to track the requirement to resume the device (which may depend on
its children etc).

Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Reviewed-by: Ulf Hansson <ulf.hansson@linaro.org>
2017-11-27 01:20:59 +01:00
..
80211 cfg80211: remove unused function ieee80211_data_from_8023() 2017-09-21 11:42:02 +02:00
dmaengine dmaengine: doc: ReSTize pxa_dma doc 2017-11-05 10:03:34 -07:00
firmware Revert "firmware: add sanity check on shutdown/suspend" 2017-09-10 21:19:06 -07:00
iio docs: IIO documentation sphinx conversion 2017-01-04 13:24:41 -07:00
pm PM / core: Add LEAVE_SUSPENDED driver flag 2017-11-27 01:20:59 +01:00
usb Documentation: fix usb related doc refs 2017-10-12 11:15:48 -06:00
basics.rst docs: Do not include kerneldoc comments from kernel/sys.c 2017-07-17 14:05:36 -06:00
conf.py doc-rst: make driver-api folder buildable stand-alone 2016-10-26 17:25:00 -06:00
device_link.rst docs / driver-api: Fix structure references in device_link.rst 2017-02-20 16:40:46 -07:00
device-io.rst docs: Convert the deviceio template to RST 2017-01-31 17:31:21 -07:00
dma-buf.rst docs: Do not include from .../seqno-fence.c 2017-07-17 14:07:49 -06:00
edac.rst edac.rst: move concepts dictionary from edac.h 2016-12-15 08:58:12 -02:00
frame-buffer.rst
gpio.rst docs: driver-api: Add GPIO section 2017-08-14 15:01:13 +02:00
hsi.rst docs: split up serial-interfaces.rst 2016-09-06 09:14:52 -06:00
i2c.rst Merge branch 'i2c/for-4.13' of git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux 2017-07-12 10:04:56 -07:00
index.rst dmaengine: doc: Add ReST style dmaengine document 2017-11-05 10:03:19 -07:00
infrastructure.rst PM / docs: Drop confusing kernel-doc references from infrastructure.rst 2017-01-03 00:07:09 +01:00
input.rst
libata.rst libata.rst: add c function and struct cross-references 2017-05-16 08:44:11 -03:00
message-based.rst docs: Don't format internal MPT docs 2016-09-06 09:15:48 -06:00
misc_devices.rst docs-rst: core_api: move driver-specific stuff to drivers_api 2017-04-02 14:17:43 -06:00
miscellaneous.rst docs: driver-api: Remove trailing blank line 2017-08-07 14:27:45 -06:00
mtdnand.rst mtd: nand: Rename nand.h into rawnand.h 2017-08-13 10:11:49 +02:00
pci.rst docs-rst: core_api: move driver-specific stuff to drivers_api 2017-04-02 14:17:43 -06:00
pinctl.rst pinctrl/gpio: Unify namespace for cross-calls 2017-09-22 11:02:10 +02:00
rapidio.rst docs-rst: convert rapidio book to ReST 2017-05-16 08:44:16 -03:00
regulator.rst docs: Convert the regulator docbook to RST 2017-01-31 17:31:41 -07:00
s390-drivers.rst docs: Get the struct cmbdata kernel doc from the right file 2017-07-17 14:19:25 -06:00
scsi.rst scsi: fix doc. typo for I2O 2017-10-11 14:20:50 -04:00
sound.rst
spi.rst docs: split up serial-interfaces.rst 2016-09-06 09:14:52 -06:00
uio-howto.rst doc: convert UIO howto from docbook to sphinx 2017-01-31 11:12:41 +01:00
vme.rst docs: Update VME documentation to include kerneldoc comments 2017-03-17 15:10:49 +09:00
w1.rst There has been a fair amount of activity in the docs tree this time 2017-07-03 21:13:25 -07:00