PICL_GET_FRUTREE_PARENT(3PICL) PICL Library Functions

NAME

picl_get_frutree_parent - get frutree parent node for a given device
node

SYNOPSIS

cc [ flag... ] file... -lpicl [ library... ]
#include <picl.h>

int picl_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 picl_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

picl_get_prop_by_name(3PICL), picl_get_propinfo(3PICL),
picl_get_propval(3PICL), picl_get_propval_by_name(3PICL),
attributes(7)

April 9, 2016 PICL_GET_FRUTREE_PARENT(3PICL)