Struct ucp_ep_params

#[repr(C)]
pub struct ucp_ep_params {
    pub field_mask: u64,
    pub address: *const ucp_address_t,
    pub err_mode: ucp_err_handling_mode_t,
    pub err_handler: ucp_err_handler_t,
    pub user_data: *mut c_void,
    pub flags: c_uint,
    pub sockaddr: ucs_sock_addr_t,
    pub conn_request: ucp_conn_request_h,
    pub name: *const c_char,
}

@ingroup UCP_ENDPOINT @brief Tuning parameters for the UCP endpoint.

The structure defines the parameters that are used for the UCP endpoint tuning during the UCP ep @ref ucp_ep_create “creation”.

Fields

field_mask: u64

Mask of valid fields in this structure, using bits from @ref ucp_ep_params_field. Fields not specified in this mask will be ignored. Provides ABI compatibility with respect to adding new fields.

address: *const ucp_address_t

Destination address; this field should be set along with its corresponding bit in the field_mask - @ref UCP_EP_PARAM_FIELD_REMOTE_ADDRESS and must be obtained using @ref ucp_worker_get_address.

err_mode: ucp_err_handling_mode_t

Desired error handling mode, optional parameter. Default value is @ref UCP_ERR_HANDLING_MODE_NONE.

err_handler: ucp_err_handler_t

Handler to process transport level failure.

user_data: *mut c_void

User data associated with an endpoint. See @ref ucp_stream_poll_ep_t and @ref ucp_err_handler_t

flags: c_uint

Endpoint flags from @ref ucp_ep_params_flags_field. This value is optional. If it’s not set (along with its corresponding bit in the field_mask - @ref UCP_EP_PARAM_FIELD_FLAGS), the @ref ucp_ep_create() routine will consider the flags as set to zero.

sockaddr: ucs_sock_addr_t

Destination address in the form of a sockaddr; this field should be set along with its corresponding bit in the field_mask - @ref UCP_EP_PARAM_FIELD_SOCK_ADDR and must be obtained from the user, it means that this type of the endpoint creation is possible only on client side in client-server connection establishment flow.

conn_request: ucp_conn_request_h

Connection request from client; this field should be set along with its corresponding bit in the field_mask - @ref UCP_EP_PARAM_FIELD_CONN_REQUEST and must be obtained from @ref ucp_listener_conn_callback_t, it means that this type of the endpoint creation is possible only on server side in client-server connection establishment flow.

name: *const c_char

Endpoint name. Tracing and analysis tools can identify the endpoint using this name. To retrieve the endpoint’s name, use @ref ucp_ep_query, as the name you supply may be changed by UCX under some circumstances, e.g. a name conflict. This field is only assigned if you set @ref UCP_EP_PARAM_FIELD_NAME in the field mask. If not, then a default unique name will be created for you.

Trait Implementations

impl Clone for ucp_ep_params

fn clone(&self) -> ucp_ep_params

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ucp_ep_params

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Copy for ucp_ep_params