Struct IcmpTracerouteMsgPart

Source

#[repr(C)]pub struct IcmpTracerouteMsgPart {
    pub hops_out: [u8; 2],
    pub hops_in: [u8; 2],
    pub bandwidth_out: [u8; 4],
    pub mtu_out: [u8; 4],
}

Expand description

Represents the variable length portion of a Traceroute message (RFC 1393) that follows the ICMP header.

Contains hop counts, bandwidth, and MTU information about the traced route. All fields are stored in network byte order.

§Example

use core::mem;
use aya_ebpf::programs::TcContext;
use network_types::eth::EthHdr;
use network_types::icmp::{Icmpv4Hdr, Icmpv4HdrData, IcmpTracerouteMsgPart};
use network_types::ip::Ipv4Hdr;

fn handle_icmp_traceroute(ctx: &TcContext) -> Result<u32, ()> {
    // Parse the ICMP header from start of payload
    let icmp_start = ctx.data() + EthHdr::LEN + Ipv4Hdr::LEN;
    let icmp_hdr: *mut Icmpv4Hdr = icmp_start as *mut Icmpv4Hdr;

    // Check if it's a Traceroute Request/Reply message by matching on the safe enum.
    if let Ok(Icmpv4HdrData::Traceroute(traceroute_hdr)) = unsafe { (*icmp_hdr).data() } {
        // Access the traceroute-specific fields without repeating the type checks.
        let traceroute_msg: *const IcmpTracerouteMsgPart = unsafe {
            (icmp_start as *const u8)
                .add(Icmpv4Hdr::LEN) as *const IcmpTracerouteMsgPart
        };

        // Consume the traceroute fields in network byte order
        let _id = traceroute_hdr.id();
        unsafe {
            let _hops_out = (*traceroute_msg).hops_out();
            let _bandwidth = (*traceroute_msg).bandwidth_out();
            let _mtu = (*traceroute_msg).mtu_out();
            // Do something meaningful with these values here.
        }
    }
    Ok(0)
}

Fields§

§hops_out: [u8; 2]§hops_in: [u8; 2]§bandwidth_out: [u8; 4]§mtu_out: [u8; 4]

Implementations§

Source §

impl IcmpTracerouteMsgPart

Source

pub const LEN: usize

Source

pub fn hops_out(&self) -> u16

Returns the outbound hop count in host byte order. This indicates the maximum number of hops that can be traversed to the target.

Source

pub fn set_hops_out(&mut self, hops: u16)

Sets the outbound hop count field. The value will be stored in network byte order. This should be set to the maximum number of hops that can be traversed to the target.

Source

pub fn hops_in(&self) -> u16

Returns the inbound hop count in host byte order. This indicates the maximum number of hops that can be traversed in the return path.

Source

pub fn set_hops_in(&mut self, hops: u16)

Sets the inbound hop count field. The value will be stored in network byte order. This should be set to the maximum number of hops that can be traversed in the return path.

Source

pub fn bandwidth_out(&self) -> u32

Returns the outbound bandwidth estimate in host byte order. This represents the minimum bandwidth along the forward path in bytes per second.

Source

pub fn set_bandwidth_out(&mut self, bandwidth: u32)

Sets the outbound bandwidth field. The value will be stored in network byte order. This should be set to the minimum bandwidth along the forward path in bytes per second.

Source