Document device_add_child_ordered().

This commit is contained in:
dfr 1999-05-28 09:38:25 +00:00
parent c18814fa7d
commit 38c8bc6c65

View File

@ -26,7 +26,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.\" $Id$ .\" $Id: device_add_child.9,v 1.1 1998/09/03 21:52:05 dfr Exp $
.\" .\"
.Dd June 16, 1998 .Dd June 16, 1998
.Dt device_add_child 9 .Dt device_add_child 9
@ -41,7 +41,7 @@
.Ft int .Ft int
.Fn bus_add_child "device_t dev" "const char *name" "int unit" "void *ivars" .Fn bus_add_child "device_t dev" "const char *name" "int unit" "void *ivars"
.Ft int .Ft int
.Fn bus_add_child_after "device_t dev" "device_t place" "const char *name" "int unit" "void *ivars" .Fn bus_add_child_ordered "device_t dev" "int order" "const char *name" "int unit" "void *ivars"
.Sh DESCRIPTION .Sh DESCRIPTION
.Pp .Pp
Create a new child device of Create a new child device of
@ -83,22 +83,18 @@ be passed. If the specified unit number is already allocated, a new
unit will be allocated and a diagnostic message printed. unit will be allocated and a diagnostic message printed.
.Pp .Pp
If the devices attached to a bus must be probed in a specific order If the devices attached to a bus must be probed in a specific order
(e.g. for ISA bus devices which are sensitive to failed probe attempts (e.g. for the ISA bus some devices are sensitive to failed probe attempts
of unrelated drivers), the of unrelated drivers and therefore must be probed first),
.Fa place the
.Fa order
argument of argument of
.Xr device_add_child_after 9 .Xr device_add_child_ordered 9
should be used. If should be used to specify a partial ordering.
.Dv NULL The new device will be added before any existing device with a greater
is passed, the new device will be added as the first child of order.
.Fa dev , If
otherwise it will be added immediately after
.Fa place
(which must be an existing child of
.Fa dev )
in the list of children. If
.Xr device_add_child 9 .Xr device_add_child 9
is used, then the new child will be added at the end of the list. is used, then the new child will be added as if its order was zero.
.Sh RETURN VALUES .Sh RETURN VALUES
The new device if successful, NULL otherwise. The new device if successful, NULL otherwise.
.Sh SEE ALSO .Sh SEE ALSO