Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

di_init(3devinfo) [posix man page]

di_init(3DEVINFO)														 di_init(3DEVINFO)

NAME
di_init, di_fini - create and destroy a snapshot of kernel device tree SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> di_node_t di_init(const char *phys_path, uint_t flags); void di_fini(di_node_t root); flags Snapshot content specification. The possible values can be a bitwise OR of the following: DINFOSUBTREE Include subtree. DINFOPROP Include properties. DINFOMINOR Include minor data. DINFOCPYALL Include all of the above. DINFOLYR Include device layering data. If flags is 0, the snapshot contains only a single node without properties or minor nodes. phys_path Physical path of the root node of the snapshot. See di_devfs_path(3DEVINFO). root Handle obtained by calling di_init(). The di_init() function creates a snapshot of the kernel device tree and returns a handle of the root node. The caller specifies the con- tents of the snapshot by providing flag and phys_path. The di_fini() function 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(). Upon success, di_init() returns a handle. Otherwise, DI_NODE_NIL is returned and errno is set to indicate the error. The di_init() function can set errno to any error code that can also be set by open(2), ioctl(2) or mmap(2). The most common error codes include: EACCES Insufficient privilege for accessing device configuration data. ENXIO Either the device named by phys_path is not present in the system, or the devinfo(7D) driver is not installed properly. EINVAL Either phys_path is incorrectly formed or the flags argument is invalid. Example 1: Using the libdevinfo Interfaces To Print All Device Tree Node Names 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 ", 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 "); exit(1); } di_walk_node(root_node, DI_WALK_CLDFIRST, NULL, prt_nodename); di_fini(root_node); } Example 2: Using the libdevinfo Interfaces To Print The Physical Path Of SCSI Disks 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 ", 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 "); exit(1); } walk_disknodes(root_node); di_fini(root_node); } See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ open(2), ioctl(2), mmap(2), libdevinfo(3LIB), attributes(5) 8 Dec 2003 di_init(3DEVINFO)
Man Page