]>
git.proxmox.com Git - mirror_ubuntu-eoan-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() */
30 * True after the bprm_set_creds hook has been called once
31 * (multiple calls can be made via prepare_binprm() for
32 * binfmt_script/misc).
36 * True if most recent call to the commoncaps bprm_set_creds
37 * hook (due to multiple prepare_binprm() calls from the
38 * binfmt_script/misc handlers) resulted in elevated
43 * Set by bprm_set_creds hook to indicate a privilege-gaining
44 * exec has happened. Used to sanitize execution environment
45 * and to set AT_SECURE auxv for glibc.
51 unsigned int recursion_depth
; /* only for search_binary_handler() */
53 struct cred
*cred
; /* new credentials */
54 int unsafe
; /* how unsafe this exec is (mask of LSM_UNSAFE_*) */
55 unsigned int per_clear
; /* bits to clear in current->personality */
57 const char * filename
; /* Name of binary as seen by procps */
58 const char * interp
; /* Name of the binary really executed. Most
59 of the time same as filename, but could be
60 different for binfmt_{misc,script} */
61 unsigned interp_flags
;
63 unsigned long loader
, exec
;
65 struct rlimit rlim_stack
; /* Saved RLIMIT_STACK used during exec. */
67 char buf
[BINPRM_BUF_SIZE
];
70 #define BINPRM_FLAGS_ENFORCE_NONDUMP_BIT 0
71 #define BINPRM_FLAGS_ENFORCE_NONDUMP (1 << BINPRM_FLAGS_ENFORCE_NONDUMP_BIT)
73 /* fd of the binary should be passed to the interpreter */
74 #define BINPRM_FLAGS_EXECFD_BIT 1
75 #define BINPRM_FLAGS_EXECFD (1 << BINPRM_FLAGS_EXECFD_BIT)
77 /* filename of the binary will be inaccessible after exec */
78 #define BINPRM_FLAGS_PATH_INACCESSIBLE_BIT 2
79 #define BINPRM_FLAGS_PATH_INACCESSIBLE (1 << BINPRM_FLAGS_PATH_INACCESSIBLE_BIT)
81 /* Function parameter for binfmt->coredump */
82 struct coredump_params
{
83 const kernel_siginfo_t
*siginfo
;
87 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 prepare_binprm(struct linux_binprm
*);
121 extern int __must_check
remove_arg_zero(struct linux_binprm
*);
122 extern int search_binary_handler(struct linux_binprm
*);
123 extern int flush_old_exec(struct linux_binprm
* bprm
);
124 extern void setup_new_exec(struct linux_binprm
* bprm
);
125 extern void finalize_exec(struct linux_binprm
*bprm
);
126 extern void would_dump(struct linux_binprm
*, struct file
*);
128 extern int suid_dumpable
;
130 /* Stack area protections */
131 #define EXSTACK_DEFAULT 0 /* Whatever the arch defaults to */
132 #define EXSTACK_DISABLE_X 1 /* Disable executable stacks */
133 #define EXSTACK_ENABLE_X 2 /* Enable executable stacks */
135 extern int setup_arg_pages(struct linux_binprm
* bprm
,
136 unsigned long stack_top
,
137 int executable_stack
);
138 extern int transfer_args_to_stack(struct linux_binprm
*bprm
,
139 unsigned long *sp_location
);
140 extern int bprm_change_interp(const char *interp
, struct linux_binprm
*bprm
);
141 extern int copy_strings_kernel(int argc
, const char *const *argv
,
142 struct linux_binprm
*bprm
);
143 extern void install_exec_creds(struct linux_binprm
*bprm
);
144 extern void set_binfmt(struct linux_binfmt
*new);
145 extern ssize_t
read_code(struct file
*, unsigned long, loff_t
, size_t);
147 extern int do_execve(struct filename
*,
148 const char __user
* const __user
*,
149 const char __user
* const __user
*);
150 extern int do_execveat(int, struct filename
*,
151 const char __user
* const __user
*,
152 const char __user
* const __user
*,
154 int do_execve_file(struct file
*file
, void *__argv
, void *__envp
);
156 #endif /* _LINUX_BINFMTS_H */