Manual Pages for UNIX Operating System command usage for man dat_lmr_free

Direct Access Transport Library Functions      dat_lmr_free(3DAT)



NAME
     dat_lmr_free - destroy an instance of the LMR

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

     DAT_RETURN
         dat_lmr_free (
         IN    DAT_LMR_HANDLE    lmr_handle
         )


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


DESCRIPTION
     The dat_lmr_free() 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 dat_lmr_free() fails. Any DTO operation
     that uses the destroyed LMR after the dat_lmr_free() is com-
     pleted shall fail and report a protection violation. The use
     of rmr_context 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  rmr_context,  whose  Transport-specific request
     arrived to the local host after the dat_lmr_free() has  com-
     pleted,  fails  and  reports  a protection violation. Remote
     RDMA operation that  uses  the  destroyed  LMR  rmr_context,
     whose  Transport-specific  request arrived to the local host
     prior to the dat_lmr_free() returns, might or might not com-
     plete  successfully.  If it fails, DAT_DTO_ERR_REMOTE_ACCESS
     is reported in DAT_DTO_COMPLETION_STATUS for the remote RDMA
     DTO and the connection is broken.

RETURN VALUES
     DAT_SUCCESS           The operation was successful.


     DAT_INVALID_HANDLE    The lmr_handle parameter is invalid.


     DAT_INVALID_STATE     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      dat_lmr_free(3DAT)



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