Direct Access Transport Library Functions       datepfree(3DAT)



NAME
     datepfree - destroy an instance of the Endpoint

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

     DATRETURN
         datepfree (
         IN    DATEPHANDLE    ephandle
         )


PARAMETERS
     ephandle    Handle for an instance of the Endpoint.


DESCRIPTION
     The datepfree() function destroys an instance of the  End-
     point.


     The Endpoint can be destroyed in any Endpoint  state  except
     Reserved,  Passive Connection Pending, and Tentative Connec-
     tion Pending. The destruction of the Endpoint can also cause
     the  destruction of DTOs and RMRs posted to the Endpoint and
     not dequeued yet. This includes  completions  for  all  out-
     standing  and  in-progress  DTOs/RMRs.  The Consumer must be
     ready for all completions that are not dequeued  yet  either
     still    being   on   the   Endpoint   recvevdhandle   and
     requestevdhandle or not being there.


     The destruction of  the  Endpoint  during  connection  setup
     aborts connection establishment.


     If the Endpoint is in the Reserved state, the Consumer shall
     first  destroy  the  associated  Reserved Service Point that
     transitions the Endpoint into the  Unconnected  state  where
     the  Endpoint  can  be  destroyed. If the Endpoint is in the
     Passive Connection Pending state, the Consumer  shall  first
     reject  the  associated  Connection Request that transitions
     the Endpoint into the Unconnected state where  the  Endpoint
     can  be  destroyed. If the Endpoint is in the Tentative Con-
     nection Pending state, the Consumer shall reject the associ-
     ated  Connection  Request that transitions the Endpoint back
     to Provider control, and the Endpoint is destroyed as far as
     the Consumer is concerned.






SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions       datepfree(3DAT)



     The freeing of an Endpoint also destroys an Event Stream for
     each of the associated Event Dispatchers.


     Use of the handle of the destroyed Endpoint  in  any  subse-
     quent operation except for the datepfree() fails.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    The ephandle parameter is invalid.


     DATINVALIDSTATE     Parameter in  an  invalid  state.  The
                           Endpoint  is in DATEPSTATERESERVED,
                           DATEPSTATEPASIVECONECTIONPENDING,
                           or
                           DATEPSTATETENTATIVECONECTIONPENDING.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard: uDAPL, 1.1, 1.2   
    
     MT-Level                     Unsafe                      
    


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

















SunOS 5.11          Last change: 16 Jul 2004                    2