Go to main content

man pages section 3: Extended Library Functions, Volume 3

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
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)