]>
git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blob - include/linux/binfmts.h
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _LINUX_BINFMTS_H
3 #define _LINUX_BINFMTS_H
5 #include <linux/sched.h>
6 #include <linux/unistd.h>
8 #include <uapi/linux/binfmts.h>
12 #define CORENAME_MAX_SIZE 128
15 * This structure is used to hold the arguments that are used when loading binaries.
19 struct vm_area_struct
*vma
;
20 unsigned long vma_pages
;
22 # define MAX_ARG_PAGES 32
23 struct page
*page
[MAX_ARG_PAGES
];
26 unsigned long p
; /* current top of mem */
27 unsigned long argmin
; /* rlimit marker for copy_strings() */
29 /* Should an execfd be passed to userspace? */
32 /* Use the creds of a script (see binfmt_misc) */
35 * Set by bprm_creds_for_exec hook to indicate a
36 * privilege-gaining exec has happened. Used to set
37 * AT_SECURE auxv for glibc.
41 * Set when errors can no longer be returned to the
48 struct file
*executable
; /* Executable to pass to the interpreter */
49 struct file
*interpreter
;
51 struct cred
*cred
; /* new credentials */
52 int unsafe
; /* how unsafe this exec is (mask of LSM_UNSAFE_*) */
53 unsigned int per_clear
; /* bits to clear in current->personality */
55 const char *filename
; /* Name of binary as seen by procps */
56 const char *interp
; /* Name of the binary really executed. Most
57 of the time same as filename, but could be
58 different for binfmt_{misc,script} */
59 const char *fdpath
; /* generated filename for execveat */
60 unsigned interp_flags
;
61 int execfd
; /* File descriptor of the executable */
62 unsigned long loader
, exec
;
64 struct rlimit rlim_stack
; /* Saved RLIMIT_STACK used during exec. */
66 char buf
[BINPRM_BUF_SIZE
];
69 #define BINPRM_FLAGS_ENFORCE_NONDUMP_BIT 0
70 #define BINPRM_FLAGS_ENFORCE_NONDUMP (1 << BINPRM_FLAGS_ENFORCE_NONDUMP_BIT)
72 /* filename of the binary will be inaccessible after exec */
73 #define BINPRM_FLAGS_PATH_INACCESSIBLE_BIT 2
74 #define BINPRM_FLAGS_PATH_INACCESSIBLE (1 << BINPRM_FLAGS_PATH_INACCESSIBLE_BIT)
76 /* preserve argv0 for the interpreter */
77 #define BINPRM_FLAGS_PRESERVE_ARGV0_BIT 3
78 #define BINPRM_FLAGS_PRESERVE_ARGV0 (1 << BINPRM_FLAGS_PRESERVE_ARGV0_BIT)
80 /* Function parameter for binfmt->coredump */
81 struct coredump_params
{
82 const kernel_siginfo_t
*siginfo
;
86 unsigned long mm_flags
;
93 * This structure defines the functions that are used to load the binary formats that
98 struct module
*module
;
99 int (*load_binary
)(struct linux_binprm
*);
100 int (*load_shlib
)(struct file
*);
101 int (*core_dump
)(struct coredump_params
*cprm
);
102 unsigned long min_coredump
; /* minimal dump size */
103 } __randomize_layout
;
105 extern void __register_binfmt(struct linux_binfmt
*fmt
, int insert
);
107 /* Registration of default binfmt handlers */
108 static inline void register_binfmt(struct linux_binfmt
*fmt
)
110 __register_binfmt(fmt
, 0);
112 /* Same as above, but adds a new binfmt at the top of the list */
113 static inline void insert_binfmt(struct linux_binfmt
*fmt
)
115 __register_binfmt(fmt
, 1);
118 extern void unregister_binfmt(struct linux_binfmt
*);
120 extern int __must_check
remove_arg_zero(struct linux_binprm
*);
121 extern int begin_new_exec(struct linux_binprm
* bprm
);
122 extern void setup_new_exec(struct linux_binprm
* bprm
);
123 extern void finalize_exec(struct linux_binprm
*bprm
);
124 extern void would_dump(struct linux_binprm
*, struct file
*);
126 extern int suid_dumpable
;
128 /* Stack area protections */
129 #define EXSTACK_DEFAULT 0 /* Whatever the arch defaults to */
130 #define EXSTACK_DISABLE_X 1 /* Disable executable stacks */
131 #define EXSTACK_ENABLE_X 2 /* Enable executable stacks */
133 extern int setup_arg_pages(struct linux_binprm
* bprm
,
134 unsigned long stack_top
,
135 int executable_stack
);
136 extern int transfer_args_to_stack(struct linux_binprm
*bprm
,
137 unsigned long *sp_location
);
138 extern int bprm_change_interp(const char *interp
, struct linux_binprm
*bprm
);
139 int copy_string_kernel(const char *arg
, struct linux_binprm
*bprm
);
140 extern void set_binfmt(struct linux_binfmt
*new);
141 extern ssize_t
read_code(struct file
*, unsigned long, loff_t
, size_t);
143 int kernel_execve(const char *filename
,
144 const char *const *argv
, const char *const *envp
);
146 #endif /* _LINUX_BINFMTS_H */