Manual Pages for UNIX Operating System command usage for man dat_evd_free

Direct Access Transport Library Functions      dat_evd_free(3DAT)



NAME
     dat_evd_free - destroy an instance of the Event Dispatcher

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

     DAT_RETURN
         dat_evd_free (
         IN    DAT_EVD_HANDLE    evd_handle
         )


PARAMETERS
     evd_handle    Handle  for   an   instance   of   the   Event
                   Dispatcher.


DESCRIPTION
     The dat_evd_free() function destroys a specified instance of
     the Event Dispatcher.


     All events on the queue of the  specified  Event  Dispatcher
     are  lost.  The destruction of the Event Dispatcher instance
     does not have any effect on any DAT Objects that  originated
     an  Event Stream that had fed events to the Event Dispatcher
     instance. There should be no event streams feeding the Event
     Dispatcher  and  no  threads blocked on the Event Dispatcher
     when the EVD is being closed as at  the  time  when  it  was
     created.


     Use of the handle of the destroyed Event Dispatcher  in  any
     consequent operation fails.

RETURN VALUES
     DAT_SUCCESS           The operation was successful.


     DAT_INVALID_HANDLE    The evd_handle parameter is invalid


     DAT_INVALID_STATE     Invalid  parameter.  There  are  Event
                           Streams   associated  with  the  Event
                           Dispatcher feeding it.


USAGE
     Consumers are advised to destroy all Objects that  originate
     Event  Streams that feed an instance of the Event Dispatcher
     before destroying it. An exception to  this  rule  is  Event



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      dat_evd_free(3DAT)



     Dispatchers of an IA.


     Freeing an IA automatically destroys all Objects  associated
     with  it  directly and indirectly, including Event Dispatch-
     ers.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|
    | Standard                    | uDAPL, 1.1, 1.2             |
    |_____________________________|_____________________________|


SEE ALSO
     libdat(3LIB), attributes(5)





























SunOS 5.11          Last change: 16 Jul 2004                    2