Struct aya::programs::SocketFilter

pub struct SocketFilter { /* fields omitted */ }

A program used to inspect and filter incoming packets on a socket.

SocketFilter programs are attached on sockets and can be used to inspect and filter incoming packets.

Minimum kernel version

The minimum kernel version required to use this feature is 4.0.

Examples

use std::convert::TryInto;
use std::net::TcpStream;
use std::os::unix::io::AsRawFd;
use aya::programs::SocketFilter;

let mut client = TcpStream::connect("127.0.0.1:1234")?;
let prog: &mut SocketFilter = bpf.program_mut("filter_packets")?.try_into()?;
prog.load()?;
prog.attach(client.as_raw_fd())?;

Implementations

impl SocketFilter

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

Loads the program inside the kernel.

See also Program::load.

pub fn attach<T: AsRawFd>(&mut self, socket: T) -> Result<LinkRef, ProgramError>

Attaches the filter on the given socket.

Trait Implementations

impl Debug for SocketFilter

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

Formats the value using the given formatter.

impl ProgramFd for SocketFilter

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

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

type Error = ProgramError

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = ProgramError

The type returned in the event of a conversion error.

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

Performs the conversion.