Skip to content

Latest commit

 

History

History
76 lines (60 loc) · 1.46 KB

README.md

File metadata and controls

76 lines (60 loc) · 1.46 KB
Raw

IODash

Lightweight C++ I/O library for POSIX operation systems

Features

  • Fast & lightweight
  • RAII
  • Header only
  • Both sync & async
  • Uses very little memory (1MB for 10k TCP conns on x86_64)
  • No more Boosted

Supported IO targets

  • Regular file (no async so far)
  • Socket (TCP, UDP, Unix, Pipe, SocketPair...)
  • Serial (/dev/tty*)
  • Timer (timerfd on Linux) (WIP)
  • ...more to come

Supported event backends

  • poll
  • epoll
  • ...more to come

Requirements

  • C++17
  • POSIX compatible operation system

Benchmarks

See Benchmarks.

ToDos

  • Documentation!!!
  • Serial port class
  • kqueue support for BSDs
  • io_uring support for newer Linux

Usage

#include <IODash.hpp>

using namespace IODash;
SocketAddress<AddressFamily::IPv4> v4_addr("127.0.0.1:8080");
v4_addr.from_string("0.0.0.0");
v4_addr.from_string("0.0.0.0:8888");
v4_addr.port() = 8080;
std::cout << v4_addr.to_string();

SocketAddress<AddressFamily::IPv6> v6_addr("[::1]:8888");
v6_addr.from_string("::");
v6_addr.from_string("[::]:8888");
v6_addr.port() = 8080;
std::cout << v6_addr.to_string();

std::unordered_set<SocketAddress<AddressFamily::IPv4>> addrs;
addrs.insert(v4_addr);
Socket<AddressFamily::IPv4, SocketType::Datagram> socket0; // IPv4 UDP
socket0.create();
socket0.sendto({"127.0.0.1:9999"}, "abcde", 5);

For more examples, see test.cpp and http_test.cpp.

Documentation

TBD

Warning

The API is not stabilized yet.

License

MIT