Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

SunOS 5.10 - man page for di_devfs_path_free (sunos section 3devinfo)

di_devfs_path(3DEVINFO) 			       Device Information Library Functions				   di_devfs_path(3DEVINFO)

NAME
di_devfs_path, di_devfs_minor_path, di_devfs_path_free - generate and free physical path names
SYNOPSIS
cc [ flag... ] file... -ldevinfo [ library... ] #include <libdevinfo.h> char *di_devfs_path(di_node_t node); char *di_devfs_minor_path(di_minor_t minor); void di_devfs_path_free(char *path_buf);
PARAMETERS
node The handle to a device node in the snapshot. minor The handle to a device minor node in the snapshot. path_buf A pointer returned by di_devfs_path() or di_devfs_minor_path().
DESCRIPTION
The di_devfs_path() function generates the physical path of the device node specified by node. The di_devfs_minor_path() function generates the physical path of the device minor node specified by minor. The di_devfs_path_free() function frees memory that was allocated to store the physical path by di_devfs_path() and di_devfs_minor_path(). The caller of di_devfs_path() and di_devfs_minor_path() is responsible for freeing this memory allocated by calling di_devfs_path_free().
RETURN VALUES
Upon successful completion, the di_devfs_path() and di_devfs_minor_path() functions return a pointer to the string containing the physical path of a device node or a device minor node, respectively. Otherwise, they return NULL and errno is set to indicate the error.
ERRORS
The di_devfs_path() and di_devfs_minor_path() functions will fail if: EINVAL The node or minor argument is not a valid handle. The di_devfs_path() and di_devfs_minor_path() functions can also return any error value returned by malloc(3C).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+
SEE ALSO
di_init(3DEVINFO), libdevinfo(3LIB), malloc(3C), attributes(5) Writing Device Drivers SunOS 5.10 22 Mar 2004 di_devfs_path(3DEVINFO)