blob: dd43fc98c9824b805b15596dec2b874b5850aa5b [file] [log] [blame]
Greg Kroah-Hartmane2be04c2017-11-01 15:09:13 +01001/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -07002/* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com
3 *
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of version 2 of the GNU General Public
6 * License as published by the Free Software Foundation.
7 */
8#ifndef _UAPI__LINUX_BPF_H__
9#define _UAPI__LINUX_BPF_H__
10
11#include <linux/types.h>
Alexei Starovoitovc15952d2014-10-14 02:08:54 -070012#include <linux/bpf_common.h>
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -070013
14/* Extended instruction set based on top of classic BPF */
15
16/* instruction classes */
17#define BPF_ALU64 0x07 /* alu mode in double word width */
18
19/* ld/ldx fields */
Jesper Dangaard Brouercb5f7332018-01-17 12:05:36 +010020#define BPF_DW 0x18 /* double word (64-bit) */
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -070021#define BPF_XADD 0xc0 /* exclusive add */
22
23/* alu/jmp fields */
24#define BPF_MOV 0xb0 /* mov reg to reg */
25#define BPF_ARSH 0xc0 /* sign extending arithmetic shift right */
26
27/* change endianness of a register */
28#define BPF_END 0xd0 /* flags for endianness conversion: */
29#define BPF_TO_LE 0x00 /* convert to little-endian */
30#define BPF_TO_BE 0x08 /* convert to big-endian */
31#define BPF_FROM_LE BPF_TO_LE
32#define BPF_FROM_BE BPF_TO_BE
33
Daniel Borkmann92b31a92017-08-10 01:39:55 +020034/* jmp encodings */
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -070035#define BPF_JNE 0x50 /* jump != */
Daniel Borkmann92b31a92017-08-10 01:39:55 +020036#define BPF_JLT 0xa0 /* LT is unsigned, '<' */
37#define BPF_JLE 0xb0 /* LE is unsigned, '<=' */
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -070038#define BPF_JSGT 0x60 /* SGT is signed '>', GT in x86 */
39#define BPF_JSGE 0x70 /* SGE is signed '>=', GE in x86 */
Daniel Borkmann92b31a92017-08-10 01:39:55 +020040#define BPF_JSLT 0xc0 /* SLT is signed, '<' */
41#define BPF_JSLE 0xd0 /* SLE is signed, '<=' */
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -070042#define BPF_CALL 0x80 /* function call */
43#define BPF_EXIT 0x90 /* function return */
44
45/* Register numbers */
46enum {
47 BPF_REG_0 = 0,
48 BPF_REG_1,
49 BPF_REG_2,
50 BPF_REG_3,
51 BPF_REG_4,
52 BPF_REG_5,
53 BPF_REG_6,
54 BPF_REG_7,
55 BPF_REG_8,
56 BPF_REG_9,
57 BPF_REG_10,
58 __MAX_BPF_REG,
59};
60
61/* BPF has 10 general purpose 64-bit registers and stack frame. */
62#define MAX_BPF_REG __MAX_BPF_REG
63
64struct bpf_insn {
65 __u8 code; /* opcode */
66 __u8 dst_reg:4; /* dest register */
67 __u8 src_reg:4; /* source register */
68 __s16 off; /* signed offset */
69 __s32 imm; /* signed immediate constant */
70};
71
Daniel Mackb95a5c42017-01-21 17:26:11 +010072/* Key of an a BPF_MAP_TYPE_LPM_TRIE entry */
73struct bpf_lpm_trie_key {
74 __u32 prefixlen; /* up to 32 for AF_INET, 128 for AF_INET6 */
75 __u8 data[0]; /* Arbitrary size */
76};
77
Daniel Borkmannb2197752015-10-29 14:58:09 +010078/* BPF syscall commands, see bpf(2) man-page for details. */
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070079enum bpf_cmd {
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070080 BPF_MAP_CREATE,
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070081 BPF_MAP_LOOKUP_ELEM,
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070082 BPF_MAP_UPDATE_ELEM,
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070083 BPF_MAP_DELETE_ELEM,
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070084 BPF_MAP_GET_NEXT_KEY,
Alexei Starovoitov09756af2014-09-26 00:17:00 -070085 BPF_PROG_LOAD,
Daniel Borkmannb2197752015-10-29 14:58:09 +010086 BPF_OBJ_PIN,
87 BPF_OBJ_GET,
Daniel Mackf4324552016-11-23 16:52:27 +010088 BPF_PROG_ATTACH,
89 BPF_PROG_DETACH,
Alexei Starovoitov1cf1cae2017-03-30 21:45:38 -070090 BPF_PROG_TEST_RUN,
Martin KaFai Lau34ad5582017-06-05 12:15:48 -070091 BPF_PROG_GET_NEXT_ID,
92 BPF_MAP_GET_NEXT_ID,
Martin KaFai Laub16d9aa2017-06-05 12:15:49 -070093 BPF_PROG_GET_FD_BY_ID,
Martin KaFai Laubd5f5f4e2017-06-05 12:15:50 -070094 BPF_MAP_GET_FD_BY_ID,
Martin KaFai Lau1e270972017-06-05 12:15:52 -070095 BPF_OBJ_GET_INFO_BY_FD,
Alexei Starovoitov468e2f62017-10-02 22:50:22 -070096 BPF_PROG_QUERY,
Alexei Starovoitovc4f66992018-03-28 12:05:37 -070097 BPF_RAW_TRACEPOINT_OPEN,
Martin KaFai Lauf56a6532018-04-18 15:56:01 -070098 BPF_BTF_LOAD,
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070099};
100
101enum bpf_map_type {
102 BPF_MAP_TYPE_UNSPEC,
Alexei Starovoitov0f8e4bd2014-11-13 17:36:45 -0800103 BPF_MAP_TYPE_HASH,
Alexei Starovoitov28fbcfa2014-11-13 17:36:46 -0800104 BPF_MAP_TYPE_ARRAY,
Alexei Starovoitov04fd61a2015-05-19 16:59:03 -0700105 BPF_MAP_TYPE_PROG_ARRAY,
Kaixu Xiaea317b22015-08-06 07:02:34 +0000106 BPF_MAP_TYPE_PERF_EVENT_ARRAY,
Alexei Starovoitov824bd0c2016-02-01 22:39:53 -0800107 BPF_MAP_TYPE_PERCPU_HASH,
Alexei Starovoitova10423b2016-02-01 22:39:54 -0800108 BPF_MAP_TYPE_PERCPU_ARRAY,
Alexei Starovoitovd5a3b1f2016-02-17 19:58:58 -0800109 BPF_MAP_TYPE_STACK_TRACE,
Martin KaFai Lau4ed8ec52016-06-30 10:28:43 -0700110 BPF_MAP_TYPE_CGROUP_ARRAY,
Martin KaFai Lau29ba7322016-11-11 10:55:09 -0800111 BPF_MAP_TYPE_LRU_HASH,
Martin KaFai Lau8f844932016-11-11 10:55:10 -0800112 BPF_MAP_TYPE_LRU_PERCPU_HASH,
Daniel Mackb95a5c42017-01-21 17:26:11 +0100113 BPF_MAP_TYPE_LPM_TRIE,
Martin KaFai Lau56f668d2017-03-22 10:00:33 -0700114 BPF_MAP_TYPE_ARRAY_OF_MAPS,
Martin KaFai Laubcc6b1b2017-03-22 10:00:34 -0700115 BPF_MAP_TYPE_HASH_OF_MAPS,
John Fastabend546ac1f2017-07-17 09:28:56 -0700116 BPF_MAP_TYPE_DEVMAP,
John Fastabend174a79f2017-08-15 22:32:47 -0700117 BPF_MAP_TYPE_SOCKMAP,
Jesper Dangaard Brouer6710e112017-10-16 12:19:28 +0200118 BPF_MAP_TYPE_CPUMAP,
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700119};
120
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700121enum bpf_prog_type {
122 BPF_PROG_TYPE_UNSPEC,
Alexei Starovoitovddd872b2014-12-01 15:06:34 -0800123 BPF_PROG_TYPE_SOCKET_FILTER,
Alexei Starovoitov25415172015-03-25 12:49:20 -0700124 BPF_PROG_TYPE_KPROBE,
Daniel Borkmann96be4322015-03-01 12:31:46 +0100125 BPF_PROG_TYPE_SCHED_CLS,
Daniel Borkmann94caee82015-03-20 15:11:11 +0100126 BPF_PROG_TYPE_SCHED_ACT,
Alexei Starovoitov98b5c2c2016-04-06 18:43:25 -0700127 BPF_PROG_TYPE_TRACEPOINT,
Brenden Blanco6a773a12016-07-19 12:16:47 -0700128 BPF_PROG_TYPE_XDP,
Alexei Starovoitov0515e592016-09-01 18:37:22 -0700129 BPF_PROG_TYPE_PERF_EVENT,
Daniel Mack0e336612016-11-23 16:52:25 +0100130 BPF_PROG_TYPE_CGROUP_SKB,
David Ahern610236582016-12-01 08:48:04 -0800131 BPF_PROG_TYPE_CGROUP_SOCK,
Thomas Graf3a0af8f2016-11-30 17:10:10 +0100132 BPF_PROG_TYPE_LWT_IN,
133 BPF_PROG_TYPE_LWT_OUT,
134 BPF_PROG_TYPE_LWT_XMIT,
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700135 BPF_PROG_TYPE_SOCK_OPS,
John Fastabendb005fd12017-08-15 22:31:58 -0700136 BPF_PROG_TYPE_SK_SKB,
Roman Gushchinebc614f2017-11-05 08:15:32 -0500137 BPF_PROG_TYPE_CGROUP_DEVICE,
John Fastabend4f738ad2018-03-18 12:57:10 -0700138 BPF_PROG_TYPE_SK_MSG,
Alexei Starovoitovc4f66992018-03-28 12:05:37 -0700139 BPF_PROG_TYPE_RAW_TRACEPOINT,
Andrey Ignatov4fbac772018-03-30 15:08:02 -0700140 BPF_PROG_TYPE_CGROUP_SOCK_ADDR,
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700141};
142
Daniel Mack0e336612016-11-23 16:52:25 +0100143enum bpf_attach_type {
144 BPF_CGROUP_INET_INGRESS,
145 BPF_CGROUP_INET_EGRESS,
David Ahern610236582016-12-01 08:48:04 -0800146 BPF_CGROUP_INET_SOCK_CREATE,
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700147 BPF_CGROUP_SOCK_OPS,
John Fastabend464bc0f2017-08-28 07:10:04 -0700148 BPF_SK_SKB_STREAM_PARSER,
149 BPF_SK_SKB_STREAM_VERDICT,
Roman Gushchinebc614f2017-11-05 08:15:32 -0500150 BPF_CGROUP_DEVICE,
John Fastabend4f738ad2018-03-18 12:57:10 -0700151 BPF_SK_MSG_VERDICT,
Andrey Ignatov4fbac772018-03-30 15:08:02 -0700152 BPF_CGROUP_INET4_BIND,
153 BPF_CGROUP_INET6_BIND,
Andrey Ignatovd74bad42018-03-30 15:08:05 -0700154 BPF_CGROUP_INET4_CONNECT,
155 BPF_CGROUP_INET6_CONNECT,
Andrey Ignatovaac3fc32018-03-30 15:08:07 -0700156 BPF_CGROUP_INET4_POST_BIND,
157 BPF_CGROUP_INET6_POST_BIND,
Daniel Mack0e336612016-11-23 16:52:25 +0100158 __MAX_BPF_ATTACH_TYPE
159};
160
161#define MAX_BPF_ATTACH_TYPE __MAX_BPF_ATTACH_TYPE
162
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -0700163/* cgroup-bpf attach flags used in BPF_PROG_ATTACH command
164 *
165 * NONE(default): No further bpf programs allowed in the subtree.
166 *
167 * BPF_F_ALLOW_OVERRIDE: If a sub-cgroup installs some bpf program,
168 * the program in this cgroup yields to sub-cgroup program.
169 *
170 * BPF_F_ALLOW_MULTI: If a sub-cgroup installs some bpf program,
171 * that cgroup program gets run in addition to the program in this cgroup.
172 *
173 * Only one program is allowed to be attached to a cgroup with
174 * NONE or BPF_F_ALLOW_OVERRIDE flag.
175 * Attaching another program on top of NONE or BPF_F_ALLOW_OVERRIDE will
176 * release old program and attach the new one. Attach flags has to match.
177 *
178 * Multiple programs are allowed to be attached to a cgroup with
179 * BPF_F_ALLOW_MULTI flag. They are executed in FIFO order
180 * (those that were attached first, run first)
181 * The programs of sub-cgroup are executed first, then programs of
182 * this cgroup and then programs of parent cgroup.
183 * When children program makes decision (like picking TCP CA or sock bind)
184 * parent program has a chance to override it.
185 *
186 * A cgroup with MULTI or OVERRIDE flag allows any attach flags in sub-cgroups.
187 * A cgroup with NONE doesn't allow any programs in sub-cgroups.
188 * Ex1:
189 * cgrp1 (MULTI progs A, B) ->
190 * cgrp2 (OVERRIDE prog C) ->
191 * cgrp3 (MULTI prog D) ->
192 * cgrp4 (OVERRIDE prog E) ->
193 * cgrp5 (NONE prog F)
194 * the event in cgrp5 triggers execution of F,D,A,B in that order.
195 * if prog F is detached, the execution is E,D,A,B
196 * if prog F and D are detached, the execution is E,A,B
197 * if prog F, E and D are detached, the execution is C,A,B
198 *
199 * All eligible programs are executed regardless of return code from
200 * earlier programs.
Alexei Starovoitov7f677632017-02-10 20:28:24 -0800201 */
202#define BPF_F_ALLOW_OVERRIDE (1U << 0)
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -0700203#define BPF_F_ALLOW_MULTI (1U << 1)
Alexei Starovoitov7f677632017-02-10 20:28:24 -0800204
David S. Millere07b98d2017-05-10 11:38:07 -0700205/* If BPF_F_STRICT_ALIGNMENT is used in BPF_PROG_LOAD command, the
206 * verifier will perform strict alignment checking as if the kernel
207 * has been built with CONFIG_EFFICIENT_UNALIGNED_ACCESS not set,
208 * and NET_IP_ALIGN defined to 2.
209 */
210#define BPF_F_STRICT_ALIGNMENT (1U << 0)
211
Alexei Starovoitovcc8b0b92017-12-14 17:55:05 -0800212/* when bpf_ldimm64->src_reg == BPF_PSEUDO_MAP_FD, bpf_ldimm64->imm == fd */
Daniel Borkmannf1a66f82015-03-01 12:31:43 +0100213#define BPF_PSEUDO_MAP_FD 1
214
Alexei Starovoitovcc8b0b92017-12-14 17:55:05 -0800215/* when bpf_call->src_reg == BPF_PSEUDO_CALL, bpf_call->imm == pc-relative
216 * offset to another bpf function
217 */
218#define BPF_PSEUDO_CALL 1
219
Alexei Starovoitov3274f522014-11-13 17:36:44 -0800220/* flags for BPF_MAP_UPDATE_ELEM command */
221#define BPF_ANY 0 /* create new element or update existing */
222#define BPF_NOEXIST 1 /* create new element if it didn't exist */
223#define BPF_EXIST 2 /* update existing element */
224
Martin KaFai Lau96eabe72017-08-18 11:28:00 -0700225/* flags for BPF_MAP_CREATE command */
Alexei Starovoitov6c905982016-03-07 21:57:15 -0800226#define BPF_F_NO_PREALLOC (1U << 0)
Martin KaFai Lau29ba7322016-11-11 10:55:09 -0800227/* Instead of having one common LRU list in the
Martin KaFai Lau8f844932016-11-11 10:55:10 -0800228 * BPF_MAP_TYPE_LRU_[PERCPU_]HASH map, use a percpu LRU list
Martin KaFai Lau29ba7322016-11-11 10:55:09 -0800229 * which can scale and perform better.
230 * Note, the LRU nodes (including free nodes) cannot be moved
231 * across different LRU lists.
232 */
233#define BPF_F_NO_COMMON_LRU (1U << 1)
Martin KaFai Lau96eabe72017-08-18 11:28:00 -0700234/* Specify numa node during map creation */
235#define BPF_F_NUMA_NODE (1U << 2)
Alexei Starovoitov6c905982016-03-07 21:57:15 -0800236
Alexei Starovoitov468e2f62017-10-02 22:50:22 -0700237/* flags for BPF_PROG_QUERY */
238#define BPF_F_QUERY_EFFECTIVE (1U << 0)
239
Martin KaFai Laucb4d2b32017-09-27 14:37:52 -0700240#define BPF_OBJ_NAME_LEN 16U
241
Chenbo Feng6e71b042017-10-18 13:00:22 -0700242/* Flags for accessing BPF object */
243#define BPF_F_RDONLY (1U << 3)
244#define BPF_F_WRONLY (1U << 4)
245
Song Liu615755a2018-03-14 10:23:21 -0700246/* Flag for stack_map, store build_id+offset instead of pointer */
247#define BPF_F_STACK_BUILD_ID (1U << 5)
248
249enum bpf_stack_build_id_status {
250 /* user space need an empty entry to identify end of a trace */
251 BPF_STACK_BUILD_ID_EMPTY = 0,
252 /* with valid build_id and offset */
253 BPF_STACK_BUILD_ID_VALID = 1,
254 /* couldn't get build_id, fallback to ip */
255 BPF_STACK_BUILD_ID_IP = 2,
256};
257
258#define BPF_BUILD_ID_SIZE 20
259struct bpf_stack_build_id {
260 __s32 status;
261 unsigned char build_id[BPF_BUILD_ID_SIZE];
262 union {
263 __u64 offset;
264 __u64 ip;
265 };
266};
267
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700268union bpf_attr {
269 struct { /* anonymous struct used by BPF_MAP_CREATE command */
270 __u32 map_type; /* one of enum bpf_map_type */
271 __u32 key_size; /* size of key in bytes */
272 __u32 value_size; /* size of value in bytes */
273 __u32 max_entries; /* max number of entries in a map */
Martin KaFai Lau96eabe72017-08-18 11:28:00 -0700274 __u32 map_flags; /* BPF_MAP_CREATE related
275 * flags defined above.
276 */
Martin KaFai Lau56f668d2017-03-22 10:00:33 -0700277 __u32 inner_map_fd; /* fd pointing to the inner map */
Martin KaFai Lau96eabe72017-08-18 11:28:00 -0700278 __u32 numa_node; /* numa node (effective only if
279 * BPF_F_NUMA_NODE is set).
280 */
Martin KaFai Lau067cae42017-10-05 21:52:12 -0700281 char map_name[BPF_OBJ_NAME_LEN];
Jakub Kicinskia3884572018-01-11 20:29:09 -0800282 __u32 map_ifindex; /* ifindex of netdev to create on */
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700283 __u32 btf_fd; /* fd pointing to a BTF type data */
284 __u32 btf_key_id; /* BTF type_id of the key */
285 __u32 btf_value_id; /* BTF type_id of the value */
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700286 };
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -0700287
288 struct { /* anonymous struct used by BPF_MAP_*_ELEM commands */
289 __u32 map_fd;
290 __aligned_u64 key;
291 union {
292 __aligned_u64 value;
293 __aligned_u64 next_key;
294 };
Alexei Starovoitov3274f522014-11-13 17:36:44 -0800295 __u64 flags;
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -0700296 };
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700297
298 struct { /* anonymous struct used by BPF_PROG_LOAD command */
299 __u32 prog_type; /* one of enum bpf_prog_type */
300 __u32 insn_cnt;
301 __aligned_u64 insns;
302 __aligned_u64 license;
Alexei Starovoitovcbd35702014-09-26 00:17:03 -0700303 __u32 log_level; /* verbosity level of verifier */
304 __u32 log_size; /* size of user buffer */
305 __aligned_u64 log_buf; /* user supplied buffer */
Alexei Starovoitov25415172015-03-25 12:49:20 -0700306 __u32 kern_version; /* checked when prog_type=kprobe */
David S. Millere07b98d2017-05-10 11:38:07 -0700307 __u32 prog_flags;
Martin KaFai Lau067cae42017-10-05 21:52:12 -0700308 char prog_name[BPF_OBJ_NAME_LEN];
Jakub Kicinski1f6f4cb2017-11-20 15:21:53 -0800309 __u32 prog_ifindex; /* ifindex of netdev to prep for */
Andrey Ignatov5e43f892018-03-30 15:08:00 -0700310 /* For some prog types expected attach type must be known at
311 * load time to verify attach type specific parts of prog
312 * (context accesses, allowed helpers, etc).
313 */
314 __u32 expected_attach_type;
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700315 };
Daniel Borkmannb2197752015-10-29 14:58:09 +0100316
317 struct { /* anonymous struct used by BPF_OBJ_* commands */
318 __aligned_u64 pathname;
319 __u32 bpf_fd;
Chenbo Feng6e71b042017-10-18 13:00:22 -0700320 __u32 file_flags;
Daniel Borkmannb2197752015-10-29 14:58:09 +0100321 };
Daniel Mackf4324552016-11-23 16:52:27 +0100322
323 struct { /* anonymous struct used by BPF_PROG_ATTACH/DETACH commands */
324 __u32 target_fd; /* container object to attach to */
325 __u32 attach_bpf_fd; /* eBPF program to attach */
326 __u32 attach_type;
Alexei Starovoitov7f677632017-02-10 20:28:24 -0800327 __u32 attach_flags;
Daniel Mackf4324552016-11-23 16:52:27 +0100328 };
Alexei Starovoitov1cf1cae2017-03-30 21:45:38 -0700329
330 struct { /* anonymous struct used by BPF_PROG_TEST_RUN command */
331 __u32 prog_fd;
332 __u32 retval;
333 __u32 data_size_in;
334 __u32 data_size_out;
335 __aligned_u64 data_in;
336 __aligned_u64 data_out;
337 __u32 repeat;
338 __u32 duration;
339 } test;
Martin KaFai Lau34ad5582017-06-05 12:15:48 -0700340
Martin KaFai Laub16d9aa2017-06-05 12:15:49 -0700341 struct { /* anonymous struct used by BPF_*_GET_*_ID */
342 union {
343 __u32 start_id;
344 __u32 prog_id;
Martin KaFai Laubd5f5f4e2017-06-05 12:15:50 -0700345 __u32 map_id;
Martin KaFai Laub16d9aa2017-06-05 12:15:49 -0700346 };
Martin KaFai Lau34ad5582017-06-05 12:15:48 -0700347 __u32 next_id;
Chenbo Feng6e71b042017-10-18 13:00:22 -0700348 __u32 open_flags;
Martin KaFai Lau34ad5582017-06-05 12:15:48 -0700349 };
Martin KaFai Lau1e270972017-06-05 12:15:52 -0700350
351 struct { /* anonymous struct used by BPF_OBJ_GET_INFO_BY_FD */
352 __u32 bpf_fd;
353 __u32 info_len;
354 __aligned_u64 info;
355 } info;
Alexei Starovoitov468e2f62017-10-02 22:50:22 -0700356
357 struct { /* anonymous struct used by BPF_PROG_QUERY command */
358 __u32 target_fd; /* container object to query */
359 __u32 attach_type;
360 __u32 query_flags;
361 __u32 attach_flags;
362 __aligned_u64 prog_ids;
363 __u32 prog_cnt;
364 } query;
Alexei Starovoitovc4f66992018-03-28 12:05:37 -0700365
366 struct {
367 __u64 name;
368 __u32 prog_fd;
369 } raw_tracepoint;
Martin KaFai Lauf56a6532018-04-18 15:56:01 -0700370
371 struct { /* anonymous struct for BPF_BTF_LOAD */
372 __aligned_u64 btf;
373 __aligned_u64 btf_log_buf;
374 __u32 btf_size;
375 __u32 btf_log_size;
376 __u32 btf_log_level;
377 };
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700378} __attribute__((aligned(8)));
379
Quentin Monnet56a092c2018-04-25 18:16:52 +0100380/* The description below is an attempt at providing documentation to eBPF
381 * developers about the multiple available eBPF helper functions. It can be
382 * parsed and used to produce a manual page. The workflow is the following,
383 * and requires the rst2man utility:
Thomas Grafebb676d2016-10-27 11:23:51 +0200384 *
Quentin Monnet56a092c2018-04-25 18:16:52 +0100385 * $ ./scripts/bpf_helpers_doc.py \
386 * --filename include/uapi/linux/bpf.h > /tmp/bpf-helpers.rst
387 * $ rst2man /tmp/bpf-helpers.rst > /tmp/bpf-helpers.7
388 * $ man /tmp/bpf-helpers.7
Thomas Grafebb676d2016-10-27 11:23:51 +0200389 *
Quentin Monnet56a092c2018-04-25 18:16:52 +0100390 * Note that in order to produce this external documentation, some RST
391 * formatting is used in the descriptions to get "bold" and "italics" in
392 * manual pages. Also note that the few trailing white spaces are
393 * intentional, removing them would break paragraphs for rst2man.
Thomas Grafebb676d2016-10-27 11:23:51 +0200394 *
Quentin Monnet56a092c2018-04-25 18:16:52 +0100395 * Start of BPF helper function descriptions:
Thomas Grafebb676d2016-10-27 11:23:51 +0200396 */
397#define __BPF_FUNC_MAPPER(FN) \
398 FN(unspec), \
399 FN(map_lookup_elem), \
400 FN(map_update_elem), \
401 FN(map_delete_elem), \
402 FN(probe_read), \
403 FN(ktime_get_ns), \
404 FN(trace_printk), \
405 FN(get_prandom_u32), \
406 FN(get_smp_processor_id), \
407 FN(skb_store_bytes), \
408 FN(l3_csum_replace), \
409 FN(l4_csum_replace), \
410 FN(tail_call), \
411 FN(clone_redirect), \
412 FN(get_current_pid_tgid), \
413 FN(get_current_uid_gid), \
414 FN(get_current_comm), \
415 FN(get_cgroup_classid), \
416 FN(skb_vlan_push), \
417 FN(skb_vlan_pop), \
418 FN(skb_get_tunnel_key), \
419 FN(skb_set_tunnel_key), \
420 FN(perf_event_read), \
421 FN(redirect), \
422 FN(get_route_realm), \
423 FN(perf_event_output), \
424 FN(skb_load_bytes), \
425 FN(get_stackid), \
426 FN(csum_diff), \
427 FN(skb_get_tunnel_opt), \
428 FN(skb_set_tunnel_opt), \
429 FN(skb_change_proto), \
430 FN(skb_change_type), \
431 FN(skb_under_cgroup), \
432 FN(get_hash_recalc), \
433 FN(get_current_task), \
434 FN(probe_write_user), \
435 FN(current_task_under_cgroup), \
436 FN(skb_change_tail), \
437 FN(skb_pull_data), \
438 FN(csum_update), \
439 FN(set_hash_invalid), \
Thomas Graf3a0af8f2016-11-30 17:10:10 +0100440 FN(get_numa_node_id), \
Martin KaFai Lau17bedab2016-12-07 15:53:11 -0800441 FN(skb_change_head), \
Gianluca Borelloa5e8c072017-01-18 17:55:49 +0000442 FN(xdp_adjust_head), \
Chenbo Feng91b82702017-03-22 17:27:34 -0700443 FN(probe_read_str), \
Chenbo Feng6acc5c22017-03-22 17:27:35 -0700444 FN(get_socket_cookie), \
Daniel Borkmannded092c2017-06-11 00:50:47 +0200445 FN(get_socket_uid), \
Lawrence Brakmo8c4b4c72017-06-30 20:02:46 -0700446 FN(set_hash), \
Daniel Borkmann2be7e212017-07-02 02:13:26 +0200447 FN(setsockopt), \
John Fastabend97f91a72017-07-17 09:29:18 -0700448 FN(skb_adjust_room), \
John Fastabend174a79f2017-08-15 22:32:47 -0700449 FN(redirect_map), \
450 FN(sk_redirect_map), \
451 FN(sock_map_update), \
Yonghong Song908432c2017-10-05 09:19:20 -0700452 FN(xdp_adjust_meta), \
Yonghong Song4bebdc72017-10-05 09:19:22 -0700453 FN(perf_event_read_value), \
Lawrence Brakmocd86d1f2017-10-20 11:05:40 -0700454 FN(perf_prog_read_value), \
Josef Bacik9802d862017-12-11 11:36:48 -0500455 FN(getsockopt), \
Lawrence Brakmob13d8802018-01-25 16:14:10 -0800456 FN(override_return), \
John Fastabend4f738ad2018-03-18 12:57:10 -0700457 FN(sock_ops_cb_flags_set), \
John Fastabend2a100312018-03-18 12:57:15 -0700458 FN(msg_redirect_map), \
John Fastabend91843d52018-03-18 12:57:20 -0700459 FN(msg_apply_bytes), \
John Fastabend015632b2018-03-18 12:57:25 -0700460 FN(msg_cork_bytes), \
Andrey Ignatovd74bad42018-03-30 15:08:05 -0700461 FN(msg_pull_data), \
Nikita V. Shirokovb32cc5b2018-04-17 21:42:13 -0700462 FN(bind), \
Eyal Birger12bed762018-04-24 17:50:29 +0300463 FN(xdp_adjust_tail), \
464 FN(skb_get_xfrm_state),
Thomas Grafebb676d2016-10-27 11:23:51 +0200465
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700466/* integer value in 'imm' field of BPF_CALL instruction selects which helper
467 * function eBPF program intends to call
468 */
Thomas Grafebb676d2016-10-27 11:23:51 +0200469#define __BPF_ENUM_FN(x) BPF_FUNC_ ## x
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700470enum bpf_func_id {
Thomas Grafebb676d2016-10-27 11:23:51 +0200471 __BPF_FUNC_MAPPER(__BPF_ENUM_FN)
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700472 __BPF_FUNC_MAX_ID,
473};
Thomas Grafebb676d2016-10-27 11:23:51 +0200474#undef __BPF_ENUM_FN
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700475
Daniel Borkmann781c53b2016-01-11 01:16:38 +0100476/* All flags used by eBPF helper functions, placed here. */
477
478/* BPF_FUNC_skb_store_bytes flags. */
479#define BPF_F_RECOMPUTE_CSUM (1ULL << 0)
Daniel Borkmann8afd54c2016-03-04 15:15:03 +0100480#define BPF_F_INVALIDATE_HASH (1ULL << 1)
Daniel Borkmann781c53b2016-01-11 01:16:38 +0100481
482/* BPF_FUNC_l3_csum_replace and BPF_FUNC_l4_csum_replace flags.
483 * First 4 bits are for passing the header field size.
484 */
485#define BPF_F_HDR_FIELD_MASK 0xfULL
486
487/* BPF_FUNC_l4_csum_replace flags. */
488#define BPF_F_PSEUDO_HDR (1ULL << 4)
Daniel Borkmann2f729592016-02-19 23:05:26 +0100489#define BPF_F_MARK_MANGLED_0 (1ULL << 5)
Daniel Borkmannd1b662a2017-01-24 01:06:28 +0100490#define BPF_F_MARK_ENFORCE (1ULL << 6)
Daniel Borkmann781c53b2016-01-11 01:16:38 +0100491
492/* BPF_FUNC_clone_redirect and BPF_FUNC_redirect flags. */
493#define BPF_F_INGRESS (1ULL << 0)
494
Daniel Borkmannc6c33452016-01-11 01:16:39 +0100495/* BPF_FUNC_skb_set_tunnel_key and BPF_FUNC_skb_get_tunnel_key flags. */
496#define BPF_F_TUNINFO_IPV6 (1ULL << 0)
497
Alexei Starovoitovd5a3b1f2016-02-17 19:58:58 -0800498/* BPF_FUNC_get_stackid flags. */
499#define BPF_F_SKIP_FIELD_MASK 0xffULL
500#define BPF_F_USER_STACK (1ULL << 8)
501#define BPF_F_FAST_STACK_CMP (1ULL << 9)
502#define BPF_F_REUSE_STACKID (1ULL << 10)
503
Daniel Borkmann2da897e2016-02-23 02:05:26 +0100504/* BPF_FUNC_skb_set_tunnel_key flags. */
505#define BPF_F_ZERO_CSUM_TX (1ULL << 1)
Daniel Borkmann22080872016-03-04 15:15:05 +0100506#define BPF_F_DONT_FRAGMENT (1ULL << 2)
William Tu77a51962018-03-01 13:49:57 -0800507#define BPF_F_SEQ_NUMBER (1ULL << 3)
Daniel Borkmann2da897e2016-02-23 02:05:26 +0100508
Yonghong Song908432c2017-10-05 09:19:20 -0700509/* BPF_FUNC_perf_event_output, BPF_FUNC_perf_event_read and
510 * BPF_FUNC_perf_event_read_value flags.
511 */
Daniel Borkmann1e337592016-04-18 21:01:23 +0200512#define BPF_F_INDEX_MASK 0xffffffffULL
513#define BPF_F_CURRENT_CPU BPF_F_INDEX_MASK
Daniel Borkmann555c8a82016-07-14 18:08:05 +0200514/* BPF_FUNC_perf_event_output for sk_buff input context. */
515#define BPF_F_CTXLEN_MASK (0xfffffULL << 32)
Daniel Borkmann1e337592016-04-18 21:01:23 +0200516
Daniel Borkmann2be7e212017-07-02 02:13:26 +0200517/* Mode for BPF_FUNC_skb_adjust_room helper. */
518enum bpf_adj_room_mode {
519 BPF_ADJ_ROOM_NET,
520};
521
Alexei Starovoitov9bac3d62015-03-13 11:57:42 -0700522/* user accessible mirror of in-kernel sk_buff.
523 * new fields can only be added to the end of this structure
524 */
525struct __sk_buff {
526 __u32 len;
527 __u32 pkt_type;
528 __u32 mark;
529 __u32 queue_mapping;
Alexei Starovoitovc2497392015-03-16 18:06:02 -0700530 __u32 protocol;
531 __u32 vlan_present;
532 __u32 vlan_tci;
Michal Sekletar27cd5452015-03-24 14:48:41 +0100533 __u32 vlan_proto;
Daniel Borkmannbcad5712015-04-03 20:52:24 +0200534 __u32 priority;
Alexei Starovoitov37e82c22015-05-27 15:30:39 -0700535 __u32 ingress_ifindex;
536 __u32 ifindex;
Alexei Starovoitovd691f9e2015-06-04 10:11:54 -0700537 __u32 tc_index;
538 __u32 cb[5];
Daniel Borkmannba7591d2015-08-01 00:46:29 +0200539 __u32 hash;
Daniel Borkmann045efa82015-09-15 23:05:42 -0700540 __u32 tc_classid;
Alexei Starovoitov969bf052016-05-05 19:49:10 -0700541 __u32 data;
542 __u32 data_end;
Daniel Borkmannb1d9fc42017-04-19 23:01:17 +0200543 __u32 napi_id;
John Fastabend8a31db52017-08-15 22:33:09 -0700544
Daniel Borkmannde8f3a82017-09-25 02:25:51 +0200545 /* Accessed by BPF_PROG_TYPE_sk_skb types from here to ... */
John Fastabend8a31db52017-08-15 22:33:09 -0700546 __u32 family;
547 __u32 remote_ip4; /* Stored in network byte order */
548 __u32 local_ip4; /* Stored in network byte order */
549 __u32 remote_ip6[4]; /* Stored in network byte order */
550 __u32 local_ip6[4]; /* Stored in network byte order */
551 __u32 remote_port; /* Stored in network byte order */
552 __u32 local_port; /* stored in host byte order */
Daniel Borkmannde8f3a82017-09-25 02:25:51 +0200553 /* ... here. */
554
555 __u32 data_meta;
Alexei Starovoitov9bac3d62015-03-13 11:57:42 -0700556};
557
Alexei Starovoitovd3aa45c2015-07-30 15:36:57 -0700558struct bpf_tunnel_key {
559 __u32 tunnel_id;
Daniel Borkmannc6c33452016-01-11 01:16:39 +0100560 union {
561 __u32 remote_ipv4;
562 __u32 remote_ipv6[4];
563 };
564 __u8 tunnel_tos;
565 __u8 tunnel_ttl;
Daniel Borkmannc0e760c2016-03-30 00:02:00 +0200566 __u16 tunnel_ext;
Daniel Borkmann4018ab12016-03-09 03:00:05 +0100567 __u32 tunnel_label;
Alexei Starovoitovd3aa45c2015-07-30 15:36:57 -0700568};
569
Eyal Birger12bed762018-04-24 17:50:29 +0300570/* user accessible mirror of in-kernel xfrm_state.
571 * new fields can only be added to the end of this structure
572 */
573struct bpf_xfrm_state {
574 __u32 reqid;
575 __u32 spi; /* Stored in network byte order */
576 __u16 family;
577 union {
578 __u32 remote_ipv4; /* Stored in network byte order */
579 __u32 remote_ipv6[4]; /* Stored in network byte order */
580 };
581};
582
Thomas Graf3a0af8f2016-11-30 17:10:10 +0100583/* Generic BPF return codes which all BPF program types may support.
584 * The values are binary compatible with their TC_ACT_* counter-part to
585 * provide backwards compatibility with existing SCHED_CLS and SCHED_ACT
586 * programs.
587 *
588 * XDP is handled seprately, see XDP_*.
589 */
590enum bpf_ret_code {
591 BPF_OK = 0,
592 /* 1 reserved */
593 BPF_DROP = 2,
594 /* 3-6 reserved */
595 BPF_REDIRECT = 7,
596 /* >127 are reserved for prog type specific return codes */
597};
598
David Ahern610236582016-12-01 08:48:04 -0800599struct bpf_sock {
600 __u32 bound_dev_if;
David Ahernaa4c1032016-12-01 08:48:06 -0800601 __u32 family;
602 __u32 type;
603 __u32 protocol;
David Ahern482dca92017-08-31 15:05:44 -0700604 __u32 mark;
605 __u32 priority;
Andrey Ignatovaac3fc32018-03-30 15:08:07 -0700606 __u32 src_ip4; /* Allows 1,2,4-byte read.
607 * Stored in network byte order.
608 */
609 __u32 src_ip6[4]; /* Allows 1,2,4-byte read.
610 * Stored in network byte order.
611 */
612 __u32 src_port; /* Allows 4-byte read.
613 * Stored in host byte order
614 */
David Ahern610236582016-12-01 08:48:04 -0800615};
616
Martin KaFai Lau17bedab2016-12-07 15:53:11 -0800617#define XDP_PACKET_HEADROOM 256
618
Brenden Blanco6a773a12016-07-19 12:16:47 -0700619/* User return codes for XDP prog type.
620 * A valid XDP program must return one of these defined values. All other
Daniel Borkmann9beb8be2017-09-09 01:40:35 +0200621 * return codes are reserved for future use. Unknown return codes will
622 * result in packet drops and a warning via bpf_warn_invalid_xdp_action().
Brenden Blanco6a773a12016-07-19 12:16:47 -0700623 */
624enum xdp_action {
625 XDP_ABORTED = 0,
626 XDP_DROP,
627 XDP_PASS,
Brenden Blanco6ce96ca2016-07-19 12:16:53 -0700628 XDP_TX,
John Fastabend814abfa2017-07-17 09:27:07 -0700629 XDP_REDIRECT,
Brenden Blanco6a773a12016-07-19 12:16:47 -0700630};
631
632/* user accessible metadata for XDP packet hook
633 * new fields must be added to the end of this structure
634 */
635struct xdp_md {
636 __u32 data;
637 __u32 data_end;
Daniel Borkmannde8f3a82017-09-25 02:25:51 +0200638 __u32 data_meta;
Jesper Dangaard Brouerdaaf24c2018-01-11 17:39:09 +0100639 /* Below access go through struct xdp_rxq_info */
Jesper Dangaard Brouer02dd3292018-01-03 11:26:14 +0100640 __u32 ingress_ifindex; /* rxq->dev->ifindex */
641 __u32 rx_queue_index; /* rxq->queue_index */
Brenden Blanco6a773a12016-07-19 12:16:47 -0700642};
643
John Fastabend174a79f2017-08-15 22:32:47 -0700644enum sk_action {
John Fastabendbfa640752017-10-27 09:45:53 -0700645 SK_DROP = 0,
646 SK_PASS,
John Fastabend174a79f2017-08-15 22:32:47 -0700647};
648
John Fastabend4f738ad2018-03-18 12:57:10 -0700649/* user accessible metadata for SK_MSG packet hook, new fields must
650 * be added to the end of this structure
651 */
652struct sk_msg_md {
653 void *data;
654 void *data_end;
655};
656
Martin KaFai Lau1e270972017-06-05 12:15:52 -0700657#define BPF_TAG_SIZE 8
658
659struct bpf_prog_info {
660 __u32 type;
661 __u32 id;
662 __u8 tag[BPF_TAG_SIZE];
663 __u32 jited_prog_len;
664 __u32 xlated_prog_len;
665 __aligned_u64 jited_prog_insns;
666 __aligned_u64 xlated_prog_insns;
Martin KaFai Laucb4d2b32017-09-27 14:37:52 -0700667 __u64 load_time; /* ns since boottime */
668 __u32 created_by_uid;
669 __u32 nr_map_ids;
670 __aligned_u64 map_ids;
Martin KaFai Lau067cae42017-10-05 21:52:12 -0700671 char name[BPF_OBJ_NAME_LEN];
Jakub Kicinski675fc272017-12-27 18:39:09 -0800672 __u32 ifindex;
Jiri Olsab85fab02018-04-25 19:41:06 +0200673 __u32 gpl_compatible:1;
Jakub Kicinski675fc272017-12-27 18:39:09 -0800674 __u64 netns_dev;
675 __u64 netns_ino;
Martin KaFai Lau1e270972017-06-05 12:15:52 -0700676} __attribute__((aligned(8)));
677
678struct bpf_map_info {
679 __u32 type;
680 __u32 id;
681 __u32 key_size;
682 __u32 value_size;
683 __u32 max_entries;
684 __u32 map_flags;
Martin KaFai Lau067cae42017-10-05 21:52:12 -0700685 char name[BPF_OBJ_NAME_LEN];
Jakub Kicinski52775b32018-01-17 19:13:28 -0800686 __u32 ifindex;
687 __u64 netns_dev;
688 __u64 netns_ino;
Martin KaFai Lau1e270972017-06-05 12:15:52 -0700689} __attribute__((aligned(8)));
690
Andrey Ignatov4fbac772018-03-30 15:08:02 -0700691/* User bpf_sock_addr struct to access socket fields and sockaddr struct passed
692 * by user and intended to be used by socket (e.g. to bind to, depends on
693 * attach attach type).
694 */
695struct bpf_sock_addr {
696 __u32 user_family; /* Allows 4-byte read, but no write. */
697 __u32 user_ip4; /* Allows 1,2,4-byte read and 4-byte write.
698 * Stored in network byte order.
699 */
700 __u32 user_ip6[4]; /* Allows 1,2,4-byte read an 4-byte write.
701 * Stored in network byte order.
702 */
703 __u32 user_port; /* Allows 4-byte read and write.
704 * Stored in network byte order
705 */
706 __u32 family; /* Allows 4-byte read, but no write */
707 __u32 type; /* Allows 4-byte read, but no write */
708 __u32 protocol; /* Allows 4-byte read, but no write */
709};
710
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700711/* User bpf_sock_ops struct to access socket values and specify request ops
712 * and their replies.
713 * Some of this fields are in network (bigendian) byte order and may need
714 * to be converted before use (bpf_ntohl() defined in samples/bpf/bpf_endian.h).
715 * New fields can only be added at the end of this structure
716 */
717struct bpf_sock_ops {
718 __u32 op;
719 union {
Lawrence Brakmode525be2018-01-25 16:14:09 -0800720 __u32 args[4]; /* Optionally passed to bpf program */
721 __u32 reply; /* Returned by bpf program */
722 __u32 replylong[4]; /* Optionally returned by bpf prog */
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700723 };
724 __u32 family;
725 __u32 remote_ip4; /* Stored in network byte order */
726 __u32 local_ip4; /* Stored in network byte order */
727 __u32 remote_ip6[4]; /* Stored in network byte order */
728 __u32 local_ip6[4]; /* Stored in network byte order */
729 __u32 remote_port; /* Stored in network byte order */
730 __u32 local_port; /* stored in host byte order */
Lawrence Brakmof19397a2017-12-01 10:15:04 -0800731 __u32 is_fullsock; /* Some TCP fields are only valid if
732 * there is a full socket. If not, the
733 * fields read as zero.
734 */
735 __u32 snd_cwnd;
736 __u32 srtt_us; /* Averaged RTT << 3 in usecs */
Lawrence Brakmob13d8802018-01-25 16:14:10 -0800737 __u32 bpf_sock_ops_cb_flags; /* flags defined in uapi/linux/tcp.h */
Lawrence Brakmo44f0e432018-01-25 16:14:12 -0800738 __u32 state;
739 __u32 rtt_min;
740 __u32 snd_ssthresh;
741 __u32 rcv_nxt;
742 __u32 snd_nxt;
743 __u32 snd_una;
744 __u32 mss_cache;
745 __u32 ecn_flags;
746 __u32 rate_delivered;
747 __u32 rate_interval_us;
748 __u32 packets_out;
749 __u32 retrans_out;
750 __u32 total_retrans;
751 __u32 segs_in;
752 __u32 data_segs_in;
753 __u32 segs_out;
754 __u32 data_segs_out;
755 __u32 lost_out;
756 __u32 sacked_out;
757 __u32 sk_txhash;
758 __u64 bytes_received;
759 __u64 bytes_acked;
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700760};
761
Lawrence Brakmob13d8802018-01-25 16:14:10 -0800762/* Definitions for bpf_sock_ops_cb_flags */
Lawrence Brakmof89013f2018-01-25 16:14:11 -0800763#define BPF_SOCK_OPS_RTO_CB_FLAG (1<<0)
Lawrence Brakmoa31ad292018-01-25 16:14:14 -0800764#define BPF_SOCK_OPS_RETRANS_CB_FLAG (1<<1)
Lawrence Brakmod4487492018-01-25 16:14:15 -0800765#define BPF_SOCK_OPS_STATE_CB_FLAG (1<<2)
766#define BPF_SOCK_OPS_ALL_CB_FLAGS 0x7 /* Mask of all currently
Lawrence Brakmob13d8802018-01-25 16:14:10 -0800767 * supported cb flags
768 */
769
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700770/* List of known BPF sock_ops operators.
771 * New entries can only be added at the end
772 */
773enum {
774 BPF_SOCK_OPS_VOID,
Lawrence Brakmo8550f322017-06-30 20:02:42 -0700775 BPF_SOCK_OPS_TIMEOUT_INIT, /* Should return SYN-RTO value to use or
776 * -1 if default value should be used
777 */
Lawrence Brakmo13d3b1e2017-06-30 20:02:44 -0700778 BPF_SOCK_OPS_RWND_INIT, /* Should return initial advertized
779 * window (in packets) or -1 if default
780 * value should be used
781 */
Lawrence Brakmo9872a4b2017-06-30 20:02:47 -0700782 BPF_SOCK_OPS_TCP_CONNECT_CB, /* Calls BPF program right before an
783 * active connection is initialized
784 */
785 BPF_SOCK_OPS_ACTIVE_ESTABLISHED_CB, /* Calls BPF program when an
786 * active connection is
787 * established
788 */
789 BPF_SOCK_OPS_PASSIVE_ESTABLISHED_CB, /* Calls BPF program when a
790 * passive connection is
791 * established
792 */
Lawrence Brakmo91b5b212017-06-30 20:02:49 -0700793 BPF_SOCK_OPS_NEEDS_ECN, /* If connection's congestion control
794 * needs ECN
795 */
Lawrence Brakmoe6546ef2017-10-20 11:05:39 -0700796 BPF_SOCK_OPS_BASE_RTT, /* Get base RTT. The correct value is
797 * based on the path and may be
798 * dependent on the congestion control
799 * algorithm. In general it indicates
800 * a congestion threshold. RTTs above
801 * this indicate congestion
802 */
Lawrence Brakmof89013f2018-01-25 16:14:11 -0800803 BPF_SOCK_OPS_RTO_CB, /* Called when an RTO has triggered.
804 * Arg1: value of icsk_retransmits
805 * Arg2: value of icsk_rto
806 * Arg3: whether RTO has expired
807 */
Lawrence Brakmoa31ad292018-01-25 16:14:14 -0800808 BPF_SOCK_OPS_RETRANS_CB, /* Called when skb is retransmitted.
809 * Arg1: sequence number of 1st byte
810 * Arg2: # segments
811 * Arg3: return value of
812 * tcp_transmit_skb (0 => success)
813 */
Lawrence Brakmod4487492018-01-25 16:14:15 -0800814 BPF_SOCK_OPS_STATE_CB, /* Called when TCP changes state.
815 * Arg1: old_state
816 * Arg2: new_state
817 */
818};
819
820/* List of TCP states. There is a build check in net/ipv4/tcp.c to detect
821 * changes between the TCP and BPF versions. Ideally this should never happen.
822 * If it does, we need to add code to convert them before calling
823 * the BPF sock_ops function.
824 */
825enum {
826 BPF_TCP_ESTABLISHED = 1,
827 BPF_TCP_SYN_SENT,
828 BPF_TCP_SYN_RECV,
829 BPF_TCP_FIN_WAIT1,
830 BPF_TCP_FIN_WAIT2,
831 BPF_TCP_TIME_WAIT,
832 BPF_TCP_CLOSE,
833 BPF_TCP_CLOSE_WAIT,
834 BPF_TCP_LAST_ACK,
835 BPF_TCP_LISTEN,
836 BPF_TCP_CLOSING, /* Now a valid state */
837 BPF_TCP_NEW_SYN_RECV,
838
839 BPF_TCP_MAX_STATES /* Leave at the end! */
Lawrence Brakmo40304b22017-06-30 20:02:40 -0700840};
841
Lawrence Brakmofc747812017-06-30 20:02:51 -0700842#define TCP_BPF_IW 1001 /* Set TCP initial congestion window */
Lawrence Brakmo13bf9642017-06-30 20:02:53 -0700843#define TCP_BPF_SNDCWND_CLAMP 1002 /* Set sndcwnd_clamp */
Lawrence Brakmofc747812017-06-30 20:02:51 -0700844
Yonghong Song908432c2017-10-05 09:19:20 -0700845struct bpf_perf_event_value {
846 __u64 counter;
847 __u64 enabled;
848 __u64 running;
849};
850
Roman Gushchinebc614f2017-11-05 08:15:32 -0500851#define BPF_DEVCG_ACC_MKNOD (1ULL << 0)
852#define BPF_DEVCG_ACC_READ (1ULL << 1)
853#define BPF_DEVCG_ACC_WRITE (1ULL << 2)
854
855#define BPF_DEVCG_DEV_BLOCK (1ULL << 0)
856#define BPF_DEVCG_DEV_CHAR (1ULL << 1)
857
858struct bpf_cgroup_dev_ctx {
Yonghong Song06ef0cc2017-12-18 10:13:44 -0800859 /* access_type encoded as (BPF_DEVCG_ACC_* << 16) | BPF_DEVCG_DEV_* */
860 __u32 access_type;
Roman Gushchinebc614f2017-11-05 08:15:32 -0500861 __u32 major;
862 __u32 minor;
863};
864
Alexei Starovoitovc4f66992018-03-28 12:05:37 -0700865struct bpf_raw_tracepoint_args {
866 __u64 args[0];
867};
868
Alexei Starovoitovdaedfb22014-09-04 22:17:18 -0700869#endif /* _UAPI__LINUX_BPF_H__ */