Content-type: text/html Man page of di_lnode_private_set

di_lnode_private_set

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

NAME

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

SYNOPSIS

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

void di_lnode_private_set(di_lnode_t lnode, void *data);

void *di_lnode_private_get(di_lnode_t lnode);

void di_minor_private_set(di_minor_t minor, void *data);

void *di_minor_private_get(di_minor_t minor);

void di_node_private_set(di_node_t node, void *data);

void *di_node_private_get(di_node_t node);

void di_link_private_set(di_link_t link, void *data);

void *di_link_private_get(di_link_t link);  

PARAMETERS

lnode A handle to an lnode.

minor A handle to a minor node.

node A handle to a devinfo node.

link A handle to a link.

data A pointer to caller-specific data.

 

DESCRIPTION

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().

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_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_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().

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

RETURN VALUES

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

The di_lnode_private_get(), di_minor_private_get(), di_node_private_get(), and di_node_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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelSafe

 

SEE ALSO

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


 

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