root/tools/testing/selftests/bpf/prog_tests/cgroup_hierarchical_stats.c
// SPDX-License-Identifier: GPL-2.0-only
/*
 * This test makes sure BPF stats collection using rstat works correctly.
 * The test uses 3 BPF progs:
 * (a) counter: This BPF prog is invoked every time we attach a process to a
 *              cgroup and locklessly increments a percpu counter.
 *              The program then calls cgroup_rstat_updated() to inform rstat
 *              of an update on the (cpu, cgroup) pair.
 *
 * (b) flusher: This BPF prog is invoked when an rstat flush is ongoing, it
 *              aggregates all percpu counters to a total counter, and also
 *              propagates the changes to the ancestor cgroups.
 *
 * (c) dumper: This BPF prog is a cgroup_iter. It is used to output the total
 *             counter of a cgroup through reading a file in userspace.
 *
 * The test sets up a cgroup hierarchy, and the above programs. It spawns a few
 * processes in the leaf cgroups and makes sure all the counters are aggregated
 * correctly.
 *
 * Copyright 2022 Google LLC.
 */
#include <asm-generic/errno.h>
#include <errno.h>
#include <sys/types.h>
#include <sys/mount.h>
#include <sys/stat.h>
#include <unistd.h>

#include <test_progs.h>
#include <bpf/libbpf.h>
#include <bpf/bpf.h>

#include "cgroup_helpers.h"
#include "cgroup_hierarchical_stats.skel.h"

#define PAGE_SIZE 4096
#define MB(x) (x << 20)

#define PROCESSES_PER_CGROUP 3

#define BPFFS_ROOT "/sys/fs/bpf/"
#define BPFFS_ATTACH_COUNTERS BPFFS_ROOT "attach_counters/"

#define CG_ROOT_NAME "root"
#define CG_ROOT_ID 1

#define CGROUP_PATH(p, n) {.path = p"/"n, .name = n}

static struct {
        const char *path, *name;
        unsigned long long id;
        int fd;
} cgroups[] = {
        CGROUP_PATH("/", "test"),
        CGROUP_PATH("/test", "child1"),
        CGROUP_PATH("/test", "child2"),
        CGROUP_PATH("/test/child1", "child1_1"),
        CGROUP_PATH("/test/child1", "child1_2"),
        CGROUP_PATH("/test/child2", "child2_1"),
        CGROUP_PATH("/test/child2", "child2_2"),
};

#define N_CGROUPS ARRAY_SIZE(cgroups)
#define N_NON_LEAF_CGROUPS 3

static int root_cgroup_fd;
static bool mounted_bpffs;

/* reads file at 'path' to 'buf', returns 0 on success. */
static int read_from_file(const char *path, char *buf, size_t size)
{
        int fd, len;

        fd = open(path, O_RDONLY);
        if (fd < 0)
                return fd;

        len = read(fd, buf, size);
        close(fd);
        if (len < 0)
                return len;

        buf[len] = 0;
        return 0;
}

/* mounts bpffs and mkdir for reading stats, returns 0 on success. */
static int setup_bpffs(void)
{
        int err;

        /* Mount bpffs */
        err = mount("bpf", BPFFS_ROOT, "bpf", 0, NULL);
        mounted_bpffs = !err;
        if (ASSERT_FALSE(err && errno != EBUSY, "mount"))
                return err;

        /* Create a directory to contain stat files in bpffs */
        err = mkdir(BPFFS_ATTACH_COUNTERS, 0755);
        if (!ASSERT_OK(err, "mkdir"))
                return err;

        return 0;
}

static void cleanup_bpffs(void)
{
        /* Remove created directory in bpffs */
        ASSERT_OK(rmdir(BPFFS_ATTACH_COUNTERS), "rmdir "BPFFS_ATTACH_COUNTERS);

        /* Unmount bpffs, if it wasn't already mounted when we started */
        if (mounted_bpffs)
                return;

        ASSERT_OK(umount(BPFFS_ROOT), "unmount bpffs");
}

