hyper-client-sockets

Crates.iohyper-client-sockets
lib.rshyper-client-sockets
version
sourcesrc
created_at2024-07-18 07:27:34.594635+00
updated_at2025-01-20 18:01:15.02309+00
descriptionA Hyper client library allowing access to Unix, VSock and Firecracker sockets
homepage
repositoryhttps://github.com/rust-firecracker/hyper-client-sockets
max_upload_size
id1307098
Cargo.toml error:TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
kanpov (kanpov)

documentation

README

Hyper Client Sockets

Before hyper v1, hyperlocal was the most convenient solution to use Unix sockets for both client and server. With hyper v1, server socket support is no longer needed (just use UnixListener or VsockListener instead of TcpListener), yet hyperlocal still has it and hasn't received a release since several years.

This library provides hyper v1 client support for:

  • Unix (AF_UNIX) sockets (HyperUnixStream implementing hyper traits)
  • VSock (AF_VSOCK) sockets (HyperVsockStream implementing hyper traits)
  • Firecracker Unix sockets that need CONNECT commands in order to establish a tunnel (HyperFirecrackerStream implementing hyper traits)

Additionally, the library supports different async I/O backends:

  • Tokio using tokio-backend
  • async-io stack using async-io-backend

The backend to use when connecting can be specified with the Backend trait. Compiling with both backends enabled is supported but not recommended, and leaving the choice of backend to the user is recommended for library developers.

Lastly, the hyper-util feature provides compatibility with hyper-util's Client connection pool via hex-encoded URIs.

Commit count: 51

cargo fmt