tools/bpf/bpftool/Documentation/bpftool-link.rst

Source file repositories/reference/linux-study-clean/tools/bpf/bpftool/Documentation/bpftool-link.rst

File Facts

System
Linux kernel
Corpus path
tools/bpf/bpftool/Documentation/bpftool-link.rst
Extension
.rst
Size
2861 bytes
Lines
108
Domain
Support Tooling And Documentation
Bucket
tools
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

================
bpftool-link
================
-------------------------------------------------------------------------------
tool for inspection and simple manipulation of eBPF links
-------------------------------------------------------------------------------

:Manual section: 8

.. include:: substitutions.rst

SYNOPSIS
========

**bpftool** [*OPTIONS*] **link** *COMMAND*

*OPTIONS* := { |COMMON_OPTIONS| | { **-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*]
    Show information about active links. If *LINK* is specified show
    information only about given link, otherwise list all links currently
    active on the system.

    Output will start with link ID followed by link type and zero or more named
    attributes, some of which depend on type of link.

    Since Linux 5.8 bpftool is able to discover information about processes
    that hold open file descriptors (FDs) against BPF links. On such kernels
    bpftool will automatically emit this information as well.

bpftool link pin *LINK* *FILE*
    Pin link *LINK* as *FILE*.

    Note: *FILE* must be located in *bpffs* mount. It must not contain a dot
    character ('.'), which is reserved for future extensions of *bpffs*.

bpftool link detach *LINK*
    Force-detach link *LINK*. BPF link and its underlying BPF program will stay
    valid, but they will be detached from the respective BPF hook and BPF link
    will transition into a defunct state until last open file descriptor for
    that link is closed.

bpftool link help
    Print short help message.

OPTIONS
=======
    .. include:: common_options.rst

    -f, --bpffs
        When showing BPF links, show file names of pinned links.

    -n, --nomount

Annotation

Implementation Notes