use core::{cell::UnsafeCell, mem, num::NonZeroU32, ptr::NonNull}; use aya_bpf_bindings::bindings::bpf_devmap_val; use aya_bpf_cty::c_void; use crate::{ bindings::{bpf_map_def, bpf_map_type::BPF_MAP_TYPE_DEVMAP}, helpers::bpf_map_lookup_elem, maps::PinningType, }; use super::try_redirect_map; /// An array of network devices. /// /// XDP programs can use this map to redirect packets to other network deviecs. /// /// # Minimum kernel version /// /// The minimum kernel version required to use this feature is 4.14. /// /// # Examples /// /// ```rust,no_run /// use aya_bpf::{bindings::xdp_action, macros::{map, xdp}, maps::DevMap, programs::XdpContext}; /// /// #[map] /// static MAP: DevMap = DevMap::with_max_entries(1, 0); /// /// #[xdp] /// fn xdp(_ctx: XdpContext) -> i32 { /// MAP.redirect(0, xdp_action::XDP_PASS as u64) /// } /// ``` #[repr(transparent)] pub struct DevMap { def: UnsafeCell, } unsafe impl Sync for DevMap {} impl DevMap { /// Creates a [`DevMap`] with a set maximum number of elements. /// /// # Examples /// /// ```rust,no_run /// use aya_bpf::{macros::map, maps::DevMap}; /// /// #[map] /// static MAP: DevMap = DevMap::with_max_entries(8, 0); /// ``` pub const fn with_max_entries(max_entries: u32, flags: u32) -> DevMap { DevMap { def: UnsafeCell::new(bpf_map_def { type_: BPF_MAP_TYPE_DEVMAP, key_size: mem::size_of::() as u32, value_size: mem::size_of::() as u32, max_entries, map_flags: flags, id: 0, pinning: PinningType::None as u32, }), } } /// Creates a [`DevMap`] with a set maximum number of elements that can be pinned to the BPF /// File System (bpffs). /// /// # Examples /// /// ```rust,no_run /// use aya_bpf::{macros::map, maps::DevMap}; /// /// #[map] /// static MAP: DevMap = DevMap::pinned(8, 0); /// ``` pub const fn pinned(max_entries: u32, flags: u32) -> DevMap { DevMap { def: UnsafeCell::new(bpf_map_def { type_: BPF_MAP_TYPE_DEVMAP, key_size: mem::size_of::() as u32, value_size: mem::size_of::() as u32, max_entries, map_flags: flags, id: 0, pinning: PinningType::ByName as u32, }), } } /// Retrieves the interface index at `index` in the array. /// /// To actually redirect a packet, see [`DevMap::redirect`]. /// /// # Examples /// /// ```rust,no_run /// use aya_bpf::{macros::map, maps::DevMap}; /// /// #[map] /// static MAP: DevMap = DevMap::with_max_entries(1, 0); /// /// let target_if_index = MAP.get(0).target_if_index; /// /// // redirect to if_index /// ``` #[inline(always)] pub fn get(&self, index: u32) -> Option { unsafe { let value = bpf_map_lookup_elem( self.def.get() as *mut _, &index as *const _ as *const c_void, ); NonNull::new(value as *mut bpf_devmap_val).map(|p| DevMapValue { if_index: p.as_ref().ifindex, // SAFETY: map writes use fd, map reads use id. // https://elixir.bootlin.com/linux/v6.2/source/include/uapi/linux/bpf.h#L6136 prog_id: NonZeroU32::new(p.as_ref().bpf_prog.id), }) } } /// Redirects the current packet on the interface at `index`. /// /// The lower two bits of `flags` are used for the return code if the map lookup fails, which /// can be used as the XDP program's return code if a CPU cannot be found. /// /// # Examples /// /// ```rust,no_run /// use aya_bpf::{bindings::xdp_action, macros::{map, xdp}, maps::DevMap, programs::XdpContext}; /// /// #[map] /// static MAP: DevMap = DevMap::with_max_entries(8, 0); /// /// #[xdp] /// fn xdp(_ctx: XdpContext) -> u32 { /// MAP.redirect(7, 0).unwrap_or(xdp_action::XDP_DROP) /// } /// ``` #[inline(always)] pub fn redirect(&self, index: u32, flags: u64) -> Result { try_redirect_map(&self.def, index, flags) } } #[derive(Clone, Copy)] /// The value of a device map. pub struct DevMapValue { /// Target interface index to redirect to. pub if_index: u32, /// Chained XDP program ID. pub prog_id: Option, }