hpux man page for di_devfs_path

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)