PICL Library Functions                    piclgetpropval(3PICL)



NAME
     piclgetpropval, piclgetpropvalbyname - get  the  value
     of a property

SYNOPSIS
     cc [ flag... ] file... -lpicl [ library... ]
     #include 

     int piclgetpropval(piclprophdlt proph, void *valbuf,
          sizet nbytes);


     int piclgetpropvalbyname(piclnodehdlt nodeh,
          char *propname, void *valbuf, sizet nbytes);


DESCRIPTION
     The piclgetpropval() function copies the value of the pro-
     perty specified by the handle proph into the buffer location
     given by valbuf. The size of the buffer valbuf in  bytes  is
     specified in nbytes.


     The piclgetpropvalbyname() function gets  the  value  of
     property  named  propname  of  the  node specified by handle
     nodeh. The value is copied into the buffer location given by
     valbuf.  The size of the buffer valbuf in bytes is specified
     in nbytes.


     The piclgetpropvalbyname() function is  used  to  get  a
     reserved property's value. An example of a reserved property
     is "parent".  Please refer to libpicl(3PICL) for a complete
     list of reserved property names.

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


     PICLPROPNOTFOUND is returned if the property of the  speci-
     fied name does not exist.


     PICLPERMDENIED is returned if the client does not have suf-
     ficient permission to access the property.


     PICLSTALEHANDLE is returned if  the  handle  is  no  longer
     valid.  This occurs if the PICL tree was refreshed or reini-
     tialized.




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                    piclgetpropval(3PICL)



     PICLINVALIDHANDLE 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.

ERORS
     PICLNOTINITIALIZED    Session not initialized


     PICLNORESPONSE        Daemon not responding


     PICLPERMDENIED        Insufficient permission


     PICLVALUETOBIG       Value too big for buffer


     PICLNOTPROP           Not a property


     PICLPROPNOTFOUND      Property node found


     PICLNOTNODE           Not a node


     PICLINVALIDHANDLE     Invalid handle specified


     PICLSTALEHANDLE       Stale handle specified


     PICLFAILURE           General system failure


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libpicl(3PICL), piclgetpropinfo(3PICL), attributes(5)




SunOS 5.11          Last change: 28 Mar 2000                    2