opensolaris man page for ptree_add_prop

ptree_add_prop(3PICLTREE)				  PICL Plug-In Library Functions				 ptree_add_prop(3PICLTREE)

NAME
       ptree_add_prop, ptree_delete_prop - add or delete a property

SYNOPSIS
       cc [ flag... ] file... -lpicltree [ library... ]
       #include <picltree.h>

       int ptree_add_prop(picl_nodehdl_t nodeh, picl_prophdl_t proph);

       int ptree_delete_prop(picl_prophdl_t proph);

DESCRIPTION
       The  ptree_add_prop()  function	adds  the property specified by the handle proph to the list of properties of the node specified by handle
       nodeh.

       The ptree_delete_prop() function deletes the property from the property list of the node.  For  a  table  property,  the  entire  table	is
       deleted.

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

       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.

ERRORS
       PICL_NOTTABLE	     Not a table

       PICL_NOTPROP	     Not a property

       PICL_INVALIDHANDLE    Invalid handle

       PICL_STALEHANDLE      Stale handle

       PICL_PROPEXISTS	     Property already exists

       PICL_FAILURE	     General system failure

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       ptree_create_prop(3PICLTREE), attributes(5)

SunOS 5.11							    25 Apr 2002 					 ptree_add_prop(3PICLTREE)