opensolaris man page for ptree_get_root

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

NAME
       ptree_get_root - get the root node handle

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

       int ptree_get_root(picl_nodehdl_t *nodeh);

DESCRIPTION
       The ptree_get_root() function copies the handle of the root node of the PICL tree into the location specified by nodeh.

RETURN VALUES
       Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error.

ERRORS
       PICL_INVALIDARG	  Invalid argument

       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
       libpicltree(3PICLTREE), ptree_create_node(3PICLTREE), attributes(5)

SunOS 5.11							    28 Mar 2000 					 ptree_get_root(3PICLTREE)