device_get_children(9) [osx man page]

DEVICE_GET_CHILDREN(9)					   BSD Kernel Developer's Manual				    DEVICE_GET_CHILDREN(9)

NAME

     device_get_children -- get a list of devices connected to a device

SYNOPSIS

     #include <sys/param.h>
     #include <sys/bus.h>

     int
     device_get_children(device_t dev, device_t **devlistp, int *devcountp);

DESCRIPTION

     Retrieve a list of all device instances currently connected to dev and return the list in *devlistp and the count in *devcountp.  The memory
     allocated for the list should be freed using free(*devlistp, M_TEMP).  devlistp and devcountp are not changed when an error is returned.

RETURN VALUES

     Zero is returned on success, otherwise an appropriate error is returned.

SEE ALSO

     devclass(9), device(9)

AUTHORS

     This manual page was written by Doug Rabson.

BSD
								  August 23, 2008							       BSD

BUS_CHILD_PRESENT(9)					   BSD Kernel Developer's Manual				      BUS_CHILD_PRESENT(9)

NAME

     bus_child_present -- ask the bus driver to see if this device is still really present

SYNOPSIS

     #include <sys/param.h>
     #include <sys/bus.h>

     #include <machine/bus.h>
     #include <sys/rman.h>
     #include <machine/resource.h>

     int
     bus_child_present(device_t dev);

DESCRIPTION

     The bus_child_present() function requests that the parent device driver of dev check to see if the hardware represented by dev is still phys-
     ically accessible at this time.  While the notion of accessible varies from bus to bus, generally hardware that is not accessible cannot be
     accessed via the bus_space*() methods that would otherwise be used to access the device.

     This does not ask the question ``does this device have children?'' which can better be answered by device_get_children(9).

RETURN VALUES

     A zero return value indicates that the device is not present in the system.  A non-zero return value indicates that the device is present in
     the system, or that the state of the device cannot be determined.

EXAMPLES

     This is some example code.  It only calls stop when the dc(4) device is actually present.

	   device_t dev;
	   dc_softc *sc;

	   sc = device_get_softc(dev);
	   if (bus_child_present(dev))
		   dc_stop(sc);

SEE ALSO

     device(9), driver(9)

AUTHORS

     This manual page was written by Warner Losh <imp@FreeBSD.org>.

BSD
								  March 27, 2003							       BSD