mbox series

[bpf-next,0/2] libbpf: add support for privileged/unprivileged control separation

Message ID 20201104094626.3406-1-mariuszx.dudek@intel.com (mailing list archive)
Headers show
Series libbpf: add support for privileged/unprivileged control separation | expand

Message

Mariusz Dudek Nov. 4, 2020, 9:46 a.m. UTC
From: Mariusz Dudek <mariuszx.dudek@intel.com>

	This patch series adds support for separation of eBPF program
	load and xsk socket creation. In for example a Kubernetes
	environment you can have an AF_XDP CNI or daemonset that is 
	responsible for launching pods that execute an application 
	using AF_XDP sockets. It is desirable that the pod runs with
	as low privileges as possible, CAP_NET_RAW in this case, 
	and that all operations that require privileges are contained
	in the CNI or daemonset.
	
	In this case, you have to be able separate ePBF program load from
	xsk socket creation.

	Currently, this will not work with the xsk_socket__create APIs
	because you need to have CAP_NET_ADMIN privileges to load eBPF
	program and CAP_SYS_ADMIN privileges to create update xsk_bpf_maps.
	To be exact xsk_set_bpf_maps does not need those privileges but
	it takes the prog_fd and xsks_map_fd and those are known only to
	process that was loading eBPF program. The api bpf_prog_get_fd_by_id
	that looks up the fd of the prog using an prog_id and
	bpf_map_get_fd_by_id that looks for xsks_map_fd usinb map_id both
	requires CAP_SYS_ADMIN.

	With this patch, the pod can be run with CAP_NET_RAW capability
	only. In case your umem is larger or equal process limit for
	MEMLOCK you need either increase the limit or CAP_IPC_LOCK capability. 
	Without this patch in case of insufficient rights ENOPERM is
	returned by xsk_socket__create.

	To resolve this privileges issue two new APIs are introduced:
	- xsk_setup_xdp_prog - prepares bpf program if given and
	loads it on a selected network interface or loads the built in
	XDP program, if no XDP program is supplied. It can also return
	xsks_map_fd which is needed by unprivileged process to update
	xsks_map with AF_XDP socket "fd"
	- xsk_update_xskmap - inserts an AF_XDP socket into an xskmap for a
	particular xsk_socket

	Usage example:
	int xsk_setup_xdp_prog(int ifindex, struct bpf_prog_cfg *cfg,
			int *xsks_map_fd)

	if cfg == NULL, then the default program is loaded.

	Instead of NULL user can pass pointer to struct
	bpf_prog_cfg and provide own bpf program. 

	int xsk_update_xskmap(struct xsk_socket *xsk, int xsks_map_fd);

	Inserts AF_XDP socket "fd" into the xskmap.

	The first patch introduces the new APIs. The second patch provides
	a new sample applications working as control and modification to
	existing xdpsock application to work with less privileges.

	This patch set is based on bpf-next commit cb5dc5b062a9
	("Merge branch 'bpf: safeguard hashtab locking in NMI context')

Mariusz Dudek (2):
  libbpf: separate XDP program load with xsk socket creation
  samples/bpf: sample application for eBPF load and socket creation
    split

 samples/bpf/Makefile            |   4 +-
 samples/bpf/xdpsock.h           |   8 ++
 samples/bpf/xdpsock_ctrl_proc.c | 184 ++++++++++++++++++++++++++++++++
 samples/bpf/xdpsock_user.c      | 146 +++++++++++++++++++++++--
 tools/lib/bpf/libbpf.map        |   2 +
 tools/lib/bpf/xsk.c             | 157 ++++++++++++++++++++++-----
 tools/lib/bpf/xsk.h             |  13 +++
 7 files changed, 478 insertions(+), 36 deletions(-)
 create mode 100644 samples/bpf/xdpsock_ctrl_proc.c