Direct Access Transport Library Functions      datlmrfree(3DAT)



NAME
     datlmrfree - destroy an instance of the LMR

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

     DATRETURN
         datlmrfree (
         IN    DATLMRHANDLE    lmrhandle
         )


PARAMETERS
     lmrhandle:    Handle for an instance  of  LMR  to  be  des-
                    troyed.


DESCRIPTION
     The datlmrfree() function destroys an instance of the LMR.
     The  LMR  cannot be destroyed if it is in use by an RMR. The
     operation does not deallocate the  memory  region  or  unpin
     memory on a host.


     Use of the handle of the destroyed  LMR  in  any  subsequent
     operation except for datlmrfree() fails. Any DTO operation
     that uses the destroyed LMR after the datlmrfree() is com-
     pleted shall fail and report a protection violation. The use
     of rmrcontext of the destroyed LMR by a remote peer for  an
     RDMA  DTO results in an error and broken connection on which
     it was used. Any remote RDMA operation that  uses  the  des-
     troyed  LMR  rmrcontext,  whose  Transport-specific request
     arrived to the local host after the datlmrfree() has  com-
     pleted,  fails  and  reports  a protection violation. Remote
     RDMA operation that  uses  the  destroyed  LMR  rmrcontext,
     whose  Transport-specific  request arrived to the local host
     prior to the datlmrfree() returns, might or might not com-
     plete  successfully.  If it fails, DATDTOEREMOTEACES
     is reported in DATDTOCOMPLETIONSTATUS for the remote RDMA
     DTO and the connection is broken.

RETURN VALUES
     DATSUCES           The operation was successful.


     DATINVALIDHANDLE    The lmrhandle parameter is invalid.


     DATINVALIDSTATE     Parameter in an invalid state; LMR  is
                           in use by an RMR instance.




SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      datlmrfree(3DAT)



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