UCX  1.8
Unified Communication X
ucp_def.h
1 /*
2 * Copyright (C) Mellanox Technologies Ltd. 2001-2014. ALL RIGHTS RESERVED.
3 * Copyright (C) UT-Battelle, LLC. 2014-2015. ALL RIGHTS RESERVED.
4 * Copyright (C) IBM 2015. ALL RIGHTS RESERVED.
5 * Copyright (C) Los Alamos National Security, LLC. 2018. ALL RIGHTS RESERVED.
6 *
7 * See file LICENSE for terms.
8 */
9 
10 #ifndef UCP_DEF_H_
11 #define UCP_DEF_H_
12 
13 #include <ucs/type/status.h>
14 #include <ucs/config/types.h>
15 #include <stddef.h>
16 #include <stdint.h>
17 
18 
29 
30 
51 typedef struct ucp_context *ucp_context_h;
52 
53 
68 typedef struct ucp_config ucp_config_t;
69 
70 
83 typedef struct ucp_ep *ucp_ep_h;
84 
85 
93 typedef struct ucp_conn_request *ucp_conn_request_h;
94 
95 
103 typedef struct ucp_address ucp_address_t;
104 
105 
112 typedef enum {
131 
132 
143 typedef struct ucp_rkey *ucp_rkey_h;
144 
145 
158 typedef struct ucp_mem *ucp_mem_h;
159 
160 
168 typedef struct ucp_listener *ucp_listener_h;
169 
170 
176 typedef struct ucp_mem_attr {
182  uint64_t field_mask;
183 
187  void *address;
188 
192  size_t length;
194 
195 
206 };
207 
208 
231  typedef struct ucp_worker *ucp_worker_h;
232 
233 
242 typedef uint64_t ucp_tag_t;
243 
244 
253 typedef struct ucp_recv_desc *ucp_tag_message_h;
254 
255 
263 typedef uint64_t ucp_datatype_t;
264 
265 
274 typedef void (*ucp_request_init_callback_t)(void *request);
275 
276 
286 typedef void (*ucp_request_cleanup_callback_t)(void *request);
287 
288 
304 typedef void (*ucp_send_callback_t)(void *request, ucs_status_t status);
305 
306 
320 typedef void (*ucp_err_handler_cb_t)(void *arg, ucp_ep_h ep, ucs_status_t status);
321 
322 
329 typedef struct ucp_err_handler {
332  void *arg;
337 
338 
353 typedef void (*ucp_listener_accept_callback_t)(ucp_ep_h ep, void *arg);
354 
355 
369 typedef void
371 
372 
391  void *arg;
394 
395 
411 typedef void (*ucp_stream_recv_callback_t)(void *request, ucs_status_t status,
412  size_t length);
413 
414 
434 typedef void (*ucp_tag_recv_callback_t)(void *request, ucs_status_t status,
435  ucp_tag_recv_info_t *info);
436 
451  UCP_WAKEUP_RMA = UCS_BIT(0),
452  UCP_WAKEUP_AMO = UCS_BIT(1),
453  UCP_WAKEUP_TAG_SEND = UCS_BIT(2),
454  UCP_WAKEUP_TAG_RECV = UCS_BIT(3),
455  UCP_WAKEUP_TX = UCS_BIT(10),
462  UCP_WAKEUP_RX = UCS_BIT(11),
467  UCP_WAKEUP_EDGE = UCS_BIT(16)
472 
473 
505 typedef ucs_status_t (*ucp_am_callback_t)(void *arg, void *data, size_t length,
506  ucp_ep_h reply_ep, unsigned flags);
507 
508 
516 typedef struct ucp_ep_params {
523  uint64_t field_mask;
524 
532 
538 
543 
548  void *user_data;
549 
557  unsigned flags;
558 
567 
577 
579 
580 
581 #endif
Tuning parameters for the UCP endpoint.
Definition: ucp_def.h:516
Definition: ucp_def.h:121
UCP receive information descriptor.
Definition: ucp.h:1074
struct ucp_mem * ucp_mem_h
UCP Memory handle.
Definition: ucp_def.h:158
UCP endpoint error handling context.
Definition: ucp_def.h:329
void(* ucp_tag_recv_callback_t)(void *request, ucs_status_t status, ucp_tag_recv_info_t *info)
Completion callback for non-blocking tag receives.
Definition: ucp_def.h:434
uint64_t ucp_datatype_t
UCP Datatype Identifier.
Definition: ucp_def.h:263
void(* ucp_stream_recv_callback_t)(void *request, ucs_status_t status, size_t length)
Completion callback for non-blocking stream oriented receives.
Definition: ucp_def.h:411
ucp_wakeup_event_types
UCP worker wakeup events mask.
Definition: ucp_def.h:450
struct ucp_mem_attr ucp_mem_attr_t
Attributes of the UCP Memory handle, filled by ucp_mem_query function.
uint64_t field_mask
Definition: ucp_def.h:182
void(* ucp_listener_conn_callback_t)(ucp_conn_request_h conn_request, void *arg)
A callback for handling of incoming connection request conn_request from a client.
Definition: ucp_def.h:370
struct ucp_context * ucp_context_h
UCP Application Context.
Definition: ucp_def.h:51
ucs_sock_addr_t sockaddr
Definition: ucp_def.h:566
struct ucp_conn_request * ucp_conn_request_h
UCP connection request.
Definition: ucp_def.h:93
unsigned flags
Definition: ucp_def.h:557
Definition: ucp_def.h:455
ucp_err_handler_cb_t cb
Definition: ucp_def.h:330
void(* ucp_err_handler_cb_t)(void *arg, ucp_ep_h ep, ucs_status_t status)
Callback to process peer failure.
Definition: ucp_def.h:320
Definition: ucp_def.h:204
struct ucp_listener * ucp_listener_h
UCP listen handle.
Definition: ucp_def.h:168
void(* ucp_request_cleanup_callback_t)(void *request)
Request cleanup callback.
Definition: ucp_def.h:286
struct ucp_listener_conn_handler ucp_listener_conn_handler_t
UCP callback to handle the connection request in a client-server connection establishment flow.
void * arg
Definition: ucp_def.h:391
Definition: ucp_def.h:205
ucp_listener_conn_callback_t cb
Definition: ucp_def.h:390
Attributes of the UCP Memory handle, filled by ucp_mem_query function.
Definition: ucp_def.h:176
void * arg
Definition: ucp_def.h:332
uint64_t field_mask
Definition: ucp_def.h:523
ucp_mem_attr_field
UCP Memory handle attributes field mask.
Definition: ucp_def.h:203
Definition: ucp_def.h:451
void(* ucp_request_init_callback_t)(void *request)
Request initialization callback.
Definition: ucp_def.h:274
struct ucp_ep_params ucp_ep_params_t
Tuning parameters for the UCP endpoint.
Definition: ucp_def.h:462
ucs_status_t
Status codes.
Definition: status.h:45
struct ucp_address ucp_address_t
UCP worker address.
Definition: ucp_def.h:103
void(* ucp_send_callback_t)(void *request, ucs_status_t status)
Completion callback for non-blocking sends.
Definition: ucp_def.h:304
ucp_conn_request_h conn_request
Definition: ucp_def.h:576
struct ucp_config ucp_config_t
UCP configuration descriptor.
Definition: ucp_def.h:68
struct ucp_recv_desc * ucp_tag_message_h
UCP Message descriptor.
Definition: ucp_def.h:253
Definition: ucp_def.h:467
void(* ucp_listener_accept_callback_t)(ucp_ep_h ep, void *arg)
A callback for accepting client/server connections on a listener ucp_listener_h.
Definition: ucp_def.h:353
size_t length
Definition: ucp_def.h:192
void * address
Definition: ucp_def.h:187
uint64_t ucp_tag_t
UCP Tag Identifier.
Definition: ucp_def.h:242
const ucp_address_t * address
Definition: ucp_def.h:531
struct ucp_err_handler ucp_err_handler_t
UCP endpoint error handling context.
ucp_err_handling_mode_t err_mode
Definition: ucp_def.h:537
Definition: ucp_def.h:452
enum ucp_wakeup_event_types ucp_wakeup_event_t
UCP worker wakeup events mask.
ucp_err_handler_t err_handler
Definition: ucp_def.h:542
struct ucp_worker * ucp_worker_h
UCP Worker.
Definition: ucp_def.h:231
void * user_data
Definition: ucp_def.h:548
Definition: ucp_def.h:454
ucp_err_handling_mode_t
Error handling mode for the UCP endpoint.
Definition: ucp_def.h:112
Definition: types.h:116
struct ucp_ep * ucp_ep_h
UCP Endpoint.
Definition: ucp_def.h:83
UCP callback to handle the connection request in a client-server connection establishment flow.
Definition: ucp_def.h:389
struct ucp_rkey * ucp_rkey_h
UCP Remote memory handle.
Definition: ucp_def.h:143
ucs_status_t(* ucp_am_callback_t)(void *arg, void *data, size_t length, ucp_ep_h reply_ep, unsigned flags)
Callback to process incoming Active Message.
Definition: ucp_def.h:505
Definition: ucp_def.h:453
Definition: ucp_def.h:113