Lines Matching +full:device +full:- +full:specific
1 #-
2 # Copyright (c) 1998-2004 Doug Rabson
33 * @defgroup BUS bus - KObj methods for drivers of devices with children
34 * @brief A set of methods required device drivers that support
96 * @brief Print a description of a child device
99 * device. It should describe the attachment that the child has with
101 * device is attached to. See bus_generic_print_child() for more
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
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
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.
221 * @param _dev the device whose devclass had a new driver
231 * @brief Create a new child device
235 * device instances. The new device will be added after the last
238 * a suitable ivar to the device specific to that bus.
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
246 * @param _name devclass name for new device or @c NULL if not
248 * @param _unit unit number for new device or @c -1 if not
265 * @param _dev the bus device
276 * resource-ID field varies from bus to bus (but @p *rid == 0 is always
282 * @param _dev the parent device of @p _child
283 * @param _child the device which is requesting an allocation
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
315 * device for instance. It will also establish a mapping for the resource
318 * @param _dev the parent device of @p _child
319 * @param _child the device which allocated the resource
336 * @param _dev the parent device of @p _child
337 * @param _child the device which allocated the resource
358 * @param _dev the parent device of @p _child
359 * @param _child the device which allocated the resource
377 * @param _dev the parent device of @p _child
378 * @param _child the device which allocated the resource
395 * @param _dev the parent device of @p _child
396 * @param _child the device which allocated the resource
416 * @param _dev the device associated with the resource
435 * @param _dev the parent device of @p _child
436 * @param _child the device which allocated the resource
452 * interrupt handler - the caller should save this value to use in a
455 * @param _dev the parent device of @p _child
456 * @param _child the device which allocated the resource
486 * @param _dev the parent device of @p _child
487 * @param _child the device which allocated the resource
503 * that the associated device is powered down and cannot be a source
508 * @param _dev the parent device of @p _child
509 * @param _child the device which allocated the resource
522 * the associated device is powered up and can be an interrupt source
527 * @param _dev the parent device of @p _child
528 * @param _child the device which allocated the resource
547 * @param _dev the parent device of @p _child
548 * @param _child the device which owns the resource
569 * @param _dev the parent device of @p _child
570 * @param _child the device which owns the resource
593 * @param _dev the parent device of @p _child
594 * @param _child the device which owns the resource
610 * list of the given child device.
612 * @param _dev the parent device of @p _child
613 * @param _child the device which owns the resource list
627 * @param _dev the bus device
642 * This method should return 0 if the device is not present. It
643 * should return -1 if it is present. Any errors in determining
645 * assume that the device is present, even if there is an error
647 * errors, but newcard will return an error if the device fails to
650 * @param _dev the parent device of @p _child
651 * @param _child the device which is being examined
659 * @brief Returns the pnp info for this device.
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
671 * @param _child the device which is being examined
681 * @brief Returns the location for this device.
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
693 * @param _child the device which is being examined
703 * @brief Allow drivers to request that an interrupt be bound to a specific
706 * @param _dev the parent device of @p _child
707 * @param _child the device which allocated the resource
722 * @param _dev the bus device
738 * @param _dev the parent device of @p _child
739 * @param _child the device which allocated the resource
765 * @param _dev the bus device
766 * @param _dname the name of the device w/o unit numbers
767 * @param _dunit the unit number of the device
778 * @param _dev the parent device of @p _child
779 * @param _child the device to which the tag will belong
789 * @param _dev the parent device of @p _child
790 * @param _child the device to which the tag will belong
798 * @brief Allow the bus to determine the unit number of a device.
800 * @param _dev the parent device of @p _child
801 * @param _child the device whose unit is to be wired
802 * @param _name the name of the device's new devclass
803 * @param _unitp a pointer to the device's new unit value
815 * @param _dev the bus device
824 * @param _dev the bus device
825 * @param _child the child device
837 * @param _dev the parent device of @p _child
838 * @param _child the device to suspend
848 * @param _dev the parent device of @p _child
849 * @param _child the device to resume
859 * @param _dev the bus device
860 * @param _child the child device
872 * @param _dev the bus device
873 * @param _child the child device
891 * calls this method to save bus-specific information, for instance,
897 * @param _dev the bus device
898 * @param _child the child device
911 * @param _dev the bus device
912 * @param _child the child device
922 * @param _dev the bus device
923 * @param _child the child device
933 * @brief Gets child's specific property
935 * The bus_get_property can be used to access device
936 * specific properties stored on the bus. If _propvalue
940 * @param _dev the bus device
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
960 * The get_device_path method retrieves a device's
961 * full path to the device using one of several
964 * @param _bus the bus device
965 * @param _child the child device