xref: /linux/tools/bpf/bpftool/Documentation/bpftool-prog.rst (revision 83a37b3292f4aca799b355179ad6fbdd78a08e10)
1================
2bpftool-prog
3================
4-------------------------------------------------------------------------------
5tool for inspection and simple manipulation of eBPF progs
6-------------------------------------------------------------------------------
7
8:Manual section: 8
9
10SYNOPSIS
11========
12
13|	**bpftool** prog show [*PROG*]
14|	**bpftool** prog dump xlated *PROG* [file *FILE*] [opcodes]
15|	**bpftool** prog dump jited  *PROG* [file *FILE*] [opcodes]
16|	**bpftool** prog pin *PROG* *FILE*
17|	**bpftool** prog help
18|
19|	*PROG* := { id *PROG_ID* | pinned *FILE* | tag *PROG_TAG* }
20
21DESCRIPTION
22===========
23	**bpftool prog show** [*PROG*]
24		  Show information about loaded programs.  If *PROG* is
25		  specified show information only about given program, otherwise
26		  list all programs currently loaded on the system.
27
28		  Output will start with program ID followed by program type and
29		  zero or more named attributes (depending on kernel version).
30
31	**bpftool prog dump xlated** *PROG* [**file** *FILE*] [**opcodes**]
32		  Dump eBPF instructions of the program from the kernel.
33		  If *FILE* is specified image will be written to a file,
34		  otherwise it will be disassembled and printed to stdout.
35
36		  **opcodes** controls if raw opcodes will be printed.
37
38	**bpftool prog dump jited**  *PROG* [**file** *FILE*] [**opcodes**]
39		  Dump jited image (host machine code) of the program.
40		  If *FILE* is specified image will be written to a file,
41		  otherwise it will be disassembled and printed to stdout.
42
43		  **opcodes** controls if raw opcodes will be printed.
44
45	**bpftool prog pin** *PROG* *FILE*
46		  Pin program *PROG* as *FILE*.
47
48		  Note: *FILE* must be located in *bpffs* mount.
49
50	**bpftool prog help**
51		  Print short help message.
52
53EXAMPLES
54========
55**# bpftool prog show**
56::
57
58  10: xdp  name some_prog  tag 00:5a:3d:21:23:62:0c:8b
59	loaded_at Sep 29/20:11  uid 0
60	xlated 528B  jited 370B  memlock 4096B  map_ids 10
61
62|
63| **# bpftool prog dump xlated id 10 file /tmp/t**
64| **# ls -l /tmp/t**
65|   -rw------- 1 root root 560 Jul 22 01:42 /tmp/t
66
67|
68| **# bpftool prog dum jited pinned /sys/fs/bpf/prog**
69
70::
71
72    push   %rbp
73    mov    %rsp,%rbp
74    sub    $0x228,%rsp
75    sub    $0x28,%rbp
76    mov    %rbx,0x0(%rbp)
77
78
79
80SEE ALSO
81========
82	**bpftool**\ (8), **bpftool-map**\ (8)
83