Struct aya::programs::SkLookup

pub struct SkLookup { /* private fields */ }

A program used to redirect incoming packets to a local socket.

SkLookup programs are attached to network namespaces to provide programmable socket lookup for TCP/UDP when a packet is to be delievered locally.

You may attach multiple programs to the same namespace and they are executed in the order they were attached.

Minimum kernel version

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

Examples

use std::fs::File;
use std::convert::TryInto;
use aya::programs::SkLookup;

let file = File::open("/var/run/netns/test")?;
let program: &mut SkLookup = bpf.program_mut("sk_lookup").unwrap().try_into()?;
program.load()?;
program.attach(file)?;

Implementations

impl SkLookup

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

Loads the program inside the kernel.

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

Attaches the program to the given network namespace.

The returned value can be used to detach, see SkLookup::detach.

pub fn take_link(
    &mut self,
    link_id: SkLookupLinkId
) -> Result<OwnedLink<SkLookupLink>, ProgramError>

Takes ownership of the link referenced by the provided link_id.

The link will be detached on Drop and the caller is now responsible for managing its lifetime.

pub fn detach(&mut self, link_id: SkLookupLinkId) -> Result<(), ProgramError>

Detaches the program.

See SkLookup::attach.

impl SkLookup

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

Unloads the program from the kernel.

Links will be detached before unloading the program. Note that owned links obtained using take_link() will not be detached.

Trait Implementations

impl Debug for SkLookup

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

Formats the value using the given formatter.

impl ProgramFd for SkLookup

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

Returns the RawFd of the program if it has been loaded, or None

impl ProgramFd for &mut SkLookup

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

Returns the RawFd of the program if it has been loaded, or None

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

type Error = ProgramError

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = ProgramError

The type returned in the event of a conversion error.

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

Performs the conversion.