net only.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,
it’s 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
WSAEMSGSIZEerror.
Mio does not change the value (either ok or error) returned by the OS, it’s up to the user to handle this. How to deal with these differences 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§
- TcpListener
- A structure representing a socket server
- TcpStream
- A non-blocking TCP stream between a local socket and a remote socket.
- UdpSocket
Non-WASI - A User Datagram Protocol socket.
- Unix
Datagram Unix - A Unix datagram socket.
- Unix
Listener Unix - A non-blocking Unix domain socket server.
- Unix
Stream Unix - A non-blocking Unix stream socket.