552c9ca5a0
WHAT: Open our low-level communication infrastructure by moving all necessary components (btl/rcache/allocator/mpool) down in OPAL All the components required for inter-process communications are currently deeply integrated in the OMPI layer. Several groups/institutions have express interest in having a more generic communication infrastructure, without all the OMPI layer dependencies. This communication layer should be made available at a different software level, available to all layers in the Open MPI software stack. As an example, our ORTE layer could replace the current OOB and instead use the BTL directly, gaining access to more reactive network interfaces than TCP. Similarly, external software libraries could take advantage of our highly optimized AM (active message) communication layer for their own purpose. UTK with support from Sandia, developped a version of Open MPI where the entire communication infrastucture has been moved down to OPAL (btl/rcache/allocator/mpool). Most of the moved components have been updated to match the new schema, with few exceptions (mainly BTLs where I have no way of compiling/testing them). Thus, the completion of this RFC is tied to being able to completing this move for all BTLs. For this we need help from the rest of the Open MPI community, especially those supporting some of the BTLs. A non-exhaustive list of BTLs that qualify here is: mx, portals4, scif, udapl, ugni, usnic. This commit was SVN r32317.
63 строки
2.0 KiB
C
63 строки
2.0 KiB
C
/* -*- Mode: C; c-basic-offset:4 ; indent-tabs-mode:nil -*- */
|
|
/*
|
|
* Copyright (c) 2011-2013 Los Alamos National Security, LLC. All rights
|
|
* reserved.
|
|
* Copyright (c) 2011 UT-Battelle, LLC. All rights reserved.
|
|
* $COPYRIGHT$
|
|
*
|
|
* Additional copyrights may follow
|
|
*
|
|
* $HEADER$
|
|
*/
|
|
|
|
#if !defined(MPI_COMMON_UGNI_EP_H)
|
|
#define MPI_COMMON_UGNI_EP_H
|
|
|
|
struct opal_common_ugni_device_t;
|
|
|
|
struct opal_common_ugni_endpoint_t {
|
|
opal_object_t super;
|
|
uint32_t ep_rem_addr, ep_rem_id; /**< remote information */
|
|
struct opal_common_ugni_device_t *dev; /**< device this endpoint is using */
|
|
};
|
|
typedef struct opal_common_ugni_endpoint_t opal_common_ugni_endpoint_t;
|
|
|
|
OBJ_CLASS_DECLARATION(opal_common_ugni_endpoint_t);
|
|
|
|
/*
|
|
* Get (and retain) a reference to an endpoint to peer_proc. This endpoint
|
|
* needs to be returned with opal_common_ugni_endpoint_return.
|
|
*
|
|
* @param[IN] dev uGNI device this endpoint should be bound to.
|
|
* @param[IN] peer_proc remote peer the endpoint will be connected to.
|
|
* @param[OUT] ep uGNI endpoint for the peer
|
|
*/
|
|
int opal_common_ugni_endpoint_for_proc (struct opal_common_ugni_device_t *dev, opal_proc_t *peer_proc,
|
|
opal_common_ugni_endpoint_t **ep);
|
|
|
|
/*
|
|
* Allocate and bind a uGNI endpoint handle to the remote peer.
|
|
*
|
|
* @param[IN] cep common endpoint
|
|
* @param[IN] cq completion queue
|
|
* @param[OUT] ep_handle uGNI endpoint handle
|
|
*/
|
|
int opal_common_ugni_ep_create (opal_common_ugni_endpoint_t *cep, gni_cq_handle_t cq, gni_ep_handle_t *ep_handle);
|
|
|
|
/*
|
|
* Unbind and free the uGNI endpoint handle.
|
|
*
|
|
* @param[IN] ep_handle uGNI endpoint handle to unbind and release
|
|
*/
|
|
int opal_common_ugni_ep_destroy (gni_ep_handle_t *ep_handle);
|
|
|
|
/*
|
|
* Return (and possibly free) a common endpoint. The endpoint may not be used
|
|
* once it is returned.
|
|
*
|
|
* @param[IN] ep uGNI endpoint to return
|
|
*/
|
|
void opal_common_ugni_endpoint_return (opal_common_ugni_endpoint_t *ep);
|
|
|
|
#endif /* MPI_COMMON_UGNI_EP_H */
|