7702 lines · 278.9 KB · C
RawDownload
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note *//* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com * * This program is free software; you can redistribute it and/or * modify it under the terms of version 2 of the GNU General Public * License as published by the Free Software Foundation. */#ifndef _UAPI__LINUX_BPF_H__#define _UAPI__LINUX_BPF_H__ #include <linux/types.h>#include <linux/bpf_common.h> /* Extended instruction set based on top of classic BPF */ /* instruction classes */#define BPF_JMP32	0x06	/* jmp mode in word width */#define BPF_ALU64	0x07	/* alu mode in double word width */ /* ld/ldx fields */#define BPF_DW		0x18	/* double word (64-bit) */#define BPF_MEMSX	0x80	/* load with sign extension */#define BPF_ATOMIC	0xc0	/* atomic memory ops - op type in immediate */#define BPF_XADD	0xc0	/* exclusive add - legacy name */ /* alu/jmp fields */#define BPF_MOV		0xb0	/* mov reg to reg */#define BPF_ARSH	0xc0	/* sign extending arithmetic shift right */ /* change endianness of a register */#define BPF_END		0xd0	/* flags for endianness conversion: */#define BPF_TO_LE	0x00	/* convert to little-endian */#define BPF_TO_BE	0x08	/* convert to big-endian */#define BPF_FROM_LE	BPF_TO_LE#define BPF_FROM_BE	BPF_TO_BE /* jmp encodings */#define BPF_JNE		0x50	/* jump != */#define BPF_JLT		0xa0	/* LT is unsigned, '<' */#define BPF_JLE		0xb0	/* LE is unsigned, '<=' */#define BPF_JSGT	0x60	/* SGT is signed '>', GT in x86 */#define BPF_JSGE	0x70	/* SGE is signed '>=', GE in x86 */#define BPF_JSLT	0xc0	/* SLT is signed, '<' */#define BPF_JSLE	0xd0	/* SLE is signed, '<=' */#define BPF_JCOND	0xe0	/* conditional pseudo jumps: may_goto, goto_or_nop */#define BPF_CALL	0x80	/* function call */#define BPF_EXIT	0x90	/* function return */ /* atomic op type fields (stored in immediate) */#define BPF_FETCH	0x01	/* not an opcode on its own, used to build others */#define BPF_XCHG	(0xe0 | BPF_FETCH)	/* atomic exchange */#define BPF_CMPXCHG	(0xf0 | BPF_FETCH)	/* atomic compare-and-write */ #define BPF_LOAD_ACQ	0x100	/* load-acquire */#define BPF_STORE_REL	0x110	/* store-release */ enum bpf_cond_pseudo_jmp {	BPF_MAY_GOTO = 0,}; /* Register numbers */enum {	BPF_REG_0 = 0,	BPF_REG_1,	BPF_REG_2,	BPF_REG_3,	BPF_REG_4,	BPF_REG_5,	BPF_REG_6,	BPF_REG_7,	BPF_REG_8,	BPF_REG_9,	BPF_REG_10,	__MAX_BPF_REG,}; /* BPF has 10 general purpose 64-bit registers and stack frame. */#define MAX_BPF_REG	__MAX_BPF_REG struct bpf_insn {	__u8	code;		/* opcode */	__u8	dst_reg:4;	/* dest register */	__u8	src_reg:4;	/* source register */	__s16	off;		/* signed offset */	__s32	imm;		/* signed immediate constant */}; /* Deprecated: use struct bpf_lpm_trie_key_u8 (when the "data" member is needed for * byte access) or struct bpf_lpm_trie_key_hdr (when using an alternative type for * the trailing flexible array member) instead. */struct bpf_lpm_trie_key {	__u32	prefixlen;	/* up to 32 for AF_INET, 128 for AF_INET6 */	__u8	data[0];	/* Arbitrary size */}; /* Header for bpf_lpm_trie_key structs */struct bpf_lpm_trie_key_hdr {	__u32	prefixlen;}; /* Key of an a BPF_MAP_TYPE_LPM_TRIE entry, with trailing byte array. */struct bpf_lpm_trie_key_u8 {	union {		struct bpf_lpm_trie_key_hdr	hdr;		__u32				prefixlen;	};	__u8	data[];		/* Arbitrary size */}; struct bpf_cgroup_storage_key {	__u64	cgroup_inode_id;	/* cgroup inode id */	__u32	attach_type;		/* program attach type (enum bpf_attach_type) */}; enum bpf_cgroup_iter_order {	BPF_CGROUP_ITER_ORDER_UNSPEC = 0,	BPF_CGROUP_ITER_SELF_ONLY,		/* process only a single object. */	BPF_CGROUP_ITER_DESCENDANTS_PRE,	/* walk descendants in pre-order. */	BPF_CGROUP_ITER_DESCENDANTS_POST,	/* walk descendants in post-order. */	BPF_CGROUP_ITER_ANCESTORS_UP,		/* walk ancestors upward. */	/*	 * Walks the immediate children of the specified parent	 * cgroup_subsys_state. Unlike BPF_CGROUP_ITER_DESCENDANTS_PRE,	 * BPF_CGROUP_ITER_DESCENDANTS_POST, and BPF_CGROUP_ITER_ANCESTORS_UP	 * the iterator does not include the specified parent as one of the	 * returned iterator elements.	 */	BPF_CGROUP_ITER_CHILDREN,}; union bpf_iter_link_info {	struct {		__u32	map_fd;	} map;	struct {		enum bpf_cgroup_iter_order order; 		/* At most one of cgroup_fd and cgroup_id can be non-zero. If		 * both are zero, the walk starts from the default cgroup v2		 * root. For walking v1 hierarchy, one should always explicitly		 * specify cgroup_fd.		 */		__u32	cgroup_fd;		__u64	cgroup_id;	} cgroup;	/* Parameters of task iterators. */	struct {		__u32	tid;		__u32	pid;		__u32	pid_fd;	} task;}; /* BPF syscall commands, see bpf(2) man-page for more details. *//** * DOC: eBPF Syscall Preamble * * The operation to be performed by the **bpf**\ () system call is determined * by the *cmd* argument. Each operation takes an accompanying argument, * provided via *attr*, which is a pointer to a union of type *bpf_attr* (see * below). The size argument is the size of the union pointed to by *attr*. *//** * DOC: eBPF Syscall Commands * * BPF_MAP_CREATE *	Description *		Create a map and return a file descriptor that refers to the *		map. The close-on-exec file descriptor flag (see **fcntl**\ (2)) *		is automatically enabled for the new file descriptor. * *		Applying **close**\ (2) to the file descriptor returned by *		**BPF_MAP_CREATE** will delete the map (but see NOTES). * *	Return *		A new file descriptor (a nonnegative integer), or -1 if an *		error occurred (in which case, *errno* is set appropriately). * * BPF_MAP_LOOKUP_ELEM *	Description *		Look up an element with a given *key* in the map referred to *		by the file descriptor *map_fd*. * *		The *flags* argument may be specified as one of the *		following: * *		**BPF_F_LOCK** *			Look up the value of a spin-locked map without *			returning the lock. This must be specified if the *			elements contain a spinlock. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * * BPF_MAP_UPDATE_ELEM *	Description *		Create or update an element (key/value pair) in a specified map. * *		The *flags* argument should be specified as one of the *		following: * *		**BPF_ANY** *			Create a new element or update an existing element. *		**BPF_NOEXIST** *			Create a new element only if it did not exist. *		**BPF_EXIST** *			Update an existing element. *		**BPF_F_LOCK** *			Update a spin_lock-ed map element. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * *		May set *errno* to **EINVAL**, **EPERM**, **ENOMEM**, *		**E2BIG**, **EEXIST**, or **ENOENT**. * *		**E2BIG** *			The number of elements in the map reached the *			*max_entries* limit specified at map creation time. *		**EEXIST** *			If *flags* specifies **BPF_NOEXIST** and the element *			with *key* already exists in the map. *		**ENOENT** *			If *flags* specifies **BPF_EXIST** and the element with *			*key* does not exist in the map. * * BPF_MAP_DELETE_ELEM *	Description *		Look up and delete an element by key in a specified map. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * * BPF_MAP_GET_NEXT_KEY *	Description *		Look up an element by key in a specified map and return the key *		of the next element. Can be used to iterate over all elements *		in the map. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * *		The following cases can be used to iterate over all elements of *		the map: * *		* If *key* is not found, the operation returns zero and sets *		  the *next_key* pointer to the key of the first element. *		* If *key* is found, the operation returns zero and sets the *		  *next_key* pointer to the key of the next element. *		* If *key* is the last element, returns -1 and *errno* is set *		  to **ENOENT**. * *		May set *errno* to **ENOMEM**, **EFAULT**, **EPERM**, or *		**EINVAL** on error. * * BPF_PROG_LOAD *	Description *		Verify and load an eBPF program, returning a new file *		descriptor associated with the program. * *		Applying **close**\ (2) to the file descriptor returned by *		**BPF_PROG_LOAD** will unload the eBPF program (but see NOTES). * *		The close-on-exec file descriptor flag (see **fcntl**\ (2)) is *		automatically enabled for the new file descriptor. * *	Return *		A new file descriptor (a nonnegative integer), or -1 if an *		error occurred (in which case, *errno* is set appropriately). * * BPF_OBJ_PIN *	Description *		Pin an eBPF program or map referred by the specified *bpf_fd* *		to the provided *pathname* on the filesystem. * *		The *pathname* argument must not contain a dot ("."). * *		On success, *pathname* retains a reference to the eBPF object, *		preventing deallocation of the object when the original *		*bpf_fd* is closed. This allow the eBPF object to live beyond *		**close**\ (\ *bpf_fd*\ ), and hence the lifetime of the parent *		process. * *		Applying **unlink**\ (2) or similar calls to the *pathname* *		unpins the object from the filesystem, removing the reference. *		If no other file descriptors or filesystem nodes refer to the *		same object, it will be deallocated (see NOTES). * *		The filesystem type for the parent directory of *pathname* must *		be **BPF_FS_MAGIC**. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * * BPF_OBJ_GET *	Description *		Open a file descriptor for the eBPF object pinned to the *		specified *pathname*. * *	Return *		A new file descriptor (a nonnegative integer), or -1 if an *		error occurred (in which case, *errno* is set appropriately). * * BPF_PROG_ATTACH *	Description *		Attach an eBPF program to a *target_fd* at the specified *		*attach_type* hook. * *		The *attach_type* specifies the eBPF attachment point to *		attach the program to, and must be one of *bpf_attach_type* *		(see below). * *		The *attach_bpf_fd* must be a valid file descriptor for a *		loaded eBPF program of a cgroup, flow dissector, LIRC, sockmap *		or sock_ops type corresponding to the specified *attach_type*. * *		The *target_fd* must be a valid file descriptor for a kernel *		object which depends on the attach type of *attach_bpf_fd*: * *		**BPF_PROG_TYPE_CGROUP_DEVICE**, *		**BPF_PROG_TYPE_CGROUP_SKB**, *		**BPF_PROG_TYPE_CGROUP_SOCK**, *		**BPF_PROG_TYPE_CGROUP_SOCK_ADDR**, *		**BPF_PROG_TYPE_CGROUP_SOCKOPT**, *		**BPF_PROG_TYPE_CGROUP_SYSCTL**, *		**BPF_PROG_TYPE_SOCK_OPS** * *			Control Group v2 hierarchy with the eBPF controller *			enabled. Requires the kernel to be compiled with *			**CONFIG_CGROUP_BPF**. * *		**BPF_PROG_TYPE_FLOW_DISSECTOR** * *			Network namespace (eg /proc/self/ns/net). * *		**BPF_PROG_TYPE_LIRC_MODE2** * *			LIRC device path (eg /dev/lircN). Requires the kernel *			to be compiled with **CONFIG_BPF_LIRC_MODE2**. * *		**BPF_PROG_TYPE_SK_SKB**, *		**BPF_PROG_TYPE_SK_MSG** * *			eBPF map of socket type (eg **BPF_MAP_TYPE_SOCKHASH**). * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * * BPF_PROG_DETACH *	Description *		Detach the eBPF program associated with the *target_fd* at the *		hook specified by *attach_type*. The program must have been *		previously attached using **BPF_PROG_ATTACH**. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * * BPF_PROG_TEST_RUN *	Description *		Run the eBPF program associated with the *prog_fd* a *repeat* *		number of times against a provided program context *ctx_in* and *		data *data_in*, and return the modified program context *		*ctx_out*, *data_out* (for example, packet data), result of the *		execution *retval*, and *duration* of the test run. * *		The sizes of the buffers provided as input and output *		parameters *ctx_in*, *ctx_out*, *data_in*, and *data_out* must *		be provided in the corresponding variables *ctx_size_in*, *		*ctx_size_out*, *data_size_in*, and/or *data_size_out*. If any *		of these parameters are not provided (ie set to NULL), the *		corresponding size field must be zero. * *		Some program types have particular requirements: * *		**BPF_PROG_TYPE_SK_LOOKUP** *			*data_in* and *data_out* must be NULL. * *		**BPF_PROG_TYPE_RAW_TRACEPOINT**, *		**BPF_PROG_TYPE_RAW_TRACEPOINT_WRITABLE** * *			*ctx_out*, *data_in* and *data_out* must be NULL. *			*repeat* must be zero. * *		BPF_PROG_RUN is an alias for BPF_PROG_TEST_RUN. * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * *		**ENOSPC** *			Either *data_size_out* or *ctx_size_out* is too small. *		**ENOTSUPP** *			This command is not supported by the program type of *			the program referred to by *prog_fd*. * * BPF_PROG_GET_NEXT_ID *	Description *		Fetch the next eBPF program currently loaded into the kernel. * *		Looks for the eBPF program with an id greater than *start_id* *		and updates *next_id* on success. If no other eBPF programs *		remain with ids higher than *start_id*, returns -1 and sets *		*errno* to **ENOENT**. * *	Return *		Returns zero on success. On error, or when no id remains, -1 *		is returned and *errno* is set appropriately. * * BPF_MAP_GET_NEXT_ID *	Description *		Fetch the next eBPF map currently loaded into the kernel. * *		Looks for the eBPF map with an id greater than *start_id* *		and updates *next_id* on success. If no other eBPF maps *		remain with ids higher than *start_id*, returns -1 and sets *		*errno* to **ENOENT**. * *	Return *		Returns zero on success. On error, or when no id remains, -1 *		is returned and *errno* is set appropriately. * * BPF_PROG_GET_FD_BY_ID *	Description *		Open a file descriptor for the eBPF program corresponding to *		*prog_id*. * *	Return *		A new file descriptor (a nonnegative integer), or -1 if an *		error occurred (in which case, *errno* is set appropriately). * * BPF_MAP_GET_FD_BY_ID *	Description *		Open a file descriptor for the eBPF map corresponding to *		*map_id*. * *	Return *		A new file descriptor (a nonnegative integer), or -1 if an *		error occurred (in which case, *errno* is set appropriately). * * BPF_OBJ_GET_INFO_BY_FD *	Description *		Obtain information about the eBPF object corresponding to *		*bpf_fd*. * *		Populates up to *info_len* bytes of *info*, which will be in *		one of the following formats depending on the eBPF object type *		of *bpf_fd*: * *		* **struct bpf_prog_info** *		* **struct bpf_map_info** *		* **struct bpf_btf_info** *		* **struct bpf_link_info** *		* **struct bpf_token_info** * *	Return *		Returns zero on success. On error, -1 is returned and *errno* *		is set appropriately. * * BPF_PROG_QUERY *	Description *		Obtain information about eBPF programs associated with the *		specified *attach_type* hook. * *		The *target_fd* must be a valid file descriptor for a kernel *		object which depends on the attach type of *attach_bpf_fd*: * *		**BPF_PROG_TYPE_CGROUP_DEVICE**, *		**BPF_PROG_TYPE_CGROUP_SKB**, *		**BPF_PROG_TYPE_CGROUP_SOCK**, *		**BPF_PROG_TYPE_CGROUP_SOCK_ADDR**, *		**BPF_PROG_TYPE_CGROUP_SOCKOPT**, *		**BPF_PROG_TYPE_CGROUP_SYSCTL**, *		**BPF_PROG_TYPE_SOCK_OPS** * *			Control Group v2 hierarchy with the eBPF controller *			enabled. Requires the kernel to be compiled with *			**CONFIG_CGROUP_BPF**. * *		**BPF_PROG_TYPE_FLOW_DISSECTOR** * *			Network namespace (eg /proc/self/ns/net). * *		**BPF_PROG_TYPE_LIRC_MODE2** * *			LIRC device path (eg /dev/lircN). Requires the kernel *			to be compiled with **CONFIG_BPF_LIRC_MODE2**. * *		**BPF_PROG_QUERY** always fetches the number of programs *		attached and the *attach_flags* which were used to attach those *		programs. Additionally, if *prog_ids* is nonzero and the number *		of attached programs is less than *prog_cnt*, populates *		*prog_ids* with the eBPF program ids of the programs attached

Lines 1–500 of 7702.