Manual Pages for UNIX Operating System command usage for man dat_rmr_free

Direct Access Transport Library Functions      dat_rmr_free(3DAT)



NAME
     dat_rmr_free - destroy an instance of the RMR

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

     DAT_RETURN
         dat_rmr_free (
         IN    DAT_RMR_HANDLE    rmr_handle
         )


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


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


     Use of the handle of the destroyed  RMR  in  any  subsequent
     operation  except  for  the dat_rmr_free() fails. Any remote
     RDMA operation that  uses  the  destroyed  RMR  rmr_context,
     whose  Transport-specific  request arrived to the local host
     after the dat_rmr_free() has completed, fails and reports  a
     protection  violation.  Remote  RDMA operation that uses the
     destroyed RMR rmr_context, whose Transport-specific  request
     arrived  to  the  local  host  prior  to  the dat_rmr_free()
     return, might or might  not  complete  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.


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

RETURN VALUES
     DAT_SUCCESS           The operation was successful.


     DAT_INVALID_HANDLE    The rmr_handle handle is invalid.


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




SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      dat_rmr_free(3DAT)



     ____________________________________________________________
    |       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