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)


March 28, 2000 PICL_WAIT(3PICL)