Documentation/power/runtime_pm.rst

108     the helper functions described in Section 4 for the device until its status
113 mechanism allowing the device to request a change of its power state, such as
136     4 for the device, until its status is directly set to either 'active', or
148     idle callback with the device as its argument.
266       PM core as 'suspended', regardless of its real hardware status
323       then run pm_runtime_autosuspend(dev) and return its result
383       return its result
387       return its result;
390       if its return value is checked by the caller, as this is likely to
409       pm_request_idle(dev) and return its result
417       pm_request_autosuspend(dev) and return its result
421       pm_runtime_idle(dev) and return its result
425       pm_runtime_suspend(dev) and return its result
429       pm_runtime_autosuspend(dev) and return its result
458       PM status to 'active' and update its parent's counter of 'active'
466       PM status to 'suspended' and update its parent's counter of 'active'
472     - return true if the device's runtime PM status is 'active' or its
476     - return true if the device's runtime PM status is 'suspended' and its
483     - set the power.runtime_auto flag for the device and decrease its usage
488     - unset the power.runtime_auto flag for the device and increase its usage
576 Thus, if the device is initially active (i.e. it is able to process I/O), its
588 should be called for it too as soon as reasonably possible or its runtime PM
593 reflects the actual state of the device, its bus type's or its driver's
632 it at run time by changing the value of its /sys/devices/.../power/control
676   * Even though the device was suspended, if its usage counter was > 0 then most
680 brought back to full power during resume, then its runtime PM status will have
710 that the device appears to be runtime-suspended and its state is fine, so it
711 may be left in runtime suspend provided that all of its descendants are also
719 The PM core does its best to reduce the probability of race conditions between
745       device and return its result, or return 0 if not defined
749       device and return its result, or return 0 if not defined
753       callback provided by its driver and return its result, or return 0 if not
758       callback provided by the device's driver and return its result, or return
770       callback provided by its driver and return its result, or return 0 if not
775       callback provided by the device's driver and return its result, or return
780       callback provided by its driver and return its result, or return 0 if not
785       callback provided by the device's driver and return its result, or return
790       callback provided by its driver and return its result, or return 0 if not
795       callback provided by the device's driver and return its result, or return
806 provide its own callbacks for ->runtime_idle(), ->runtime_suspend(),
815 DEFINE_RUNTIME_DEV_PM_OPS() defined in include/linux/pm_runtime.h (possibly setting its
906 This synchronization must be handled by the driver, using its private lock.
972 callback while holding its private lock.  If the function returns a nonzero