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)


March 28, 2000 PICL_GET_ROOT(3PICL)