Skip to content

Connect to Unix Domain sockets by abstract names #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sivizius wants to merge 6 commits into
base: master
Choose a base branch
from
Open

Connect to Unix Domain sockets by abstract names #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
cee16a2
refactor: restructure and reuse code
sivizius Nov 7, 2025
11982ad
feat(firecracker,unix): use `OsString` to allow abstract names
sivizius Nov 7, 2025
fd51b83
feat(firecracker,unix): `unix::SocketAddr` methods for `Uri` extensions
sivizius Nov 11, 2025
37ae28f
feat(tokio,async_io,connector): expose inner types
sivizius Nov 11, 2025
a10e8d4
feat(tokio,async_io): impl `hyper_util::<...>::Connection` for IO types
sivizius Nov 11, 2025
f486936
feat(vsock): avoid GPL-2.0 incompatible Apache-2.0-licensed `vsock`
sivizius Jan 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
140 changes: 120 additions & 20 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 6 additions & 6 deletions Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ version = "0.6.0"
edition = "2021"
license = "MIT"
description = "A Hyper client library allowing access to Unix, VSock and Firecracker sockets"
rust-version = "1.63"
rust-version = "1.74"
repository = "https://github.com/rust-firecracker/hyper-client-sockets"
readme = "README.md"
keywords = ["hyper", "client", "sockets"]
Expand All @@ -19,7 +19,7 @@ hyper = { version = "1.5.2", default-features = false }

# hyper-util support
tower-service = { version = "0.3.3", optional = true }
hyper-util = { version = "0.1.10", optional = true, default-features = false }
hyper-util = { version = "0.1.17", optional = true, default-features = false }
hex = { version = "0.4.3", optional = true }
http = { version = "1.2.0", optional = true }
# tokio backend
Expand All @@ -31,8 +31,8 @@ smol-hyper = { version = "0.1.1", optional = true, default-features = false, fea
"async-io",
] }
futures-lite = { version = "2.6.0", optional = true }
# vsock sockets
vsock = { version = "0.5.1", optional = true }
# VSOCK sockets
nix = { version = "0.29.0", features = [ "socket" ], optional = true }

[dev-dependencies]
hyper-client-sockets = { path = ".", features = ["full"] }
Expand All @@ -41,7 +41,7 @@ tokio = { version = "1.43.0", features = ["macros", "fs"] }
async-executor = "1.13.1"
# hyper utils
hyper = { version = "1.5.2", features = ["server", "http1"] }
hyper-util = { version = "0.1.10", features = [
hyper-util = { version = "0.1.17", features = [
"client",
"client-legacy",
"http1",
Expand Down Expand Up @@ -78,5 +78,5 @@ hyper-util = [
"dep:http",
]
unix = []
vsock = ["dep:vsock"]
vsock = ["dep:nix"]
firecracker = []
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
## 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.
Before hyper v1, hyperlocal was the most convenient solution to use Unix Domain 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)
- Firecracker Unix Domain sockets that need `CONNECT` commands in order to establish a tunnel (`HyperFirecrackerStream` implementing hyper traits)

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

Expand Down
Loading