man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: July 2014
 
 

di_path_private_set(3DEVINFO)

Name

di_node_private_set, di_node_private_get, di_path_private_set, di_path_private_get, di_minor_private_set, di_minor_private_get, di_link_private_set, di_link_private_get, di_lnode_private_set, di_lnode_private_get - manipulate libdevinfo user traversal pointers

Synopsis

cc [ flag… ] file–ldevinfo [ library… ]
#include <libdevinfo.h>

void di_node_private_set(di_node_t node, void *data);
void *di_node_private_get(di_node_t node);
void di_path_private_set(di_path_t path, void *data);
void *di_path_private_get(di_path_t path);
void di_minor_private_set(di_minor_t minor, void *data);
void *di_minor_private_get(di_minor_t minor);
void di_link_private_set(di_link_t link, void *data);
void *di_link_private_get(di_link_t link);
void di_lnode_private_set(di_lnode_t lnode, void *data);
void *di_lnode_private_get(di_lnode_t lnode);

Parameters

node

The handle to a devinfo node in a di_init(3DEVINFO) snapshot.

path

The handle to a path node in a snapshot.

minor

The handle to a minor node in a snapshot.

link

The handle to a link in a snapshot.

lnode

The handle to an lnode in a snapshot.

data

A pointer to caller-specific data.

Description

The di_node_private_set() function allows a caller to associate caller-specific data pointed to by data with a devinfo node, thereby facilitating traversal of devinfo nodes in the snapshot.

The di_node_private_get() function allows a caller to retrieve a data pointer that was associated with a devinfo node obtained by a call to di_node_private_set().

The di_path_private_set() function allows a caller to associate caller-specific data pointed to by data with a devinfo path node, thereby facilitating traversal of path nodes in the snapshot.

The di_path_private_get()function allows a caller to retrieve a data pointer that was associated with a path node obtained by a call to di_path_private_set().

The di_minor_private_set() function allows a caller to associate caller-specific data pointed to by data with a minor node specified by minor, thereby facilitating traversal of minor nodes in the snapshot.

The di_minor_private_get() function allows a caller to retrieve a data pointer that was associated with a minor node obtained by a call to di_minor_private_set().

The di_link_private_set() function allows a caller to associate caller-specific data pointed to by data with a link, thereby facilitating traversal of links in the snapshot.

The di_link_private_get() function allows a caller to retrieve a data pointer that was associated with a link obtained by a call to di_link_private_set().

The di_lnode_private_set() function allows a caller to associate caller-specific data pointed to by data with an lnode specified by lnode, thereby facilitating traversal of lnodes in the snapshot.

The di_lnode_private_get() function allows a caller to retrieve a data pointer that was associated with an lnode by a call to di_lnode_private_set().

These functions do not perform any type of locking. It is up to the caller to satisfy any locking needs.

Return Values

The di_node_private_set(), di_path_private_set(), di_minor_private_set(), di_link_private_set(), and di_lnode_private_set() functions do not return values.

The di_node_private_get(), di_path_private_get(), di_minor_private_get(), di_link_private_get(), and di_lnode_private_get() functions return a pointer to caller-specific data that was initialized with their corresponding *_set() function. If no caller-specific data was assigned with a *_set() function, the results are undefined.

Errors

No errors are defined.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Safe

See Also

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