bpftool-iter(8)             System Manager's Manual            bpftool-iter(8)

<?><?><?> (NAME)
       bpftool-iter - <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> BPF
       (<?><?><?><?><?><?><?><?><?><?><?>)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       bpftool [OPTIONS] iter COMMAND

       OPTIONS := { { -j | --json } [{ -p | --pretty }] | { -d | --debug } }

       COMMANDS := { pin | help }

<?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (ITER COMMANDS)
       bpftool iter pin OBJ PATH [map MAP]
       bpftool iter help

       OBJ := /a/file/of/bpf_iter_target.o
       MAP := { id MAP_ID | pinned FILE }


<?><?><?><?><?><?><?> (DESCRIPTION)

       bpftool iter pin OBJ PATH [map MAP]
              <?><?> <?><?><?><?><?><?><?><?><?><?> BPF<?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> (<?><?><?><?><?> tasks<?> bpf_maps <?>
              <?><?><?><?>) <?><?> <?><?> <?><?> <?><?><?><?><?><?> bpf <?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?>
              <?><?> task<?> <?><?> bpf_map <?> <?><?><?><?>) <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> read()
              <?><?><?><?><?><?>.

              <?><?><?><?><?> pin <?><?> <?><?><?><?><?><?><?><?><?><?> bpf
              <?><?> OBJ <?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?> <?><?>
              PATH <?><?><?><?><?> (pin) <?><?><?><?><?><?>.  <?><?><?><?>
              PATH <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> bpffs
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> ('.') <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> bpffs <?><?><?><?> <?><?><?> <?><?><?>.

              <?><?><?><?><?><?><?><?><?><?> bpf <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> MAP <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> bpf <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> bpf <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?>)<?>
              <?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?>.

              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> cat PATH <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> bpf <?><?> <?><?><?><?><?><?>
              <?><?><?>.

       bpftool iter help
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)

       -h, --help
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              (<?><?><?><?><?> bpftool help).

       -V, --version
              <?><?><?> <?><?><?><?><?> <?><?><?><?> bpftool (<?><?><?><?><?>
              bpftool version)<?> <?><?><?><?><?> <?><?><?><?> libbpf <?><?>
              <?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> bpftool
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> LLVM <?><?> libbfd <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> JIT <?><?><?> (bpftool prog dump
              jited) <?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> BPF (<?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> bpftool prog profile
              <?><?> <?><?><?><?><?> pid<?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> BPF <?><?><?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?>) <?><?><?><?><?><?>.

       -j, --json
              <?><?><?><?><?> <?><?><?><?><?> JSON. <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
              JSON <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>.

       -p, --pretty
              <?><?><?><?><?> <?><?><?><?><?> JSON <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?> -j <?><?><?>.

       -d, --debug
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (debug-level). <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> libbpf <?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (verifier) <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       # bpftool iter pin bpf_iter_netlink.o /sys/fs/bpf/my_netlink

          <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> bpf <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> bpf_iter_netlink.o <?> <?><?><?><?><?> <?><?><?><?> (pin) <?><?>
          <?><?> /sys/fs/bpf/my_netlink

       # bpftool iter pin bpf_iter_hashmap.o /sys/fs/bpf/my_hashmap map id 20

          <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> bpf <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> bpf_iter_hashmap.o <?> <?><?><?><?><?> <?><?>
          <?><?><?><?><?> 20<?> <?> <?><?><?><?><?> <?><?><?><?> (pin) <?><?> <?><?> /sys/fs/bpf/my_hashmap

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bpf(2), bpf-helpers(7), bpftool(8), bpftool-btf(8), bpftool-cgroup(8),
       bpftool-feature(8), bpftool-gen(8), bpftool-link(8), bpftool-map(8),
       bpftool-net(8), bpftool-perf(8), bpftool-prog(8),
       bpftool-struct_ops(8), bpftool-token(8)

                                                               bpftool-iter(8)