UCP/API: Deprecate ucp_request_alloc

Author: yosefe

src/ucp/api/ucp.h

@@ -3931,22 +3931,6 @@ void ucp_stream_data_release(ucp_ep_h ep, void *data);
 void ucp_request_free(void *request);
 
 
-/**
- * @ingroup UCP_COMM
- * @brief Create an empty communications request.
- *
- * @param [in]  worker       UCP worker.
- *
- * @return Error code as defined by @ref ucs_status_t
- *
- * This routine creates request which may be used in functions
- * @ref ucp_tag_send_nbx, @ref ucp_tag_recv_nbx, etc. The application
- * is responsible for releasing the handle using the @ref ucp_request_free
- * routine
- */
-void *ucp_request_alloc(ucp_worker_h worker);
-
-
 /**
  * @ingroup UCP_DATATYPE
  * @brief Create a generic datatype.

src/ucp/api/ucp_compat.h

@@ -55,6 +55,18 @@ void ucp_ep_destroy(ucp_ep_h ep);
 ucs_status_ptr_t ucp_disconnect_nb(ucp_ep_h ep);
 
 
+/**
+ * @ingroup UCP_COMM
+ * @deprecated User should allocate requests using standard methods such as
+ *             malloc() or alloca().
+ *
+ * @param [in]  worker       UCP worker.
+ *
+ * @return This function is not implemented and always returns NULL.
+ */
+void *ucp_request_alloc(ucp_worker_h worker);
+
+
 /**
  * @ingroup UCP_ENDPOINT
  * @deprecated Replaced by @ref ucp_tag_recv_request_test and