Content-type: text/html Man page of di_devfs_path

di_devfs_path

Section: Device Information Library Functions (3DEVINFO)
Updated: 22 Mar 2004
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelSafe

 

SEE ALSO

di_init(3DEVINFO), libdevinfo(3LIB), malloc(3C), attributes(5)

Writing Device Drivers


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:19 GMT, October 02, 2010