picl_get_frutree_parent(3PICL)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also

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 Also

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

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also