Direct Access Transport Library Functions      datrmrfree(3DAT)



NAME
     datrmrfree - destroy an instance of the RMR

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

     DATRETURN
         datrmrfree (
         IN    DATRMRHANDLE    rmrhandle
         )


PARAMETERS
     rmrhandle    Handle for an instance of the RMR to  be  des-
                   troyed.


DESCRIPTION
     The datrmrfree() function destroys an instance of the RMR.


     Use of the handle of the destroyed  RMR  in  any  subsequent
     operation  except  for  the datrmrfree() fails. Any remote
     RDMA operation that  uses  the  destroyed  RMR  rmrcontext,
     whose  Transport-specific  request arrived to the local host
     after the datrmrfree() has completed, fails and reports  a
     protection  violation.  Remote  RDMA operation that uses the
     destroyed RMR rmrcontext, whose Transport-specific  request
     arrived  to  the  local  host  prior  to  the datrmrfree()
     return, might or might  not  complete  successfully.  If  it
     fails,     DATDTOEREMOTEACES    is    reported    in
     DATDTOCOMPLETIONSTATUS for the remote RDMA  DTO  and  the
     connection is broken.


     The datrmrfree() function is allowed on  either  bound  or
     unbound  RMR.  If RMR is bound, datrmrfree() unbinds (free
     HCA TPT and other resources and  whatever  else  binds  with
     length of 0 should do), and then free RMR.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    The rmrhandle handle is invalid.


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




SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datrmrfree(3DAT)



     
           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