PICL_GET_ROOT(3PICL) PICL Library Functions PICL_GET_ROOT(3PICL)
picl_get_root - get the root handle of the PICL tree
cc [ flag... ] file... -lpicl [ library... ]
#include <picl.h>
int picl_get_root(picl_nodehdl_t *nodehandle);
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.
Upon successful completion, 0 is returned. On failure, a non-negative
integer is returned to indicate an error.
PICL_NOTINITIALIZED
Session not initialized
PICL_NORESPONSE
Daemon not responding
PICL_FAILURE
General system failure
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
picl_initialize(3PICL), picl_shutdown(3PICL), attributes(7)
March 28, 2000 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(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
SEE ALSO
picl_initialize(3PICL), picl_shutdown(3PICL), attributes(7)
March 28, 2000 PICL_GET_ROOT(3PICL)