ptree_get_frutree_parent(3picltre) [sunos man page]
ptree_get_frutree_parent(3PICLTREE) PICL Plug-In Library Functions 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 con- tainer 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
ptree_get_propinfo(3PICLTREE), ptree_get_propval(3PICLTREE), ptree_get_propval_by_name(3PICLTREE), ptree_get_prop_by_name(3PICLTREE), attributes(5) SunOS 5.10 5 Feb 2004 ptree_get_frutree_parent(3PICLTREE)
Check Out this Related Man Page
ptree_create_and_add_node(3PICLTREE) PICL Plug-In Library Functions ptree_create_and_add_node(3PICLTREE) NAME
ptree_create_and_add_node - create and add node to tree and return node handle SYNOPSIS
cc [ flag... ] file... -lpicltree [ library... ] #include <picltree.h> int ptree_create_and_add_node(picl_nodehdl_t parh, const char *name, const char *classname, picl_nodehdl_t *nodeh); DESCRIPTION
The ptree_create_and_add_node() function creates a node with the name and PICL class specified by name and classname respectively. It then adds the node as a a child to the node specified by parh. The handle of the new node is returned in nodeh. RETURN VALUES
Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error. PICL_STALEHANDLE is returned if the handle is no longer valid. This occurs if the PICL tree was refreshed or reinitialized. PICL_INVALIDHANDLE is returned if the specified handle never existed. ERRORS
PICL_INVALIDARG Invalid argument PICL_VALUETOOBIG Value exceeds maximum size PICL_NOTSUPPORTED Property version not supported PICL_CANTDESTROY Attempting to destroy before delete PICL_NOTNODE Not a node PICL_INVALIDHANDLE Invalid handle PICL_STALEHANDLE Stale handle PICL_FAILURE General system failure ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
ptree_create_node(3PICLTREE), ptree_add_node(3PICLTREE), attributes(5) SunOS 5.11 1 Aug 2000 ptree_create_and_add_node(3PICLTREE)