Something went wrong. Try again.
(I'm so sorry!) Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
Something went wrong. Try again.
C
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114/* SPDX-License-Identifier: GPL-2.0 */#ifndef _LINUX_BINFMT_MISC_H#define _LINUX_BINFMT_MISC_H
#include <linux/types.h>
struct bpf_prog;struct file;struct linux_binprm;struct ucounts;struct user_namespace;
#define BINFMT_MISC_OPS_NAME_MAX 16
/* Longest name a 'B' entry can bind an interpreter under. */#define BINFMT_MISC_INTERP_NAME_MAX 32
/* Most interpreters one entry can bind. */#define BINFMT_MISC_INTERP_MAX 100
/** * struct binfmt_misc_interp - an interpreter an entry was registered with * @list: link in the entry's list, in registration order * @file: the file, opened at registration and never resolved again * @ucounts: the UCOUNT_BINFMT_MISC_INTERPRETERS charge the binding took * @path: the path it was registered under, used as the name the interpreter * runs under; stored after @name in the same allocation * @name: the name the load program selects it by; empty for the fixed * interpreter of a static 'F' entry * * Owned by the entry and living exactly as long as it does. The list head * is handed to the handler's load program for the duration of one exec, * which picks one with bpf_binprm_select_interp(). */struct binfmt_misc_interp { struct list_head list; struct file *file; struct ucounts *ucounts; const char *path; char name[];};
const struct binfmt_misc_interp *binfmt_misc_find_interp(const struct list_head *interps, const char *name);
/** * enum bpf_binprm_flags - per-exec invocation flags a load program can request * @BPF_BINPRM_PRESERVE_ARGV0: keep the caller's argv[0] (like the 'P' flag) * @BPF_BINPRM_CREDENTIALS: compute credentials from the binary; implies execfd * (like the 'C' flag) * @BPF_BINPRM_EXECFD: pass the binary via AT_EXECFD (like the 'O' flag) * @BPF_BINPRM_TRANSPARENT: leave argv untouched, the interpreter takes the * binary from AT_EXECFD (like the 'T' flag); implies * execfd, excludes preserve-argv0 * @BPF_BINPRM_LOADER: substitute the interpreter for the binary's PT_INTERP * and run the binary as a native exec (like the 'L' * flag); excludes every other flag * * Set from a load program with bpf_binprm_set_flags(). Unlike a static entry, * a bpf handler chooses these per exec rather than once at registration. */enum bpf_binprm_flags { BPF_BINPRM_PRESERVE_ARGV0 = (1ULL << 0), BPF_BINPRM_CREDENTIALS = (1ULL << 1), BPF_BINPRM_EXECFD = (1ULL << 2), BPF_BINPRM_TRANSPARENT = (1ULL << 3), BPF_BINPRM_LOADER = (1ULL << 4),};
/** * struct binfmt_misc_ops - bpf-backed binary type handler * @match: decide whether the handler applies to @bprm; consulted from the * entry lookup walk like static magic and extension matching, in * registration order with first-match-wins semantics; sleepable, * so it can read the binary to decide, but the verifier rejects * the interpreter selection kfuncs in it * @load: select an interpreter for the matched @bprm via * bpf_binprm_set_interp(), or one the entry bound via * bpf_binprm_select_interp(), and return zero; a match is * committed, so a failure fails the exec instead of falling * through to later entries; -ENOEXEC does not fail the exec but * moves on to the remaining binary formats * @name: name that 'B' entries reference the handler by */struct binfmt_misc_ops { bool (*match)(struct linux_binprm *bprm); int (*load)(struct linux_binprm *bprm); char name[BINFMT_MISC_OPS_NAME_MAX];};
#ifdef CONFIG_BINFMT_MISC_BPFconst struct binfmt_misc_ops *binfmt_misc_get_ops(struct user_namespace *user_ns, const char *name);void binfmt_misc_put_ops(const struct binfmt_misc_ops *ops);bool bpf_prog_is_binfmt_misc_ops(const struct bpf_prog *prog);#elsestatic inline const struct binfmt_misc_ops *binfmt_misc_get_ops(struct user_namespace *user_ns, const char *name){ return NULL;}
static inline void binfmt_misc_put_ops(const struct binfmt_misc_ops *ops){}
static inline bool bpf_prog_is_binfmt_misc_ops(const struct bpf_prog *prog){ return false;}#endif /* CONFIG_BINFMT_MISC_BPF */
#endif /* _LINUX_BINFMT_MISC_H */