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(5) for descriptions of the following attributes:


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

SEE ALSO


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


April 9, 2016
PTREE_GET_FRUTREE_PARENT(3PICLTREE)