Struct aya::programs::tc::SchedClassifier

pub struct SchedClassifier { /* fields omitted */ }

A network traffic control classifier.

SchedClassifier programs can be used to inspect, filter or redirect network packets in both ingress and egress. They are executed as part of the linux network traffic control system. See https://man7.org/linux/man-pages/man8/tc-bpf.8.html.

Examples

use std::convert::TryInto;
use aya::programs::{tc, SchedClassifier, TcAttachType};

// the clsact qdisc needs to be added before SchedClassifier programs can be
// attached
tc::qdisc_add_clsact("eth0")?;

let prog: &mut SchedClassifier = bpf.program_mut("redirect_ingress")?.try_into()?;
prog.load()?;
prog.attach("eth0", TcAttachType::Ingress)?;

Implementations

impl SchedClassifier

pub fn load(&mut self) -> Result<(), ProgramError>

Loads the program inside the kernel.

See also Program::load.

pub fn name(&self) -> String

Returns the name of the program.

pub fn attach(
    &mut self,
    interface: &str,
    attach_type: TcAttachType
) -> Result<LinkRef, ProgramError>

Attaches the program to the given interface.

Errors

TcError::NetlinkError is returned if attaching fails. A common cause of failure is not having added the clsact qdisc to the given interface, see qdisc_add_clsact

Trait Implementations

impl Debug for SchedClassifier

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

Formats the value using the given formatter.

impl ProgramFd for SchedClassifier

fn fd(&self) -> Option<RawFd>

impl<'a> TryFrom<&'a Program> for &'a SchedClassifier

type Error = ProgramError

The type returned in the event of a conversion error.

fn try_from(program: &'a Program) -> Result<&'a SchedClassifier, ProgramError>

Performs the conversion.

impl<'a> TryFrom<&'a mut Program> for &'a mut SchedClassifier

type Error = ProgramError

The type returned in the event of a conversion error.

fn try_from(
    program: &'a mut Program
) -> Result<&'a mut SchedClassifier, ProgramError>

Performs the conversion.