--- di_lnode_private_set.3devinfo.orig Mon Jan 28 10:48:24 2008 +++ di_lnode_private_set.3devinfo Fri Feb 1 11:24:29 2008 @@ -1,56 +1,72 @@ -Device Information Library Functions di_lnode_private_set(3DEVINFO) +Device Information Library Functions di_node_private_set(3DEVINFO) 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_path_private_set, + di_path_private_get, + di_minor_private_set, + di_minor_private_get, di_link_private_set, - di_link_private_get + di_link_private_get, + di_lnode_private_set, + di_lnode_private_get - manipulate libdevinfo user traversal pointers SYNOPSIS cc [ flag... ] file... -ldevinfo [ library... ] #include - void di_lnode_private_set(di_lnode_t lnode, void *data); - void *di_lnode_private_get(di_lnode_t lnode); + 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_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); + void di_lnode_private_set(di_lnode_t lnode, void *data); + void *di_lnode_private_get(di_lnode_t lnode); + PARAMETERS - lnode A handle to an lnode. + node The handle to a device node in a di_init(3DEVINFO) snapshot. - minor A handle to a minor node. + path The handle to a path node in a snapshot. - node A handle to a devinfo node. + minor The handle to a minor node in a snapshot. - link A handle to a link. + link The handle to a link in a snapshot. + lnode The handle to a lnode in a snapshot. + data A pointer to caller-specific data. DESCRIPTION - The di_lnode_private_set() function allows a caller to asso- - ciate caller-specific data pointed to by data with an lnode - specified by lnode, thereby facilitating traversal of lnodes - in the snapshot. + The di_node_private_set() function allows a caller to asso- + ciate caller-specific data pointed to by data with a devinfo + node, thereby facilitating traversal of devinfo nodes 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_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 asso- + ciate 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 asso- ciate caller-specific data pointed to by data with a minor node specified by minor, thereby facilitating traversal of minor nodes in the snapshot. @@ -58,17 +74,8 @@ 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 asso- - ciate 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 asso- ciate caller-specific data pointed to by data with a link, thereby facilitating traversal of links in the snapshot. @@ -75,22 +82,31 @@ 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 asso- + ciate 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_lnode_private_set(), di_minor_private_set(), - di_node_private_set(), and di_link_private_set() functions - do not 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_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 initial- - ized with their corresponding set function. If no caller- - specific data was assigned with a set function, the results - are undefined. + The di_node_private_set(), di_path_private_set(), + di_minor_private_set(), di_link_private_set(), and + di_lnode_private_set() 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.