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

<?><?><?> (NAME)
       bpftool-link - <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> bpf

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

       OPTIONS := { { -j | --json } [{ -p | --pretty }] | { -d | --debug } | {
       -f | --bpffs } | { -n | --nomount } }

       COMMANDS := { show | list | pin | help }

<?><?><?><?><?><?><?> <?><?><?><?><?> (LINK COMMANDS)
       bpftool link { show | list } [LINK]
       bpftool link pin LINK FILE
       bpftool link detach LINK
       bpftool link help

       LINK := { id LINK_ID | pinned FILE }


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

       bpftool link { show | list } [LINK]
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?> LINK
              <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>.

              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> (link ID)
              <?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?> <?><?><?> <?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?>.

              <?><?> <?><?><?><?><?><?> 5.8 <?><?> <?><?><?><?>
              <?><?><?><?><?> bpftool <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (FDs) <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> BPF
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?> bpftool <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       bpftool link pin LINK FILE
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> LINK <?><?>
              <?><?><?><?><?> FILE.

              <?><?><?><?>: FILE <?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (mount) <?><?><?><?><?> <?><?> bpffs
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> ('.') <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              bpffs <?><?><?><?> <?><?><?> <?><?><?>.

       bpftool link detach LINK
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> LINK.
              <?><?><?><?><?> BPF <?> <?><?><?><?><?><?> BPF
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
              (hook) <?><?><?><?><?> <?><?> BPF <?><?><?> <?><?><?><?><?><?>
              <?><?> <?> <?><?><?><?><?> BPF <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (defunct) <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.

       bpftool link 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
                 <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
                 <?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?><?> libbpf <?> <?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                 (verifier) <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?>.

          -f, --bpffs
                 <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
                 BPF<?> <?><?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (pinned)
                 <?><?> <?><?><?><?> <?><?><?><?><?><?>.

          -n, --nomount
                 <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
                 <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
                 (mount) <?><?><?> <?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?><?> (<?><?><?><?><?> tracefs <?><?>
                 <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> BPF)
                 <?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       # bpftool link show

          10: cgroup  prog 25
                  cgroup_id 614  attach_type egress
                  pids test_progs(223)

       # bpftool --json --pretty link show

          [{
                  "type": "cgroup",
                  "prog_id": 25,
                  "cgroup_id": 614,
                  "attach_type": "egress",
                  "pids": [{
                          "pid": 223,
                          "comm": "test_progs"
                      }
                  ]
              }
          ]

       # bpftool link pin id 10 /sys/fs/bpf/link
       # ls -l /sys/fs/bpf/


          -rw------- 1 root root 0 Apr 23 21:39 link

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

                                                               bpftool-link(8)