Struct aya::programs::SkMsg

pub struct SkMsg { /* fields omitted */ }

A program used to intercept messages sent with sendmsg()/sendfile().

SkMsg programs are attached to socket maps, and can be used inspect, filter and redirect messages sent on sockets. See also SockMap and SockHash.

Examples

use std::convert::{TryFrom, TryInto};
use std::io::Write;
use std::net::TcpStream;
use std::os::unix::io::AsRawFd;
use aya::maps::SockHash;
use aya::programs::SkMsg;

let mut intercept_egress = SockHash::try_from(bpf.map_mut("INTERCEPT_EGRESS")?)?;
let prog: &mut SkMsg = bpf.program_mut("intercept_egress_packet")?.try_into()?;
prog.load()?;
prog.attach(&intercept_egress)?;

let mut client = TcpStream::connect("127.0.0.1:1234")?;
intercept_egress.insert(1234, client.as_raw_fd(), 0)?;

// the write will be intercepted
client.write_all(b"foo")?;

Implementations

impl SkMsg

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, map: &dyn SocketMap) -> Result<LinkRef, ProgramError>

Attaches the program to the given sockmap.

Trait Implementations

impl Debug for SkMsg

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

Formats the value using the given formatter.

impl ProgramFd for SkMsg

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

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

type Error = ProgramError

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = ProgramError

The type returned in the event of a conversion error.

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

Performs the conversion.