lio 0.4.1

A platform-independent async I/O library with native support for io_uring (Linux), IOCP (Windows), and kqueue (macOS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//! Test utilities for integration tests.
//!
//! This module provides helper functions for creating sockets using lio's
//! async operations. Only available when building tests.

use crate::api;
use crate::api::{io::Io, ops};

/// Creates a Unix stream socket using lio operations (blocking).
///
/// Returns the Resource which must be closed by the caller using `lio::close()`.
#[doc(hidden)]
pub fn unix_stream_socket() -> Io<ops::Socket> {
  api::socket(libc::AF_UNIX, libc::SOCK_STREAM, 0)
}

/// Creates a Unix datagram socket using lio operations (blocking).
///
/// Returns the Resource which must be closed by the caller using `lio::close()`.
#[doc(hidden)]
pub fn unix_dgram_socket() -> Io<ops::Socket> {
  api::socket(libc::AF_UNIX, libc::SOCK_DGRAM, 0)
}

/// Creates a TCP IPv4 socket using lio operations.
///
/// Returns a Io that can be used with `.send()`, `.when_done()`, `.blocking()`, etc.
#[doc(hidden)]
pub fn tcp_socket() -> Io<ops::Socket> {
  api::socket(libc::AF_INET, libc::SOCK_STREAM, 0)
}

/// Creates a TCP IPv6 socket using lio operations.
///
/// Returns a Io that can be used with `.send()`, `.when_done()`, `.blocking()`, etc.
#[doc(hidden)]
pub fn tcp6_socket() -> Io<ops::Socket> {
  api::socket(libc::AF_INET6, libc::SOCK_STREAM, libc::IPPROTO_TCP)
}

/// Creates a UDP IPv4 socket using lio operations.
///
/// Returns a Io that can be used with `.send()`, `.when_done()`, `.blocking()`, etc.
#[doc(hidden)]
pub fn udp_socket() -> Io<ops::Socket> {
  api::socket(libc::AF_INET, libc::SOCK_DGRAM, libc::IPPROTO_UDP)
}

/// Creates a UDP IPv6 socket using lio operations.
///
/// Returns a Io that can be used with `.send()`, `.when_done()`, `.blocking()`, etc.
#[doc(hidden)]
pub fn udp6_socket() -> Io<ops::Socket> {
  api::socket(libc::AF_INET6, libc::SOCK_DGRAM, libc::IPPROTO_UDP)
}