links_blocking

Crates.iolinks_blocking
lib.rslinks_blocking
version0.2.12
sourcesrc
created_at2024-01-02 23:14:32.16065
updated_at2024-02-24 00:37:56.342374
descriptionBlocking implementation of links_blocking crate
homepage
repositoryhttps://github.com/softstream-link/links
max_upload_size
id1086771
size84,922
King K. Roll (softstream-link)

documentation

README

Motivation

  • Project motivation is to simplify application code development in the area of network communication. With focus on performance and ergonomics.

How does it simplify?

  • Traditionally, network api provide methods that exposes access to very low level byte arrays of data where as an application layer prefers to work with structs which carry information about application state.

  • Rust's std::net module is not an exception and it leaves developer with the responsibility to interpret the byte array by performing a number of steps to extract a single frame of bytes from that array, convert it into a desired data structure, while keeping track of remaining bytes and managing a lot of other details. The implementation details here have direct impact on application performance and reliability.

  • Even once those details have been addressed, the developer has to solve for many additional tasks such as:

    • How to handle partial reads?
    • Can i split read and write between different threads?
    • If i do split reads into a separate thread, can i use a single thread to manage all reads?
    • ... etc, etc
  • This library addresses above challenges, while providing a highly performant network code without imposing limitations on how application wishes to use the api.

Please tell me more

  • At a very high level The main concept is based on the the following two structures

    • Clt - this is a network client and can initiate a connection
    • Svc - this is a network service which listens to a port and creates a Clt for each established connection
    • Both Clt and Svc then provide and send and recv methods with a signature that roughly looks like this:
      • Clt::send(msg: &T) vs Clt::recv() -> T - where T is a generic type that you specify when instantiating a Clt and Svc
  • There are three implementations of this library. Follow individual links for more details

    • nonblocking - this implementation is most complete at the moment and its send()/recv() methods take a timeout argument. This allows the application developer to set io wait limits. The internal implementation relies on spin locks and waits to provide best latency performance as it does not let OS to park the running thread, which incurs significant latency penalty. This implementation is recommended for cases with low latency performance requirement.
    • blocking - this implementation is simplest to use as all method calls work sequentially by blocking until the operation completes. The ease of use comes at the cost of performance and scalability. This implementation is recommended for your typical network loads.
    • async - this implementation is based on Rust's async/await tokio framework, however, at the moment of this writing Rust's async api is still going through stabilization and is not yet available on stable toolchain.
Commit count: 0

cargo fmt