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(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
SEE ALSO
attributes(7) March 28, 2000 PICL_WAIT(3PICL)