request_tag.h
1 
5 #pragma once
6 #include <memory>
7 #include <string>
8 #include <utility>
9 
10 #include <ucp/api/ucp.h>
11 
12 #include <ucxx/delayed_submission.h>
13 #include <ucxx/request.h>
14 #include <ucxx/typedefs.h>
15 
16 namespace ucxx {
17 
24 class RequestTag : public Request {
25  private:
55  RequestTag(
56  std::shared_ptr<Component> endpointOrWorker,
57  const std::variant<data::TagSend, data::TagReceive, data::TagReceiveWithHandle> requestData,
58  std::string operationName,
59  const bool enablePythonFuture = false,
60  RequestCallbackUserFunction callbackFunction = nullptr,
61  RequestCallbackUserData callbackData = nullptr);
62 
63  public:
95  friend std::shared_ptr<RequestTag> createRequestTag(
96  std::shared_ptr<Component> endpointOrWorker,
97  const std::variant<data::TagSend, data::TagReceive, data::TagReceiveWithHandle> requestData,
98  const bool enablePythonFuture,
99  RequestCallbackUserFunction callbackFunction,
100  RequestCallbackUserData callbackData);
101 
103 
111  void request();
112 
128  static void tagSendCallback(void* request, ucs_status_t status, void* arg);
129 
147  static void tagRecvCallback(void* request,
148  ucs_status_t status,
149  const ucp_tag_recv_info_t* info,
150  void* arg);
151 
168  void callback(void* request, ucs_status_t status, const ucp_tag_recv_info_t* info);
169 };
170 
171 } // namespace ucxx
Send or receive a message with the UCX Tag API.
Definition: request_tag.h:24
void request()
Create and submit a tag request.
friend std::shared_ptr< RequestTag > createRequestTag(std::shared_ptr< Component > endpointOrWorker, const std::variant< data::TagSend, data::TagReceive, data::TagReceiveWithHandle > requestData, const bool enablePythonFuture, RequestCallbackUserFunction callbackFunction, RequestCallbackUserData callbackData)
Constructor for std::shared_ptr<ucxx::RequestTag>.
virtual void populateDelayedSubmission()
Populate the internal submission dispatcher.
void callback(void *request, ucs_status_t status, const ucp_tag_recv_info_t *info)
Implementation of the tag receive request callback.
static void tagSendCallback(void *request, ucs_status_t status, void *arg)
Callback executed by UCX when a tag send request is completed.
static void tagRecvCallback(void *request, ucs_status_t status, const ucp_tag_recv_info_t *info, void *arg)
Callback executed by UCX when a tag receive request is completed.
Base type for a UCXX transfer request.
Definition: request.h:38
Definition: address.h:15
std::function< void(ucs_status_t, std::shared_ptr< void >)> RequestCallbackUserFunction
A user-defined function to execute as part of a ucxx::Request callback.
Definition: typedefs.h:91
std::shared_ptr< void > RequestCallbackUserData
Data for the user-defined function provided to the ucxx::Request callback.
Definition: typedefs.h:99