tail head cat sleep
QR code linking to this page

Manual Pages  — BUS_ADD_CHILD

NAME

BUS_ADD_CHILD – add a device node to the tree with a given priority

CONTENTS

SYNOPSIS

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

device_t
BUS_ADD_CHILD(device_t dev, int order, const char *name, int unit);

DESCRIPTION

The BUS_ADD_CHILD() method is used by the driver identify routine to add devices to the tree. It can also be used to add children to buses that implement this routine in other contexts, although the behavior is bus specific. Please see device_add_child(9) for more details. The interface is the same as device_add_child(9) however, the bus' BUS_ADD_CHILD() is called.

Buses implementing BUS_ADD_CHILD() should insert the device into the tree using device_add_child(9) before adding things such as their own ivars and resource lists to the device. BUS_ADD_CHILD() is not called by device_add_child(9). BUS_ADD_CHILD() instead calls device_add_child(9).

A panic will result when called for a bus that does not implement BUS_ADD_CHILD(). Some buses require a special bus-specific routine to be called instead of BUS_ADD_CHILD().

RETURN VALUES

The BUS_ADD_CHILD() method returns device_t added to the tree, or NULL to indicate failure.

SEE ALSO

device(9), device_add_child(9), driver(9)

AUTHORS

This manual page was written by M. Warner Losh.

BUS_ADD_CHILD (9) April 8, 2018

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

If you have any trouble sounding condescending, find a Unix user to show you how it's done.
— Scott Adams