Crate rust_tcp_ipc

This is a crate for Interprocess Communication via TCP.

It allows for easy, asynchronous sending and receiving messages/commands.

A flexible protocol is used, consisting of a command, a length and a payload.

In detail, it is expected that the used TCP protocol works via exchange of byte collections. A fixed header length is assumed, so - for example - the first 5 bytes of each message encode the message header. The header in turn consists of a command (like Stop, Start, Pause, Load, …) and a length part. Command & length can be in arbitrary order (but have to be fixed for the protocol). Then the next length-many bytes which are received are the payload of the message. Further received bytes form the next message.

An example is given in the Examples.

Structs

Client

This is the main type of the library. Here all the logic is bundle. It can be used to easily send and receive messages via TCP, allowing for many different protcols to be used.

ClientConfig

This bundles the time-settings for the protocol

ShutdownError

The error type for a shutdown attemp.

TcpListener

A TCP socket server, listening for connections.

TcpStream

A TCP stream between a local and a remote socket.

Enums

BusyStateUpdateResult

The error type for a BusyState update

ConnectErrors

The error type for the connect-function.

ReadThreadErrors

The error type for operations in the asynchronous read thread

TryRecvError

This enumeration is the list of the possible reasons that try_recv could not return data when called. This can occur with both a channel and a sync_channel.

WriteMessageErrors

The error type for a message writing

Traits

Read

The Read trait allows for reading bytes from a source.

ToSocketAddrs

A trait for objects which can be converted or resolved to one or more SocketAddr values.

Write

A trait for objects which are byte-oriented sinks.