Right now, most cgroup hooks are best used for permission checks. They
can only reject a syscall with -EPERM, so a cause of a rejection, if
the rejected by eBPF cgroup hooks, is ambiguous to userspace.
Additionally, if the syscalls are implemented in eBPF, all permission
checks and the implementation has to happen within the same filter,
as programs executed later in the series of progs are unaware of the
return values return by the previous progs.
This patch series adds two helpers, bpf_get_retval and bpf_set_retval,
that allows hooks to get/set the return value of syscall to userspace.
This also allows later progs to retrieve retval set by previous progs.
For legacy programs that rejects a syscall without setting the retval,
for backwards compatibility, if a prog rejects without itself or a
prior prog setting retval to an -err, the retval is set by the kernel
to -EPERM.
For getsockopt hooks that has ctx->retval, this variable mirrors that
that accessed by the helpers.
Additionally, the following user-visible behavior for getsockopt
hooks has changed:
- If a prior filter rejected the syscall, it will be visible
in ctx->retval.
- Attempting to change the retval arbitrarily is now allowed and
will not cause an -EFAULT.
- If kernel rejects a getsockopt syscall before running the hooks,
the error will be visible in ctx->retval. Returning 0 from the
prog will not overwrite the error to -EPERM unless there is an
explicit call of bpf_set_retval(-EPERM)
Tests have been added in this series to test the behavior of the helper
with cgroup setsockopt getsockopt hooks.
Patch 1 changes the API of macros to prepare for the next patch and
should be a no-op.
Patch 2 moves ctx->retval to a struct pointed to by current
task_struct.
Patch 3 implements the helpers.
Patch 4 tests the behaviors of the helpers.
v1 -> v2:
- errno -> retval
- split one helper to get & set helpers
- allow retval to be set arbitrarily in the general case
- made the helper retval and context retval mirror each other
v2 -> v3:
- squashed sockopt_sk test change to the patch that broke it
YiFei Zhu (4):
bpf: Make BPF_PROG_RUN_ARRAY return -err instead of allow boolean
bpf: Move getsockopt retval to struct bpf_cg_run_ctx
bpf: Add cgroup helpers bpf_{get,set}_retval to get/set syscall return
value
selftests/bpf: Test bpf_{get,set}_retval behavior with cgroup/sockopt
include/linux/bpf.h | 34 +-
include/linux/filter.h | 5 +-
include/uapi/linux/bpf.h | 18 +
kernel/bpf/cgroup.c | 149 ++++--
security/device_cgroup.c | 2 +-
tools/include/uapi/linux/bpf.h | 18 +
.../bpf/prog_tests/cgroup_getset_retval.c | 481 ++++++++++++++++++
.../selftests/bpf/prog_tests/sockopt_sk.c | 2 +-
.../progs/cgroup_getset_retval_getsockopt.c | 45 ++
.../progs/cgroup_getset_retval_setsockopt.c | 52 ++
.../testing/selftests/bpf/progs/sockopt_sk.c | 32 +-
11 files changed, 750 insertions(+), 88 deletions(-)
create mode 100644 tools/testing/selftests/bpf/prog_tests/cgroup_getset_retval.c
create mode 100644 tools/testing/selftests/bpf/progs/cgroup_getset_retval_getsockopt.c
create mode 100644 tools/testing/selftests/bpf/progs/cgroup_getset_retval_setsockopt.c
--
2.34.1.448.ga2b2bfdf31-goog
