NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | EXAMPLES | ATTRIBUTES | SEE ALSO
#include <libdevinfo.h>di_node_t di_init(const char *phys_path, uint_t flags);
di_init() creates a snapshot of the kernel device tree and returns a handle of the root node. The caller specifies the contents of the snapshot by providing flag and phys_path.
di_fini() destroys the snapshot of the kernel device tree and frees the associated memory. All handles associated with this snapshot become invalid after the call to di_fini().
Physical path of the root node of the snapshot. See di_devfs_path(3DEVINFO).
Snapshot content specification. The possible values may be a bitwise OR of the following:
Include subtree.
Include properties.
Include minor data.
Include all of above.
Upon success, a handle is returned. Otherwise, DI_NODE_NIL is returned and errno is set to indicate the error.
di_init() may set errno to any error code that may also be set by open(2), ioctl(2) or mmap(2). The most common error codes include:
Insufficient privilege for accessing device configuration data.
Either the device named by phys_path is not present in the system, or the devinfo(7D) driver is not installed properly.
Either phys_path is incorrectly formed or the flags argument is invalid.
The following is an example using the libdevinfo() interfaces to print all device tree node names:
/* * Code to print all device tree node names */ #include <stdio.h> #include <libdevinfo.h> int prt_nodename(di_node_t node, void *arg) { printf("%s\n", di_node_name(node)); return (DI_WALK_CONTINUE); } main() { di_node_t root_node; if((root_node = di_init("/", DINFOSUBTREE)) == DI_NODE_NIL) { fprintf(stderr, "di_init() failed\n"); exit(1); } di_walk_node(root_node, DI_WALK_CLDFIRST, NULL, prt_nodename); di_fini(root_node); }
The following example uses the libdevinfo()interfaces to print the physical path of SCSI disks:
/* * Code to print physical path of scsi disks */ #include <stdio.h> #include <libdevinfo.h> #define DISK_DRIVER "sd" /* driver name */ void prt_diskinfo(di_node_t node) { int instance; char *phys_path; /* * If the device node exports no minor nodes, * there is no physical disk. */ if (di_minor_next(node, DI_MINOR_NIL) == DI_MINOR_NIL) { return; } instance = di_instance(node); phys_path = di_devfs_path(node); printf("%s%d: %s\n", DISK_DRIVER, instance, phys_path); di_devfs_path_free(phys_path); } void walk_disknodes(di_node_t node) { node = di_drv_first_node(DISK_DRIVER, node); while (node != DI_NODE_NIL) { prt_diskinfo(node); node = di_drv_next_node(node); } } main() { di_node_t root_node; if ((root_node = di_init("/", DINFOCPYALL)) == DI_NODE_NIL) { fprintf(stderr, "di_init() failed\n"); exit(1); } walk_disknodes(root_node); di_fini(root_node); }
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT Level | Safe |
Interface Stability | Evolving |
NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | EXAMPLES | ATTRIBUTES | SEE ALSO