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; /* only for search_binary_handler() */ 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 /* Function parameter for binfmt->coredump */ 58 struct coredump_params { 59 const siginfo_t *siginfo; 60 struct pt_regs *regs; 61 struct file *file; 62 unsigned long limit; 63 unsigned long mm_flags; 64 loff_t written; 65 }; 66 67 /* 68 * This structure defines the functions that are used to load the binary formats that 69 * linux accepts. 70 */ 71 struct linux_binfmt { 72 struct list_head lh; 73 struct module *module; 74 int (*load_binary)(struct linux_binprm *); 75 int (*load_shlib)(struct file *); 76 int (*core_dump)(struct coredump_params *cprm); 77 unsigned long min_coredump; /* minimal dump size */ 78 }; 79 80 extern void __register_binfmt(struct linux_binfmt *fmt, int insert); 81 82 /* Registration of default binfmt handlers */ 83 static inline void register_binfmt(struct linux_binfmt *fmt) 84 { 85 __register_binfmt(fmt, 0); 86 } 87 /* Same as above, but adds a new binfmt at the top of the list */ 88 static inline void insert_binfmt(struct linux_binfmt *fmt) 89 { 90 __register_binfmt(fmt, 1); 91 } 92 93 extern void unregister_binfmt(struct linux_binfmt *); 94 95 extern int prepare_binprm(struct linux_binprm *); 96 extern int __must_check remove_arg_zero(struct linux_binprm *); 97 extern int search_binary_handler(struct linux_binprm *); 98 extern int flush_old_exec(struct linux_binprm * bprm); 99 extern void setup_new_exec(struct linux_binprm * bprm); 100 extern void would_dump(struct linux_binprm *, struct file *); 101 102 extern int suid_dumpable; 103 104 /* Stack area protections */ 105 #define EXSTACK_DEFAULT 0 /* Whatever the arch defaults to */ 106 #define EXSTACK_DISABLE_X 1 /* Disable executable stacks */ 107 #define EXSTACK_ENABLE_X 2 /* Enable executable stacks */ 108 109 extern int setup_arg_pages(struct linux_binprm * bprm, 110 unsigned long stack_top, 111 int executable_stack); 112 extern int bprm_change_interp(char *interp, struct linux_binprm *bprm); 113 extern int copy_strings_kernel(int argc, const char *const *argv, 114 struct linux_binprm *bprm); 115 extern int prepare_bprm_creds(struct linux_binprm *bprm); 116 extern void install_exec_creds(struct linux_binprm *bprm); 117 extern void set_binfmt(struct linux_binfmt *new); 118 extern void free_bprm(struct linux_binprm *); 119 extern ssize_t read_code(struct file *, unsigned long, loff_t, size_t); 120 121 #endif /* _LINUX_BINFMTS_H */ 122