Struct HashMap 

pub struct HashMap<T, K, V> { /* private fields */ }

A hash map that can be shared between eBPF programs and user space.

Minimum kernel version

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

Examples

use aya::maps::HashMap;

let mut redirect_ports = HashMap::try_from(bpf.map_mut("REDIRECT_PORTS").unwrap())?;

// redirect port 80 to 8080
redirect_ports.insert(80, 8080, 0);
// redirect port 443 to 8443
redirect_ports.insert(443, 8443, 0);

Implementations

impl<T: Borrow<MapData>, K: Pod, V: Pod> HashMap<T, K, V>

pub fn get(&self, key: &K, flags: u64) -> Result<V, MapError>

Returns a copy of the value associated with the key.

pub fn iter(&self) -> MapIter<'_, K, V, Self>

An iterator visiting all key-value pairs in arbitrary order. The iterator item type is Result<(K, V), MapError>.

pub fn keys(&self) -> MapKeys<'_, K>

An iterator visiting all keys in arbitrary order. The iterator element type is Result<K, MapError>.

impl<T: BorrowMut<MapData>, K: Pod, V: Pod> HashMap<T, K, V>

pub fn insert( &mut self, key: impl Borrow<K>, value: impl Borrow<V>, flags: u64, ) -> Result<(), MapError>

Inserts a key-value pair into the map.

pub fn remove(&mut self, key: &K) -> Result<(), MapError>

Removes a key from the map.

impl<T: Borrow<MapData>, K: Pod, V: Pod> HashMap<T, K, V>

pub fn pin<P: AsRef<Path>>(self, path: P) -> Result<(), PinError>

Pins the map to a BPF filesystem.

When a map is pinned it will remain loaded until the corresponding file is deleted. All parent directories in the given path must already exist.

impl<K: Pod, V: Pod> HashMap<MapData, K, V>

pub fn create(max_entries: u32, flags: u32) -> Result<Self, MapError>

Creates a standalone map with the given max_entries capacity and flags.

Trait Implementations

impl<T: Debug, K: Debug, V: Debug> Debug for HashMap<T, K, V>

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

Formats the value using the given formatter.

impl<'a, T: Borrow<MapData>, K: Pod, V: Pod> IntoIterator for &'a HashMap<T, K, V>

type Item = Result<(K, V), MapError>

The type of the elements being iterated over.

type IntoIter = MapIter<'a, K, V, HashMap<T, K, V>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: Borrow<MapData>, K: Pod, V: Pod> IterableMap<K, V> for HashMap<T, K, V>

fn map(&self) -> &MapData

Get a generic map handle

fn get(&self, key: &K) -> Result<V, MapError>

Get the value for the provided key

impl<'a, K: Pod, V: Pod> TryFrom<&'a Map> for HashMap<&'a MapData, K, V>

type Error = MapError

The type returned in the event of a conversion error.

fn try_from(map: &'a Map) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, K: Pod, V: Pod> TryFrom<&'a mut Map> for HashMap<&'a mut MapData, K, V>

type Error = MapError

The type returned in the event of a conversion error.

fn try_from(map: &'a mut Map) -> Result<Self, Self::Error>

Performs the conversion.

impl<K: Pod, V: Pod> TryFrom<Map> for HashMap<MapData, K, V>

type Error = MapError

The type returned in the event of a conversion error.

fn try_from(map: Map) -> Result<Self, Self::Error>

Performs the conversion.