ptree_unregister_handler(3picltre) [sunos man page]

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

NAME

       ptree_unregister_handler - unregister the event handler for the event

SYNOPSIS

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

       void  ptree_register_handler(const  char  *ename, void (*evt_handler)(const char *ename, const void *earg, size_t size, void *cookie), void
       *cookie);

DESCRIPTION

       The ptree_unregister_handler() function unregisters the event handler for the specified event. The argument ename specifies the name of the
       PICL  event  for which to unregister the handler. The argument evt_handler specifies the event handler function. The argument cookie is the
       pointer to the caller-specific data given at the time of registration of the handler.

       If the handler being unregistered is currently executing, then this function will block	until  its  completion.  Because  of  this,  locks
       acquired by the handlers should not be held across the call to ptree_unregister_handler() or a deadlock may result.

       The ptree_unregister_handler() function must not be invoked from the handler that is being unregistered.

RETURN VALUES

       This function does not return a value.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ptree_register_handler(3PICLTREE), attributes(5)

SunOS 5.10							    1 Aug 2000				       ptree_unregister_handler(3PICLTREE)

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

NAME

       ptree_post_event - post a PICL event

SYNOPSIS

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

       int ptree_post_event(const char *ename, const void *earg, size_t size, void (*completion_handler)(char *ename, void *earg, size_t size));

DESCRIPTION

       The  ptree_post_event()	function posts the specified event and its arguments to the PICL framework. The argument ename specifies a pointer
       to a string containing the name of the PICL event. The arguments earg and size specify a pointer to a buffer containing the event arguments
       and  size  of  that buffer, respectively. The argument completion_handler specifies the completion handler to be called after the event has
       been dispatched to all handlers. A NULL value for a completion handler indicates that no handler  should  be  called.  The  PICL  framework
       invokes the completion handler of an event with the ename, earg, and size arguments specified at the time of the posting of the event.

       PICL events are dispatched in the order in which they were posted. They are dispatched by executing the handlers registered for that event.
       The handlers are invoked in the order in which they were registered.

       New events will not begin execution until all previous events have finished execution. Specifically, an event posted from an event  handler
       will not begin execution until the current event has finished execution.

       The  caller may not reuse or reclaim the resources associated with the event name and arguments until the invocation of the completion han-
       dler.  The completion handlers are normally used to reclaim any resources allocated for the posting of an event.

RETURN VALUES

       Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error, the event  is  not  posted,
       and the completion handler is not invoked.

ERRORS

       PICL_INVALIDARG	       Invalid argument

       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_register_handler(3PICLTREE), ptree_unregister_handler(3PICLTREE), attributes(5)

SunOS 5.10							    1 Aug 2000					       ptree_post_event(3PICLTREE)