margo.h 4.03 KB
Newer Older
1 2 3 4 5 6 7 8 9
/*
 * (C) 2015 The University of Chicago
 * 
 * See COPYRIGHT in top-level directory.
 */

#ifndef __MARGO
#define __MARGO

10 11 12 13
#ifdef __cplusplus
extern "C" {
#endif

14 15 16 17 18 19
#include <mercury_bulk.h>
#include <mercury.h>
#include <mercury_macros.h>
#include <abt.h>
#include <ev.h>

20 21 22 23

struct margo_instance;
typedef struct margo_instance* margo_instance_id;

24 25
#define MARGO_INSTANCE_NULL ((margo_instance_id)NULL)

26
/**
Jonathan Jenkins's avatar
Jonathan Jenkins committed
27
 * Initializes margo library from given argobots and Mercury instances.
Philip Carns's avatar
Philip Carns committed
28 29 30 31
 * @param [in] progress_pool Argobots pool to drive communication
 * @param [in] handler_pool Argobots pool to service RPC handlers
 * @param [in] hg_context Mercury context
 * @param [in] hg_class Mercury class
32
 * @returns margo instance id on success, NULL upon error
33
 */
34 35
margo_instance_id margo_init(ABT_pool progress_pool, ABT_pool handler_pool,
    hg_context_t *hg_context, hg_class_t *hg_class);
36 37 38

/**
 * Shuts down margo library and its underlying evfibers and mercury resources
Philip Carns's avatar
Philip Carns committed
39
 * @param [in] mid Margo instance
40
 */
41
void margo_finalize(margo_instance_id mid);
42 43

/**
Philip Carns's avatar
Philip Carns committed
44 45 46
 * Retrieve the abt_handler pool that was associated with the instance at 
 *    initialization time
 * @param [in] mid Margo instance
47
 */
48
ABT_pool* margo_get_handler_pool(margo_instance_id mid);
49 50 51

/**
 * Forward an RPC request to a remote host
Philip Carns's avatar
Philip Carns committed
52
 * @param [in] mid Margo instance
53 54 55 56 57
 * @param [in] handle identifier for the RPC to be sent
 * @param [in] in_struct input argument struct for RPC
 * @returns 0 on success, hg_return_t values on error
 */
hg_return_t margo_forward(
58
    margo_instance_id mid,
59 60 61 62 63
    hg_handle_t handle,
    void *in_struct);

/** 
 * Perform a bulk transfer
Philip Carns's avatar
Philip Carns committed
64
 * @param [in] mid Margo instance
65 66 67 68 69 70 71 72 73 74 75
 * @param [in] context Mercury bulk context
 * @param [in] op type of operation to perform
 * @param [in] origin_addr remote Mercury address
 * @param [in] origin_handle remote Mercury bulk memory handle
 * @param [in] origin_offset offset into remote bulk memory to access
 * @param [in] local_handle local bulk memory handle
 * @param [in] local_offset offset into local bulk memory to access
 * @param [in] size size (in bytes) of transfer
 * @returns 0 on success, hg_return_t values on error
 */
hg_return_t margo_bulk_transfer(
76
    margo_instance_id mid,
77 78 79 80 81 82 83 84 85
    hg_bulk_context_t *context,
    hg_bulk_op_t op,
    na_addr_t origin_addr,
    hg_bulk_t origin_handle,
    size_t origin_offset,
    hg_bulk_t local_handle,
    size_t local_offset,
    size_t size);

86 87 88 89 90 91 92 93
/**
 * address lookup
 * @param [in] na_class         pointer to NA class
 * @param [in] context          pointer to context of execution
 * @param [in] name             lookup name
 * @returns NA_SUCCESS on on success
 */
na_return_t margo_na_addr_lookup(
94
    margo_instance_id mid,
95 96
    na_class_t   *na_class,
    na_context_t *context,
97 98
    const char   *name,
    na_addr_t    *addr);
99

Philip Carns's avatar
Philip Carns committed
100 101
/**
 * Retrive the Margo instance that has been associated with a Mercury class
102
 * @param [in] cl Mercury class
Philip Carns's avatar
Philip Carns committed
103
 * @returns Margo instance on success, NULL on error
104
 */
105
margo_instance_id margo_hg_class_to_instance(hg_class_t *cl);
106

107 108 109 110
/**
 * macro that defines a function to glue an RPC handler to a fiber
 * @param [in] __name name of handler function
 */
111
#define DEFINE_MARGO_RPC_HANDLER(__name) \
112
hg_return_t __name##_handler(hg_handle_t handle) { \
113 114
    int __ret; \
    ABT_pool* __pool; \
115 116
    margo_instance_id __mid; \
    struct hg_info *__hgi; \
Jonathan Jenkins's avatar
Jonathan Jenkins committed
117
    hg_handle_t* __handle = (hg_handle_t*) malloc(sizeof(*__handle)); \
118 119
    if(!__handle) return(HG_NOMEM_ERROR); \
    *__handle = handle; \
120 121
    __hgi = HG_Get_info(handle); \
    __mid = margo_hg_class_to_instance(__hgi->hg_class); \
122
    __pool = margo_get_handler_pool(__mid); \
123 124 125 126 127 128 129
    __ret = ABT_thread_create(*__pool, __name, __handle, ABT_THREAD_ATTR_NULL, NULL); \
    if(__ret != 0) { \
        return(HG_NOMEM_ERROR); \
    } \
    return(HG_SUCCESS); \
}

Philip Carns's avatar
Philip Carns committed
130 131 132 133 134
/**
 * macro that declares the prototype for a function to glue an RPC 
 * handler to a fiber
 * @param [in] __name name of handler function
 */
135
#define DECLARE_MARGO_RPC_HANDLER(__name) hg_return_t __name##_handler(hg_handle_t handle);
136

137 138 139 140
#ifdef __cplusplus
}
#endif

141
#endif /* __MARGO */