Tribblix: manual page: picl_set

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