di_binding_name(3)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | EXAMPLES | ATTRIBUTES | SEE ALSO

NAME

di_binding_name, di_bus_addr, di_compatible_names, di_devid, di_driver_name, di_driver_ops, di_instance, di_nodeid, di_node_name- return libdevinfo node information

SYNOPSIS

char *di_binding_name(di_node_t node);
char *di_bus_addr(di_node_t node);
int di_compatible_names(di_node_t node, char **names);
ddi_devid_t di_devid(di_node_t node);
char *di_driver_name(di_node_t node);
uint_t di_driver_ops(di_node_t node);
int di_instance(di_node_t node);
int di_nodeid(di_node_t node);
char *di_node_name(di_node_t node);

DESCRIPTION

These interfaces are used to extract information associated with a device node.

PARAMETERS

All Interfaces

node

A handle to a device node.

di_compatible_names()

names

The address of a pointer.

RETURN VALUES

di_binding_name()

di_binding_name() returns a pointer to the binding name. The binding name is the name used by the system to select a driver for the device.

di_bus_addr()

di_bus_addr() returns a pointer to a null-terminated string containing the assigned bus address for the device. NULL is returned if a bus address has not been assigned to the device. A zero-length string may be returned and is considered a valid bus address.

di_compatible_names()

The return value of di_compatible_names() is the number of compatible names. names is updated to point to a buffer contained within the snapshot. The buffer contains a concatenation of null-terminated strings, for example:

---

<name1>Ø<name2>Ø...<namen>Ø

---

See the discussion of generic names in Writing Device Drivers for a description of how compatible names are used by Solaris to achieve driver binding for the node.

di_devid()

di_devid() returns the device ID for node, if it is registered. Otherwise, a null pointer is returned. Interfaces in the libdevid(4) library may be used to manipulate the handle to the device id.

di_driver_name()

di_driver_name() returns the name of the driver bound to the node. A null pointer is returned if node is not bound to any driver.

di_driver_ops()

di_driver_ops() returns a bit array of device driver entry points that are supported by the driver bound to this node. Possible bit fields supported by the driver are DI_CB_OPS, DI_BUS_OPS, DI_STREAM_OPS.

di_instance()

di_instance() returns the instance number of the device. A value of -1 indicates an instance number has not been assigned to the device by the system.

di_nodeid()

di_nodeid() returns the type of device, which may be one of the following possible values: DI_PSEUDO_NODEID, DI_PROM_NODEID, and DI_SID_NODEID. Devices of type DI_PROM_NODEID may have additional properties that are defined by the PROM. See di_prom_prop_data(3) and di_prom_prop_lookup_bytes(3).

di_node_name()

di_node_name() returns a pointer to a null-terminated string containing the node name.

EXAMPLES

See di_init(3) for an example showing typical use of these interfaces.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT Level	Safe
Interface Stability	Evolving

SEE ALSO

di_init(3),di_prom_init(3)di_prom_prop_data(3),di_prom_prop_lookup_bytes(3), libdevinfo(3),libdevid(4),attributes(5)

Writing Device Drivers

SunOS 5.7  Last Revised 3 Jul 1998

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | EXAMPLES | ATTRIBUTES | SEE ALSO