1 // SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 /* Copyright (C) 2017-2018 Netronome Systems, Inc. */
8 #include <linux/kernel.h>
15 #include <sys/types.h>
21 #include "json_writer.h"
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",
56 const size_t map_type_name_size = ARRAY_SIZE(map_type_name);
58 static bool map_is_per_cpu(__u32 type)
60 return type == BPF_MAP_TYPE_PERCPU_HASH ||
61 type == BPF_MAP_TYPE_PERCPU_ARRAY ||
62 type == BPF_MAP_TYPE_LRU_PERCPU_HASH ||
63 type == BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE;
66 static bool map_is_map_of_maps(__u32 type)
68 return type == BPF_MAP_TYPE_ARRAY_OF_MAPS ||
69 type == BPF_MAP_TYPE_HASH_OF_MAPS;
72 static bool map_is_map_of_progs(__u32 type)
74 return type == BPF_MAP_TYPE_PROG_ARRAY;
77 static int map_type_from_str(const char *type)
81 for (i = 0; i < ARRAY_SIZE(map_type_name); i++)
82 /* Don't allow prefixing in case of possible future shadowing */
83 if (map_type_name[i] && !strcmp(map_type_name[i], type))
88 static void *alloc_value(struct bpf_map_info *info)
90 if (map_is_per_cpu(info->type))
91 return malloc(round_up(info->value_size, 8) *
94 return malloc(info->value_size);
97 static int do_dump_btf(const struct btf_dumper *d,
98 struct bpf_map_info *map_info, void *key,
104 /* start of key-value pair */
105 jsonw_start_object(d->jw);
107 if (map_info->btf_key_type_id) {
108 jsonw_name(d->jw, "key");
110 ret = btf_dumper_type(d, map_info->btf_key_type_id, key);
115 value_id = map_info->btf_vmlinux_value_type_id ?
116 : map_info->btf_value_type_id;
118 if (!map_is_per_cpu(map_info->type)) {
119 jsonw_name(d->jw, "value");
120 ret = btf_dumper_type(d, value_id, value);
122 unsigned int i, n, step;
124 jsonw_name(d->jw, "values");
125 jsonw_start_array(d->jw);
126 n = get_possible_cpus();
127 step = round_up(map_info->value_size, 8);
128 for (i = 0; i < n; i++) {
129 jsonw_start_object(d->jw);
130 jsonw_int_field(d->jw, "cpu", i);
131 jsonw_name(d->jw, "value");
132 ret = btf_dumper_type(d, value_id, value + i * step);
133 jsonw_end_object(d->jw);
137 jsonw_end_array(d->jw);
141 /* end of key-value pair */
142 jsonw_end_object(d->jw);
147 static json_writer_t *get_btf_writer(void)
149 json_writer_t *jw = jsonw_new(stdout);
153 jsonw_pretty(jw, true);
158 static void print_entry_json(struct bpf_map_info *info, unsigned char *key,
159 unsigned char *value, struct btf *btf)
161 jsonw_start_object(json_wtr);
163 if (!map_is_per_cpu(info->type)) {
164 jsonw_name(json_wtr, "key");
165 print_hex_data_json(key, info->key_size);
166 jsonw_name(json_wtr, "value");
167 print_hex_data_json(value, info->value_size);
169 struct btf_dumper d = {
172 .is_plain_text = false,
175 jsonw_name(json_wtr, "formatted");
176 do_dump_btf(&d, info, key, value);
179 unsigned int i, n, step;
181 n = get_possible_cpus();
182 step = round_up(info->value_size, 8);
184 jsonw_name(json_wtr, "key");
185 print_hex_data_json(key, info->key_size);
187 jsonw_name(json_wtr, "values");
188 jsonw_start_array(json_wtr);
189 for (i = 0; i < n; i++) {
190 jsonw_start_object(json_wtr);
192 jsonw_int_field(json_wtr, "cpu", i);
194 jsonw_name(json_wtr, "value");
195 print_hex_data_json(value + i * step,
198 jsonw_end_object(json_wtr);
200 jsonw_end_array(json_wtr);
202 struct btf_dumper d = {
205 .is_plain_text = false,
208 jsonw_name(json_wtr, "formatted");
209 do_dump_btf(&d, info, key, value);
213 jsonw_end_object(json_wtr);
217 print_entry_error_msg(struct bpf_map_info *info, unsigned char *key,
218 const char *error_msg)
220 int msg_size = strlen(error_msg);
221 bool single_line, break_names;
223 break_names = info->key_size > 16 || msg_size > 16;
224 single_line = info->key_size + msg_size <= 24 && !break_names;
226 printf("key:%c", break_names ? '\n' : ' ');
227 fprint_hex(stdout, key, info->key_size, " ");
229 printf(single_line ? " " : "\n");
231 printf("value:%c%s", break_names ? '\n' : ' ', error_msg);
237 print_entry_error(struct bpf_map_info *map_info, void *key, int lookup_errno)
239 /* For prog_array maps or arrays of maps, failure to lookup the value
240 * means there is no entry for that key. Do not print an error message
243 if ((map_is_map_of_maps(map_info->type) ||
244 map_is_map_of_progs(map_info->type)) && lookup_errno == ENOENT)
248 jsonw_start_object(json_wtr); /* entry */
249 jsonw_name(json_wtr, "key");
250 print_hex_data_json(key, map_info->key_size);
251 jsonw_name(json_wtr, "value");
252 jsonw_start_object(json_wtr); /* error */
253 jsonw_string_field(json_wtr, "error", strerror(lookup_errno));
254 jsonw_end_object(json_wtr); /* error */
255 jsonw_end_object(json_wtr); /* entry */
257 const char *msg = NULL;
259 if (lookup_errno == ENOENT)
261 else if (lookup_errno == ENOSPC &&
262 map_info->type == BPF_MAP_TYPE_REUSEPORT_SOCKARRAY)
263 msg = "<cannot read>";
265 print_entry_error_msg(map_info, key,
266 msg ? : strerror(lookup_errno));
270 static void print_entry_plain(struct bpf_map_info *info, unsigned char *key,
271 unsigned char *value)
273 if (!map_is_per_cpu(info->type)) {
274 bool single_line, break_names;
276 break_names = info->key_size > 16 || info->value_size > 16;
277 single_line = info->key_size + info->value_size <= 24 &&
280 if (info->key_size) {
281 printf("key:%c", break_names ? '\n' : ' ');
282 fprint_hex(stdout, key, info->key_size, " ");
284 printf(single_line ? " " : "\n");
287 if (info->value_size) {
288 printf("value:%c", break_names ? '\n' : ' ');
289 fprint_hex(stdout, value, info->value_size, " ");
294 unsigned int i, n, step;
296 n = get_possible_cpus();
297 step = round_up(info->value_size, 8);
299 if (info->key_size) {
301 fprint_hex(stdout, key, info->key_size, " ");
304 if (info->value_size) {
305 for (i = 0; i < n; i++) {
306 printf("value (CPU %02d):%c",
307 i, info->value_size > 16 ? '\n' : ' ');
308 fprint_hex(stdout, value + i * step,
309 info->value_size, " ");
316 static char **parse_bytes(char **argv, const char *name, unsigned char *val,
319 unsigned int i = 0, base = 0;
322 if (is_prefix(*argv, "hex")) {
327 while (i < n && argv[i]) {
328 val[i] = strtoul(argv[i], &endptr, base);
330 p_err("error parsing byte: %s", argv[i]);
337 p_err("%s expected %d bytes got %d", name, n, i);
344 /* on per cpu maps we must copy the provided value on all value instances */
345 static void fill_per_cpu_value(struct bpf_map_info *info, void *value)
347 unsigned int i, n, step;
349 if (!map_is_per_cpu(info->type))
352 n = get_possible_cpus();
353 step = round_up(info->value_size, 8);
354 for (i = 1; i < n; i++)
355 memcpy(value + i * step, value, info->value_size);
358 static int parse_elem(char **argv, struct bpf_map_info *info,
359 void *key, void *value, __u32 key_size, __u32 value_size,
360 __u32 *flags, __u32 **value_fd)
365 p_err("did not find %s", key ? "key" : "value");
369 if (is_prefix(*argv, "key")) {
372 p_err("duplicate key");
374 p_err("unnecessary key");
378 argv = parse_bytes(argv + 1, "key", key, key_size);
382 return parse_elem(argv, info, NULL, value, key_size, value_size,
384 } else if (is_prefix(*argv, "value")) {
389 p_err("duplicate value");
391 p_err("unnecessary value");
397 if (map_is_map_of_maps(info->type)) {
400 if (value_size != 4) {
401 p_err("value smaller than 4B for map in map?");
404 if (!argv[0] || !argv[1]) {
405 p_err("not enough value arguments for map in map");
409 fd = map_parse_fd(&argc, &argv);
415 } else if (map_is_map_of_progs(info->type)) {
418 if (value_size != 4) {
419 p_err("value smaller than 4B for map of progs?");
422 if (!argv[0] || !argv[1]) {
423 p_err("not enough value arguments for map of progs");
426 if (is_prefix(*argv, "id"))
427 p_info("Warning: updating program array via MAP_ID, make sure this map is kept open\n"
428 " by some process or pinned otherwise update will be lost");
430 fd = prog_parse_fd(&argc, &argv);
437 argv = parse_bytes(argv, "value", value, value_size);
441 fill_per_cpu_value(info, value);
444 return parse_elem(argv, info, key, NULL, key_size, value_size,
446 } else if (is_prefix(*argv, "any") || is_prefix(*argv, "noexist") ||
447 is_prefix(*argv, "exist")) {
449 p_err("flags specified multiple times: %s", *argv);
453 if (is_prefix(*argv, "any"))
455 else if (is_prefix(*argv, "noexist"))
456 *flags = BPF_NOEXIST;
457 else if (is_prefix(*argv, "exist"))
460 return parse_elem(argv + 1, info, key, value, key_size,
461 value_size, NULL, value_fd);
464 p_err("expected key or value, got: %s", *argv);
468 static void show_map_header_json(struct bpf_map_info *info, json_writer_t *wtr)
470 jsonw_uint_field(wtr, "id", info->id);
471 if (info->type < ARRAY_SIZE(map_type_name))
472 jsonw_string_field(wtr, "type", map_type_name[info->type]);
474 jsonw_uint_field(wtr, "type", info->type);
477 jsonw_string_field(wtr, "name", info->name);
479 jsonw_name(wtr, "flags");
480 jsonw_printf(wtr, "%d", info->map_flags);
483 static int show_map_close_json(int fd, struct bpf_map_info *info)
485 char *memlock, *frozen_str;
488 memlock = get_fdinfo(fd, "memlock");
489 frozen_str = get_fdinfo(fd, "frozen");
491 jsonw_start_object(json_wtr);
493 show_map_header_json(info, json_wtr);
495 print_dev_json(info->ifindex, info->netns_dev, info->netns_ino);
497 jsonw_uint_field(json_wtr, "bytes_key", info->key_size);
498 jsonw_uint_field(json_wtr, "bytes_value", info->value_size);
499 jsonw_uint_field(json_wtr, "max_entries", info->max_entries);
502 jsonw_int_field(json_wtr, "bytes_memlock", atoi(memlock));
505 if (info->type == BPF_MAP_TYPE_PROG_ARRAY) {
506 char *owner_prog_type = get_fdinfo(fd, "owner_prog_type");
507 char *owner_jited = get_fdinfo(fd, "owner_jited");
509 if (owner_prog_type) {
510 unsigned int prog_type = atoi(owner_prog_type);
512 if (prog_type < prog_type_name_size)
513 jsonw_string_field(json_wtr, "owner_prog_type",
514 prog_type_name[prog_type]);
516 jsonw_uint_field(json_wtr, "owner_prog_type",
520 jsonw_bool_field(json_wtr, "owner_jited",
521 !!atoi(owner_jited));
523 free(owner_prog_type);
529 frozen = atoi(frozen_str);
532 jsonw_int_field(json_wtr, "frozen", frozen);
535 jsonw_int_field(json_wtr, "btf_id", info->btf_id);
537 if (!hash_empty(map_table.table)) {
538 struct pinned_obj *obj;
540 jsonw_name(json_wtr, "pinned");
541 jsonw_start_array(json_wtr);
542 hash_for_each_possible(map_table.table, obj, hash, info->id) {
543 if (obj->id == info->id)
544 jsonw_string(json_wtr, obj->path);
546 jsonw_end_array(json_wtr);
549 emit_obj_refs_json(&refs_table, info->id, json_wtr);
551 jsonw_end_object(json_wtr);
556 static void show_map_header_plain(struct bpf_map_info *info)
558 printf("%u: ", info->id);
559 if (info->type < ARRAY_SIZE(map_type_name))
560 printf("%s ", map_type_name[info->type]);
562 printf("type %u ", info->type);
565 printf("name %s ", info->name);
567 printf("flags 0x%x", info->map_flags);
568 print_dev_plain(info->ifindex, info->netns_dev, info->netns_ino);
572 static int show_map_close_plain(int fd, struct bpf_map_info *info)
574 char *memlock, *frozen_str;
577 memlock = get_fdinfo(fd, "memlock");
578 frozen_str = get_fdinfo(fd, "frozen");
580 show_map_header_plain(info);
581 printf("\tkey %uB value %uB max_entries %u",
582 info->key_size, info->value_size, info->max_entries);
585 printf(" memlock %sB", memlock);
588 if (info->type == BPF_MAP_TYPE_PROG_ARRAY) {
589 char *owner_prog_type = get_fdinfo(fd, "owner_prog_type");
590 char *owner_jited = get_fdinfo(fd, "owner_jited");
592 if (owner_prog_type || owner_jited)
594 if (owner_prog_type) {
595 unsigned int prog_type = atoi(owner_prog_type);
597 if (prog_type < prog_type_name_size)
598 printf("owner_prog_type %s ",
599 prog_type_name[prog_type]);
601 printf("owner_prog_type %d ", prog_type);
604 printf("owner%s jited",
605 atoi(owner_jited) ? "" : " not");
607 free(owner_prog_type);
612 if (!hash_empty(map_table.table)) {
613 struct pinned_obj *obj;
615 hash_for_each_possible(map_table.table, obj, hash, info->id) {
616 if (obj->id == info->id)
617 printf("\n\tpinned %s", obj->path);
623 frozen = atoi(frozen_str);
627 if (!info->btf_id && !frozen)
633 printf("btf_id %d", info->btf_id);
636 printf("%sfrozen", info->btf_id ? " " : "");
638 emit_obj_refs_plain(&refs_table, info->id, "\n\tpids ");
644 static int do_show_subset(int argc, char **argv)
646 struct bpf_map_info info = {};
647 __u32 len = sizeof(info);
652 fds = malloc(sizeof(int));
654 p_err("mem alloc failed");
657 nb_fds = map_parse_fds(&argc, &argv, &fds);
661 if (json_output && nb_fds > 1)
662 jsonw_start_array(json_wtr); /* root array */
663 for (i = 0; i < nb_fds; i++) {
664 err = bpf_obj_get_info_by_fd(fds[i], &info, &len);
666 p_err("can't get map info: %s",
668 for (; i < nb_fds; i++)
674 show_map_close_json(fds[i], &info);
676 show_map_close_plain(fds[i], &info);
680 if (json_output && nb_fds > 1)
681 jsonw_end_array(json_wtr); /* root array */
688 static int do_show(int argc, char **argv)
690 struct bpf_map_info info = {};
691 __u32 len = sizeof(info);
697 build_pinned_obj_table(&map_table, BPF_OBJ_MAP);
698 build_obj_refs_table(&refs_table, BPF_OBJ_MAP);
701 return do_show_subset(argc, argv);
707 jsonw_start_array(json_wtr);
709 err = bpf_map_get_next_id(id, &id);
713 p_err("can't get next map: %s%s", strerror(errno),
714 errno == EINVAL ? " -- kernel too old?" : "");
718 fd = bpf_map_get_fd_by_id(id);
722 p_err("can't get map by id (%u): %s",
723 id, strerror(errno));
727 err = bpf_obj_get_info_by_fd(fd, &info, &len);
729 p_err("can't get map info: %s", strerror(errno));
735 show_map_close_json(fd, &info);
737 show_map_close_plain(fd, &info);
740 jsonw_end_array(json_wtr);
742 delete_obj_refs_table(&refs_table);
744 return errno == ENOENT ? 0 : -1;
747 static int dump_map_elem(int fd, void *key, void *value,
748 struct bpf_map_info *map_info, struct btf *btf,
749 json_writer_t *btf_wtr)
751 if (bpf_map_lookup_elem(fd, key, value)) {
752 print_entry_error(map_info, key, errno);
757 print_entry_json(map_info, key, value, btf);
759 struct btf_dumper d = {
762 .is_plain_text = true,
765 do_dump_btf(&d, map_info, key, value);
767 print_entry_plain(map_info, key, value);
773 static int maps_have_btf(int *fds, int nb_fds)
775 struct bpf_map_info info = {};
776 __u32 len = sizeof(info);
779 for (i = 0; i < nb_fds; i++) {
780 err = bpf_obj_get_info_by_fd(fds[i], &info, &len);
782 p_err("can't get map info: %s", strerror(errno));
793 static struct btf *btf_vmlinux;
795 static struct btf *get_map_kv_btf(const struct bpf_map_info *info)
797 struct btf *btf = NULL;
799 if (info->btf_vmlinux_value_type_id) {
801 btf_vmlinux = libbpf_find_kernel_btf();
802 if (IS_ERR(btf_vmlinux))
803 p_err("failed to get kernel btf");
806 } else if (info->btf_value_type_id) {
809 err = btf__get_from_id(info->btf_id, &btf);
811 p_err("failed to get btf");
812 btf = err ? ERR_PTR(err) : ERR_PTR(-ESRCH);
819 static void free_map_kv_btf(struct btf *btf)
821 if (!IS_ERR(btf) && btf != btf_vmlinux)
825 static void free_btf_vmlinux(void)
827 if (!IS_ERR(btf_vmlinux))
828 btf__free(btf_vmlinux);
832 map_dump(int fd, struct bpf_map_info *info, json_writer_t *wtr,
835 void *key, *value, *prev_key;
836 unsigned int num_elems = 0;
837 struct btf *btf = NULL;
840 key = malloc(info->key_size);
841 value = alloc_value(info);
842 if (!key || !value) {
843 p_err("mem alloc failed");
851 btf = get_map_kv_btf(info);
858 jsonw_start_object(wtr); /* map object */
859 show_map_header_json(info, wtr);
860 jsonw_name(wtr, "elements");
862 jsonw_start_array(wtr); /* elements */
863 } else if (show_header) {
864 show_map_header_plain(info);
867 if (info->type == BPF_MAP_TYPE_REUSEPORT_SOCKARRAY &&
868 info->value_size != 8)
869 p_info("Warning: cannot read values from %s map with value_size != 8",
870 map_type_name[info->type]);
872 err = bpf_map_get_next_key(fd, prev_key, key);
878 if (!dump_map_elem(fd, key, value, info, btf, wtr))
884 jsonw_end_array(wtr); /* elements */
886 jsonw_end_object(wtr); /* map object */
888 printf("Found %u element%s\n", num_elems,
889 num_elems != 1 ? "s" : "");
896 free_map_kv_btf(btf);
901 static int do_dump(int argc, char **argv)
903 json_writer_t *wtr = NULL, *btf_wtr = NULL;
904 struct bpf_map_info info = {};
906 __u32 len = sizeof(info);
913 fds = malloc(sizeof(int));
915 p_err("mem alloc failed");
918 nb_fds = map_parse_fds(&argc, &argv, &fds);
927 do_plain_btf = maps_have_btf(fds, nb_fds);
928 if (do_plain_btf < 0)
932 btf_wtr = get_btf_writer();
935 p_info("failed to create json writer for btf. falling back to plain output");
939 if (wtr && nb_fds > 1)
940 jsonw_start_array(wtr); /* root array */
941 for (i = 0; i < nb_fds; i++) {
942 if (bpf_obj_get_info_by_fd(fds[i], &info, &len)) {
943 p_err("can't get map info: %s", strerror(errno));
946 err = map_dump(fds[i], &info, wtr, nb_fds > 1);
947 if (!wtr && i != nb_fds - 1)
954 if (wtr && nb_fds > 1)
955 jsonw_end_array(wtr); /* root array */
958 jsonw_destroy(&btf_wtr);
960 for (; i < nb_fds; i++)
968 static int alloc_key_value(struct bpf_map_info *info, void **key, void **value)
973 if (info->key_size) {
974 *key = malloc(info->key_size);
976 p_err("key mem alloc failed");
981 if (info->value_size) {
982 *value = alloc_value(info);
984 p_err("value mem alloc failed");
994 static int do_update(int argc, char **argv)
996 struct bpf_map_info info = {};
997 __u32 len = sizeof(info);
998 __u32 *value_fd = NULL;
999 __u32 flags = BPF_ANY;
1006 fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1010 err = alloc_key_value(&info, &key, &value);
1014 err = parse_elem(argv, &info, key, value, info.key_size,
1015 info.value_size, &flags, &value_fd);
1019 err = bpf_map_update_elem(fd, key, value, flags);
1021 p_err("update failed: %s", strerror(errno));
1032 if (!err && json_output)
1033 jsonw_null(json_wtr);
1037 static void print_key_value(struct bpf_map_info *info, void *key,
1040 json_writer_t *btf_wtr;
1041 struct btf *btf = NULL;
1044 err = btf__get_from_id(info->btf_id, &btf);
1046 p_err("failed to get btf");
1051 print_entry_json(info, key, value, btf);
1053 /* if here json_wtr wouldn't have been initialised,
1054 * so let's create separate writer for btf
1056 btf_wtr = get_btf_writer();
1058 p_info("failed to create json writer for btf. falling back to plain output");
1061 print_entry_plain(info, key, value);
1063 struct btf_dumper d = {
1066 .is_plain_text = true,
1069 do_dump_btf(&d, info, key, value);
1070 jsonw_destroy(&btf_wtr);
1073 print_entry_plain(info, key, value);
1078 static int do_lookup(int argc, char **argv)
1080 struct bpf_map_info info = {};
1081 __u32 len = sizeof(info);
1089 fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1093 err = alloc_key_value(&info, &key, &value);
1097 err = parse_elem(argv, &info, key, NULL, info.key_size, 0, NULL, NULL);
1101 err = bpf_map_lookup_elem(fd, key, value);
1103 if (errno == ENOENT) {
1105 jsonw_null(json_wtr);
1108 fprint_hex(stdout, key, info.key_size, " ");
1109 printf("\n\nNot found\n");
1112 p_err("lookup failed: %s", strerror(errno));
1118 /* here means bpf_map_lookup_elem() succeeded */
1119 print_key_value(&info, key, value);
1129 static int do_getnext(int argc, char **argv)
1131 struct bpf_map_info info = {};
1132 __u32 len = sizeof(info);
1133 void *key, *nextkey;
1140 fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1144 key = malloc(info.key_size);
1145 nextkey = malloc(info.key_size);
1146 if (!key || !nextkey) {
1147 p_err("mem alloc failed");
1153 err = parse_elem(argv, &info, key, NULL, info.key_size, 0,
1162 err = bpf_map_get_next_key(fd, key, nextkey);
1164 p_err("can't get next key: %s", strerror(errno));
1169 jsonw_start_object(json_wtr);
1171 jsonw_name(json_wtr, "key");
1172 print_hex_data_json(key, info.key_size);
1174 jsonw_null_field(json_wtr, "key");
1176 jsonw_name(json_wtr, "next_key");
1177 print_hex_data_json(nextkey, info.key_size);
1178 jsonw_end_object(json_wtr);
1182 fprint_hex(stdout, key, info.key_size, " ");
1185 printf("key: None\n");
1187 printf("next key:\n");
1188 fprint_hex(stdout, nextkey, info.key_size, " ");
1200 static int do_delete(int argc, char **argv)
1202 struct bpf_map_info info = {};
1203 __u32 len = sizeof(info);
1211 fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1215 key = malloc(info.key_size);
1217 p_err("mem alloc failed");
1222 err = parse_elem(argv, &info, key, NULL, info.key_size, 0, NULL, NULL);
1226 err = bpf_map_delete_elem(fd, key);
1228 p_err("delete failed: %s", strerror(errno));
1234 if (!err && json_output)
1235 jsonw_null(json_wtr);
1239 static int do_pin(int argc, char **argv)
1243 err = do_pin_any(argc, argv, map_parse_fd);
1244 if (!err && json_output)
1245 jsonw_null(json_wtr);
1249 static int do_create(int argc, char **argv)
1251 struct bpf_create_map_attr attr = { NULL, };
1252 const char *pinfile;
1257 pinfile = GET_ARG();
1263 if (is_prefix(*argv, "type")) {
1266 if (attr.map_type) {
1267 p_err("map type already specified");
1271 attr.map_type = map_type_from_str(*argv);
1272 if ((int)attr.map_type < 0) {
1273 p_err("unrecognized map type: %s", *argv);
1277 } else if (is_prefix(*argv, "name")) {
1279 attr.name = GET_ARG();
1280 } else if (is_prefix(*argv, "key")) {
1281 if (parse_u32_arg(&argc, &argv, &attr.key_size,
1284 } else if (is_prefix(*argv, "value")) {
1285 if (parse_u32_arg(&argc, &argv, &attr.value_size,
1288 } else if (is_prefix(*argv, "entries")) {
1289 if (parse_u32_arg(&argc, &argv, &attr.max_entries,
1292 } else if (is_prefix(*argv, "flags")) {
1293 if (parse_u32_arg(&argc, &argv, &attr.map_flags,
1296 } else if (is_prefix(*argv, "dev")) {
1299 if (attr.map_ifindex) {
1300 p_err("offload device already specified");
1304 attr.map_ifindex = if_nametoindex(*argv);
1305 if (!attr.map_ifindex) {
1306 p_err("unrecognized netdevice '%s': %s",
1307 *argv, strerror(errno));
1311 } else if (is_prefix(*argv, "inner_map")) {
1312 struct bpf_map_info info = {};
1313 __u32 len = sizeof(info);
1319 inner_map_fd = map_parse_fd_and_info(&argc, &argv,
1321 if (inner_map_fd < 0)
1323 attr.inner_map_fd = inner_map_fd;
1325 p_err("unknown arg %s", *argv);
1331 p_err("map name not specified");
1337 fd = bpf_create_map_xattr(&attr);
1339 p_err("map create failed: %s", strerror(errno));
1343 err = do_pin_fd(fd, pinfile);
1349 jsonw_null(json_wtr);
1352 if (attr.inner_map_fd > 0)
1353 close(attr.inner_map_fd);
1358 static int do_pop_dequeue(int argc, char **argv)
1360 struct bpf_map_info info = {};
1361 __u32 len = sizeof(info);
1369 fd = map_parse_fd_and_info(&argc, &argv, &info, &len);
1373 err = alloc_key_value(&info, &key, &value);
1377 err = bpf_map_lookup_and_delete_elem(fd, key, value);
1379 if (errno == ENOENT) {
1381 jsonw_null(json_wtr);
1383 printf("Error: empty map\n");
1385 p_err("pop failed: %s", strerror(errno));
1391 print_key_value(&info, key, value);
1401 static int do_freeze(int argc, char **argv)
1408 fd = map_parse_fd(&argc, &argv);
1417 err = bpf_map_freeze(fd);
1420 p_err("failed to freeze map: %s", strerror(errno));
1425 jsonw_null(json_wtr);
1430 static int do_help(int argc, char **argv)
1433 jsonw_null(json_wtr);
1438 "Usage: %1$s %2$s { show | list } [MAP]\n"
1439 " %1$s %2$s create FILE type TYPE key KEY_SIZE value VALUE_SIZE \\\n"
1440 " entries MAX_ENTRIES name NAME [flags FLAGS] \\\n"
1441 " [inner_map MAP] [dev NAME]\n"
1442 " %1$s %2$s dump MAP\n"
1443 " %1$s %2$s update MAP [key DATA] [value VALUE] [UPDATE_FLAGS]\n"
1444 " %1$s %2$s lookup MAP [key DATA]\n"
1445 " %1$s %2$s getnext MAP [key DATA]\n"
1446 " %1$s %2$s delete MAP key DATA\n"
1447 " %1$s %2$s pin MAP FILE\n"
1448 " %1$s %2$s event_pipe MAP [cpu N index M]\n"
1449 " %1$s %2$s peek MAP\n"
1450 " %1$s %2$s push MAP value VALUE\n"
1451 " %1$s %2$s pop MAP\n"
1452 " %1$s %2$s enqueue MAP value VALUE\n"
1453 " %1$s %2$s dequeue MAP\n"
1454 " %1$s %2$s freeze MAP\n"
1457 " " HELP_SPEC_MAP "\n"
1458 " DATA := { [hex] BYTES }\n"
1459 " " HELP_SPEC_PROGRAM "\n"
1460 " VALUE := { DATA | MAP | PROG }\n"
1461 " UPDATE_FLAGS := { any | exist | noexist }\n"
1462 " TYPE := { hash | array | prog_array | perf_event_array | percpu_hash |\n"
1463 " percpu_array | stack_trace | cgroup_array | lru_hash |\n"
1464 " lru_percpu_hash | lpm_trie | array_of_maps | hash_of_maps |\n"
1465 " devmap | devmap_hash | sockmap | cpumap | xskmap | sockhash |\n"
1466 " cgroup_storage | reuseport_sockarray | percpu_cgroup_storage |\n"
1467 " queue | stack | sk_storage | struct_ops | ringbuf | inode_storage }\n"
1468 " " HELP_SPEC_OPTIONS "\n"
1470 bin_name, argv[-2]);
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 },
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 },
1496 int do_map(int argc, char **argv)
1498 return cmd_select(cmds, argc, argv, do_help);