root/tools/bpf/bpftool/cgroup.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. parse_attach_type
  2. show_bpf_prog
  3. count_attached_bpf_progs
  4. cgroup_has_attached_progs
  5. show_attached_bpf_progs
  6. do_show
  7. do_show_tree_fn
  8. find_cgroup_root
  9. do_show_tree
  10. do_attach
  11. do_detach
  12. do_help
  13. do_cgroup

   1 // SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 // Copyright (C) 2017 Facebook
   3 // Author: Roman Gushchin <guro@fb.com>
   4 
   5 #define _XOPEN_SOURCE 500
   6 #include <errno.h>
   7 #include <fcntl.h>
   8 #include <ftw.h>
   9 #include <mntent.h>
  10 #include <stdio.h>
  11 #include <stdlib.h>
  12 #include <string.h>
  13 #include <sys/stat.h>
  14 #include <sys/types.h>
  15 #include <unistd.h>
  16 
  17 #include <bpf.h>
  18 
  19 #include "main.h"
  20 
  21 #define HELP_SPEC_ATTACH_FLAGS                                          \
  22         "ATTACH_FLAGS := { multi | override }"
  23 
  24 #define HELP_SPEC_ATTACH_TYPES                                                 \
  25         "       ATTACH_TYPE := { ingress | egress | sock_create |\n"           \
  26         "                        sock_ops | device | bind4 | bind6 |\n"        \
  27         "                        post_bind4 | post_bind6 | connect4 |\n"       \
  28         "                        connect6 | sendmsg4 | sendmsg6 |\n"           \
  29         "                        recvmsg4 | recvmsg6 | sysctl |\n"             \
  30         "                        getsockopt | setsockopt }"
  31 
  32 static unsigned int query_flags;
  33 
  34 static const char * const attach_type_strings[] = {
  35         [BPF_CGROUP_INET_INGRESS] = "ingress",
  36         [BPF_CGROUP_INET_EGRESS] = "egress",
  37         [BPF_CGROUP_INET_SOCK_CREATE] = "sock_create",
  38         [BPF_CGROUP_SOCK_OPS] = "sock_ops",
  39         [BPF_CGROUP_DEVICE] = "device",
  40         [BPF_CGROUP_INET4_BIND] = "bind4",
  41         [BPF_CGROUP_INET6_BIND] = "bind6",
  42         [BPF_CGROUP_INET4_CONNECT] = "connect4",
  43         [BPF_CGROUP_INET6_CONNECT] = "connect6",
  44         [BPF_CGROUP_INET4_POST_BIND] = "post_bind4",
  45         [BPF_CGROUP_INET6_POST_BIND] = "post_bind6",
  46         [BPF_CGROUP_UDP4_SENDMSG] = "sendmsg4",
  47         [BPF_CGROUP_UDP6_SENDMSG] = "sendmsg6",
  48         [BPF_CGROUP_SYSCTL] = "sysctl",
  49         [BPF_CGROUP_UDP4_RECVMSG] = "recvmsg4",
  50         [BPF_CGROUP_UDP6_RECVMSG] = "recvmsg6",
  51         [BPF_CGROUP_GETSOCKOPT] = "getsockopt",
  52         [BPF_CGROUP_SETSOCKOPT] = "setsockopt",
  53         [__MAX_BPF_ATTACH_TYPE] = NULL,
  54 };
  55 
  56 static enum bpf_attach_type parse_attach_type(const char *str)
  57 {
  58         enum bpf_attach_type type;
  59 
  60         for (type = 0; type < __MAX_BPF_ATTACH_TYPE; type++) {
  61                 if (attach_type_strings[type] &&
  62                     is_prefix(str, attach_type_strings[type]))
  63                         return type;
  64         }
  65 
  66         return __MAX_BPF_ATTACH_TYPE;
  67 }
  68 
  69 static int show_bpf_prog(int id, const char *attach_type_str,
  70                          const char *attach_flags_str,
  71                          int level)
  72 {
  73         struct bpf_prog_info info = {};
  74         __u32 info_len = sizeof(info);
  75         int prog_fd;
  76 
  77         prog_fd = bpf_prog_get_fd_by_id(id);
  78         if (prog_fd < 0)
  79                 return -1;
  80 
  81         if (bpf_obj_get_info_by_fd(prog_fd, &info, &info_len)) {
  82                 close(prog_fd);
  83                 return -1;
  84         }
  85 
  86         if (json_output) {
  87                 jsonw_start_object(json_wtr);
  88                 jsonw_uint_field(json_wtr, "id", info.id);
  89                 jsonw_string_field(json_wtr, "attach_type",
  90                                    attach_type_str);
  91                 jsonw_string_field(json_wtr, "attach_flags",
  92                                    attach_flags_str);
  93                 jsonw_string_field(json_wtr, "name", info.name);
  94                 jsonw_end_object(json_wtr);
  95         } else {
  96                 printf("%s%-8u %-15s %-15s %-15s\n", level ? "    " : "",
  97                        info.id,
  98                        attach_type_str,
  99                        attach_flags_str,
 100                        info.name);
 101         }
 102 
 103         close(prog_fd);
 104         return 0;
 105 }
 106 
 107 static int count_attached_bpf_progs(int cgroup_fd, enum bpf_attach_type type)
 108 {
 109         __u32 prog_cnt = 0;
 110         int ret;
 111 
 112         ret = bpf_prog_query(cgroup_fd, type, query_flags, NULL,
 113                              NULL, &prog_cnt);
 114         if (ret)
 115                 return -1;
 116 
 117         return prog_cnt;
 118 }
 119 
 120 static int cgroup_has_attached_progs(int cgroup_fd)
 121 {
 122         enum bpf_attach_type type;
 123         bool no_prog = true;
 124 
 125         for (type = 0; type < __MAX_BPF_ATTACH_TYPE; type++) {
 126                 int count = count_attached_bpf_progs(cgroup_fd, type);
 127 
 128                 if (count < 0 && errno != EINVAL)
 129                         return -1;
 130 
 131                 if (count > 0) {
 132                         no_prog = false;
 133                         break;
 134                 }
 135         }
 136 
 137         return no_prog ? 0 : 1;
 138 }
 139 static int show_attached_bpf_progs(int cgroup_fd, enum bpf_attach_type type,
 140                                    int level)
 141 {
 142         const char *attach_flags_str;
 143         __u32 prog_ids[1024] = {0};
 144         __u32 prog_cnt, iter;
 145         __u32 attach_flags;
 146         char buf[32];
 147         int ret;
 148 
 149         prog_cnt = ARRAY_SIZE(prog_ids);
 150         ret = bpf_prog_query(cgroup_fd, type, query_flags, &attach_flags,
 151                              prog_ids, &prog_cnt);
 152         if (ret)
 153                 return ret;
 154 
 155         if (prog_cnt == 0)
 156                 return 0;
 157 
 158         switch (attach_flags) {
 159         case BPF_F_ALLOW_MULTI:
 160                 attach_flags_str = "multi";
 161                 break;
 162         case BPF_F_ALLOW_OVERRIDE:
 163                 attach_flags_str = "override";
 164                 break;
 165         case 0:
 166                 attach_flags_str = "";
 167                 break;
 168         default:
 169                 snprintf(buf, sizeof(buf), "unknown(%x)", attach_flags);
 170                 attach_flags_str = buf;
 171         }
 172 
 173         for (iter = 0; iter < prog_cnt; iter++)
 174                 show_bpf_prog(prog_ids[iter], attach_type_strings[type],
 175                               attach_flags_str, level);
 176 
 177         return 0;
 178 }
 179 
 180 static int do_show(int argc, char **argv)
 181 {
 182         enum bpf_attach_type type;
 183         int has_attached_progs;
 184         const char *path;
 185         int cgroup_fd;
 186         int ret = -1;
 187 
 188         query_flags = 0;
 189 
 190         if (!REQ_ARGS(1))
 191                 return -1;
 192         path = GET_ARG();
 193 
 194         while (argc) {
 195                 if (is_prefix(*argv, "effective")) {
 196                         if (query_flags & BPF_F_QUERY_EFFECTIVE) {
 197                                 p_err("duplicated argument: %s", *argv);
 198                                 return -1;
 199                         }
 200                         query_flags |= BPF_F_QUERY_EFFECTIVE;
 201                         NEXT_ARG();
 202                 } else {
 203                         p_err("expected no more arguments, 'effective', got: '%s'?",
 204                               *argv);
 205                         return -1;
 206                 }
 207         }
 208 
 209         cgroup_fd = open(path, O_RDONLY);
 210         if (cgroup_fd < 0) {
 211                 p_err("can't open cgroup %s", path);
 212                 goto exit;
 213         }
 214 
 215         has_attached_progs = cgroup_has_attached_progs(cgroup_fd);
 216         if (has_attached_progs < 0) {
 217                 p_err("can't query bpf programs attached to %s: %s",
 218                       path, strerror(errno));
 219                 goto exit_cgroup;
 220         } else if (!has_attached_progs) {
 221                 ret = 0;
 222                 goto exit_cgroup;
 223         }
 224 
 225         if (json_output)
 226                 jsonw_start_array(json_wtr);
 227         else
 228                 printf("%-8s %-15s %-15s %-15s\n", "ID", "AttachType",
 229                        "AttachFlags", "Name");
 230 
 231         for (type = 0; type < __MAX_BPF_ATTACH_TYPE; type++) {
 232                 /*
 233                  * Not all attach types may be supported, so it's expected,
 234                  * that some requests will fail.
 235                  * If we were able to get the show for at least one
 236                  * attach type, let's return 0.
 237                  */
 238                 if (show_attached_bpf_progs(cgroup_fd, type, 0) == 0)
 239                         ret = 0;
 240         }
 241 
 242         if (json_output)
 243                 jsonw_end_array(json_wtr);
 244 
 245 exit_cgroup:
 246         close(cgroup_fd);
 247 exit:
 248         return ret;
 249 }
 250 
 251 /*
 252  * To distinguish nftw() errors and do_show_tree_fn() errors
 253  * and avoid duplicating error messages, let's return -2
 254  * from do_show_tree_fn() in case of error.
 255  */
 256 #define NFTW_ERR                -1
 257 #define SHOW_TREE_FN_ERR        -2
 258 static int do_show_tree_fn(const char *fpath, const struct stat *sb,
 259                            int typeflag, struct FTW *ftw)
 260 {
 261         enum bpf_attach_type type;
 262         int has_attached_progs;
 263         int cgroup_fd;
 264 
 265         if (typeflag != FTW_D)
 266                 return 0;
 267 
 268         cgroup_fd = open(fpath, O_RDONLY);
 269         if (cgroup_fd < 0) {
 270                 p_err("can't open cgroup %s: %s", fpath, strerror(errno));
 271                 return SHOW_TREE_FN_ERR;
 272         }
 273 
 274         has_attached_progs = cgroup_has_attached_progs(cgroup_fd);
 275         if (has_attached_progs < 0) {
 276                 p_err("can't query bpf programs attached to %s: %s",
 277                       fpath, strerror(errno));
 278                 close(cgroup_fd);
 279                 return SHOW_TREE_FN_ERR;
 280         } else if (!has_attached_progs) {
 281                 close(cgroup_fd);
 282                 return 0;
 283         }
 284 
 285         if (json_output) {
 286                 jsonw_start_object(json_wtr);
 287                 jsonw_string_field(json_wtr, "cgroup", fpath);
 288                 jsonw_name(json_wtr, "programs");
 289                 jsonw_start_array(json_wtr);
 290         } else {
 291                 printf("%s\n", fpath);
 292         }
 293 
 294         for (type = 0; type < __MAX_BPF_ATTACH_TYPE; type++)
 295                 show_attached_bpf_progs(cgroup_fd, type, ftw->level);
 296 
 297         if (errno == EINVAL)
 298                 /* Last attach type does not support query.
 299                  * Do not report an error for this, especially because batch
 300                  * mode would stop processing commands.
 301                  */
 302                 errno = 0;
 303 
 304         if (json_output) {
 305                 jsonw_end_array(json_wtr);
 306                 jsonw_end_object(json_wtr);
 307         }
 308 
 309         close(cgroup_fd);
 310 
 311         return 0;
 312 }
 313 
 314 static char *find_cgroup_root(void)
 315 {
 316         struct mntent *mnt;
 317         FILE *f;
 318 
 319         f = fopen("/proc/mounts", "r");
 320         if (f == NULL)
 321                 return NULL;
 322 
 323         while ((mnt = getmntent(f))) {
 324                 if (strcmp(mnt->mnt_type, "cgroup2") == 0) {
 325                         fclose(f);
 326                         return strdup(mnt->mnt_dir);
 327                 }
 328         }
 329 
 330         fclose(f);
 331         return NULL;
 332 }
 333 
 334 static int do_show_tree(int argc, char **argv)
 335 {
 336         char *cgroup_root, *cgroup_alloced = NULL;
 337         int ret;
 338 
 339         query_flags = 0;
 340 
 341         if (!argc) {
 342                 cgroup_alloced = find_cgroup_root();
 343                 if (!cgroup_alloced) {
 344                         p_err("cgroup v2 isn't mounted");
 345                         return -1;
 346                 }
 347                 cgroup_root = cgroup_alloced;
 348         } else {
 349                 cgroup_root = GET_ARG();
 350 
 351                 while (argc) {
 352                         if (is_prefix(*argv, "effective")) {
 353                                 if (query_flags & BPF_F_QUERY_EFFECTIVE) {
 354                                         p_err("duplicated argument: %s", *argv);
 355                                         return -1;
 356                                 }
 357                                 query_flags |= BPF_F_QUERY_EFFECTIVE;
 358                                 NEXT_ARG();
 359                         } else {
 360                                 p_err("expected no more arguments, 'effective', got: '%s'?",
 361                                       *argv);
 362                                 return -1;
 363                         }
 364                 }
 365         }
 366 
 367         if (json_output)
 368                 jsonw_start_array(json_wtr);
 369         else
 370                 printf("%s\n"
 371                        "%-8s %-15s %-15s %-15s\n",
 372                        "CgroupPath",
 373                        "ID", "AttachType", "AttachFlags", "Name");
 374 
 375         switch (nftw(cgroup_root, do_show_tree_fn, 1024, FTW_MOUNT)) {
 376         case NFTW_ERR:
 377                 p_err("can't iterate over %s: %s", cgroup_root,
 378                       strerror(errno));
 379                 ret = -1;
 380                 break;
 381         case SHOW_TREE_FN_ERR:
 382                 ret = -1;
 383                 break;
 384         default:
 385                 ret = 0;
 386         }
 387 
 388         if (json_output)
 389                 jsonw_end_array(json_wtr);
 390 
 391         free(cgroup_alloced);
 392 
 393         return ret;
 394 }
 395 
 396 static int do_attach(int argc, char **argv)
 397 {
 398         enum bpf_attach_type attach_type;
 399         int cgroup_fd, prog_fd;
 400         int attach_flags = 0;
 401         int ret = -1;
 402         int i;
 403 
 404         if (argc < 4) {
 405                 p_err("too few parameters for cgroup attach");
 406                 goto exit;
 407         }
 408 
 409         cgroup_fd = open(argv[0], O_RDONLY);
 410         if (cgroup_fd < 0) {
 411                 p_err("can't open cgroup %s", argv[0]);
 412                 goto exit;
 413         }
 414 
 415         attach_type = parse_attach_type(argv[1]);
 416         if (attach_type == __MAX_BPF_ATTACH_TYPE) {
 417                 p_err("invalid attach type");
 418                 goto exit_cgroup;
 419         }
 420 
 421         argc -= 2;
 422         argv = &argv[2];
 423         prog_fd = prog_parse_fd(&argc, &argv);
 424         if (prog_fd < 0)
 425                 goto exit_cgroup;
 426 
 427         for (i = 0; i < argc; i++) {
 428                 if (is_prefix(argv[i], "multi")) {
 429                         attach_flags |= BPF_F_ALLOW_MULTI;
 430                 } else if (is_prefix(argv[i], "override")) {
 431                         attach_flags |= BPF_F_ALLOW_OVERRIDE;
 432                 } else {
 433                         p_err("unknown option: %s", argv[i]);
 434                         goto exit_cgroup;
 435                 }
 436         }
 437 
 438         if (bpf_prog_attach(prog_fd, cgroup_fd, attach_type, attach_flags)) {
 439                 p_err("failed to attach program");
 440                 goto exit_prog;
 441         }
 442 
 443         if (json_output)
 444                 jsonw_null(json_wtr);
 445 
 446         ret = 0;
 447 
 448 exit_prog:
 449         close(prog_fd);
 450 exit_cgroup:
 451         close(cgroup_fd);
 452 exit:
 453         return ret;
 454 }
 455 
 456 static int do_detach(int argc, char **argv)
 457 {
 458         enum bpf_attach_type attach_type;
 459         int prog_fd, cgroup_fd;
 460         int ret = -1;
 461 
 462         if (argc < 4) {
 463                 p_err("too few parameters for cgroup detach");
 464                 goto exit;
 465         }
 466 
 467         cgroup_fd = open(argv[0], O_RDONLY);
 468         if (cgroup_fd < 0) {
 469                 p_err("can't open cgroup %s", argv[0]);
 470                 goto exit;
 471         }
 472 
 473         attach_type = parse_attach_type(argv[1]);
 474         if (attach_type == __MAX_BPF_ATTACH_TYPE) {
 475                 p_err("invalid attach type");
 476                 goto exit_cgroup;
 477         }
 478 
 479         argc -= 2;
 480         argv = &argv[2];
 481         prog_fd = prog_parse_fd(&argc, &argv);
 482         if (prog_fd < 0)
 483                 goto exit_cgroup;
 484 
 485         if (bpf_prog_detach2(prog_fd, cgroup_fd, attach_type)) {
 486                 p_err("failed to detach program");
 487                 goto exit_prog;
 488         }
 489 
 490         if (json_output)
 491                 jsonw_null(json_wtr);
 492 
 493         ret = 0;
 494 
 495 exit_prog:
 496         close(prog_fd);
 497 exit_cgroup:
 498         close(cgroup_fd);
 499 exit:
 500         return ret;
 501 }
 502 
 503 static int do_help(int argc, char **argv)
 504 {
 505         if (json_output) {
 506                 jsonw_null(json_wtr);
 507                 return 0;
 508         }
 509 
 510         fprintf(stderr,
 511                 "Usage: %s %s { show | list } CGROUP [**effective**]\n"
 512                 "       %s %s tree [CGROUP_ROOT] [**effective**]\n"
 513                 "       %s %s attach CGROUP ATTACH_TYPE PROG [ATTACH_FLAGS]\n"
 514                 "       %s %s detach CGROUP ATTACH_TYPE PROG\n"
 515                 "       %s %s help\n"
 516                 "\n"
 517                 HELP_SPEC_ATTACH_TYPES "\n"
 518                 "       " HELP_SPEC_ATTACH_FLAGS "\n"
 519                 "       " HELP_SPEC_PROGRAM "\n"
 520                 "       " HELP_SPEC_OPTIONS "\n"
 521                 "",
 522                 bin_name, argv[-2],
 523                 bin_name, argv[-2], bin_name, argv[-2],
 524                 bin_name, argv[-2], bin_name, argv[-2]);
 525 
 526         return 0;
 527 }
 528 
 529 static const struct cmd cmds[] = {
 530         { "show",       do_show },
 531         { "list",       do_show },
 532         { "tree",       do_show_tree },
 533         { "attach",     do_attach },
 534         { "detach",     do_detach },
 535         { "help",       do_help },
 536         { 0 }
 537 };
 538 
 539 int do_cgroup(int argc, char **argv)
 540 {
 541         return cmd_select(cmds, argc, argv, do_help);
 542 }

/* [<][>][^][v][top][bottom][index][help] */