Module mio::net

source ·
Expand description

Networking primitives.

The types provided in this module are non-blocking by default and are designed to be portable across all supported Mio platforms. As long as the portability guidelines are followed, the behavior should be identical no matter the target platform.

Notes

When using a datagram based socket, i.e. UdpSocket or UnixDatagram, its only possible to receive a packet once. This means that if you provide a buffer that is too small you won’t be able to receive the data anymore. How OSs deal with this situation is different for each OS:

  • Unixes, such as Linux, FreeBSD and macOS, will simply fill the buffer and return the amount of bytes written. This means that if the returned value is equal to the size of the buffer it may have only written a part of the packet (or the packet has the same size as the buffer).
  • Windows returns an WSAEMSGSIZE error.

Mio does not change the value (either ok or error) returned by the OS, it’s up to the user handle this. How to deal with these difference is still up for debate, specifically in https://github.com/rust-lang/rust/issues/55794. The best advice we can give is to always call receive with a large enough buffer.

Structs

  • SocketAddr
    An address associated with a mio specific Unix socket.
  • TcpListener
    A structure representing a socket server
  • TcpStream
    A non-blocking TCP stream between a local socket and a remote socket.
  • UdpSocket
    A User Datagram Protocol socket.
  • UnixDatagram
    A Unix datagram socket.
  • UnixListener
    A non-blocking Unix domain socket server.
  • UnixStream
    A non-blocking Unix stream socket.