Struct NetNs

pub struct NetNs<E: Env = DefaultEnv> { /* private fields */ }

A network namespace type.

It could be used to enter network namespace.

Implementations

impl<E: Env> NetNs<E>

pub fn new_with_env<S: AsRef<str>>(ns_name: S, env: E) -> Result<Self>

Creates a new NetNs with the specified name and Env.

The persist dir of network namespace will be created if it doesn’t already exist.

pub fn path(&self) -> &Path

Gets the path of this network namespace.

pub fn env(&self) -> Option<&E>

Gets the Env of this network namespace.

pub fn file(&self) -> &File

Gets the Env of this network namespace.

pub fn enter(&self) -> Result<()>

Makes the current thread enter this network namespace.

Requires elevated privileges.

pub fn get_from_env<S: AsRef<str>>(ns_name: S, env: E) -> Result<Self>

Returns the NetNs with the specified name and Env.

pub fn remove(self) -> Result<()>

Removes this network namespace manually.

Once called, this instance will not be available.

pub fn run<F, T>(&self, f: F) -> Result<T>

where F: FnOnce(&Self) -> T,

Run a closure in NetNs, which is specified by name and Env.

Requires elevated privileges.

impl NetNs

pub fn new<S: AsRef<str>>(ns_name: S) -> Result<Self>

Creates a new persistent (bind-mounted) network namespace and returns an object representing that namespace, without switching to it.

The persist directory of network namespace will be created if it doesn’t already exist. This function will use DefaultEnv to create persist directory.

Requires elevated privileges.

pub fn get<S: AsRef<str>>(ns_name: S) -> Result<Self>

Returns the NetNs with the specified name and DefaultEnv.

pub fn run_in<S, F, T>(ns_name: S, f: F) -> Result<T>

where S: AsRef<str>, F: FnOnce(&Self) -> T,

Run a closure in NetNs, which is specified by name and DefaultEnv.

Requires elevated privileges.

Trait Implementations

impl<E: Debug + Env> Debug for NetNs<E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<E: Env> Display for NetNs<E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<E1: Env, E2: Env> PartialEq<NetNs<E1>> for NetNs<E2>

fn eq(&self, other: &NetNs<E1>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.