xref: /titanic_52/usr/src/man/man3picl/picl_wait.3picl (revision f5c2e7ea56aaa46a9976476fb0cb1f02b9426f07)
te
Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
PICL_WAIT 3PICL "Mar 28, 2000"
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)