PTREE_GET_FRUTREE_PARENT(3PICLTREE) PICL Plug-In Library Functions

NAME

ptree_get_frutree_parent - get frutree parent node for a given device
node

SYNOPSIS

cc [ flag... ] file... -lpicltree [ library... ]
#include <picltree.h>

int ptree_get_frutree_parent(picl_nodehdl_t devh,
picl_nodehdl_t *frutreeh);

DESCRIPTION

The devices under the /platform subtree of the PICLTREE are linked to
their FRU containers represented in the /frutree using PICL reference
properties. The ptree_get_frutree_parent() function returns the
handle of the node in the /frutree subtree that is the FRU parent or
container of the device specified by the node handle, devh. The
handle is returned in the frutreeh argument.

RETURN VALUES

Upon successful completion, 0 is returned. Otherwise a non-negative
integer is returned to indicate an error.

ERRORS

PICL_FAILURE
General system failure


PICL_INVALIDHANDLE
Invalid handle


PICL_PROPNOTFOUND
Property not found


PICL_STALEHANDLE
Stale handle

ATTRIBUTES

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


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

ptree_get_prop_by_name(3PICLTREE), ptree_get_propinfo(3PICLTREE),
ptree_get_propval(3PICLTREE), ptree_get_propval_by_name(3PICLTREE),
attributes(7)

April 9, 2016
PTREE_GET_FRUTREE_PARENT(3PICLTREE)