Struct PppUnit 

pub struct PppUnit { /* private fields */ }

A PPP network interface (pppN) created through /dev/ppp.

The interface exists while this value is alive. Connect a PPP channel to it with connect_channel; PPP control frames are then read from and written to the unit descriptor, while configured network protocols flow through the interface.

Implementations

impl PppUnit

pub fn new() -> Result<Self>

Creates a PPP unit with a kernel-chosen index.

pub fn with_index(index: i32) -> Result<Self>

Creates the PPP unit with the given index, failing with EEXIST when it is taken.

pub fn index(&self) -> i32

Returns the unit index, N of pppN.

pub fn ifname(&self) -> &L2tpIfName

Returns the interface name, pppN.

pub fn connect_channel(&self, socket: &PppSocket) -> Result<PppChannel>

Connects a PPP channel to this unit (PPPIOCATTCHAN followed by PPPIOCCONNECT).

The returned PppChannel must stay alive for as long as the channel should remain connected to the unit.

The unit and socket must belong to the same network namespace; otherwise this returns Error::NamespaceMismatch. Attachment runs in that namespace. Calling this from another namespace requires CAP_SYS_ADMIN to enter the owning namespace on a temporary thread; the calling thread is never moved.

Trait Implementations

impl AsFd for PppUnit

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.

impl AsRawFd for PppUnit

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for PppUnit

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

Formats the value using the given formatter.