mirror of
https://github.com/raspberrypi/linux.git
synced 2025-12-15 22:41:38 +00:00
adfdd9c685
Add a __caps_unpriv annotation so that tests requiring specific capabilities while dropping the rest can conveniently specify them during selftest declaration instead of munging with capabilities at runtime from the testing binary. While at it, let us convert test_verifier_mtu to use this new support instead. Since we do not want to include linux/capability.h, we only defined the four main capabilities BPF subsystem deals with in bpf_misc.h for use in tests. If the user passes a CAP_SYS_NICE or anything else that's not defined in the header, capability parsing code will return a warning. Also reject strtol returning 0. CAP_CHOWN = 0 but we'll never need to use it, and strtol doesn't errno on failed conversion. Fail the test in such a case. The original diff for this idea is available at link [0]. [0]: https://lore.kernel.org/bpf/a1e48f5d9ae133e19adc6adf27e19d585e06bab4.camel@gmail.com Signed-off-by: Eduard Zingerman <eddyz87@gmail.com> [ Kartikeya: rebase on bpf-next, add warn to parse_caps, convert test_verifier_mtu ] Signed-off-by: Kumar Kartikeya Dwivedi <memxor@gmail.com> Link: https://lore.kernel.org/r/20241204044757.1483141-4-memxor@gmail.com Signed-off-by: Alexei Starovoitov <ast@kernel.org>
212 lines
9.5 KiB
C
212 lines
9.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
#ifndef __BPF_MISC_H__
|
|
#define __BPF_MISC_H__
|
|
|
|
#define XSTR(s) STR(s)
|
|
#define STR(s) #s
|
|
|
|
/* Expand a macro and then stringize the expansion */
|
|
#define QUOTE(str) #str
|
|
#define EXPAND_QUOTE(str) QUOTE(str)
|
|
|
|
/* This set of attributes controls behavior of the
|
|
* test_loader.c:test_loader__run_subtests().
|
|
*
|
|
* The test_loader sequentially loads each program in a skeleton.
|
|
* Programs could be loaded in privileged and unprivileged modes.
|
|
* - __success, __failure, __msg, __regex imply privileged mode;
|
|
* - __success_unpriv, __failure_unpriv, __msg_unpriv, __regex_unpriv
|
|
* imply unprivileged mode.
|
|
* If combination of privileged and unprivileged attributes is present
|
|
* both modes are used. If none are present privileged mode is implied.
|
|
*
|
|
* See test_loader.c:drop_capabilities() for exact set of capabilities
|
|
* that differ between privileged and unprivileged modes.
|
|
*
|
|
* For test filtering purposes the name of the program loaded in
|
|
* unprivileged mode is derived from the usual program name by adding
|
|
* `@unpriv' suffix.
|
|
*
|
|
* __msg Message expected to be found in the verifier log.
|
|
* Multiple __msg attributes could be specified.
|
|
* To match a regular expression use "{{" "}}" brackets,
|
|
* e.g. "foo{{[0-9]+}}" matches strings like "foo007".
|
|
* Extended POSIX regular expression syntax is allowed
|
|
* inside the brackets.
|
|
* __msg_unpriv Same as __msg but for unprivileged mode.
|
|
*
|
|
* __xlated Expect a line in a disassembly log after verifier applies rewrites.
|
|
* Multiple __xlated attributes could be specified.
|
|
* Regular expressions could be specified same way as in __msg.
|
|
* __xlated_unpriv Same as __xlated but for unprivileged mode.
|
|
*
|
|
* __jited Match a line in a disassembly of the jited BPF program.
|
|
* Has to be used after __arch_* macro.
|
|
* For example:
|
|
*
|
|
* __arch_x86_64
|
|
* __jited(" endbr64")
|
|
* __jited(" nopl (%rax,%rax)")
|
|
* __jited(" xorq %rax, %rax")
|
|
* ...
|
|
* __naked void some_test(void)
|
|
* {
|
|
* asm volatile (... ::: __clobber_all);
|
|
* }
|
|
*
|
|
* Regular expressions could be included in patterns same way
|
|
* as in __msg.
|
|
*
|
|
* By default assume that each pattern has to be matched on the
|
|
* next consecutive line of disassembly, e.g.:
|
|
*
|
|
* __jited(" endbr64") # matched on line N
|
|
* __jited(" nopl (%rax,%rax)") # matched on line N+1
|
|
*
|
|
* If match occurs on a wrong line an error is reported.
|
|
* To override this behaviour use literal "...", e.g.:
|
|
*
|
|
* __jited(" endbr64") # matched on line N
|
|
* __jited("...") # not matched
|
|
* __jited(" nopl (%rax,%rax)") # matched on any line >= N
|
|
*
|
|
* __jited_unpriv Same as __jited but for unprivileged mode.
|
|
*
|
|
*
|
|
* __success Expect program load success in privileged mode.
|
|
* __success_unpriv Expect program load success in unprivileged mode.
|
|
*
|
|
* __failure Expect program load failure in privileged mode.
|
|
* __failure_unpriv Expect program load failure in unprivileged mode.
|
|
*
|
|
* __retval Execute the program using BPF_PROG_TEST_RUN command,
|
|
* expect return value to match passed parameter:
|
|
* - a decimal number
|
|
* - a hexadecimal number, when starts from 0x
|
|
* - literal INT_MIN
|
|
* - literal POINTER_VALUE (see definition below)
|
|
* - literal TEST_DATA_LEN (see definition below)
|
|
* __retval_unpriv Same, but load program in unprivileged mode.
|
|
*
|
|
* __description Text to be used instead of a program name for display
|
|
* and filtering purposes.
|
|
*
|
|
* __log_level Log level to use for the program, numeric value expected.
|
|
*
|
|
* __flag Adds one flag use for the program, the following values are valid:
|
|
* - BPF_F_STRICT_ALIGNMENT;
|
|
* - BPF_F_TEST_RND_HI32;
|
|
* - BPF_F_TEST_STATE_FREQ;
|
|
* - BPF_F_SLEEPABLE;
|
|
* - BPF_F_XDP_HAS_FRAGS;
|
|
* - A numeric value.
|
|
* Multiple __flag attributes could be specified, the final flags
|
|
* value is derived by applying binary "or" to all specified values.
|
|
*
|
|
* __auxiliary Annotated program is not a separate test, but used as auxiliary
|
|
* for some other test cases and should always be loaded.
|
|
* __auxiliary_unpriv Same, but load program in unprivileged mode.
|
|
*
|
|
* __arch_* Specify on which architecture the test case should be tested.
|
|
* Several __arch_* annotations could be specified at once.
|
|
* When test case is not run on current arch it is marked as skipped.
|
|
* __caps_unpriv Specify the capabilities that should be set when running the test.
|
|
*/
|
|
#define __msg(msg) __attribute__((btf_decl_tag("comment:test_expect_msg=" XSTR(__COUNTER__) "=" msg)))
|
|
#define __xlated(msg) __attribute__((btf_decl_tag("comment:test_expect_xlated=" XSTR(__COUNTER__) "=" msg)))
|
|
#define __jited(msg) __attribute__((btf_decl_tag("comment:test_jited=" XSTR(__COUNTER__) "=" msg)))
|
|
#define __failure __attribute__((btf_decl_tag("comment:test_expect_failure")))
|
|
#define __success __attribute__((btf_decl_tag("comment:test_expect_success")))
|
|
#define __description(desc) __attribute__((btf_decl_tag("comment:test_description=" desc)))
|
|
#define __msg_unpriv(msg) __attribute__((btf_decl_tag("comment:test_expect_msg_unpriv=" XSTR(__COUNTER__) "=" msg)))
|
|
#define __xlated_unpriv(msg) __attribute__((btf_decl_tag("comment:test_expect_xlated_unpriv=" XSTR(__COUNTER__) "=" msg)))
|
|
#define __jited_unpriv(msg) __attribute__((btf_decl_tag("comment:test_jited=" XSTR(__COUNTER__) "=" msg)))
|
|
#define __failure_unpriv __attribute__((btf_decl_tag("comment:test_expect_failure_unpriv")))
|
|
#define __success_unpriv __attribute__((btf_decl_tag("comment:test_expect_success_unpriv")))
|
|
#define __log_level(lvl) __attribute__((btf_decl_tag("comment:test_log_level="#lvl)))
|
|
#define __flag(flag) __attribute__((btf_decl_tag("comment:test_prog_flags="#flag)))
|
|
#define __retval(val) __attribute__((btf_decl_tag("comment:test_retval="#val)))
|
|
#define __retval_unpriv(val) __attribute__((btf_decl_tag("comment:test_retval_unpriv="#val)))
|
|
#define __auxiliary __attribute__((btf_decl_tag("comment:test_auxiliary")))
|
|
#define __auxiliary_unpriv __attribute__((btf_decl_tag("comment:test_auxiliary_unpriv")))
|
|
#define __btf_path(path) __attribute__((btf_decl_tag("comment:test_btf_path=" path)))
|
|
#define __arch(arch) __attribute__((btf_decl_tag("comment:test_arch=" arch)))
|
|
#define __arch_x86_64 __arch("X86_64")
|
|
#define __arch_arm64 __arch("ARM64")
|
|
#define __arch_riscv64 __arch("RISCV64")
|
|
#define __caps_unpriv(caps) __attribute__((btf_decl_tag("comment:test_caps_unpriv=" EXPAND_QUOTE(caps))))
|
|
|
|
/* Define common capabilities tested using __caps_unpriv */
|
|
#define CAP_NET_ADMIN 12
|
|
#define CAP_SYS_ADMIN 21
|
|
#define CAP_PERFMON 38
|
|
#define CAP_BPF 39
|
|
|
|
/* Convenience macro for use with 'asm volatile' blocks */
|
|
#define __naked __attribute__((naked))
|
|
#define __clobber_all "r0", "r1", "r2", "r3", "r4", "r5", "r6", "r7", "r8", "r9", "memory"
|
|
#define __clobber_common "r0", "r1", "r2", "r3", "r4", "r5", "memory"
|
|
#define __imm(name) [name]"i"(name)
|
|
#define __imm_const(name, expr) [name]"i"(expr)
|
|
#define __imm_addr(name) [name]"i"(&name)
|
|
#define __imm_ptr(name) [name]"r"(&name)
|
|
#define __imm_insn(name, expr) [name]"i"(*(long *)&(expr))
|
|
|
|
/* Magic constants used with __retval() */
|
|
#define POINTER_VALUE 0xcafe4all
|
|
#define TEST_DATA_LEN 64
|
|
|
|
#ifndef __used
|
|
#define __used __attribute__((used))
|
|
#endif
|
|
|
|
#if defined(__TARGET_ARCH_x86)
|
|
#define SYSCALL_WRAPPER 1
|
|
#define SYS_PREFIX "__x64_"
|
|
#elif defined(__TARGET_ARCH_s390)
|
|
#define SYSCALL_WRAPPER 1
|
|
#define SYS_PREFIX "__s390x_"
|
|
#elif defined(__TARGET_ARCH_arm64)
|
|
#define SYSCALL_WRAPPER 1
|
|
#define SYS_PREFIX "__arm64_"
|
|
#elif defined(__TARGET_ARCH_riscv)
|
|
#define SYSCALL_WRAPPER 1
|
|
#define SYS_PREFIX "__riscv_"
|
|
#else
|
|
#define SYSCALL_WRAPPER 0
|
|
#define SYS_PREFIX "__se_"
|
|
#endif
|
|
|
|
/* How many arguments are passed to function in register */
|
|
#if defined(__TARGET_ARCH_x86) || defined(__x86_64__)
|
|
#define FUNC_REG_ARG_CNT 6
|
|
#elif defined(__i386__)
|
|
#define FUNC_REG_ARG_CNT 3
|
|
#elif defined(__TARGET_ARCH_s390) || defined(__s390x__)
|
|
#define FUNC_REG_ARG_CNT 5
|
|
#elif defined(__TARGET_ARCH_arm) || defined(__arm__)
|
|
#define FUNC_REG_ARG_CNT 4
|
|
#elif defined(__TARGET_ARCH_arm64) || defined(__aarch64__)
|
|
#define FUNC_REG_ARG_CNT 8
|
|
#elif defined(__TARGET_ARCH_mips) || defined(__mips__)
|
|
#define FUNC_REG_ARG_CNT 8
|
|
#elif defined(__TARGET_ARCH_powerpc) || defined(__powerpc__) || defined(__powerpc64__)
|
|
#define FUNC_REG_ARG_CNT 8
|
|
#elif defined(__TARGET_ARCH_sparc) || defined(__sparc__)
|
|
#define FUNC_REG_ARG_CNT 6
|
|
#elif defined(__TARGET_ARCH_riscv) || defined(__riscv__)
|
|
#define FUNC_REG_ARG_CNT 8
|
|
#else
|
|
/* default to 5 for others */
|
|
#define FUNC_REG_ARG_CNT 5
|
|
#endif
|
|
|
|
/* make it look to compiler like value is read and written */
|
|
#define __sink(expr) asm volatile("" : "+g"(expr))
|
|
|
|
#ifndef ARRAY_SIZE
|
|
#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
|
|
#endif
|
|
|
|
#endif
|