tools/testing/selftests/bpf/prog_tests/rhash.c
Source file repositories/reference/linux-study-clean/tools/testing/selftests/bpf/prog_tests/rhash.c
File Facts
- System
- Linux kernel
- Corpus path
tools/testing/selftests/bpf/prog_tests/rhash.c- Extension
.c- Size
- 4548 bytes
- Lines
- 184
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: implementation source
- Status
- source implementation candidate
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
test_progs.hstring.hstdio.hrhash.skel.hbpf_iter_bpf_rhash_map.skel.hlinux/bpf.hlinux/perf_event.hsys/syscall.h
Detected Declarations
function rhash_runfunction rhash_map_createfunction rhash_map_extra_presizefunction rhash_map_extra_too_bigfunction rhash_iter_testfunction test_rhash
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0
/* Copyright (c) 2026 Meta Platforms, Inc. and affiliates. */
#include <test_progs.h>
#include <string.h>
#include <stdio.h>
#include "rhash.skel.h"
#include "bpf_iter_bpf_rhash_map.skel.h"
#include <linux/bpf.h>
#include <linux/perf_event.h>
#include <sys/syscall.h>
static void rhash_run(const char *prog_name)
{
struct rhash *skel;
struct bpf_program *prog;
LIBBPF_OPTS(bpf_test_run_opts, opts);
int err;
skel = rhash__open();
if (!ASSERT_OK_PTR(skel, "rhash__open"))
return;
prog = bpf_object__find_program_by_name(skel->obj, prog_name);
if (!ASSERT_OK_PTR(prog, "bpf_object__find_program_by_name"))
goto cleanup;
bpf_program__set_autoload(prog, true);
err = rhash__load(skel);
if (!ASSERT_OK(err, "skel_load"))
goto cleanup;
err = bpf_prog_test_run_opts(bpf_program__fd(prog), &opts);
if (!ASSERT_OK(err, "prog run"))
goto cleanup;
if (!ASSERT_OK(opts.retval, "prog retval"))
goto cleanup;
if (!ASSERT_OK(skel->bss->err, "bss->err"))
goto cleanup;
cleanup:
rhash__destroy(skel);
}
static int rhash_map_create(__u32 max_entries, __u64 map_extra)
{
LIBBPF_OPTS(bpf_map_create_opts, opts,
.map_flags = BPF_F_NO_PREALLOC,
.map_extra = map_extra);
return bpf_map_create(BPF_MAP_TYPE_RHASH, "rhash_extra",
sizeof(__u32), sizeof(__u64), max_entries, &opts);
}
static void rhash_map_extra_presize(void)
{
const __u32 max_entries = 1024;
const __u32 nelem_hint = 256;
struct bpf_map_info info = {};
__u32 info_len = sizeof(info);
__u64 val = 0;
__u32 key;
int fd, i;
fd = rhash_map_create(max_entries, nelem_hint);
if (!ASSERT_GE(fd, 0, "rhash_map_create presize"))
return;
if (!ASSERT_OK(bpf_map_get_info_by_fd(fd, &info, &info_len), "info"))
goto close;
ASSERT_EQ(info.map_extra, nelem_hint, "info.map_extra");
for (i = 0; i < (int)nelem_hint; i++) {
key = i;
if (!ASSERT_OK(bpf_map_update_elem(fd, &key, &val, BPF_NOEXIST),
"update"))
goto close;
}
close:
close(fd);
}
static void rhash_map_extra_too_big(void)
{
int fd;
fd = rhash_map_create(1U << 20, 0x10000);
if (!ASSERT_LT(fd, 0, "rhash_map_create hint > U16_MAX"))
close(fd);
Annotation
- Immediate include surface: `test_progs.h`, `string.h`, `stdio.h`, `rhash.skel.h`, `bpf_iter_bpf_rhash_map.skel.h`, `linux/bpf.h`, `linux/perf_event.h`, `sys/syscall.h`.
- Detected declarations: `function rhash_run`, `function rhash_map_create`, `function rhash_map_extra_presize`, `function rhash_map_extra_too_big`, `function rhash_iter_test`, `function test_rhash`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.