opensolaris man page for picl_get_root

picl_get_root(3PICL)					      PICL Library Functions					      picl_get_root(3PICL)

NAME
       picl_get_root - get the root handle of the PICL tree

SYNOPSIS
       cc [ flag... ] file... -lpicl [ library... ]
       #include <picl.h>

       int picl_get_root(picl_nodehdl_t *nodehandle);

DESCRIPTION
       The picl_get_root() function gets the handle of the root node of the PICL tree and copies it into the location given by nodehandle.

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

ERRORS
       PICL_NOTINITIALIZED    Session not initialized

       PICL_NORESPONSE	      Daemon not responding

       PICL_FAILURE	      General system failure

ATTRIBUTES
       See attributes(5)  for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       picl_initialize(3PICL), picl_shutdown(3PICL), attributes(5)

SunOS 5.11							    28 Mar 2000 					      picl_get_root(3PICL)