Lines Matching +full:parent +full:- +full:child
1 #-
2 # Copyright (c) 1998-2004 Doug Rabson
33 * @defgroup BUS bus - KObj methods for drivers of devices with children
35 * child devices.
45 null_alloc_resource(device_t dev, device_t child,
96 * @brief Print a description of a child device
99 * device. It should describe the attachment that the child has with
100 * the parent. For instance the TurboLaser bus prints which node the
104 * @param _dev the device whose child is being printed
105 * @param _child the child device to describe
115 * @brief Print a notification about an unprobed child device.
117 * Called for each child device that did not succeed in probing for a
120 * @param _dev the device whose child was being probed
121 * @param _child the child device which failed to probe
129 * @brief Read the value of a bus-specific attribute of a device
131 * This method, along with BUS_WRITE_IVAR() manages a bus-specific set
132 * of instance variables of a child device. The intention is that
136 * This information could be given to the child device as a struct but
144 * @param _dev the device whose child was being examined
145 * @param _child the child device whose instance variable is
163 * @brief Write the value of a bus-specific attribute of a device
167 * @param _dev the device whose child was being updated
168 * @param _child the child device whose instance variable is
177 * contains a read-only value
187 * @brief Notify a bus that a child was deleted
189 * Called at the beginning of device_delete_child() to allow the parent
190 * to teardown any bus-specific state for the child.
192 * @param _dev the device whose child is being deleted
193 * @param _child the child device which is being deleted
201 * @brief Notify a bus that a child was detached
203 * Called after the child's DEVICE_DETACH() method to allow the parent
204 * to reclaim any resources allocated on behalf of the child.
206 * @param _dev the device whose child changed state
207 * @param _child the child device which changed state
219 * attach any un-matched children of the bus.
231 * @brief Create a new child device
236 * existing child with the same order. Implementations of bus_add_child
237 * call device_add_child_ordered to add the child and often add
240 * @param _dev the bus device which will be the parent of the
241 * new child device
243 * children of @p _dev - devices created using
248 * @param _unit unit number for new device or @c -1 if not
261 * This method is called by a parent bridge or devctl to trigger a bus
274 * This method is called by child devices of a bus to allocate resources.
276 * resource-ID field varies from bus to bus (but @p *rid == 0 is always
282 * @param _dev the parent device of @p _child
286 * @param _start hint at the start of the resource range - pass
288 * @param _end hint at the end of the resource range - pass
290 * @param _count hint at the size of range required - pass @c 1
293 * allocation - see @c RF_XXX flags in
318 * @param _dev the parent device of @p _child
336 * @param _dev the parent device of @p _child
358 * @param _dev the parent device of @p _child
377 * @param _dev the parent device of @p _child
395 * @param _dev the parent device of @p _child
435 * @param _dev the parent device of @p _child
452 * interrupt handler - the caller should save this value to use in a
455 * @param _dev the parent device of @p _child
486 * @param _dev the parent device of @p _child
508 * @param _dev the parent device of @p _child
527 * @param _dev the parent device of @p _child
547 * @param _dev the parent device of @p _child
569 * @param _dev the parent device of @p _child
593 * @param _dev the parent device of @p _child
610 * list of the given child device.
612 * @param _dev the parent device of @p _child
643 * should return -1 if it is present. Any errors in determining
650 * @param _dev the parent device of @p _child
663 * The string must be formatted as a space-separated list of
665 * underscores ('_') and hyphens ('-'). Values can contain any
666 * non-whitespace characters. Values containing whitespace can be
670 * @param _dev the parent device of @p _child
685 * The string must be formatted as a space-separated list of
687 * underscores ('_') and hyphens ('-'). Values can contain any
688 * non-whitespace characters. Values containing whitespace can be
692 * @param _dev the parent device of @p _child
706 * @param _dev the parent device of @p _child
738 * @param _dev the parent device of @p _child
754 * @brief Notify a (bus) driver about a child that the hints mechanism
757 * The bus is responsible for then adding the child in the right order
758 * and discovering other things about the child. The bus driver is
762 * This method is only called in response to the parent bus asking for
778 * @param _dev the parent device of @p _child
789 * @param _dev the parent device of @p _child
800 * @param _dev the parent device of @p _child
822 * @brief Notify a bus that specified child's IRQ should be remapped.
825 * @param _child the child device
835 * @brief Suspend a given child
837 * @param _dev the parent device of @p _child
846 * @brief Resume a given child
848 * @param _dev the parent device of @p _child
857 * @brief Get the VM domain handle for the given bus and child.
860 * @param _child the child device
873 * @param _child the child device
888 * @brief Prepares the given child of the bus for reset
891 * calls this method to save bus-specific information, for instance,
898 * @param _child the child device
906 * @brief Restores the child operations after the reset
912 * @param _child the child device
920 * @brief Performs reset of the child
923 * @param _child the child device
933 * @brief Gets child's specific property
941 * @param _child the child device
946 * @returns size of property if successful otherwise -1
958 * @brief Gets a child's full path to the device
965 * @param _child the child device