bus_generic_print_child(9) [freebsd man page]

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

NAME

     bus_generic_print_child -- generic implementation of DEVICE_PRINT_CHILD for busses

SYNOPSIS

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

     int
     bus_generic_print_child(device_t dev, device_t child);

DESCRIPTION

     This implementation prints out the default device announcement message.  Given device 'foo0' on bus 'bar0' where foo0 has the name "FooCard
     1234" the following would be printed:

     foo0: <FooCard 1234> on bar0

     bus_generic_print_child itself calls two functions bus_print_child_header() and bus_print_child_footer().	The former prints "foo0: <FooCard
     1234>" and the latter "on bar0".  These routines should be used if possible in your own code if bus_generic_print_child() does not completely
     suit your needs.

RETURN VALUES

     The number of characters output.

SEE ALSO

     device(9)

AUTHORS

     This manual page was written by Doug Rabson.

BSD
								   June 16, 1998							       BSD

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

NAME

     device_get_state, device_busy, device_unbusy, device_is_alive, device_is_attached -- manipulate device state

SYNOPSIS

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

     device_state_t
     device_get_state(device_t dev);

     void
     device_busy(device_t dev);

     void
     device_unbusy(device_t dev);

     int
     device_is_alive(device_t dev);

     int
     device_is_attached(device_t dev);

DESCRIPTION

     The current state of a device is accessed by calling device_get_state() which returns DS_NOTPRESENT, DS_ALIVE, DS_ATTACHED or DS_BUSY
     (described in device(9)).	To test see if a device was successfully probed, call device_is_alive() which simply returns if the state is
     greater or equal to DS_ALIVE.  To test see if a device was successfully attached, call device_is_attached() which simply returns if the state
     is greater or equal to DS_ATTACHED.

     Each device has a busy count which is incremented when device_busy() is called and decremented when device_unbusy() is called.  Both routines
     return an error if the device state is less than DS_ATTACHED.

     When device_busy() is called on a device in the DS_ATTACHED state, the device changes to the DS_BUSY state.  When device_unbusy() is called
     and after decrementing, the busy count for the device is zero, the device changes to the DS_ATTACHED state.

SEE ALSO

     device(9)

AUTHORS

     This manual page was written by Doug Rabson.

BSD
								   June 16, 1998							       BSD