Helper function `bpf_map_lookup_elem`

v3.18

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

Definition

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

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

Returns

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;

Usage

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.

Warning

modifying map values of non per-CPU maps is subject to race conditions, atomic instructions 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:

Example

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);
else
    bpf_printk("Failed to read value from the map\n");

Helper function bpf_map_lookup_elem