tools/bpf/bpftool/map.c

   1 // SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 /* Copyright (C) 2017-2018 Netronome Systems, Inc. */
   3
   4 #include <assert.h>
   5 #include <errno.h>
   6 #include <fcntl.h>
   7 #include <linux/err.h>
   8 #include <linux/kernel.h>
   9 #include <net/if.h>
  10 #include <stdbool.h>
  11 #include <stdio.h>
  12 #include <stdlib.h>
  13 #include <string.h>
  14 #include <unistd.h>
  15 #include <sys/types.h>
  16 #include <sys/stat.h>
  17
  18 #include <bpf/bpf.h>
  19 #include <bpf/btf.h>
  20
  21 #include "json_writer.h"
  22 #include "main.h"
  23
  24 const char * const map_type_name[] = {
  25         [BPF_MAP_TYPE_UNSPEC]                   = "unspec",
  26         [BPF_MAP_TYPE_HASH]                     = "hash",
  27         [BPF_MAP_TYPE_ARRAY]                    = "array",
  28         [BPF_MAP_TYPE_PROG_ARRAY]               = "prog_array",
  29         [BPF_MAP_TYPE_PERF_EVENT_ARRAY]         = "perf_event_array",
  30         [BPF_MAP_TYPE_PERCPU_HASH]              = "percpu_hash",
  31         [BPF_MAP_TYPE_PERCPU_ARRAY]             = "percpu_array",
  32         [BPF_MAP_TYPE_STACK_TRACE]              = "stack_trace",
  33         [BPF_MAP_TYPE_CGROUP_ARRAY]             = "cgroup_array",
  34         [BPF_MAP_TYPE_LRU_HASH]                 = "lru_hash",
  35         [BPF_MAP_TYPE_LRU_PERCPU_HASH]          = "lru_percpu_hash",
  36         [BPF_MAP_TYPE_LPM_TRIE]                 = "lpm_trie",
  37         [BPF_MAP_TYPE_ARRAY_OF_MAPS]            = "array_of_maps",
  38         [BPF_MAP_TYPE_HASH_OF_MAPS]             = "hash_of_maps",
  39         [BPF_MAP_TYPE_DEVMAP]                   = "devmap",
  40         [BPF_MAP_TYPE_DEVMAP_HASH]              = "devmap_hash",
  41         [BPF_MAP_TYPE_SOCKMAP]                  = "sockmap",
  42         [BPF_MAP_TYPE_CPUMAP]                   = "cpumap",
  43         [BPF_MAP_TYPE_XSKMAP]                   = "xskmap",
  44         [BPF_MAP_TYPE_SOCKHASH]                 = "sockhash",
  45         [BPF_MAP_TYPE_CGROUP_STORAGE]           = "cgroup_storage",
  46         [BPF_MAP_TYPE_REUSEPORT_SOCKARRAY]      = "reuseport_sockarray",
  47         [BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE]    = "percpu_cgroup_storage",
  48         [BPF_MAP_TYPE_QUEUE]                    = "queue",
  49         [BPF_MAP_TYPE_STACK]                    = "stack",
  50         [BPF_MAP_TYPE_SK_STORAGE]               = "sk_storage",
  51         [BPF_MAP_TYPE_STRUCT_OPS]               = "struct_ops",
  52         [BPF_MAP_TYPE_RINGBUF]                  = "ringbuf",
  53         [BPF_MAP_TYPE_INODE_STORAGE]            = "inode_storage",
  54         [BPF_MAP_TYPE_TASK_STORAGE]             = "task_storage",
  55 };
  56
  57 const size_t map_type_name_size = ARRAY_SIZE(map_type_name);
  58
  59 static bool map_is_per_cpu(__u32 type)
  60 {
  61         return type == BPF_MAP_TYPE_PERCPU_HASH ||
  62                type == BPF_MAP_TYPE_PERCPU_ARRAY ||
  63                type == BPF_MAP_TYPE_LRU_PERCPU_HASH ||
  64                type == BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE;
  65 }
  66
  67 static bool map_is_map_of_maps(__u32 type)
  68 {
  69         return type == BPF_MAP_TYPE_ARRAY_OF_MAPS ||
  70                type == BPF_MAP_TYPE_HASH_OF_MAPS;
  71 }
  72
  73 static bool map_is_map_of_progs(__u32 type)
  74 {
  75         return type == BPF_MAP_TYPE_PROG_ARRAY;
  76 }
  77
  78 static int map_type_from_str(const char *type)
  79 {
  80         unsigned int i;
  81
  82         for (i = 0; i < ARRAY_SIZE(map_type_name); i++)
  83                 /* Don't allow prefixing in case of possible future shadowing */
  84                 if (map_type_name[i] && !strcmp(map_type_name[i], type))
  85                         return i;
  86         return -1;
  87 }
  88
  89 static void *alloc_value(struct bpf_map_info *info)
  90 {
  91         if (map_is_per_cpu(info->type))
  92                 return malloc(round_up(info->value_size, 8) *
  93                               get_possible_cpus());
  94         else
  95                 return malloc(info->value_size);
  96 }
  97
  98 static int do_dump_btf(const struct btf_dumper *d,
  99                        struct bpf_map_info *map_info, void *key,
 100                        void *value)
 101 {
 102         __u32 value_id;
 103         int ret = 0;
 104
 105         /* start of key-value pair */
 106         jsonw_start_object(d->jw);
 107
 108         if (map_info->btf_key_type_id) {
 109                 jsonw_name(d->jw, "key");
 110
 111                 ret = btf_dumper_type(d, map_info->btf_key_type_id, key);
 112                 if (ret)
 113                         goto err_end_obj;
 114         }
 115
 116         value_id = map_info->btf_vmlinux_value_type_id ?
 117                 : map_info->btf_value_type_id;
 118
 119         if (!map_is_per_cpu(map_info->type)) {
 120                 jsonw_name(d->jw, "value");
 121                 ret = btf_dumper_type(d, value_id, value);
 122         } else {
 123                 unsigned int i, n, step;
 124
 125                 jsonw_name(d->jw, "values");
 126                 jsonw_start_array(d->jw);
 127                 n = get_possible_cpus();
 128                 step = round_up(map_info->value_size, 8);
 129                 for (i = 0; i < n; i++) {
 130                         jsonw_start_object(d->jw);
 131                         jsonw_int_field(d->jw, "cpu", i);
 132                         jsonw_name(d->jw, "value");
 133                         ret = btf_dumper_type(d, value_id, value + i * step);
 134                         jsonw_end_object(d->jw);
 135                         if (ret)
 136                                 break;
 137                 }
 138                 jsonw_end_array(d->jw);
 139         }
 140
 141 err_end_obj:
 142         /* end of key-value pair */
 143         jsonw_end_object(d->jw);
 144
 145         return ret;
 146 }
 147
 148 static json_writer_t *get_btf_writer(void)
 149 {
 150         json_writer_t *jw = jsonw_new(stdout);
 151
 152         if (!jw)
 153                 return NULL;
 154         jsonw_pretty(jw, true);
 155
 156         return jw;
 157 }
 158
 159 static void print_entry_json(struct bpf_map_info *info, unsigned char *key,
 160                              unsigned char *value, struct btf *btf)
 161 {
 162         jsonw_start_object(json_wtr);
 163
 164         if (!map_is_per_cpu(info->type)) {
 165                 jsonw_name(json_wtr, "key");
 166                 print_hex_data_json(key, info->key_size);
 167                 jsonw_name(json_wtr, "value");
 168                 print_hex_data_json(value, info->value_size);
 169                 if (btf) {
 170                         struct btf_dumper d = {
 171                                 .btf = btf,
 172                                 .jw = json_wtr,
 173                                 .is_plain_text = false,
 174                         };
 175
 176                         jsonw_name(json_wtr, "formatted");
 177                         do_dump_btf(&d, info, key, value);
 178                 }
 179         } else {
 180                 unsigned int i, n, step;
 181
 182                 n = get_possible_cpus();
 183                 step = round_up(info->value_size, 8);
 184
 185                 jsonw_name(json_wtr, "key");
 186                 print_hex_data_json(key, info->key_size);
 187
 188                 jsonw_name(json_wtr, "values");
 189                 jsonw_start_array(json_wtr);
 190                 for (i = 0; i < n; i++) {
 191                         jsonw_start_object(json_wtr);
 192
 193                         jsonw_int_field(json_wtr, "cpu", i);
 194
 195                         jsonw_name(json_wtr, "value");
 196                         print_hex_data_json(value + i * step,
 197                                             info->value_size);
 198
 199                         jsonw_end_object(json_wtr);
 200                 }
 201                 jsonw_end_array(json_wtr);
 202                 if (btf) {
 203                         struct btf_dumper d = {
 204                                 .btf = btf,
 205                                 .jw = json_wtr,
 206                                 .is_plain_text = false,
 207                         };
 208
 209                         jsonw_name(json_wtr, "formatted");
 210                         do_dump_btf(&d, info, key, value);
 211                 }
 212         }
 213
 214         jsonw_end_object(json_wtr);
 215 }
 216
 217 static void
 218 print_entry_error_msg(struct bpf_map_info *info, unsigned char *key,
 219                       const char *error_msg)
 220 {
 221         int msg_size = strlen(error_msg);
 222         bool single_line, break_names;
 223
 224         break_names = info->key_size > 16 || msg_size > 16;
 225         single_line = info->key_size + msg_size <= 24 && !break_names;
 226
 227         printf("key:%c", break_names ? '\n' : ' ');
 228         fprint_hex(stdout, key, info->key_size, " ");
 229
 230         printf(single_line ? "  " : "\n");
 231
 232         printf("value:%c%s", break_names ? '\n' : ' ', error_msg);
 233
 234         printf("\n");
 235 }
 236
 237 static void
 238 print_entry_error(struct bpf_map_info *map_info, void *key, int lookup_errno)
 239 {
 240         /* For prog_array maps or arrays of maps, failure to lookup the value
 241          * means there is no entry for that key. Do not print an error message
 242          * in that case.
 243          */
 244         if ((map_is_map_of_maps(map_info->type) ||
 245              map_is_map_of_progs(map_info->type)) && lookup_errno == ENOENT)
 246                 return;
 247
 248         if (json_output) {
 249                 jsonw_start_object(json_wtr);   /* entry */
 250                 jsonw_name(json_wtr, "key");
 251                 print_hex_data_json(key, map_info->key_size);
 252                 jsonw_name(json_wtr, "value");
 253                 jsonw_start_object(json_wtr);   /* error */
 254                 jsonw_string_field(json_wtr, "error", strerror(lookup_errno));
 255                 jsonw_end_object(json_wtr);     /* error */
 256                 jsonw_end_object(json_wtr);     /* entry */
 257         } else {
 258                 const char *msg = NULL;
 259
 260                 if (lookup_errno == ENOENT)
 261                         msg = "<no entry>";
 262                 else if (lookup_errno == ENOSPC &&
 263                          map_info->type == BPF_MAP_TYPE_REUSEPORT_SOCKARRAY)
 264                         msg = "<cannot read>";
 265
 266                 print_entry_error_msg(map_info, key,
 267                                       msg ? : strerror(lookup_errno));
 268         }
 269 }
 270
 271 static void print_entry_plain(struct bpf_map_info *info, unsigned char *key,
 272                               unsigned char *value)
 273 {
 274         if (!map_is_per_cpu(info->type)) {
 275                 bool single_line, break_names;
 276
 277                 break_names = info->key_size > 16 || info->value_size > 16;
 278                 single_line = info->key_size + info->value_size <= 24 &&
 279                         !break_names;
 280
 281                 if (info->key_size) {
 282                         printf("key:%c", break_names ? '\n' : ' ');
 283                         fprint_hex(stdout, key, info->key_size, " ");
 284
 285                         printf(single_line ? "  " : "\n");
 286                 }
 287
 288                 if (info->value_size) {
 289                         printf("value:%c", break_names ? '\n' : ' ');
 290                         fprint_hex(stdout, value, info->value_size, " ");
 291                 }
 292
 293                 printf("\n");
 294         } else {
 295                 unsigned int i, n, step;
 296
 297                 n = get_possible_cpus();
 298                 step = round_up(info->value_size, 8);
 299
 300                 if (info->key_size) {
 301                         printf("key:\n");
 302                         fprint_hex(stdout, key, info->key_size, " ");
 303                         printf("\n");
 304                 }
 305                 if (info->value_size) {
 306                         for (i = 0; i < n; i++) {
 307                                 printf("value (CPU %02d):%c",
 308                                        i, info->value_size > 16 ? '\n' : ' ');
 309                                 fprint_hex(stdout, value + i * step,
 310                                            info->value_size, " ");
 311                                 printf("\n");
 312                         }
 313                 }
 314         }
 315 }
 316
 317 static char **parse_bytes(char **argv, const char *name, unsigned char *val,
 318                           unsigned int n)
 319 {
 320         unsigned int i = 0, base = 0;
 321         char *endptr;
 322
 323         if (is_prefix(*argv, "hex")) {
 324                 base = 16;
 325                 argv++;
 326         }
 327
 328         while (i < n && argv[i]) {
 329                 val[i] = strtoul(argv[i], &endptr, base);
 330                 if (*endptr) {
 331                         p_err("error parsing byte: %s", argv[i]);
 332                         return NULL;
 333                 }
 334                 i++;
 335         }
 336
 337         if (i != n) {
 338                 p_err("%s expected %d bytes got %d", name, n, i);
 339                 return NULL;
 340         }
 341
 342         return argv + i;
 343 }
 344
 345 /* on per cpu maps we must copy the provided value on all value instances */
 346 static void fill_per_cpu_value(struct bpf_map_info *info, void *value)
 347 {
 348         unsigned int i, n, step;
 349
 350         if (!map_is_per_cpu(info->type))
 351                 return;
 352
 353         n = get_possible_cpus();
 354         step = round_up(info->value_size, 8);
 355         for (i = 1; i < n; i++)
 356                 memcpy(value + i * step, value, info->value_size);
 357 }
 358
 359 static int parse_elem(char **argv, struct bpf_map_info *info,
 360                       void *key, void *value, __u32 key_size, __u32 value_size,
 361                       __u32 *flags, __u32 **value_fd)
 362 {
 363         if (!*argv) {
 364                 if (!key && !value)
 365                         return 0;
 366                 p_err("did not find %s", key ? "key" : "value");
 367                 return -1;
 368         }
 369
 370         if (is_prefix(*argv, "key")) {
 371                 if (!key) {
 372                         if (key_size)
 373                                 p_err("duplicate key");
 374                         else
 375                                 p_err("unnecessary key");
 376                         return -1;
 377                 }
 378
 379                 argv = parse_bytes(argv + 1, "key", key, key_size);
 380                 if (!argv)
 381                         return -1;
 382
 383                 return parse_elem(argv, info, NULL, value, key_size, value_size,
 384                                   flags, value_fd);
 385         } else if (is_prefix(*argv, "value")) {
 386                 int fd;
 387
 388                 if (!value) {
 389                         if (value_size)
 390                                 p_err("duplicate value");
 391                         else
 392                                 p_err("unnecessary value");
 393                         return -1;
 394                 }
 395
 396                 argv++;
 397
 398                 if (map_is_map_of_maps(info->type)) {
 399                         int argc = 2;
 400
 401                         if (value_size != 4) {
 402                                 p_err("value smaller than 4B for map in map?");
 403                                 return -1;
 404                         }
 405                         if (!argv[0] || !argv[1]) {
 406                                 p_err("not enough value arguments for map in map");
 407                                 return -1;
 408                         }
 409
 410                         fd = map_parse_fd(&argc, &argv);
 411                         if (fd < 0)
 412                                 return -1;
 413
 414                         *value_fd = value;
 415                         **value_fd = fd;
 416                 } else if (map_is_map_of_progs(info->type)) {
 417                         int argc = 2;
 418
 419                         if (value_size != 4) {
 420                                 p_err("value smaller than 4B for map of progs?");
 421                                 return -1;
 422                         }
 423                         if (!argv[0] || !argv[1]) {
 424                                 p_err("not enough value arguments for map of progs");
 425                                 return -1;
 426                         }
 427                         if (is_prefix(*argv, "id"))
 428                                 p_info("Warning: updating program array via MAP_ID, make sure this map is kept open\n"
 429                                        "         by some process or pinned otherwise update will be lost");
 430
 431                         fd = prog_parse_fd(&argc, &argv);
 432                         if (fd < 0)
 433                                 return -1;
 434
 435                         *value_fd = value;
 436                         **value_fd = fd;
 437                 } else {
 438                         argv = parse_bytes(argv, "value", value, value_size);
 439                         if (!argv)
 440                                 return -1;
 441
 442                         fill_per_cpu_value(info, value);
 443                 }
 444
 445                 return parse_elem(argv, info, key, NULL, key_size, value_size,
 446                                   flags, NULL);
 447         } else if (is_prefix(*argv, "any") || is_prefix(*argv, "noexist") ||
 448                    is_prefix(*argv, "exist")) {
 449                 if (!flags) {
 450                         p_err("flags specified multiple times: %s", *argv);
 451                         return -1;
 452                 }
 453
 454                 if (is_prefix(*argv, "any"))
 455                         *flags = BPF_ANY;
 456                 else if (is_prefix(*argv, "noexist"))
 457                         *flags = BPF_NOEXIST;
 458                 else if (is_prefix(*argv, "exist"))
 459                         *flags = BPF_EXIST;
 460
 461                 return parse_elem(argv + 1, info, key, value, key_size,
 462                                   value_size, NULL, value_fd);
 463         }
 464
 465         p_err("expected key or value, got: %s", *argv);
 466         return -1;
 467 }
 468
 469 static void show_map_header_json(struct bpf_map_info *info, json_writer_t *wtr)
 470 {
 471         jsonw_uint_field(wtr, "id", info->id);
 472         if (info->type < ARRAY_SIZE(map_type_name))
 473                 jsonw_string_field(wtr, "type", map_type_name[info->type]);
 474         else
 475                 jsonw_uint_field(wtr, "type", info->type);
 476
 477         if (*info->name)
 478                 jsonw_string_field(wtr, "name", info->name);
 479
 480         jsonw_name(wtr, "flags");
 481         jsonw_printf(wtr, "%d", info->map_flags);
 482 }
 483
 484 static int show_map_close_json(int fd, struct bpf_map_info *info)
 485 {
 486         char *memlock, *frozen_str;
 487         int frozen = 0;
 488
 489         memlock = get_fdinfo(fd, "memlock");
 490         frozen_str = get_fdinfo(fd, "frozen");
 491
 492         jsonw_start_object(json_wtr);
 493
 494         show_map_header_json(info, json_wtr);
 495
 496         print_dev_json(info->ifindex, info->netns_dev, info->netns_ino);
 497
 498         jsonw_uint_field(json_wtr, "bytes_key", info->key_size);
 499         jsonw_uint_field(json_wtr, "bytes_value", info->value_size);
 500         jsonw_uint_field(json_wtr, "max_entries", info->max_entries);
 501
 502         if (memlock)
 503                 jsonw_int_field(json_wtr, "bytes_memlock", atoi(memlock));
 504         free(memlock);
 505
 506         if (info->type == BPF_MAP_TYPE_PROG_ARRAY) {
 507                 char *owner_prog_type = get_fdinfo(fd, "owner_prog_type");
 508                 char *owner_jited = get_fdinfo(fd, "owner_jited");
 509
 510                 if (owner_prog_type) {
 511                         unsigned int prog_type = atoi(owner_prog_type);
 512
 513                         if (prog_type < prog_type_name_size)
 514                                 jsonw_string_field(json_wtr, "owner_prog_type",
 515                                                    prog_type_name[prog_type]);
 516                         else
 517                                 jsonw_uint_field(json_wtr, "owner_prog_type",
 518                                                  prog_type);
 519                 }
 520                 if (owner_jited)
 521                         jsonw_bool_field(json_wtr, "owner_jited",
 522                                          !!atoi(owner_jited));
 523
 524                 free(owner_prog_type);
 525                 free(owner_jited);
 526         }
 527         close(fd);
 528
 529         if (frozen_str) {
 530                 frozen = atoi(frozen_str);
 531                 free(frozen_str);
 532         }
 533         jsonw_int_field(json_wtr, "frozen", frozen);
 534
 535         if (info->btf_id)
 536                 jsonw_int_field(json_wtr, "btf_id", info->btf_id);
 537
 538         if (!hash_empty(map_table.table)) {
 539                 struct pinned_obj *obj;
 540
 541                 jsonw_name(json_wtr, "pinned");
 542                 jsonw_start_array(json_wtr);
 543                 hash_for_each_possible(map_table.table, obj, hash, info->id) {
 544                         if (obj->id == info->id)
 545                                 jsonw_string(json_wtr, obj->path);
 546                 }
 547                 jsonw_end_array(json_wtr);
 548         }
 549
 550         emit_obj_refs_json(&refs_table, info->id, json_wtr);
 551
 552         jsonw_end_object(json_wtr);
 553
 554         return 0;
 555 }
 556
 557 static void show_map_header_plain(struct bpf_map_info *info)
 558 {
 559         printf("%u: ", info->id);
 560         if (info->type < ARRAY_SIZE(map_type_name))
 561                 printf("%s  ", map_type_name[info->type]);
 562         else
 563                 printf("type %u  ", info->type);
 564
 565         if (*info->name)
 566                 printf("name %s  ", info->name);
 567
 568         printf("flags 0x%x", info->map_flags);
 569         print_dev_plain(info->ifindex, info->netns_dev, info->netns_ino);
 570         printf("\n");
 571 }
 572
 573 static int show_map_close_plain(int fd, struct bpf_map_info *info)
 574 {
 575         char *memlock, *frozen_str;
 576         int frozen = 0;
 577
 578         memlock = get_fdinfo(fd, "memlock");
 579         frozen_str = get_fdinfo(fd, "frozen");
 580
 581         show_map_header_plain(info);
 582         printf("\tkey %uB  value %uB  max_entries %u",
 583                info->key_size, info->value_size, info->max_entries);
 584
 585         if (memlock)
 586                 printf("  memlock %sB", memlock);
 587         free(memlock);
 588
 589         if (info->type == BPF_MAP_TYPE_PROG_ARRAY) {
 590                 char *owner_prog_type = get_fdinfo(fd, "owner_prog_type");
 591                 char *owner_jited = get_fdinfo(fd, "owner_jited");
 592
 593                 if (owner_prog_type || owner_jited)
 594                         printf("\n\t");
 595                 if (owner_prog_type) {
 596                         unsigned int prog_type = atoi(owner_prog_type);
 597
 598                         if (prog_type < prog_type_name_size)
 599                                 printf("owner_prog_type %s  ",
 600                                        prog_type_name[prog_type]);
 601                         else
 602                                 printf("owner_prog_type %d  ", prog_type);
 603                 }
 604                 if (owner_jited)
 605                         printf("owner%s jited",
 606                                atoi(owner_jited) ? "" : " not");
 607
 608                 free(owner_prog_type);
 609                 free(owner_jited);
 610         }
 611         close(fd);
 612
 613         if (!hash_empty(map_table.table)) {
 614                 struct pinned_obj *obj;
 615
 616                 hash_for_each_possible(map_table.table, obj, hash, info->id) {
 617                         if (obj->id == info->id)
 618                                 printf("\n\tpinned %s", obj->path);
 619                 }
 620         }
 621         printf("\n");
 622
 623         if (frozen_str) {
 624                 frozen = atoi(frozen_str);
 625                 free(frozen_str);
 626         }
 627
 628         if (!info->btf_id && !frozen)
 629                 return 0;
 630
 631         printf("\t");
 632
 633         if (info->btf_id)
 634                 printf("btf_id %d", info->btf_id);
 635
 636         if (frozen)
 637                 printf("%sfrozen", info->btf_id ? "  " : "");
 638
 639         emit_obj_refs_plain(&refs_table, info->id, "\n\tpids ");
 640
 641         printf("\n");
 642         return 0;
 643 }
 644
 645 static int do_show_subset(int argc, char **argv)
 646 {
 647         struct bpf_map_info info = {};
 648         __u32 len = sizeof(info);
 649         int *fds = NULL;
 650         int nb_fds, i;
 651         int err = -1;
 652
 653         fds = malloc(sizeof(int));
 654         if (!fds) {
 655                 p_err("mem alloc failed");
 656                 return -1;
 657         }
 658         nb_fds = map_parse_fds(&argc, &argv, &fds);
 659         if (nb_fds < 1)
 660                 goto exit_free;
 661
 662         if (json_output && nb_fds > 1)
 663                 jsonw_start_array(json_wtr);    /* root array */
 664         for (i = 0; i < nb_fds; i++) {
 665                 err = bpf_obj_get_info_by_fd(fds[i], &info, &len);
 666                 if (err) {
 667                         p_err("can't get map info: %s",
 668                               strerror(errno));
 669                         for (; i < nb_fds; i++)
 670                                 close(fds[i]);
 671                         break;
 672                 }
 673
 674                 if (json_output)
 675                         show_map_close_json(fds[i], &info);
 676                 else
 677                         show_map_close_plain(fds[i], &info);
 678
 679                 close(fds[i]);
 680         }
 681         if (json_output && nb_fds > 1)
 682                 jsonw_end_array(json_wtr);      /* root array */
 683
 684 exit_free:
 685         free(fds);
 686         return err;
 687 }
 688
 689 static int do_show(int argc, char **argv)
 690 {
 691         struct bpf_map_info info = {};
 692         __u32 len = sizeof(info);
 693         __u32 id = 0;
 694         int err;
 695         int fd;
 696
 697         if (show_pinned)
 698                 build_pinned_obj_table(&map_table, BPF_OBJ_MAP);
 699         build_obj_refs_table(&refs_table, BPF_OBJ_MAP);
 700
 701         if (argc == 2)
 702                 return do_show_subset(argc, argv);
 703
 704         if (argc)
 705                 return BAD_ARG();
 706
 707         if (json_output)
 708                 jsonw_start_array(json_wtr);
 709         while (true) {
 710                 err = bpf_map_get_next_id(id, &id);
 711                 if (err) {
 712                         if (errno == ENOENT)
 713                                 break;
 714                         p_err("can't get next map: %s%s", strerror(errno),
 715                               errno == EINVAL ? " -- kernel too old?" : "");
 716                         break;
 717                 }
 718
 719                 fd = bpf_map_get_fd_by_id(id);
 720                 if (fd < 0) {
 721                         if (errno == ENOENT)
 722                                 continue;
 723                         p_err("can't get map by id (%u): %s",
 724                               id, strerror(errno));
 725                         break;
 726                 }
 727
 728                 err = bpf_obj_get_info_by_fd(fd, &info, &len);
 729                 if (err) {
 730                         p_err("can't get map info: %s", strerror(errno));
 731                         close(fd);
 732                         break;
 733                 }
 734
 735                 if (json_output)
 736                         show_map_close_json(fd, &info);
 737                 else
 738                         show_map_close_plain(fd, &info);
 739         }
 740         if (json_output)
 741                 jsonw_end_array(json_wtr);
 742
 743         delete_obj_refs_table(&refs_table);
 744
 745         return errno == ENOENT ? 0 : -1;
 746 }
 747
 748 static int dump_map_elem(int fd, void *key, void *value,
 749                          struct bpf_map_info *map_info, struct btf *btf,
 750                          json_writer_t *btf_wtr)
 751 {
 752         if (bpf_map_lookup_elem(fd, key, value)) {
 753                 print_entry_error(map_info, key, errno);
 754                 return -1;
 755         }
 756
 757         if (json_output) {
 758                 print_entry_json(map_info, key, value, btf);
 759         } else if (btf) {
 760                 struct btf_dumper d = {
 761                         .btf = btf,
 762                         .jw = btf_wtr,
 763                         .is_plain_text = true,
 764                 };
 765
 766                 do_dump_btf(&d, map_info, key, value);
 767         } else {
 768                 print_entry_plain(map_info, key, value);
 769         }
 770
 771         return 0;
 772 }
 773
 774 static int maps_have_btf(int *fds, int nb_fds)
 775 {
 776         struct bpf_map_info info = {};
 777         __u32 len = sizeof(info);
 778         int err, i;
 779
 780         for (i = 0; i < nb_fds; i++) {
 781                 err = bpf_obj_get_info_by_fd(fds[i], &info, &len);
 782                 if (err) {
 783                         p_err("can't get map info: %s", strerror(errno));
 784                         return -1;
 785                 }
 786
 787                 if (!info.btf_id)
 788                         return 0;
 789         }
 790
 791         return 1;
 792 }
 793
 794 static struct btf *btf_vmlinux;
 795
 796 static struct btf *get_map_kv_btf(const struct bpf_map_info *info)
 797 {
 798         struct btf *btf = NULL;
 799
 800         if (info->btf_vmlinux_value_type_id) {
 801                 if (!btf_vmlinux) {
 802                         btf_vmlinux = libbpf_find_kernel_btf();
 803                         if (IS_ERR(btf_vmlinux))
 804                                 p_err("failed to get kernel btf");
 805                 }
 806                 return btf_vmlinux;
 807         } else if (info->btf_value_type_id) {
 808                 int err;
 809
 810                 err = btf__get_from_id(info->btf_id, &btf);
 811                 if (err || !btf) {
 812                         p_err("failed to get btf");
 813                         btf = err ? ERR_PTR(err) : ERR_PTR(-ESRCH);
 814                 }
 815         }
 816
 817         return btf;
 818 }
 819
 820 static void free_map_kv_btf(struct btf *btf)
 821 {
 822         if (!IS_ERR(btf) && btf != btf_vmlinux)
 823                 btf__free(btf);
 824 }
 825
 826 static void free_btf_vmlinux(void)
 827 {
 828         if (!IS_ERR(btf_vmlinux))
 829                 btf__free(btf_vmlinux);
 830 }
 831
 832 static int
 833 map_dump(int fd, struct bpf_map_info *info, json_writer_t *wtr,
 834          bool show_header)
 835 {
 836         void *key, *value, *prev_key;
 837         unsigned int num_elems = 0;
 838         struct btf *btf = NULL;
 839         int err;
 840
 841         key = malloc(info->key_size);
 842         value = alloc_value(info);
 843         if (!key || !value) {
 844                 p_err("mem alloc failed");
 845                 err = -1;
 846                 goto exit_free;
 847         }
 848
 849         prev_key = NULL;
 850
 851         if (wtr) {
 852                 btf = get_map_kv_btf(info);
 853                 if (IS_ERR(btf)) {
 854                         err = PTR_ERR(btf);
 855                         goto exit_free;
 856                 }
 857
 858                 if (show_header) {
 859                         jsonw_start_object(wtr);        /* map object */
 860                         show_map_header_json(info, wtr);
 861                         jsonw_name(wtr, "elements");
 862                 }
 863                 jsonw_start_array(wtr);         /* elements */
 864         } else if (show_header) {
 865                 show_map_header_plain(info);
 866         }
 867
 868         if (info->type == BPF_MAP_TYPE_REUSEPORT_SOCKARRAY &&
 869             info->value_size != 8)
 870                 p_info("Warning: cannot read values from %s map with value_size != 8",
 871                        map_type_name[info->type]);
 872         while (true) {
 873                 err = bpf_map_get_next_key(fd, prev_key, key);
 874                 if (err) {
 875                         if (errno == ENOENT)
 876                                 err = 0;
 877                         break;
 878                 }
 879                 if (!dump_map_elem(fd, key, value, info, btf, wtr))
 880                         num_elems++;
 881                 prev_key = key;
 882         }
 883
 884         if (wtr) {
 885                 jsonw_end_array(wtr);   /* elements */
 886                 if (show_header)
 887                         jsonw_end_object(wtr);  /* map object */
 888         } else {
 889                 printf("Found %u element%s\n", num_elems,
 890                        num_elems != 1 ? "s" : "");
 891         }
 892
 893 exit_free:
 894         free(key);
 895         free(value);
 896         close(fd);
 897         free_map_kv_btf(btf);
 898
 899         return err;
 900 }
 901
 902 static int do_dump(int argc, char **argv)
 903 {
 904         json_writer_t *wtr = NULL, *btf_wtr = NULL;
 905         struct bpf_map_info info = {};
 906         int nb_fds, i = 0;
 907         __u32 len = sizeof(info);
 908         int *fds = NULL;
 909         int err = -1;
 910
 911         if (argc != 2)
 912                 usage();
 913
 914         fds = malloc(sizeof(int));
 915         if (!fds) {
 916                 p_err("mem alloc failed");
 917                 return -1;
 918         }
 919         nb_fds = map_parse_fds(&argc, &argv, &fds);
 920         if (nb_fds < 1)
 921                 goto exit_free;
 922
 923         if (json_output) {
 924                 wtr = json_wtr;
 925         } else {
 926                 int do_plain_btf;
 927
 928                 do_plain_btf = maps_have_btf(fds, nb_fds);
 929                 if (do_plain_btf < 0)
 930                         goto exit_close;
 931
 932                 if (do_plain_btf) {
 933                         btf_wtr = get_btf_writer();
 934                         wtr = btf_wtr;
 935                         if (!btf_wtr)
 936                                 p_info("failed to create json writer for btf. falling back to plain output");
 937                 }
 938         }
 939
 940         if (wtr && nb_fds > 1)
 941                 jsonw_start_array(wtr); /* root array */
 942         for (i = 0; i < nb_fds; i++) {
 943                 if (bpf_obj_get_info_by_fd(fds[i], &info, &len)) {
 944                         p_err("can't get map info: %s", strerror(errno));
 945                         break;
 946                 }
 947                 err = map_dump(fds[i], &info, wtr, nb_fds > 1);
 948                 if (!wtr && i != nb_fds - 1)
 949                         printf("\n");
 950
 951                 if (err)
 952                         break;
 953                 close(fds[i]);
 954         }
 955         if (wtr && nb_fds > 1)
 956                 jsonw_end_array(wtr);   /* root array */
 957
 958         if (btf_wtr)
 959                 jsonw_destroy(&btf_wtr);
 960 exit_close:
 961         for (; i < nb_fds; i++)
 962                 close(fds[i]);
 963 exit_free:
 964         free(fds);
 965         free_btf_vmlinux();
 966         return err;
 967 }
 968
 969 static int alloc_key_value(struct bpf_map_info *info, void **key, void **value)
 970 {
 971         *key = NULL;
 972         *value = NULL;
 973
 974         if (info->key_size) {
 975                 *key = malloc(info->key_size);
 976                 if (!*key) {
 977                         p_err("key mem alloc failed");
 978                         return -1;
 979                 }
 980         }
 981
 982         if (info->value_size) {
 983                 *value = alloc_value(info);
 984                 if (!*value) {
 985                         p_err("value mem alloc failed");
 986                         free(*key);
 987                         *key = NULL;
 988                         return -1;
 989                 }
 990         }
 991
 992         return 0;
 993 }
 994
 995 static int do_update(int argc, char **argv)
 996 {
 997         struct bpf_map_info info = {};
 998         __u32 len = sizeof(info);
 999         __u32 *value_fd = NULL;
1000         __u32 flags = BPF_ANY;
1001         void *key, *value;
1002         int fd, err;
1003
1004         if (argc < 2)
1005                 usage();
1006
1007         fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1008         if (fd < 0)
1009                 return -1;
1010
1011         err = alloc_key_value(&info, &key, &value);
1012         if (err)
1013                 goto exit_free;
1014
1015         err = parse_elem(argv, &info, key, value, info.key_size,
1016                          info.value_size, &flags, &value_fd);
1017         if (err)
1018                 goto exit_free;
1019
1020         err = bpf_map_update_elem(fd, key, value, flags);
1021         if (err) {
1022                 p_err("update failed: %s", strerror(errno));
1023                 goto exit_free;
1024         }
1025
1026 exit_free:
1027         if (value_fd)
1028                 close(*value_fd);
1029         free(key);
1030         free(value);
1031         close(fd);
1032
1033         if (!err && json_output)
1034                 jsonw_null(json_wtr);
1035         return err;
1036 }
1037
1038 static void print_key_value(struct bpf_map_info *info, void *key,
1039                             void *value)
1040 {
1041         json_writer_t *btf_wtr;
1042         struct btf *btf = NULL;
1043         int err;
1044
1045         err = btf__get_from_id(info->btf_id, &btf);
1046         if (err) {
1047                 p_err("failed to get btf");
1048                 return;
1049         }
1050
1051         if (json_output) {
1052                 print_entry_json(info, key, value, btf);
1053         } else if (btf) {
1054                 /* if here json_wtr wouldn't have been initialised,
1055                  * so let's create separate writer for btf
1056                  */
1057                 btf_wtr = get_btf_writer();
1058                 if (!btf_wtr) {
1059                         p_info("failed to create json writer for btf. falling back to plain output");
1060                         btf__free(btf);
1061                         btf = NULL;
1062                         print_entry_plain(info, key, value);
1063                 } else {
1064                         struct btf_dumper d = {
1065                                 .btf = btf,
1066                                 .jw = btf_wtr,
1067                                 .is_plain_text = true,
1068                         };
1069
1070                         do_dump_btf(&d, info, key, value);
1071                         jsonw_destroy(&btf_wtr);
1072                 }
1073         } else {
1074                 print_entry_plain(info, key, value);
1075         }
1076         btf__free(btf);
1077 }
1078
1079 static int do_lookup(int argc, char **argv)
1080 {
1081         struct bpf_map_info info = {};
1082         __u32 len = sizeof(info);
1083         void *key, *value;
1084         int err;
1085         int fd;
1086
1087         if (argc < 2)
1088                 usage();
1089
1090         fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1091         if (fd < 0)
1092                 return -1;
1093
1094         err = alloc_key_value(&info, &key, &value);
1095         if (err)
1096                 goto exit_free;
1097
1098         err = parse_elem(argv, &info, key, NULL, info.key_size, 0, NULL, NULL);
1099         if (err)
1100                 goto exit_free;
1101
1102         err = bpf_map_lookup_elem(fd, key, value);
1103         if (err) {
1104                 if (errno == ENOENT) {
1105                         if (json_output) {
1106                                 jsonw_null(json_wtr);
1107                         } else {
1108                                 printf("key:\n");
1109                                 fprint_hex(stdout, key, info.key_size, " ");
1110                                 printf("\n\nNot found\n");
1111                         }
1112                 } else {
1113                         p_err("lookup failed: %s", strerror(errno));
1114                 }
1115
1116                 goto exit_free;
1117         }
1118
1119         /* here means bpf_map_lookup_elem() succeeded */
1120         print_key_value(&info, key, value);
1121
1122 exit_free:
1123         free(key);
1124         free(value);
1125         close(fd);
1126
1127         return err;
1128 }
1129
1130 static int do_getnext(int argc, char **argv)
1131 {
1132         struct bpf_map_info info = {};
1133         __u32 len = sizeof(info);
1134         void *key, *nextkey;
1135         int err;
1136         int fd;
1137
1138         if (argc < 2)
1139                 usage();
1140
1141         fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1142         if (fd < 0)
1143                 return -1;
1144
1145         key = malloc(info.key_size);
1146         nextkey = malloc(info.key_size);
1147         if (!key || !nextkey) {
1148                 p_err("mem alloc failed");
1149                 err = -1;
1150                 goto exit_free;
1151         }
1152
1153         if (argc) {
1154                 err = parse_elem(argv, &info, key, NULL, info.key_size, 0,
1155                                  NULL, NULL);
1156                 if (err)
1157                         goto exit_free;
1158         } else {
1159                 free(key);
1160                 key = NULL;
1161         }
1162
1163         err = bpf_map_get_next_key(fd, key, nextkey);
1164         if (err) {
1165                 p_err("can't get next key: %s", strerror(errno));
1166                 goto exit_free;
1167         }
1168
1169         if (json_output) {
1170                 jsonw_start_object(json_wtr);
1171                 if (key) {
1172                         jsonw_name(json_wtr, "key");
1173                         print_hex_data_json(key, info.key_size);
1174                 } else {
1175                         jsonw_null_field(json_wtr, "key");
1176                 }
1177                 jsonw_name(json_wtr, "next_key");
1178                 print_hex_data_json(nextkey, info.key_size);
1179                 jsonw_end_object(json_wtr);
1180         } else {
1181                 if (key) {
1182                         printf("key:\n");
1183                         fprint_hex(stdout, key, info.key_size, " ");
1184                         printf("\n");
1185                 } else {
1186                         printf("key: None\n");
1187                 }
1188                 printf("next key:\n");
1189                 fprint_hex(stdout, nextkey, info.key_size, " ");
1190                 printf("\n");
1191         }
1192
1193 exit_free:
1194         free(nextkey);
1195         free(key);
1196         close(fd);
1197
1198         return err;
1199 }
1200
1201 static int do_delete(int argc, char **argv)
1202 {
1203         struct bpf_map_info info = {};
1204         __u32 len = sizeof(info);
1205         void *key;
1206         int err;
1207         int fd;
1208
1209         if (argc < 2)
1210                 usage();
1211
1212         fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1213         if (fd < 0)
1214                 return -1;
1215
1216         key = malloc(info.key_size);
1217         if (!key) {
1218                 p_err("mem alloc failed");
1219                 err = -1;
1220                 goto exit_free;
1221         }
1222
1223         err = parse_elem(argv, &info, key, NULL, info.key_size, 0, NULL, NULL);
1224         if (err)
1225                 goto exit_free;
1226
1227         err = bpf_map_delete_elem(fd, key);
1228         if (err)
1229                 p_err("delete failed: %s", strerror(errno));
1230
1231 exit_free:
1232         free(key);
1233         close(fd);
1234
1235         if (!err && json_output)
1236                 jsonw_null(json_wtr);
1237         return err;
1238 }
1239
1240 static int do_pin(int argc, char **argv)
1241 {
1242         int err;
1243
1244         err = do_pin_any(argc, argv, map_parse_fd);
1245         if (!err && json_output)
1246                 jsonw_null(json_wtr);
1247         return err;
1248 }
1249
1250 static int do_create(int argc, char **argv)
1251 {
1252         struct bpf_create_map_attr attr = { NULL, };
1253         const char *pinfile;
1254         int err = -1, fd;
1255
1256         if (!REQ_ARGS(7))
1257                 return -1;
1258         pinfile = GET_ARG();
1259
1260         while (argc) {
1261                 if (!REQ_ARGS(2))
1262                         return -1;
1263
1264                 if (is_prefix(*argv, "type")) {
1265                         NEXT_ARG();
1266
1267                         if (attr.map_type) {
1268                                 p_err("map type already specified");
1269                                 goto exit;
1270                         }
1271
1272                         attr.map_type = map_type_from_str(*argv);
1273                         if ((int)attr.map_type < 0) {
1274                                 p_err("unrecognized map type: %s", *argv);
1275                                 goto exit;
1276                         }
1277                         NEXT_ARG();
1278                 } else if (is_prefix(*argv, "name")) {
1279                         NEXT_ARG();
1280                         attr.name = GET_ARG();
1281                 } else if (is_prefix(*argv, "key")) {
1282                         if (parse_u32_arg(&argc, &argv, &attr.key_size,
1283                                           "key size"))
1284                                 goto exit;
1285                 } else if (is_prefix(*argv, "value")) {
1286                         if (parse_u32_arg(&argc, &argv, &attr.value_size,
1287                                           "value size"))
1288                                 goto exit;
1289                 } else if (is_prefix(*argv, "entries")) {
1290                         if (parse_u32_arg(&argc, &argv, &attr.max_entries,
1291                                           "max entries"))
1292                                 goto exit;
1293                 } else if (is_prefix(*argv, "flags")) {
1294                         if (parse_u32_arg(&argc, &argv, &attr.map_flags,
1295                                           "flags"))
1296                                 goto exit;
1297                 } else if (is_prefix(*argv, "dev")) {
1298                         NEXT_ARG();
1299
1300                         if (attr.map_ifindex) {
1301                                 p_err("offload device already specified");
1302                                 goto exit;
1303                         }
1304
1305                         attr.map_ifindex = if_nametoindex(*argv);
1306                         if (!attr.map_ifindex) {
1307                                 p_err("unrecognized netdevice '%s': %s",
1308                                       *argv, strerror(errno));
1309                                 goto exit;
1310                         }
1311                         NEXT_ARG();
1312                 } else if (is_prefix(*argv, "inner_map")) {
1313                         struct bpf_map_info info = {};
1314                         __u32 len = sizeof(info);
1315                         int inner_map_fd;
1316
1317                         NEXT_ARG();
1318                         if (!REQ_ARGS(2))
1319                                 usage();
1320                         inner_map_fd = map_parse_fd_and_info(&argc, &argv,
1321                                                              &info, &len);
1322                         if (inner_map_fd < 0)
1323                                 return -1;
1324                         attr.inner_map_fd = inner_map_fd;
1325                 } else {
1326                         p_err("unknown arg %s", *argv);
1327                         goto exit;
1328                 }
1329         }
1330
1331         if (!attr.name) {
1332                 p_err("map name not specified");
1333                 goto exit;
1334         }
1335
1336         set_max_rlimit();
1337
1338         fd = bpf_create_map_xattr(&attr);
1339         if (fd < 0) {
1340                 p_err("map create failed: %s", strerror(errno));
1341                 goto exit;
1342         }
1343
1344         err = do_pin_fd(fd, pinfile);
1345         close(fd);
1346         if (err)
1347                 goto exit;
1348
1349         if (json_output)
1350                 jsonw_null(json_wtr);
1351
1352 exit:
1353         if (attr.inner_map_fd > 0)
1354                 close(attr.inner_map_fd);
1355
1356         return err;
1357 }
1358
1359 static int do_pop_dequeue(int argc, char **argv)
1360 {
1361         struct bpf_map_info info = {};
1362         __u32 len = sizeof(info);
1363         void *key, *value;
1364         int err;
1365         int fd;
1366
1367         if (argc < 2)
1368                 usage();
1369
1370         fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1371         if (fd < 0)
1372                 return -1;
1373
1374         err = alloc_key_value(&info, &key, &value);
1375         if (err)
1376                 goto exit_free;
1377
1378         err = bpf_map_lookup_and_delete_elem(fd, key, value);
1379         if (err) {
1380                 if (errno == ENOENT) {
1381                         if (json_output)
1382                                 jsonw_null(json_wtr);
1383                         else
1384                                 printf("Error: empty map\n");
1385                 } else {
1386                         p_err("pop failed: %s", strerror(errno));
1387                 }
1388
1389                 goto exit_free;
1390         }
1391
1392         print_key_value(&info, key, value);
1393
1394 exit_free:
1395         free(key);
1396         free(value);
1397         close(fd);
1398
1399         return err;
1400 }
1401
1402 static int do_freeze(int argc, char **argv)
1403 {
1404         int err, fd;
1405
1406         if (!REQ_ARGS(2))
1407                 return -1;
1408
1409         fd = map_parse_fd(&argc, &argv);
1410         if (fd < 0)
1411                 return -1;
1412
1413         if (argc) {
1414                 close(fd);
1415                 return BAD_ARG();
1416         }
1417
1418         err = bpf_map_freeze(fd);
1419         close(fd);
1420         if (err) {
1421                 p_err("failed to freeze map: %s", strerror(errno));
1422                 return err;
1423         }
1424
1425         if (json_output)
1426                 jsonw_null(json_wtr);
1427
1428         return 0;
1429 }
1430
1431 static int do_help(int argc, char **argv)
1432 {
1433         if (json_output) {
1434                 jsonw_null(json_wtr);
1435                 return 0;
1436         }
1437
1438         fprintf(stderr,
1439                 "Usage: %1$s %2$s { show | list }   [MAP]\n"
1440                 "       %1$s %2$s create     FILE type TYPE key KEY_SIZE value VALUE_SIZE \\\n"
1441                 "                                  entries MAX_ENTRIES name NAME [flags FLAGS] \\\n"
1442                 "                                  [inner_map MAP] [dev NAME]\n"
1443                 "       %1$s %2$s dump       MAP\n"
1444                 "       %1$s %2$s update     MAP [key DATA] [value VALUE] [UPDATE_FLAGS]\n"
1445                 "       %1$s %2$s lookup     MAP [key DATA]\n"
1446                 "       %1$s %2$s getnext    MAP [key DATA]\n"
1447                 "       %1$s %2$s delete     MAP  key DATA\n"
1448                 "       %1$s %2$s pin        MAP  FILE\n"
1449                 "       %1$s %2$s event_pipe MAP [cpu N index M]\n"
1450                 "       %1$s %2$s peek       MAP\n"
1451                 "       %1$s %2$s push       MAP value VALUE\n"
1452                 "       %1$s %2$s pop        MAP\n"
1453                 "       %1$s %2$s enqueue    MAP value VALUE\n"
1454                 "       %1$s %2$s dequeue    MAP\n"
1455                 "       %1$s %2$s freeze     MAP\n"
1456                 "       %1$s %2$s help\n"
1457                 "\n"
1458                 "       " HELP_SPEC_MAP "\n"
1459                 "       DATA := { [hex] BYTES }\n"
1460                 "       " HELP_SPEC_PROGRAM "\n"
1461                 "       VALUE := { DATA | MAP | PROG }\n"
1462                 "       UPDATE_FLAGS := { any | exist | noexist }\n"
1463                 "       TYPE := { hash | array | prog_array | perf_event_array | percpu_hash |\n"
1464                 "                 percpu_array | stack_trace | cgroup_array | lru_hash |\n"
1465                 "                 lru_percpu_hash | lpm_trie | array_of_maps | hash_of_maps |\n"
1466                 "                 devmap | devmap_hash | sockmap | cpumap | xskmap | sockhash |\n"
1467                 "                 cgroup_storage | reuseport_sockarray | percpu_cgroup_storage |\n"
1468                 "                 queue | stack | sk_storage | struct_ops | ringbuf | inode_storage |\n"
1469                 "                 task_storage }\n"
1470                 "       " HELP_SPEC_OPTIONS "\n"
1471                 "",
1472                 bin_name, argv[-2]);
1473
1474         return 0;
1475 }
1476
1477 static const struct cmd cmds[] = {
1478         { "show",       do_show },
1479         { "list",       do_show },
1480         { "help",       do_help },
1481         { "dump",       do_dump },
1482         { "update",     do_update },
1483         { "lookup",     do_lookup },
1484         { "getnext",    do_getnext },
1485         { "delete",     do_delete },
1486         { "pin",        do_pin },
1487         { "event_pipe", do_event_pipe },
1488         { "create",     do_create },
1489         { "peek",       do_lookup },
1490         { "push",       do_update },
1491         { "enqueue",    do_update },
1492         { "pop",        do_pop_dequeue },
1493         { "dequeue",    do_pop_dequeue },
1494         { "freeze",     do_freeze },
1495         { 0 }
1496 };
1497
1498 int do_map(int argc, char **argv)
1499 {
1500         return cmd_select(cmds, argc, argv, do_help);
1501 }