opensolaris man page for ptree_add_node

ptree_add_node(3PICLTREE)				  PICL Plug-In Library Functions				 ptree_add_node(3PICLTREE)

NAME
       ptree_add_node, ptree_delete_node - add or delete node to or from tree

SYNOPSIS
       cc [ flag... ] file... -lpicltree [ library... ]
       #include <picltree.h>

       int ptree_add_node(picl_nodehdl_t parh, picl_nodehdl_t chdh);

       int ptree_delete_node(ptree_delete_node nodeh);

DESCRIPTION
       The  ptree_add_node()  function adds the node specified by handle chdh as a child node to the node specified by the handle parh. PICL_CANT-
       PARENT is if the child node already has a parent.

       The ptree_delete_node() function deletes the node specified by handle nodeh and all its descendant nodes from the tree.

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_NOTNODE	     Node a node

       PICL_CANTPARENT	     Already has a parent

       PICL_TREEBUSY	     PICL tree is busy

       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
       attributes(5)

SunOS 5.11							    28 Mar 2000 					 ptree_add_node(3PICLTREE)