Documentation/driver-api/device_link.rst

8 that are borne out of a parent/child relationship within the device
10 are ordered based on this relationship, i.e. children are always suspended
30 presence on the supplier.  The consumer devices are not probed before the
77 to deletion.  Device links managed by the driver core are deleted automatically
86 Two other flags are specifically targeted at use cases where the device
104 ``DL_FLAG_STATELESS`` are invalid and cannot be used.
116 Moreover, managed device links cannot be deleted directly.  They are deleted
117 by the driver core when they are not necessary any more in accordance with the
120 set) are expected to be removed by whoever called :c:func:`device_link_add()`
138 Sometimes drivers depend on optional resources.  They are able to operate
140 are not present.  An example is an SPI controller that can use a DMA engine
149 based on probe deferral.  In any case optional resources are beyond the
155 * An MMU device exists alongside a busmaster device, both are in the same
166   however these are not independent devices that happen to share a power
190   are implemented in terms of I\ :sup:`2`\ C accesses and require a specific
206   devices and turn off the power switch only when all of them are runtime
218 becomes a directed acyclic graph once device links are added.
222 no device links present, the two lists are a flattened, one-dimensional
226 as they are discovered.
228 Once device links are added, the lists need to satisfy the additional
232 are moved to the end of the list.  (Call to :c:func:`device_reorder_to_tail()`
271   and consumer.  If the link is created before any devices are probed, it
281   list and by checking that links to suppliers are in ``DL_STATE_AVAILABLE``
301 * Before a supplier's driver is removed, links to consumers that are not
302   bound to a driver are updated to ``DL_STATE_SUPPLIER_UNBIND``.
308   Consumers that are bound are freed from their driver; consumers that are
309   probing are waited for until they are done.
312   Once all links to consumers are in ``DL_STATE_SUPPLIER_UNBIND`` state,