FreeBSD/Linux Kernel Cross Reference
sys/sys/imgact.h
1 /*-
2 * SPDX-License-Identifier: BSD-3-Clause
3 *
4 * Copyright (c) 1993, David Greenman
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. Neither the name of the University nor the names of its contributors
16 * may be used to endorse or promote products derived from this software
17 * without specific prior written permission.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * SUCH DAMAGE.
30 *
31 * $FreeBSD$
32 */
33
34 #ifndef _SYS_IMGACT_H_
35 #define _SYS_IMGACT_H_
36
37 #include <sys/_uio.h>
38
39 #include <vm/vm.h>
40
41 #define MAXSHELLCMDLEN PAGE_SIZE
42
43 struct ucred;
44
45 struct image_args {
46 char *buf; /* pointer to string buffer */
47 void *bufkva; /* cookie for string buffer KVA */
48 char *begin_argv; /* beginning of argv in buf */
49 char *begin_envv; /* (interal use only) beginning of envv in buf,
50 * access with exec_args_get_begin_envv(). */
51 char *endp; /* current `end' pointer of arg & env strings */
52 char *fname; /* pointer to filename of executable (system space) */
53 char *fname_buf; /* pointer to optional malloc(M_TEMP) buffer */
54 int stringspace; /* space left in arg & env buffer */
55 int argc; /* count of argument strings */
56 int envc; /* count of environment strings */
57 int fd; /* file descriptor of the executable */
58 };
59
60 struct image_params {
61 struct proc *proc; /* our process */
62 struct label *execlabel; /* optional exec label */
63 struct vnode *vp; /* pointer to vnode of file to exec */
64 struct vm_object *object; /* The vm object for this vp */
65 struct vattr *attr; /* attributes of file */
66 const char *image_header; /* header of file to exec */
67 unsigned long entry_addr; /* entry address of target executable */
68 unsigned long reloc_base; /* load address of image */
69 char *interpreter_name; /* name of the interpreter */
70 void *auxargs; /* ELF Auxinfo structure pointer */
71 struct sf_buf *firstpage; /* first page that we mapped */
72 void *ps_strings; /* pointer to ps_string (user space) */
73 struct image_args *args; /* system call arguments */
74 struct sysentvec *sysent; /* system entry vector */
75 void *argv; /* pointer to argv (user space) */
76 void *envv; /* pointer to envv (user space) */
77 char *execpath;
78 void *execpathp;
79 char *freepath;
80 void *canary;
81 int canarylen;
82 void *pagesizes;
83 int pagesizeslen;
84 vm_prot_t stack_prot;
85 u_long stack_sz;
86 struct ucred *newcred; /* new credentials if changing */
87 #define IMGACT_SHELL 0x1
88 #define IMGACT_BINMISC 0x2
89 unsigned char interpreted; /* mask of interpreters that have run */
90 bool credential_setid; /* true if becoming setid */
91 bool vmspace_destroyed; /* we've blown away original vm space */
92 bool opened; /* we have opened executable vnode */
93 bool textset;
94 u_int map_flags;
95 #define IMGP_ASLR_SHARED_PAGE 0x1
96 uint32_t imgp_flags;
97 struct vnode *interpreter_vp; /* vnode of the interpreter */
98 };
99
100 #ifdef _KERNEL
101 struct sysentvec;
102 struct thread;
103 struct vmspace;
104
105 int exec_alloc_args(struct image_args *);
106 int exec_args_add_arg(struct image_args *args, const char *argp,
107 enum uio_seg segflg);
108 int exec_args_add_env(struct image_args *args, const char *envp,
109 enum uio_seg segflg);
110 int exec_args_add_fname(struct image_args *args, const char *fname,
111 enum uio_seg segflg);
112 int exec_args_adjust_args(struct image_args *args, size_t consume,
113 ssize_t extend);
114 char *exec_args_get_begin_envv(struct image_args *args);
115 int exec_check_permissions(struct image_params *);
116 void exec_cleanup(struct thread *td, struct vmspace *);
117 int exec_copyout_strings(struct image_params *, uintptr_t *);
118 void exec_free_args(struct image_args *);
119 int exec_map_stack(struct image_params *);
120 int exec_new_vmspace(struct image_params *, struct sysentvec *);
121 void exec_setregs(struct thread *, struct image_params *, uintptr_t);
122 int exec_shell_imgact(struct image_params *);
123 int exec_copyin_args(struct image_args *, const char *, enum uio_seg,
124 char **, char **);
125 int pre_execve(struct thread *td, struct vmspace **oldvmspace);
126 void post_execve(struct thread *td, int error, struct vmspace *oldvmspace);
127 #endif
128
129 #endif /* !_SYS_IMGACT_H_ */
Cache object: b46254d80c98f79fd48c7e04643fddee
|