PICL_WAIT(3PICL) PICL Library Functions PICL_WAIT(3PICL)
picl_wait - wait for PICL tree to refresh
cc [ flag... ] file... -lpicl [ library... ]
#include <picl.h>
int picl_wait(int to_secs);
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.
The picl_wait() function returns 0 to indicate that PICL tree has
refreshed. Otherwise, a non-negative integer is returned to indicate
error.
PICL_NOTINITIALIZED
Session not initialized
PICL_NORESPONSE
Daemon not responding
PICL_TIMEDOUT
Timed out waiting for refresh
PICL_FAILURE
General system failure
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
attributes(7)
March 28, 2000 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)