iokit/Kernel/IOServicePM.cpp

383     * when a power domain child calls requestPowerDomainState and we decide to
384         change power states to accomodate the child,
823                     // detach nub from child
869 IOReturn IOService::addPowerChild ( IOService * child )
876 	if (!child)
879     if (!initialized || !child->initialized)
882     OUR_PMLog( kPMLogAddChild, (uintptr_t) child, 0 );
885 		// Is this child already one of our children?
887 		iter = child->getParentIterator( gIOPowerPlane );
906 			PM_LOG("%s: %s (%p) is already a child\n",
907 				getName(), child->getName(), child);
911 		// Add the child to the power plane immediately, but the
913 		// We want the child to appear in the power plane before
929 					/* target */ child,
948 		connection->attachToChild( child, gIOPowerPlane );
965 	// Silent failure, to prevent platform drivers from adding the child
974 // Step 1/3 of adding a power child. Called on the power parent.
981 	// Make us temporary usable before adding the child.
1000 // Step 2/3 of adding a power child. Called on the joining child.
1056 // Step 3/3 of adding a power child. Called on the parent.
1063 	IOService *         child;
1067 	child = (IOService *) connection->getChildEntry(gIOPowerPlane);
1069 	if (child && inPlane(gIOPowerPlane))
1071 		if ((this != rootDomain) && child->getProperty("IOPMStrictTreeOrder"))
1078             rootDomain->joinAggressiveness( child );
1108 // Called on a parent whose child is being removed by PMstop().
1120     // detach nub from child
1130     // Are we awaiting an ack from this child?
1154 	// A child has gone away, re-scan children desires and clamp bits.
1490 // After we notified one of the interested drivers or a power-domain child
1598             // it's a child
2083 // Called on a power parent when a child's power requirement changes.
2093     IOService *         child;
2114 	child = (IOService *) childConnection->getChildEntry(gIOPowerPlane);
2115 	assert(child);
2131 			// The child must not wait for this parent to raise power
2145 					getName(), fMachineState, child->getName());
2157 			// child's perspective. A child power request may arrive while
2161 			// fCurrentPowerState is incorrect, and might cause the child
2167     child->fHeadNoteDomainTargetFlags |= outputPowerFlags;
2169     // Map child's requested power flags to one of our power state.
2183     // Adjust power will also propagate any changes to the child's
2194             getName(), child->getName(),
2201 	// Record the child's desires on the connection.
2595 			// Ignore child and driver when override is in effect.
2602 			// Ignore child proxy when children are present.
2717     IOService *             child;
2724             // Get child of IOPowerConnection objects
2727                 child = (IOService *) connection->copyChildEntry(gIOPowerPlane);
2728                 if (child)
2730                     (*applier)(child, context);
2731                     child->release();
2759             // Get child of IOPowerConnection objects
3469 			// else, child has already acked or driver has removed interest,
3530     // Sum child power consumption in notifyChild()
3590             // Wait for exiting child notifications to complete,
3614 	// Notify one child, wait for it to ack, then repeat for next child.
3620 	// We have the ability to power off in reverse child index order.
3902 // Notify a power domain child of an upcoming power change.
3922     // Unless the child handles the notification immediately and returns
4053 		// else, child has already acked and driver_timer reset to 0.
4288         // To prevent this, a child must make a power reservation against all
4290         // that the child will be unable to sustain the higher power state,
4291         // then the child will signal the parent to adjust power, and the child
4313     IOService *     child;              // the requesting child
4314     IOPMPowerFlags  requestPowerFlags;  // power flags requested by child
4380     context.child              = this;