picl_initialize(3picl) [opensolaris man page]

picl_initialize(3PICL)					      PICL Library Functions					    picl_initialize(3PICL)

NAME

       picl_initialize - initiate a session with the PICL daemon

SYNOPSIS

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

       int picl_initialize(void);

DESCRIPTION

       The picl_initialize() function opens the daemon door file and initiates a session with the PICL daemon running on the system.

RETURN VALUES

       Upon successful completion, 0 is returned. On failure, this function returns a non-negative integer, PICL_FAILURE.

ERRORS

       PICL_NOTSUPPORTED    Version not supported

       PICL_FAILURE	    General system failure

       PICL_NORESPONSE	    Daemon not responding

ATTRIBUTES

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

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

SEE ALSO

       picl_shutdown(3PICL), attributes(5)

SunOS 5.11							    28 Mar 2000 					    picl_initialize(3PICL)

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)