Struct RdmaManagerActor

pub struct RdmaManagerActor { /* private fields */ }

Trait Implementations

impl Actor for RdmaManagerActor

type Params = Option<IbverbsConfig>

The type of initialization parameters accepted by this actor.

fn new<'async_trait>( params: Self::Params, ) -> Pin<Box<dyn Future<Output = Result<Self, Error>> + Send + 'async_trait>>

where Self: 'async_trait,

Creates a new actor instance given its instantiation parameters.

fn init<'life0, 'life1, 'async_trait>( &'life0 mut self, _this: &'life1 Instance<Self>, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Initialize the actor, after the runtime has been fully initialized. Init thus provides a mechanism by which an actor can reliably and always receive some initial event that can be used to kick off further (potentially delayed) processing.

fn handle_supervision_event<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, _cx: &'life1 Instance<Self>, _event: &'life2 ActorSupervisionEvent, ) -> Pin<Box<dyn Future<Output = Result<bool, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle actor supervision event. Return `Ok(true)`` if the event is handled here.

fn cleanup<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, _this: &'life1 Instance<Self>, _err: Option<&'life2 ActorError>, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Cleanup things used by this actor before shutting down. Notably this function is async and allows more complex cleanup. Simpler cleanup can be handled by the impl Drop for this Actor. If err is not None, it is the error that this actor is failing with. Any errors returned by this function will be logged and ignored. If err is None, any errors returned by this function will be propagated as an ActorError. This function is not called if there is a panic in the actor, as the actor may be in an indeterminate state. It is also not called if the process is killed, there is no atexit handler or signal handler.

fn spawn<'life0, 'async_trait>( cx: &'life0 (impl Actor + 'async_trait), params: Self::Params, ) -> Pin<Box<dyn Future<Output = Result<ActorHandle<Self>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Spawn a child actor, given a spawning capability (usually given by Instance). The spawned actor will be supervised by the parent (spawning) actor.

fn spawn_detached<'async_trait>( params: Self::Params, ) -> Pin<Box<dyn Future<Output = Result<ActorHandle<Self>, Error>> + Send + 'async_trait>>

where Self: 'async_trait,

Spawns this actor in a detached state, handling its messages in a background task. The returned handle is used to control the actor’s lifecycle and to interact with it.

fn spawn_server_task<F>(future: F) -> JoinHandle<<F as Future>::Output>

where F: Future + Send + 'static, <F as Future>::Output: Send + 'static,

This method is used by the runtime to spawn the actor server. It can be used by actors that require customized runtime setups (e.g., dedicated actor threads), or want to use a custom tokio runtime.

fn handle_undeliverable_message<'life0, 'life1, 'async_trait>( &'life0 mut self, cx: &'life1 Instance<Self>, envelope: Undeliverable<MessageEnvelope>, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Default undeliverable message handling behavior.

fn display_name(&self) -> Option<String>

If overridden, we will use this name in place of the ActorId for talking about this actor in supervision error messages.

impl Binds<RdmaManagerActor> for RdmaManagerActor

fn bind(ports: &Ports<Self>)

Bind ports in this actor.

impl Debug for RdmaManagerActor

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

Formats the value using the given formatter.

impl Drop for RdmaManagerActor

fn drop(&mut self)

Executes the destructor for this type.

impl Handler<RdmaManagerMessage> for RdmaManagerActor

fn handle<'life0, 'life1, 'async_trait>( &'life0 mut self, cx: &'life1 Context<'_, Self>, message: RdmaManagerMessage, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle the next M-typed message.

impl Named for RdmaManagerActor

fn typename() -> &'static str

The globally unique type name for the type. This should typically be the fully qualified Rust name of the type.

fn typehash() -> u64

A globally unique hash for this type. TODO: actually enforce perfect hashing

fn typeid() -> TypeId

The TypeId for this type. TypeIds are unique only within a binary, and should not be used for global identification.

fn port() -> u64

The globally unique port for this type. Typed ports are in the range of 1<<63..1<<64-1.

fn arm(&self) -> Option<&'static str>

If the named type is an enum, this returns the name of the arm of the value self.

unsafe fn arm_unchecked(self_: *const ()) -> Option<&'static str>

An unsafe version of ‘arm’, accepting a pointer to the value, for use in type-erased settings.

impl RdmaManagerMessageHandler for RdmaManagerActor

fn request_buffer<'life0, 'life1, 'async_trait>( &'life0 mut self, cx: &'life1 Context<'_, Self>, addr: usize, size: usize, ) -> Pin<Box<dyn Future<Output = Result<RdmaBuffer, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Requests a buffer to be registered with the RDMA domain.

This function registers a memory region with the RDMA domain and returns an RdmaBuffer that encapsulates the necessary information for RDMA operations.

Arguments

• this - The context of the actor requesting the buffer.
• addr - The starting address of the memory region to be registered.
• size - The size of the memory region to be registered.

Returns

• Result<RdmaBuffer, anyhow::Error> - On success, returns an RdmaBuffer containing the registered memory region’s details. On failure, returns an error.

fn release_buffer<'life0, 'life1, 'async_trait>( &'life0 mut self, _cx: &'life1 Context<'_, Self>, buffer: RdmaBuffer, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Deregisters a buffer from the RDMA domain.

This function removes the specified RdmaBuffer from the RDMA domain, effectively releasing the resources associated with it.

Arguments

• _this - The context of the actor releasing the buffer.
• buffer - The RdmaBuffer to be deregistered.

Returns

• Result<(), anyhow::Error> - On success, returns Ok(()). On failure, returns an error.

fn request_queue_pair<'life0, 'life1, 'async_trait>( &'life0 mut self, cx: &'life1 Context<'_, Self>, other: ActorRef<RdmaManagerActor>, self_device: String, other_device: String, ) -> Pin<Box<dyn Future<Output = Result<RdmaQueuePair, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Requests a queue pair for communication with a remote RDMA manager actor.

Basic logic: if queue pair exists in map, return it; if None, create connection first.

Arguments

• cx - The context of the actor requesting the queue pair.
• remote - The ActorRef of the remote RDMA manager actor to communicate with.

Returns

• Result<RdmaQueuePair, anyhow::Error> - On success, returns the queue pair for communication. On failure, returns an error.

fn connect<'life0, 'life1, 'async_trait>( &'life0 mut self, _cx: &'life1 Context<'_, Self>, other: ActorRef<RdmaManagerActor>, self_device: String, other_device: String, endpoint: RdmaQpInfo, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Establishes a connection with another actor

Arguments

• other - The ActorRef of the actor to connect to
• endpoint - Connection information needed to establish the RDMA connection

fn connection_info<'life0, 'life1, 'async_trait>( &'life0 mut self, _cx: &'life1 Context<'_, Self>, other: ActorRef<RdmaManagerActor>, self_device: String, other_device: String, ) -> Pin<Box<dyn Future<Output = Result<RdmaQpInfo, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Gets connection information for establishing an RDMA connection

Arguments

• other - The ActorRef to get connection info for

Returns

• RdmaQpInfo - Connection information needed for the RDMA connection

fn release_queue_pair<'life0, 'life1, 'async_trait>( &'life0 mut self, _cx: &'life1 Context<'_, Self>, _other: ActorRef<RdmaManagerActor>, _self_device: String, _other_device: String, _qp: RdmaQueuePair, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Releases a queue pair back to the HashMap

This method is now a no-op since RdmaQueuePair is Clone and can be safely shared. The queue pair is not actually checked out, so there’s nothing to release. This method is kept for API compatibility.

Arguments

• remote - The ActorRef of the remote actor to return the queue pair for
• qp - The queue pair to release (ignored)

fn get_qp_state<'life0, 'life1, 'async_trait>( &'life0 mut self, _cx: &'life1 Context<'_, Self>, other: ActorRef<RdmaManagerActor>, self_device: String, other_device: String, ) -> Pin<Box<dyn Future<Output = Result<u32, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Gets the state of a queue pair

Arguments

• other - The ActorRef to get the QP state for
• self_device - Local device name
• other_device - Remote device name

Returns

• u32 - The QP state (e.g., IBV_QPS_RTS = Ready To Send)

fn initialize_qp<'life0, 'life1, 'async_trait>( &'life0 mut self, _cx: &'life1 Context<'_, Self>, other: ActorRef<RdmaManagerActor>, self_device: String, other_device: String, ) -> Pin<Box<dyn Future<Output = Result<bool, Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

The generated handler method for this enum variant.

fn handle<'life0, 'life1, 'async_trait>( &'life0 mut self, cx: &'life1 Context<'_, Self>, message: RdmaManagerMessage, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle the next message.

impl Referable for RdmaManagerActor

impl RemoteHandles<RdmaManagerMessage> for RdmaManagerActor

impl RemoteHandles<Signal> for RdmaManagerActor