Merge branch 'sh/clkfwk' into sh-latest

device.  This field is a pointer to an object of type struct dev_power_domain,

defined in include/linux/pm.h, providing a set of power management callbacks

analogous to the subsystem-level and device driver callbacks that are executed

for the given device during all power transitions, in addition to the respective

subsystem-level callbacks.  Specifically, the power domain "suspend" callbacks

(i.e. ->runtime_suspend(), ->suspend(), ->freeze(), ->poweroff(), etc.) are

executed after the analogous subsystem-level callbacks, while the power domain

"resume" callbacks (i.e. ->runtime_resume(), ->resume(), ->thaw(), ->restore,

etc.) are executed before the analogous subsystem-level callbacks.  Error codes

returned by the "suspend" and "resume" power domain callbacks are ignored.

Power domain ->runtime_idle() callback is executed before the subsystem-level

->runtime_idle() callback and the result returned by it is not ignored.  Namely,

if it returns error code, the subsystem-level ->runtime_idle() callback will not

be called and the helper function rpm_idle() executing it will return error

code.  This mechanism is intended to help platforms where saving device state

is a time consuming operation and should only be carried out if all devices

in the power domain are idle, before turning off the shared power resource(s).

Namely, the power domain ->runtime_idle() callback may return error code until

the pm_runtime_idle() helper (or its asychronous version) has been called for

all devices in the power domain (it is recommended that the returned error code

be -EBUSY in those cases), preventing the subsystem-level ->runtime_idle()

callback from being run prematurely.

The support for device power domains is only relevant to platforms needing to

use the same subsystem-level (e.g. platform bus type) and device driver power

management callbacks in many different power domain configurations and wanting

to avoid incorporating the support for power domains into the subsystem-level

callbacks.  The other platforms need not implement it or take it into account

in any way.

System Devices

--------------

System devices (sysdevs) follow a slightly different API, which can be found in

	include/linux/sysdev.h

	drivers/base/sys.c

System devices will be suspended with interrupts disabled, and after all other

devices have been suspended.  On resume, they will be resumed before any other

devices, and also with interrupts disabled.  These things occur in special

"sysdev_driver" phases, which affect only system devices.

Thus, after the suspend_noirq (or freeze_noirq or poweroff_noirq) phase, when

the non-boot CPUs are all offline and IRQs are disabled on the remaining online

CPU, then a sysdev_driver.suspend phase is carried out, and the system enters a

sleep state (or a system image is created).  During resume (or after the image

has been created or loaded) a sysdev_driver.resume phase is carried out, IRQs

are enabled on the only online CPU, the non-boot CPUs are enabled, and the

resume_noirq (or thaw_noirq or restore_noirq) phase begins.

Code to actually enter and exit the system-wide low power state sometimes

involves hardware details that are only known to the boot firmware, and

may leave a CPU running software (from SRAM or flash memory) that monitors

the system and manages its wakeup sequence.

for the given device during all power transitions, instead of the respective

subsystem-level callbacks.  Specifically, if a device's pm_domain pointer is

not NULL, the ->suspend() callback from the object pointed to by it will be

executed instead of its subsystem's (e.g. bus type's) ->suspend() callback and

anlogously for all of the remaining callbacks.  In other words, power management

domain callbacks, if defined for the given device, always take precedence over

the callbacks provided by the device's subsystem (e.g. bus type).

The support for device power management domains is only relevant to platforms

needing to use the same device driver power management callbacks in many

different power domain configurations and wanting to avoid incorporating the

support for power domains into subsystem-level callbacks, for example by

modifying the platform bus type.  Other platforms need not implement it or take

it into account in any way.

Device Low Power (suspend) States

	pm_runtime_set_active(dev);

	pm_runtime_enable(dev);

The PM core always increments the run-time usage counter before calling the

->prepare() callback and decrements it after calling the ->complete() callback.

Hence disabling run-time PM temporarily like this will not cause any run-time

suspend callbacks to be lost.

7. Generic subsystem callbacks

Subsystems may wish to conserve code space by using the set of generic power

 * User space memory access functions

 */

#include <linux/thread_info.h>

#include <linux/kernel.h>

#include <asm/page.h>

#include <asm/errno.h>

	clknb = container_of(nb, struct pm_clk_notifier_block, nb);

	switch (action) {

	case BUS_NOTIFY_ADD_DEVICE:

	case BUS_NOTIFY_BIND_DRIVER:

		if (clknb->con_ids[0]) {

			for (con_id = clknb->con_ids; *con_id; con_id++)

				enable_clock(dev, *con_id);

			enable_clock(dev, NULL);

		}

		break;

	case BUS_NOTIFY_DEL_DEVICE:

	case BUS_NOTIFY_UNBOUND_DRIVER:

		if (clknb->con_ids[0]) {

			for (con_id = clknb->con_ids; *con_id; con_id++)

				disable_clock(dev, *con_id);

 */

void device_pm_init(struct device *dev)

{

	dev->power.in_suspend = false;

	dev->power.is_prepared = false;

	dev->power.is_suspended = false;

	init_completion(&dev->power.completion);

	complete_all(&dev->power.completion);

	dev->power.wakeup = NULL;

	pr_debug("PM: Adding info for %s:%s\n",

		 dev->bus ? dev->bus->name : "No Bus", dev_name(dev));

	mutex_lock(&dpm_list_mtx);

	if (dev->parent && dev->parent->power.in_suspend)

	if (dev->parent && dev->parent->power.is_prepared)

		dev_warn(dev, "parent %s should not be sleeping\n",

			dev_name(dev->parent));

	list_add_tail(&dev->power.entry, &dpm_list);

	dpm_wait(dev->parent, async);

	device_lock(dev);

	dev->power.in_suspend = false;

	/*

	 * This is a fib.  But we'll allow new children to be added below

	 * a resumed device, even if the device hasn't been completed yet.

	 */

	dev->power.is_prepared = false;

	if (!dev->power.is_suspended)

		goto Unlock;

	if (dev->pwr_domain) {

		pm_dev_dbg(dev, state, "power domain ");

	}

 End:

	dev->power.is_suspended = false;

 Unlock:

	device_unlock(dev);

	complete_all(&dev->power.completion);

		struct device *dev = to_device(dpm_prepared_list.prev);

		get_device(dev);

		dev->power.in_suspend = false;

		dev->power.is_prepared = false;

		list_move(&dev->power.entry, &list);

		mutex_unlock(&dpm_list_mtx);

	device_lock(dev);

	if (async_error)

		goto End;

		goto Unlock;

	if (pm_wakeup_pending()) {

		async_error = -EBUSY;

		goto End;

		goto Unlock;

	}

	if (dev->pwr_domain) {

	}

 End:

	dev->power.is_suspended = !error;

 Unlock:

	device_unlock(dev);

	complete_all(&dev->power.completion);

			put_device(dev);

			break;

		}

		dev->power.in_suspend = true;

		dev->power.is_prepared = true;

		if (!list_empty(&dev->power.entry))

			list_move_tail(&dev->power.entry, &dpm_prepared_list);

		put_device(dev);