/* sets up cgroups, returns 0 on success. */
static int setup_cgroups(void)
{
        int i, fd, err;

        err = setup_cgroup_environment();
        if (!ASSERT_OK(err, "setup_cgroup_environment"))
                return err;

        root_cgroup_fd = get_root_cgroup();
        if (!ASSERT_GE(root_cgroup_fd, 0, "get_root_cgroup"))
                return root_cgroup_fd;

        for (i = 0; i < N_CGROUPS; i++) {
                fd = create_and_get_cgroup(cgroups[i].path);
                if (!ASSERT_GE(fd, 0, "create_and_get_cgroup"))
                        return fd;

                cgroups[i].fd = fd;
                cgroups[i].id = get_cgroup_id(cgroups[i].path);
        }
        return 0;
}

static void cleanup_cgroups(void)
{
        close(root_cgroup_fd);
        for (int i = 0; i < N_CGROUPS; i++)
                close(cgroups[i].fd);
        cleanup_cgroup_environment();
}

/* Sets up cgroup hiearchary, returns 0 on success. */
static int setup_hierarchy(void)
{
        return setup_bpffs() || setup_cgroups();
}

static void destroy_hierarchy(void)
{
        cleanup_cgroups();
        cleanup_bpffs();
}

static int attach_processes(void)
{
        int i, j, status;

        /* In every leaf cgroup, attach 3 processes */
        for (i = N_NON_LEAF_CGROUPS; i < N_CGROUPS; i++) {
                for (j = 0; j < PROCESSES_PER_CGROUP; j++) {
                        pid_t pid;

                        /* Create child and attach to cgroup */
                        pid = fork();
                        if (pid == 0) {
                                if (join_parent_cgroup(cgroups[i].path))
                                        exit(EACCES);
                                exit(0);
                        }

                        /* Cleanup child */
                        waitpid(pid, &status, 0);
                        if (!ASSERT_TRUE(WIFEXITED(status), "child process exited"))
                                return 1;
                        if (!ASSERT_EQ(WEXITSTATUS(status), 0,
                                       "child process exit code"))
                                return 1;
                }
        }
        return 0;
}

static unsigned long long
get_attach_counter(unsigned long long cgroup_id, const char *file_name)
{
        unsigned long long attach_counter = 0, id = 0;
        static char buf[128], path[128];

        /* For every cgroup, read the file generated by cgroup_iter */
        snprintf(path, 128, "%s%s", BPFFS_ATTACH_COUNTERS, file_name);
        if (!ASSERT_OK(read_from_file(path, buf, 128), "read cgroup_iter"))
                return 0;

        /* Check the output file formatting */
        ASSERT_EQ(sscanf(buf, "cg_id: %llu, attach_counter: %llu\n",
                         &id, &attach_counter), 2, "output format");

        /* Check that the cgroup_id is displayed correctly */
        ASSERT_EQ(id, cgroup_id, "cgroup_id");
        /* Check that the counter is non-zero */
        ASSERT_GT(attach_counter, 0, "attach counter non-zero");
        return attach_counter;
}

static void check_attach_counters(void)
{
        unsigned long long attach_counters[N_CGROUPS], root_attach_counter;
        int i;

        for (i = 0; i < N_CGROUPS; i++)
                attach_counters[i] = get_attach_counter(cgroups[i].id,
                                                        cgroups[i].name);

        /* Read stats for root too */
        root_attach_counter = get_attach_counter(CG_ROOT_ID, CG_ROOT_NAME);

        /* Check that all leafs cgroups have an attach counter of 3 */
        for (i = N_NON_LEAF_CGROUPS; i < N_CGROUPS; i++)
                ASSERT_EQ(attach_counters[i], PROCESSES_PER_CGROUP,
                          "leaf cgroup attach counter");

        /* Check that child1 == child1_1 + child1_2 */
        ASSERT_EQ(attach_counters[1], attach_counters[3] + attach_counters[4],
                  "child1_counter");
        /* Check that child2 == child2_1 + child2_2 */
        ASSERT_EQ(attach_counters[2], attach_counters[5] + attach_counters[6],
                  "child2_counter");
        /* Check that test == child1 + child2 */
        ASSERT_EQ(attach_counters[0], attach_counters[1] + attach_counters[2],
                  "test_counter");
        /* Check that root >= test */
        ASSERT_GE(root_attach_counter, attach_counters[1], "root_counter");
}

