Manual Pages for UNIX Operating System command usage for man picl_set_propval

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 

     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  pro-
     perty  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 argu-
     ment 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 suf-
     ficient 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 reini-
     tialized.


     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






SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                    picl_set_propval(3PICL)



     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5)













SunOS 5.11          Last change: 28 Mar 2000                    2