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)