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_wait(3PICL)					      PICL Library Functions						  picl_wait(3PICL)

NAME

       picl_wait - wait for PICL tree to refresh

SYNOPSIS

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

       int picl_wait(int to_secs);

DESCRIPTION

       The  picl_wait()  function  blocks  the calling thread until the PICL tree is refreshed. The to_secs argument specifies the timeout for the
       call in number of seconds. A value of -1 for to_secs specifies no timeout.

RETURN VALUES

       The picl_wait() function returns 0 to indicate that PICL tree has refreshed. Otherwise, a non-negative  integer	is  returned  to  indicate
       error.

ERRORS

       PICL_NOTINITIALIZED     Session not initialized

       PICL_NORESPONSE	       Daemon not responding

       PICL_TIMEDOUT	       Timed out waiting for refresh

       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

       attributes(5)

SunOS 5.10							    28 Mar 2000 						  picl_wait(3PICL)