~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/tools/bpf/bpftool/Documentation/bpftool-prog.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /tools/bpf/bpftool/Documentation/bpftool-prog.rst (Version linux-6.12-rc7) and /tools/bpf/bpftool/Documentation/bpftool-prog.rst (Version linux-5.6.19)


  1 .. SPDX-License-Identifier: (GPL-2.0-only OR B << 
  2                                                << 
  3 ================                                    1 ================
  4 bpftool-prog                                        2 bpftool-prog
  5 ================                                    3 ================
  6 ----------------------------------------------      4 -------------------------------------------------------------------------------
  7 tool for inspection and simple manipulation of      5 tool for inspection and simple manipulation of eBPF progs
  8 ----------------------------------------------      6 -------------------------------------------------------------------------------
  9                                                     7 
 10 :Manual section: 8                                  8 :Manual section: 8
 11                                                     9 
 12 .. include:: substitutions.rst                 << 
 13                                                << 
 14 SYNOPSIS                                           10 SYNOPSIS
 15 ========                                           11 ========
 16                                                    12 
 17 **bpftool** [*OPTIONS*] **prog** *COMMAND*     !!  13         **bpftool** [*OPTIONS*] **prog** *COMMAND*
 18                                                    14 
 19 *OPTIONS* := { |COMMON_OPTIONS| |              !!  15         *OPTIONS* := { { **-j** | **--json** } [{ **-p** | **--pretty** }] | { **-f** | **--bpffs** } }
 20 { **-f** | **--bpffs** } | { **-m** | **--mapc !!  16 
 21 { **-L** | **--use-loader** } }                !!  17         *COMMANDS* :=
 22                                                !!  18         { **show** | **list** | **dump xlated** | **dump jited** | **pin** | **load**
 23 *COMMANDS* :=                                  !!  19         | **loadall** | **help** }
 24 { **show** | **list** | **dump xlated** | **du << 
 25 **loadall** | **help** }                       << 
 26                                                    20 
 27 PROG COMMANDS                                      21 PROG COMMANDS
 28 =============                                      22 =============
 29                                                    23 
 30 | **bpftool** **prog** { **show** | **list** } !!  24 |       **bpftool** **prog { show | list }** [*PROG*]
 31 | **bpftool** **prog dump xlated** *PROG* [{ * !!  25 |       **bpftool** **prog dump xlated** *PROG* [{**file** *FILE* | **opcodes** | **visual** | **linum**}]
 32 | **bpftool** **prog dump jited**  *PROG* [{ * !!  26 |       **bpftool** **prog dump jited**  *PROG* [{**file** *FILE* | **opcodes** | **linum**}]
 33 | **bpftool** **prog pin** *PROG* *FILE*       !!  27 |       **bpftool** **prog pin** *PROG* *FILE*
 34 | **bpftool** **prog** { **load** | **loadall* !!  28 |       **bpftool** **prog { load | loadall }** *OBJ* *PATH* [**type** *TYPE*] [**map** {**idx** *IDX* | **name** *NAME*} *MAP*] [**dev** *NAME*] [**pinmaps** *MAP_DIR*]
 35 | **bpftool** **prog attach** *PROG* *ATTACH_T !!  29 |       **bpftool** **prog attach** *PROG* *ATTACH_TYPE* [*MAP*]
 36 | **bpftool** **prog detach** *PROG* *ATTACH_T !!  30 |       **bpftool** **prog detach** *PROG* *ATTACH_TYPE* [*MAP*]
 37 | **bpftool** **prog tracelog**                !!  31 |       **bpftool** **prog tracelog**
 38 | **bpftool** **prog run** *PROG* **data_in**  !!  32 |       **bpftool** **prog run** *PROG* **data_in** *FILE* [**data_out** *FILE* [**data_size_out** *L*]] [**ctx_in** *FILE* [**ctx_out** *FILE* [**ctx_size_out** *M*]]] [**repeat** *N*]
 39 | **bpftool** **prog profile** *PROG* [**durat !!  33 |       **bpftool** **prog help**
 40 | **bpftool** **prog help**                    << 
 41 |                                                  34 |
 42 | *MAP* := { **id** *MAP_ID* | **pinned** *FIL !!  35 |       *MAP* := { **id** *MAP_ID* | **pinned** *FILE* }
 43 | *PROG* := { **id** *PROG_ID* | **pinned** *F !!  36 |       *PROG* := { **id** *PROG_ID* | **pinned** *FILE* | **tag** *PROG_TAG* | **name** *PROG_NAME* }
 44 | *TYPE* := {                                  !!  37 |       *TYPE* := {
 45 |     **socket** | **kprobe** | **kretprobe**  !!  38 |               **socket** | **kprobe** | **kretprobe** | **classifier** | **action** |
 46 |     **tracepoint** | **raw_tracepoint** | ** !!  39 |               **tracepoint** | **raw_tracepoint** | **xdp** | **perf_event** | **cgroup/skb** |
 47 |     **cgroup/sock** | **cgroup/dev** | **lwt !!  40 |               **cgroup/sock** | **cgroup/dev** | **lwt_in** | **lwt_out** | **lwt_xmit** |
 48 |     **lwt_seg6local** | **sockops** | **sk_s !!  41 |               **lwt_seg6local** | **sockops** | **sk_skb** | **sk_msg** | **lirc_mode2** |
 49 |     **cgroup/bind4** | **cgroup/bind6** | ** !!  42 |               **cgroup/bind4** | **cgroup/bind6** | **cgroup/post_bind4** | **cgroup/post_bind6** |
 50 |     **cgroup/connect4** | **cgroup/connect6* !!  43 |               **cgroup/connect4** | **cgroup/connect6** | **cgroup/sendmsg4** | **cgroup/sendmsg6** |
 51 |     **cgroup/getpeername4** | **cgroup/getpe !!  44 |               **cgroup/recvmsg4** | **cgroup/recvmsg6** | **cgroup/sysctl** |
 52 |     **cgroup/getsockname4** | **cgroup/getso !!  45 |               **cgroup/getsockopt** | **cgroup/setsockopt**
 53 |     **cgroup/sendmsg4** | **cgroup/sendmsg6* !!  46 |       }
 54 |     **cgroup/recvmsg4** | **cgroup/recvmsg6* !!  47 |       *ATTACH_TYPE* := {
 55 |     **cgroup/getsockopt** | **cgroup/setsock !!  48 |               **msg_verdict** | **stream_verdict** | **stream_parser** | **flow_dissector**
 56 |     **struct_ops** | **fentry** | **fexit**  !!  49 |       }
 57 | }                                            << 
 58 | *ATTACH_TYPE* := {                           << 
 59 |     **sk_msg_verdict** | **sk_skb_verdict**  << 
 60 |     **sk_skb_stream_parser** | **flow_dissec << 
 61 | }                                            << 
 62 | *METRICs* := {                               << 
 63 |     **cycles** | **instructions** | **l1d_lo << 
 64 |     **itlb_misses** | **dtlb_misses**        << 
 65 | }                                            << 
 66                                                    50 
 67                                                    51 
 68 DESCRIPTION                                        52 DESCRIPTION
 69 ===========                                        53 ===========
 70 bpftool prog { show | list } [*PROG*]          !!  54         **bpftool prog { show | list }** [*PROG*]
 71     Show information about loaded programs.  I !!  55                   Show information about loaded programs.  If *PROG* is
 72     information only about given programs, oth !!  56                   specified show information only about given programs,
 73     currently loaded on the system. In case of !!  57                   otherwise list all programs currently loaded on the system.
 74     match several programs which will all be s !!  58                   In case of **tag** or **name**, *PROG* may match several
 75                                                !!  59                   programs which will all be shown.
 76     Output will start with program ID followed !!  60 
 77     named attributes (depending on kernel vers !!  61                   Output will start with program ID followed by program type and
 78                                                !!  62                   zero or more named attributes (depending on kernel version).
 79     Since Linux 5.1 the kernel can collect sta !!  63 
 80     the total time spent running the program,  !!  64                   Since Linux 5.1 the kernel can collect statistics on BPF
 81     run). If available, bpftool shows such sta !!  65                   programs (such as the total time spent running the program,
 82     not collect them by defaults, as it slight !!  66                   and the number of times it was run). If available, bpftool
 83     program run. Activation or deactivation of !!  67                   shows such statistics. However, the kernel does not collect
 84     **kernel.bpf_stats_enabled** sysctl knob.  !!  68                   them by defaults, as it slightly impacts performance on each
 85                                                !!  69                   program run. Activation or deactivation of the feature is
 86     Since Linux 5.8 bpftool is able to discove !!  70                   performed via the **kernel.bpf_stats_enabled** sysctl knob.
 87     that hold open file descriptors (FDs) agai !!  71 
 88     bpftool will automatically emit this infor !!  72         **bpftool prog dump xlated** *PROG* [{ **file** *FILE* | **opcodes** | **visual** | **linum** }]
 89                                                !!  73                   Dump eBPF instructions of the programs from the kernel. By
 90 bpftool prog dump xlated *PROG* [{ file *FILE* !!  74                   default, eBPF will be disassembled and printed to standard
 91     Dump eBPF instructions of the programs fro !!  75                   output in human-readable format. In this case, **opcodes**
 92     will be disassembled and printed to standa !!  76                   controls if raw opcodes should be printed as well.
 93     format. In this case, **opcodes** controls !!  77 
 94     as well.                                   !!  78                   In case of **tag** or **name**, *PROG* may match several
 95                                                !!  79                   programs which will all be dumped.  However, if **file** or
 96     In case of **tag** or **name**, *PROG* may !!  80                   **visual** is specified, *PROG* must match a single program.
 97     will all be dumped.  However, if **file**  !!  81 
 98     *PROG* must match a single program.        !!  82                   If **file** is specified, the binary image will instead be
 99                                                !!  83                   written to *FILE*.
100     If **file** is specified, the binary image !!  84 
101     *FILE*.                                    !!  85                   If **visual** is specified, control flow graph (CFG) will be
102                                                !!  86                   built instead, and eBPF instructions will be presented with
103     If **visual** is specified, control flow g !!  87                   CFG in DOT format, on standard output.
104     and eBPF instructions will be presented wi !!  88 
105     output.                                    !!  89                   If the programs have line_info available, the source line will
106                                                !!  90                   be displayed by default.  If **linum** is specified,
107     If the programs have line_info available,  !!  91                   the filename, line number and line column will also be
108     displayed.  If **linum** is specified, the !!  92                   displayed on top of the source line.
109     column will also be displayed.             !!  93 
110                                                !!  94         **bpftool prog dump jited**  *PROG* [{ **file** *FILE* | **opcodes** | **linum** }]
111 bpftool prog dump jited  *PROG* [{ file *FILE* !!  95                   Dump jited image (host machine code) of the program.
112     Dump jited image (host machine code) of th !!  96 
113                                                !!  97                   If *FILE* is specified image will be written to a file,
114     If *FILE* is specified image will be writt !!  98                   otherwise it will be disassembled and printed to stdout.
115     be disassembled and printed to stdout. *PR !!  99                   *PROG* must match a single program when **file** is specified.
116     when **file** is specified.                !! 100 
117                                                !! 101                   **opcodes** controls if raw opcodes will be printed.
118     **opcodes** controls if raw opcodes will b !! 102 
119                                                !! 103                   If the prog has line_info available, the source line will
120     If the prog has line_info available, the s !! 104                   be displayed by default.  If **linum** is specified,
121     **linum** is specified, the filename, line !! 105                   the filename, line number and line column will also be
122     be displayed.                              !! 106                   displayed on top of the source line.
123                                                !! 107 
124 bpftool prog pin *PROG* *FILE*                 !! 108         **bpftool prog pin** *PROG* *FILE*
125     Pin program *PROG* as *FILE*.              !! 109                   Pin program *PROG* as *FILE*.
126                                                !! 110 
127     Note: *FILE* must be located in *bpffs* mo !! 111                   Note: *FILE* must be located in *bpffs* mount. It must not
128     character ('.'), which is reserved for fut !! 112                   contain a dot character ('.'), which is reserved for future
129                                                !! 113                   extensions of *bpffs*.
130 bpftool prog { load | loadall } *OBJ* *PATH* [ !! 114 
131     Load bpf program(s) from binary *OBJ* and  !! 115         **bpftool prog { load | loadall }** *OBJ* *PATH* [**type** *TYPE*] [**map** {**idx** *IDX* | **name** *NAME*} *MAP*] [**dev** *NAME*] [**pinmaps** *MAP_DIR*]
132     load** pins only the first program from th !! 116                   Load bpf program(s) from binary *OBJ* and pin as *PATH*.
133     loadall** pins all programs from the *OBJ* !! 117                   **bpftool prog load** pins only the first program from the
134     is optional, if not specified program type !! 118                   *OBJ* as *PATH*. **bpftool prog loadall** pins all programs
135     names. By default bpftool will create new  !! 119                   from the *OBJ* under *PATH* directory.
136     object being loaded.  **map** parameter al !! 120                   **type** is optional, if not specified program type will be
137     maps. It can be specified multiple times,  !! 121                   inferred from section names.
138     *IDX* refers to index of the map to be rep !! 122                   By default bpftool will create new maps as declared in the ELF
139     from 0, while *NAME* allows to replace a m !! 123                   object being loaded.  **map** parameter allows for the reuse
140     map to use, referring to it by **id** or t !! 124                   of existing maps.  It can be specified multiple times, each
141     **offload_dev** *NAME* is specified progra !! 125                   time for a different map.  *IDX* refers to index of the map
142     networking device (offload). If **xdpmeta_ !! 126                   to be replaced in the ELF file counting from 0, while *NAME*
143     will become device-bound without offloadin !! 127                   allows to replace a map by name.  *MAP* specifies the map to
144     metadata. Optional **pinmaps** argument ca !! 128                   use, referring to it by **id** or through a **pinned** file.
145     under *MAP_DIR* directory.                 !! 129                   If **dev** *NAME* is specified program will be loaded onto
146                                                !! 130                   given networking device (offload).
147     If **autoattach** is specified program wil !! 131                   Optional **pinmaps** argument can be provided to pin all
148     case, only the link (representing the prog !! 132                   maps under *MAP_DIR* directory.
149     pinned, not the program as such, so the pa !! 133 
150     show -f**, only show in **bpftool link sho !! 134                   Note: *PATH* must be located in *bpffs* mount. It must not
151     when bpftool (libbpf) is able to infer all !! 135                   contain a dot character ('.'), which is reserved for future
152     object file, in particular, it's not suppo !! 136                   extensions of *bpffs*.
153     program does not support autoattach, bpfto !! 137 
154     for that program instead.                  !! 138         **bpftool prog attach** *PROG* *ATTACH_TYPE* [*MAP*]
155                                                !! 139                   Attach bpf program *PROG* (with type specified by
156     Note: *PATH* must be located in *bpffs* mo !! 140                   *ATTACH_TYPE*). Most *ATTACH_TYPEs* require a *MAP*
157     character ('.'), which is reserved for fut !! 141                   parameter, with the exception of *flow_dissector* which is
158                                                !! 142                   attached to current networking name space.
159 bpftool prog attach *PROG* *ATTACH_TYPE* [*MAP !! 143 
160     Attach bpf program *PROG* (with type speci !! 144         **bpftool prog detach** *PROG* *ATTACH_TYPE* [*MAP*]
161     *ATTACH_TYPEs* require a *MAP* parameter,  !! 145                   Detach bpf program *PROG* (with type specified by
162     *flow_dissector* which is attached to curr !! 146                   *ATTACH_TYPE*). Most *ATTACH_TYPEs* require a *MAP*
163                                                !! 147                   parameter, with the exception of *flow_dissector* which is
164 bpftool prog detach *PROG* *ATTACH_TYPE* [*MAP !! 148                   detached from the current networking name space.
165     Detach bpf program *PROG* (with type speci !! 149 
166     *ATTACH_TYPEs* require a *MAP* parameter,  !! 150         **bpftool prog tracelog**
167     *flow_dissector* which is detached from th !! 151                   Dump the trace pipe of the system to the console (stdout).
168                                                !! 152                   Hit <Ctrl+C> to stop printing. BPF programs can write to this
169 bpftool prog tracelog                          !! 153                   trace pipe at runtime with the **bpf_trace_printk()** helper.
170     Dump the trace pipe of the system to the c !! 154                   This should be used only for debugging purposes. For
171     stop printing. BPF programs can write to t !! 155                   streaming data from BPF programs to user space, one can use
172     the **bpf_trace_printk**\ () helper. This  !! 156                   perf events (see also **bpftool-map**\ (8)).
173     purposes. For streaming data from BPF prog !! 157 
174     perf events (see also **bpftool-map**\ (8) !! 158         **bpftool prog run** *PROG* **data_in** *FILE* [**data_out** *FILE* [**data_size_out** *L*]] [**ctx_in** *FILE* [**ctx_out** *FILE* [**ctx_size_out** *M*]]] [**repeat** *N*]
175                                                !! 159                   Run BPF program *PROG* in the kernel testing infrastructure
176 bpftool prog run *PROG* data_in *FILE* [data_o !! 160                   for BPF, meaning that the program works on the data and
177     Run BPF program *PROG* in the kernel testi !! 161                   context provided by the user, and not on actual packets or
178     meaning that the program works on the data !! 162                   monitored functions etc. Return value and duration for the
179     user, and not on actual packets or monitor !! 163                   test run are printed out to the console.
180     and duration for the test run are printed  !! 164 
181                                                !! 165                   Input data is read from the *FILE* passed with **data_in**.
182     Input data is read from the *FILE* passed  !! 166                   If this *FILE* is "**-**", input data is read from standard
183     is "**-**", input data is read from standa !! 167                   input. Input context, if any, is read from *FILE* passed with
184     is read from *FILE* passed with **ctx_in** !! 168                   **ctx_in**. Again, "**-**" can be used to read from standard
185     read from standard input, but only if stan !! 169                   input, but only if standard input is not already in use for
186     for input data. If a *FILE* is passed with !! 170                   input data. If a *FILE* is passed with **data_out**, output
187     written to that file. Similarly, output co !! 171                   data is written to that file. Similarly, output context is
188     passed with **ctx_out**. For both output f !! 172                   written to the *FILE* passed with **ctx_out**. For both
189     print to the standard output (as plain tex !! 173                   output flows, "**-**" can be used to print to the standard
190     passed). If output keywords are omitted, o !! 174                   output (as plain text, or JSON if relevant option was
191     discarded. Keywords **data_size_out** and  !! 175                   passed). If output keywords are omitted, output data and
192     the size (in bytes) for the output buffers !! 176                   context are discarded. Keywords **data_size_out** and
193     default of 32 kB should be more than enoug !! 177                   **ctx_size_out** are used to pass the size (in bytes) for the
194                                                !! 178                   output buffers to the kernel, although the default of 32 kB
195     Keyword **repeat** is used to indicate the !! 179                   should be more than enough for most cases.
196     perform. Note that output data and context !! 180 
197     the last of those runs. The duration print !! 181                   Keyword **repeat** is used to indicate the number of
198     an average over all runs performed by the  !! 182                   consecutive runs to perform. Note that output data and
199                                                !! 183                   context printed to files correspond to the last of those
200     Not all program types support test run. Am !! 184                   runs. The duration printed out at the end of the runs is an
201     them can take the **ctx_in**/**ctx_out** a !! 185                   average over all runs performed by the command.
202     perform checks on program types.           !! 186 
203                                                !! 187                   Not all program types support test run. Among those which do,
204 bpftool prog profile *PROG* [duration *DURATIO !! 188                   not all of them can take the **ctx_in**/**ctx_out**
205     Profile *METRICs* for bpf program *PROG* f !! 189                   arguments. bpftool does not perform checks on program types.
206     user hits <Ctrl+C>. *DURATION* is optional << 
207     the profiling will run up to **UINT_MAX**  << 
208                                                   190 
209 bpftool prog help                              !! 191         **bpftool prog help**
210     Print short help message.                  !! 192                   Print short help message.
211                                                   193 
212 OPTIONS                                           194 OPTIONS
213 =======                                           195 =======
214 .. include:: common_options.rst                !! 196         -h, --help
215                                                !! 197                   Print short generic help message (similar to **bpftool help**).
216 -f, --bpffs                                    << 
217     When showing BPF programs, show file names << 
218                                                   198 
219 -m, --mapcompat                                !! 199         -V, --version
220     Allow loading maps with unknown map defini !! 200                   Print version number (similar to **bpftool version**).
221                                                   201 
222 -n, --nomount                                  !! 202         -j, --json
223     Do not automatically attempt to mount any  !! 203                   Generate JSON output. For commands that cannot produce JSON, this
224     tracefs or BPF virtual file system) when n !! 204                   option has no effect.
225                                                !! 205 
226 -L, --use-loader                               !! 206         -p, --pretty
227     Load program as a "loader" program. This i !! 207                   Generate human-readable JSON output. Implies **-j**.
228     of such programs. When this option is in u !! 208 
229     programs from the object file into the ker !! 209         -f, --bpffs
230     (therefore, the *PATH* must not be provide !! 210                   When showing BPF programs, show file names of pinned
231                                                !! 211                   programs.
232     When combined with the **-d**\ \|\ **--deb !! 212 
233     messages are generated, and the execution  !! 213         -m, --mapcompat
234     the **bpf_trace_printk**\ () helper to log !! 214                   Allow loading maps with unknown map definitions.
235     creating the maps, and loading the program !! 215 
236     as a way to dump those messages).          !! 216         -n, --nomount
                                                   >> 217                   Do not automatically attempt to mount any virtual file system
                                                   >> 218                   (such as tracefs or BPF virtual file system) when necessary.
                                                   >> 219 
                                                   >> 220         -d, --debug
                                                   >> 221                   Print all logs available, even debug-level information. This
                                                   >> 222                   includes logs from libbpf as well as from the verifier, when
                                                   >> 223                   attempting to load programs.
237                                                   224 
238 EXAMPLES                                          225 EXAMPLES
239 ========                                          226 ========
240 **# bpftool prog show**                           227 **# bpftool prog show**
241                                                   228 
242 ::                                                229 ::
243                                                   230 
244     10: xdp  name some_prog  tag 005a3d2123620    231     10: xdp  name some_prog  tag 005a3d2123620c8b  gpl run_time_ns 81632 run_cnt 10
245             loaded_at 2017-09-29T20:11:00+0000    232             loaded_at 2017-09-29T20:11:00+0000  uid 0
246             xlated 528B  jited 370B  memlock 4    233             xlated 528B  jited 370B  memlock 4096B  map_ids 10
247             pids systemd(1)                    << 
248                                                   234 
249 **# bpftool --json --pretty prog show**           235 **# bpftool --json --pretty prog show**
250                                                   236 
251 ::                                                237 ::
252                                                   238 
253     [{                                            239     [{
254             "id": 10,                             240             "id": 10,
255             "type": "xdp",                        241             "type": "xdp",
256             "tag": "005a3d2123620c8b",            242             "tag": "005a3d2123620c8b",
257             "gpl_compatible": true,               243             "gpl_compatible": true,
258             "run_time_ns": 81632,                 244             "run_time_ns": 81632,
259             "run_cnt": 10,                        245             "run_cnt": 10,
260             "loaded_at": 1506715860,              246             "loaded_at": 1506715860,
261             "uid": 0,                             247             "uid": 0,
262             "bytes_xlated": 528,                  248             "bytes_xlated": 528,
263             "jited": true,                        249             "jited": true,
264             "bytes_jited": 370,                   250             "bytes_jited": 370,
265             "bytes_memlock": 4096,                251             "bytes_memlock": 4096,
266             "map_ids": [10                        252             "map_ids": [10
267             ],                                 << 
268             "pids": [{                         << 
269                     "pid": 1,                  << 
270                     "comm": "systemd"          << 
271                 }                              << 
272             ]                                     253             ]
273         }                                         254         }
274     ]                                             255     ]
275                                                   256 
276 |                                                 257 |
277 | **# bpftool prog dump xlated id 10 file /tmp    258 | **# bpftool prog dump xlated id 10 file /tmp/t**
278 | **$ ls -l /tmp/t**                           !! 259 | **# ls -l /tmp/t**
279                                                   260 
280 ::                                                261 ::
281                                                   262 
282     -rw------- 1 root root 560 Jul 22 01:42 /t    263     -rw------- 1 root root 560 Jul 22 01:42 /tmp/t
283                                                   264 
284 **# bpftool prog dump jited tag 005a3d2123620c    265 **# bpftool prog dump jited tag 005a3d2123620c8b**
285                                                   266 
286 ::                                                267 ::
287                                                   268 
288     0:   push   %rbp                              269     0:   push   %rbp
289     1:   mov    %rsp,%rbp                         270     1:   mov    %rsp,%rbp
290     2:   sub    $0x228,%rsp                       271     2:   sub    $0x228,%rsp
291     3:   sub    $0x28,%rbp                        272     3:   sub    $0x28,%rbp
292     4:   mov    %rbx,0x0(%rbp)                    273     4:   mov    %rbx,0x0(%rbp)
293                                                   274 
294 |                                                 275 |
295 | **# mount -t bpf none /sys/fs/bpf/**            276 | **# mount -t bpf none /sys/fs/bpf/**
296 | **# bpftool prog pin id 10 /sys/fs/bpf/prog*    277 | **# bpftool prog pin id 10 /sys/fs/bpf/prog**
297 | **# bpftool prog load ./my_prog.o /sys/fs/bp    278 | **# bpftool prog load ./my_prog.o /sys/fs/bpf/prog2**
298 | **# ls -l /sys/fs/bpf/**                        279 | **# ls -l /sys/fs/bpf/**
299                                                   280 
300 ::                                                281 ::
301                                                   282 
302     -rw------- 1 root root 0 Jul 22 01:43 prog    283     -rw------- 1 root root 0 Jul 22 01:43 prog
303     -rw------- 1 root root 0 Jul 22 01:44 prog    284     -rw------- 1 root root 0 Jul 22 01:44 prog2
304                                                   285 
305 **# bpftool prog dump jited pinned /sys/fs/bpf    286 **# bpftool prog dump jited pinned /sys/fs/bpf/prog opcodes**
306                                                   287 
307 ::                                                288 ::
308                                                   289 
309    0:   push   %rbp                               290    0:   push   %rbp
310         55                                        291         55
311    1:   mov    %rsp,%rbp                          292    1:   mov    %rsp,%rbp
312         48 89 e5                                  293         48 89 e5
313    4:   sub    $0x228,%rsp                        294    4:   sub    $0x228,%rsp
314         48 81 ec 28 02 00 00                      295         48 81 ec 28 02 00 00
315    b:   sub    $0x28,%rbp                         296    b:   sub    $0x28,%rbp
316         48 83 ed 28                               297         48 83 ed 28
317    f:   mov    %rbx,0x0(%rbp)                     298    f:   mov    %rbx,0x0(%rbp)
318         48 89 5d 00                               299         48 89 5d 00
319                                                   300 
320 |                                                 301 |
321 | **# bpftool prog load xdp1_kern.o /sys/fs/bp    302 | **# bpftool prog load xdp1_kern.o /sys/fs/bpf/xdp1 type xdp map name rxcnt id 7**
322 | **# bpftool prog show pinned /sys/fs/bpf/xdp    303 | **# bpftool prog show pinned /sys/fs/bpf/xdp1**
323                                                   304 
324 ::                                                305 ::
325                                                   306 
326     9: xdp  name xdp_prog1  tag 539ec6ce11b52f    307     9: xdp  name xdp_prog1  tag 539ec6ce11b52f98  gpl
327             loaded_at 2018-06-25T16:17:31-0700    308             loaded_at 2018-06-25T16:17:31-0700  uid 0
328             xlated 488B  jited 336B  memlock 4    309             xlated 488B  jited 336B  memlock 4096B  map_ids 7
329                                                   310 
330 **# rm /sys/fs/bpf/xdp1**                         311 **# rm /sys/fs/bpf/xdp1**
331                                                   312 
332 |                                              !! 313 SEE ALSO
333 | **# bpftool prog profile id 337 duration 10  !! 314 ========
334                                                !! 315         **bpf**\ (2),
335 ::                                             !! 316         **bpf-helpers**\ (7),
336                                                !! 317         **bpftool**\ (8),
337          51397 run_cnt                         !! 318         **bpftool-map**\ (8),
338       40176203 cycles                          !! 319         **bpftool-cgroup**\ (8),
339       42518139 instructions    #   1.06 insns  !! 320         **bpftool-feature**\ (8),
340            123 llc_misses      #   2.89 LLC mi !! 321         **bpftool-net**\ (8),
341                                                !! 322         **bpftool-perf**\ (8),
342 |                                              !! 323         **bpftool-btf**\ (8)
343 | Output below is for the trace logs.          << 
344 | Run in separate terminals:                   << 
345 | **# bpftool prog tracelog**                  << 
346 | **# bpftool prog load -L -d file.o**         << 
347                                                << 
348 ::                                             << 
349                                                << 
350     bpftool-620059  [004] d... 2634685.517903: << 
351     bpftool-620059  [004] d... 2634685.517912: << 
352     bpftool-620059  [004] d... 2634685.517997: << 
353     bpftool-620059  [004] d... 2634685.517999: << 
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php