sunos man page for ptree_get_frutree_parent

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)