Go to main content

man pages section 3: Extended Library Functions, Volume 3

Exit Print View

Updated: July 2017
 
 

ptree_get_frutree_parent(3PICLTREE)

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 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
Committed
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)