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

#ifndef __MARGO
#define __MARGO

#include <mercury_bulk.h>
#include <mercury.h>
#include <mercury_macros.h>
#include <abt.h>
#include <ev.h>

16
17
18
19
20
/* TODO: update doxygen, especially with mid arguments */

struct margo_instance;
typedef struct margo_instance* margo_instance_id;

21
22
23
24
25
/**
 * Initializes margo library, including initializing underlying libevfibers
 *    and Mercury instances.
 * @param [in] listen flag indicating whether to accept inbound RPCs or not
 * @param [in] local_addr address to listen on if listen is set
26
 * @returns margo instance id on success, NULL upon error
27
 */
28
29
margo_instance_id margo_init(ABT_pool progress_pool, ABT_pool handler_pool,
    hg_context_t *hg_context, hg_class_t *hg_class);
30
31
32
33

/**
 * Shuts down margo library and its underlying evfibers and mercury resources
 */
34
void margo_finalize(margo_instance_id mid);
35
36
37
38
39

/**
 * Retrieve the ABT pool associated with the main caller (whoever invoked the
 * init function); this is where margo will execute RPC handlers.
 */
40
ABT_pool* margo_get_handler_pool(margo_instance_id mid);
41
42
43
44
45
46
47
48

/**
 * Forward an RPC request to a remote host
 * @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(
49
    margo_instance_id mid,
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
    hg_handle_t handle,
    void *in_struct);

/** 
 * Perform a bulk transfer
 * @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(
66
    margo_instance_id mid,
67
68
69
70
71
72
73
74
75
    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);

76
77
78
79
80
/* given a particular hg_class, find the ABT pool that we intend to use to
 * execute handlers.
 */
margo_instance_id margo_hg_class_to_instance(hg_class_t *class);

81
82
83
84
85
/**
 * macro that defines a function to glue an RPC handler to a fiber
 * @param [in] __name name of handler function
 */
#define DEFINE_ARGO_RPC_HANDLER(__name) \
86
hg_return_t __name##_handler(hg_handle_t handle) { \
87
88
    int __ret; \
    ABT_pool* __pool; \
89
90
    margo_instance_id __mid; \
    struct hg_info *__hgi; \
91
92
93
    hg_handle_t* __handle = malloc(sizeof(*__handle)); \
    if(!__handle) return(HG_NOMEM_ERROR); \
    *__handle = handle; \
94
95
    __hgi = HG_Get_info(handle); \
    __mid = margo_hg_class_to_instance(__hgi->hg_class); \
96
    __pool = margo_get_handler_pool(__mid); \
97
98
99
100
101
102
103
    __ret = ABT_thread_create(*__pool, __name, __handle, ABT_THREAD_ATTR_NULL, NULL); \
    if(__ret != 0) { \
        return(HG_NOMEM_ERROR); \
    } \
    return(HG_SUCCESS); \
}

104
105
#define DECLARE_ARGO_RPC_HANDLER(__name) hg_return_t __name##_handler(hg_handle_t handle);

106
#endif /* __MARGO */