/* Creates iter link and pins in bpffs, returns 0 on success, -errno on failure.
 */
static int setup_cgroup_iter(struct cgroup_hierarchical_stats *obj,
                             int cgroup_fd, const char *file_name)
{
        DECLARE_LIBBPF_OPTS(bpf_iter_attach_opts, opts);
        union bpf_iter_link_info linfo = {};
        struct bpf_link *link;
        static char path[128];
        int err;

        /*
         * Create an iter link, parameterized by cgroup_fd. We only want to
         * traverse one cgroup, so set the traversal order to "self".
         */
        linfo.cgroup.cgroup_fd = cgroup_fd;
        linfo.cgroup.order = BPF_CGROUP_ITER_SELF_ONLY;
        opts.link_info = &linfo;
        opts.link_info_len = sizeof(linfo);
        link = bpf_program__attach_iter(obj->progs.dumper, &opts);
        if (!ASSERT_OK_PTR(link, "attach_iter"))
                return -EFAULT;

        /* Pin the link to a bpffs file */
        snprintf(path, 128, "%s%s", BPFFS_ATTACH_COUNTERS, file_name);
        err = bpf_link__pin(link, path);
        ASSERT_OK(err, "pin cgroup_iter");

        /* Remove the link, leaving only the ref held by the pinned file */
        bpf_link__destroy(link);
        return err;
}

/* Sets up programs for collecting stats, returns 0 on success. */
static int setup_progs(struct cgroup_hierarchical_stats **skel)
{
        int i, err;

        *skel = cgroup_hierarchical_stats__open_and_load();
        if (!ASSERT_OK_PTR(*skel, "open_and_load"))
                return 1;

        /* Attach cgroup_iter program that will dump the stats to cgroups */
        for (i = 0; i < N_CGROUPS; i++) {
                err = setup_cgroup_iter(*skel, cgroups[i].fd, cgroups[i].name);
                if (!ASSERT_OK(err, "setup_cgroup_iter"))
                        return err;
        }

        /* Also dump stats for root */
        err = setup_cgroup_iter(*skel, root_cgroup_fd, CG_ROOT_NAME);
        if (!ASSERT_OK(err, "setup_cgroup_iter"))
                return err;

        bpf_program__set_autoattach((*skel)->progs.dumper, false);
        err = cgroup_hierarchical_stats__attach(*skel);
        if (!ASSERT_OK(err, "attach"))
                return err;

        return 0;
}

static void destroy_progs(struct cgroup_hierarchical_stats *skel)
{
        static char path[128];
        int i;

        for (i = 0; i < N_CGROUPS; i++) {
                /* Delete files in bpffs that cgroup_iters are pinned in */
                snprintf(path, 128, "%s%s", BPFFS_ATTACH_COUNTERS,
                         cgroups[i].name);
                ASSERT_OK(remove(path), "remove cgroup_iter pin");
        }

        /* Delete root file in bpffs */
        snprintf(path, 128, "%s%s", BPFFS_ATTACH_COUNTERS, CG_ROOT_NAME);
        ASSERT_OK(remove(path), "remove cgroup_iter root pin");
        cgroup_hierarchical_stats__destroy(skel);
}

void test_cgroup_hierarchical_stats(void)
{
        struct cgroup_hierarchical_stats *skel = NULL;

        if (setup_hierarchy())
                goto hierarchy_cleanup;
        if (setup_progs(&skel))
                goto cleanup;
        if (attach_processes())
                goto cleanup;
        check_attach_counters();
cleanup:
        destroy_progs(skel);
hierarchy_cleanup:
        destroy_hierarchy();
}