Struct bpf_api::collections::HashMap

pub struct HashMap<K: Copy + Default + Sized, V: Copy + Default + Sized> { /* private fields */ }

Implementations

impl<K: Copy + Default + Sized, V: Copy + Default + Sized> HashMap<K, V>

pub fn create(entries: u32) -> Result<Self, Error>

Creates a new BPF hashmap with entries elements.

Arguments

• entries - The number of elements in the array.

Example

use bpf_api::collections::HashMap;

let hashmap = HashMap::<u32, u32>::create(10).expect("Failed to create hashmap");

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

Retrieves the value for a given key.

Arguments

• key - The key associated with the value to be retrieved.

Example

use bpf_api::collections::HashMap;

let hashmap = HashMap::<u32, u32>::create(10).expect("Failed to create hashmap");
assert!(matches!(hashmap.get(1000), Err(_)));

pub fn set(&self, key: K, val: V) -> Result<(), Error>

Sets the value for a given key.

Arguments

• key - The key associated with the value to be set.
• value - The new value.

Example

use bpf_api::collections::HashMap;

let hashmap = HashMap::<u32, u32>::create(10).expect("Failed to create hashmap");
assert!(matches!(hashmap.get(1000), Err(_)));
assert!(matches!(hashmap.set(1000, 0xdeadbeef), Ok(_)));
assert!(matches!(hashmap.get(1000), Ok(0xdeadbeef)));

pub fn del(&self, key: K) -> Result<(), Error>

Deletes an entry from the hash map given a key.

Arguments

• key - The key of the entry to be deleted.

Example

use bpf_api::collections::HashMap;

let hashmap = HashMap::<u32, u32>::create(10).expect("Failed to create hashmap");
assert!(matches!(hashmap.get(1000), Err(_)));
assert!(matches!(hashmap.set(1000, 0xdeadbeef), Ok(_)));
assert!(matches!(hashmap.get(1000), Ok(0xdeadbeef)));
assert!(matches!(hashmap.del(1000), Ok(_)));
assert!(matches!(hashmap.del(1000), Err(_)));

pub fn get_identifier(&self) -> u32

Retrieve the BPF identifier for this map. This is the underlying file descriptor that’s used in eBPF programs.

Example

use bpf_api::collections::HashMap;

let hashmap = HashMap::<u32, u32>::create(10).expect("Failed to create array");
hashmap.get_identifier();