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