Skip to content

Helper function bpf_map_lookup_elem


The lookup map element helper call is used to read values from maps.


Copyright (c) 2015 The Libbpf Authors. All rights reserved.

Perform a lookup in map for an entry associated to key.


Map value associated to key, or NULL if no entry was found.

static void *(* const bpf_map_lookup_elem)(void *map, const void *key) = (void *) 1;


The map argument must be a pointer to a map definition and key must be a pointer to the key you wish to lookup.

The return value will be a pointer to the map value or NULL. The value is a direct reference to the kernel memory where this map value is stored, not a copy. Therefor any modifications made to the value are automatically persisted without the need to call any additional helpers.


modifying map values of non per-CPU maps is subject to race conditions, atomics or spinlocks must be utilized to prevent race conditions if they are detrimental to your use case.

Program types

This helper call can be used in the following program types:

Map types

This helper call can be used with the following map types:


int key, value;
key = 1;
value = bpf_map_lookup_elem(&my_map, &key);
if (value)
    bpf_printk("Value read from the map: '%d'\n", value);
    bpf_printk("Failed to read value from the map\n");