Crate timeout_io

About

This library provides a simple timeout-based API for IO-operations.

It provides the following features:

• DNS-resolution (currently uses a background-thread)
• TCP-accept
• TCP-read/read-until/write
• StdIOE-read/read-until/write
• UDP-receive/send

All functions are defined as traits, so that you can easily wrap your own IO-channels without breaking compatibility.

Note: We currently do not provide a function for timeout-based connect-calls; use std::net::TcpStream::connect_timeout for TCP-connections or build sth. using io::libselect (and feel free to commit if you do so 😇)

Structs

EventMask

A struct describing null or more IO-events

SelectSet

A set of multiple (handle: event)-pairs that allows you to call select on all pairs at the same time

Enums

TimeoutIoError

An IO-error-wrapper

Traits

Acceptor

A trait for accepting elements, e.g. a TCP-listener

DnsResolvable

A trait for elements which contain a DNS-resolvable address

InstantExt

Extends std::time::Instant

IpParseable

A trait for elements which can be parsed to an IP-address

RawFd

A wrapper-trait that unifies the std::os::unix::io::AsRawFd and std::os::windows::io::AsRawSocket traits

Reader

A trait for reading with timeouts

WaitForEvent

This trait defines an API to wait for an event

Writer

A trait for writing with timeouts