netns-rs 0.1.0

A library to handle Linux network namespaces in Rust
Documentation
  • Coverage
  • 45%
    9 out of 20 items documented1 out of 2 items with examples
  • Size
  • Source code size: 46.98 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.47 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 17s Average build duration of successful builds.
  • all releases: 17s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • openanolis/netns-rs
    16 5 1
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • github:openanolis:dragonball wllenyj

netns-rs

static UT codecov

The netns-rs crate provides an ultra-simple interface for handling network namespaces in Rust. Changing namespaces requires elevated privileges, so in most cases this code needs to be run as root.

This crate only supports linux kernel.

Build

cargo build

Test(as root)

CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_RUNNER="sudo -E" cargo test

or

sudo -E cargo test

Credits

The main resource so far has been the source code of netns(golang), CNI network plugins and iproute2.

Altnernatives

https://github.com/little-dude/netlink: rtnetlink/src/ns.rs provides the same functionality, but its creation of netns in a new process feels a bit heavy.

License

This code is licensed under Apache-2.0.