PICL_SET_PROPVAL(3PICL) PICL Library Functions PICL_SET_PROPVAL(3PICL)


NAME


picl_set_propval, picl_set_propval_by_name - set the value of a property
to the specified value

SYNOPSIS


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

int picl_set_propval(picl_prophdl_t proph, void *valbuf,
size_t nbytes);


int picl_set_propval_by_name(picl_nodehdl_t nodeh,
const char *pname, void *valbuf, size_t nbytes);


DESCRIPTION


The picl_set_propval() function sets the value of the property specified
by the handle proph to the value contained in the buffer valbuf. The
argument nbytes specifies the size of the buffer valbuf.


The picl_set_propval_by_name() function sets the value of the property
named pname of the node specified by the handle nodeh to the value
contained in the buffer valbuf. The argument nbytes specifies the size of
the buffer valbuf.

RETURN VALUES


Upon successful completion, 0 is returned. On failure, a non-negative
integer is returned to indicate an error.


PICL_PERMDENIED is returned if the client does not have sufficient
permission to access the property.


PICL_STALEHANDLE is returned if the handle is no longer valid. This
occurs if the PICL tree was refreshed or reinitialized.


PICL_INVALIDHANDLE is returned if the specified handle never existed.
This error may be returned for a previously valid handle if the daemon
was brought down and restarted. When this occurs a client must revalidate
any saved handles.

ERRORS


PICL_NOTINITIALIZED
Session not initialized


PICL_NORESPONSE
Daemon not responding


PICL_PERMDENIED
Insufficient permission


PICL_NOTWRITABLE
Property is read-only


PICL_VALUETOOBIG
Value too big


PICL_NOTPROP
Not a property


PICL_NOTNODE
Not a node


PICL_INVALIDHANDLE
Invalid handle specified


PICL_STALEHANDLE
Stale handle specified


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_SET_PROPVAL(3PICL)