1 #ifndef _LINUX_BINFMTS_H 2 #define _LINUX_BINFMTS_H 3 4 #include <linux/sched.h> 5 #include <linux/unistd.h> 6 #include <asm/exec.h> 7 #include <uapi/linux/binfmts.h> 8 9 #define CORENAME_MAX_SIZE 128 10 11 /* 12 * This structure is used to hold the arguments that are used when loading binaries. 13 */ 14 struct linux_binprm { 15 char buf[BINPRM_BUF_SIZE]; 16 #ifdef CONFIG_MMU 17 struct vm_area_struct *vma; 18 unsigned long vma_pages; 19 #else 20 # define MAX_ARG_PAGES 32 21 struct page *page[MAX_ARG_PAGES]; 22 #endif 23 struct mm_struct *mm; 24 unsigned long p; /* current top of mem */ 25 unsigned int 26 cred_prepared:1,/* true if creds already prepared (multiple 27 * preps happen for interpreters) */ 28 cap_effective:1;/* true if has elevated effective capabilities, 29 * false if not; except for init which inherits 30 * its parent's caps anyway */ 31 #ifdef __alpha__ 32 unsigned int taso:1; 33 #endif 34 unsigned int recursion_depth; 35 struct file * file; 36 struct cred *cred; /* new credentials */ 37 int unsafe; /* how unsafe this exec is (mask of LSM_UNSAFE_*) */ 38 unsigned int per_clear; /* bits to clear in current->personality */ 39 int argc, envc; 40 const char * filename; /* Name of binary as seen by procps */ 41 const char * interp; /* Name of the binary really executed. Most 42 of the time same as filename, but could be 43 different for binfmt_{misc,script} */ 44 unsigned interp_flags; 45 unsigned interp_data; 46 unsigned long loader, exec; 47 char tcomm[TASK_COMM_LEN]; 48 }; 49 50 #define BINPRM_FLAGS_ENFORCE_NONDUMP_BIT 0 51 #define BINPRM_FLAGS_ENFORCE_NONDUMP (1 << BINPRM_FLAGS_ENFORCE_NONDUMP_BIT) 52 53 /* fd of the binary should be passed to the interpreter */ 54 #define BINPRM_FLAGS_EXECFD_BIT 1 55 #define BINPRM_FLAGS_EXECFD (1 << BINPRM_FLAGS_EXECFD_BIT) 56 57 #define BINPRM_MAX_RECURSION 4 58 59 /* Function parameter for binfmt->coredump */ 60 struct coredump_params { 61 siginfo_t *siginfo; 62 struct pt_regs *regs; 63 struct file *file; 64 unsigned long limit; 65 unsigned long mm_flags; 66 }; 67 68 /* 69 * This structure defines the functions that are used to load the binary formats that 70 * linux accepts. 71 */ 72 struct linux_binfmt { 73 struct list_head lh; 74 struct module *module; 75 int (*load_binary)(struct linux_binprm *, struct pt_regs * regs); 76 int (*load_shlib)(struct file *); 77 int (*core_dump)(struct coredump_params *cprm); 78 unsigned long min_coredump; /* minimal dump size */ 79 }; 80 81 extern void __register_binfmt(struct linux_binfmt *fmt, int insert); 82 83 /* Registration of default binfmt handlers */ 84 static inline void register_binfmt(struct linux_binfmt *fmt) 85 { 86 __register_binfmt(fmt, 0); 87 } 88 /* Same as above, but adds a new binfmt at the top of the list */ 89 static inline void insert_binfmt(struct linux_binfmt *fmt) 90 { 91 __register_binfmt(fmt, 1); 92 } 93 94 extern void unregister_binfmt(struct linux_binfmt *); 95 96 extern int prepare_binprm(struct linux_binprm *); 97 extern int __must_check remove_arg_zero(struct linux_binprm *); 98 extern int search_binary_handler(struct linux_binprm *, struct pt_regs *); 99 extern int flush_old_exec(struct linux_binprm * bprm); 100 extern void setup_new_exec(struct linux_binprm * bprm); 101 extern void would_dump(struct linux_binprm *, struct file *); 102 103 extern int suid_dumpable; 104 #define SUID_DUMP_DISABLE 0 /* No setuid dumping */ 105 #define SUID_DUMP_USER 1 /* Dump as user of process */ 106 #define SUID_DUMP_ROOT 2 /* Dump as root */ 107 108 /* Stack area protections */ 109 #define EXSTACK_DEFAULT 0 /* Whatever the arch defaults to */ 110 #define EXSTACK_DISABLE_X 1 /* Disable executable stacks */ 111 #define EXSTACK_ENABLE_X 2 /* Enable executable stacks */ 112 113 extern int setup_arg_pages(struct linux_binprm * bprm, 114 unsigned long stack_top, 115 int executable_stack); 116 extern int bprm_mm_init(struct linux_binprm *bprm); 117 extern int copy_strings_kernel(int argc, const char *const *argv, 118 struct linux_binprm *bprm); 119 extern int prepare_bprm_creds(struct linux_binprm *bprm); 120 extern void install_exec_creds(struct linux_binprm *bprm); 121 extern void set_binfmt(struct linux_binfmt *new); 122 extern void free_bprm(struct linux_binprm *); 123 124 #ifdef __ARCH_WANT_KERNEL_EXECVE 125 extern void ret_from_kernel_execve(struct pt_regs *normal) __noreturn; 126 #endif 127 128 #endif /* _LINUX_BINFMTS_H */ 129