netns-rs 0.2.0

A library to handle Linux network namespaces in Rust
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

# netns-rs

[![static](https://github.com/wllenyj/netns-rs/actions/workflows/rust.yml/badge.svg)](https://github.com/wllenyj/netns-rs/actions/workflows/rust.yml)
[![UT](https://github.com/wllenyj/netns-rs/actions/workflows/test.yaml/badge.svg)](https://github.com/wllenyj/netns-rs/actions/workflows/test.yaml)
[![codecov](https://codecov.io/gh/wllenyj/netns-rs/branch/main/graph/badge.svg?token=KVDCQ8ZRUS)](https://codecov.io/gh/wllenyj/netns-rs)

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)](https://github.com/vishvananda/netlink), [CNI network plugins](https://github.com/containernetworking/plugins/blob/master/pkg/testutils/netns_linux.go) and [iproute2](https://wiki.linuxfoundation.org/networking/iproute2).

## Altnernatives
[https://github.com/little-dude/netlink](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](LICENSE).