PICL_GET_FRUTREE_PARENT(3PICL)PICL_GET_FRUTREE_PARENT(3PICL)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 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 ALSOpicl_get_propinfo(3PICL), picl_get_propval(3PICL), picl_get_prop‐
val_by_name(3PICL), picl_get_prop_by_name(3PICL), attributes(5)
Feb 5, 2004 PICL_GET_FRUTREE_PARENT(3PICL)