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 };
  96
  97 #ifdef _KERNEL
  98 struct sysentvec;
  99 struct thread;
 100 struct vmspace;
 101
 102 int     exec_alloc_args(struct image_args *);
 103 int     exec_args_add_arg(struct image_args *args, const char *argp,
 104             enum uio_seg segflg);
 105 int     exec_args_add_env(struct image_args *args, const char *envp,
 106             enum uio_seg segflg);
 107 int     exec_args_add_fname(struct image_args *args, const char *fname,
 108             enum uio_seg segflg);
 109 int     exec_args_adjust_args(struct image_args *args, size_t consume,
 110             ssize_t extend);
 111 char    *exec_args_get_begin_envv(struct image_args *args);
 112 int     exec_check_permissions(struct image_params *);
 113 void    exec_cleanup(struct thread *td, struct vmspace *);
 114 int     exec_copyout_strings(struct image_params *, uintptr_t *);
 115 void    exec_free_args(struct image_args *);
 116 int     exec_map_stack(struct image_params *);
 117 int     exec_new_vmspace(struct image_params *, struct sysentvec *);
 118 void    exec_setregs(struct thread *, struct image_params *, uintptr_t);
 119 int     exec_shell_imgact(struct image_params *);
 120 int     exec_copyin_args(struct image_args *, const char *, enum uio_seg,
 121         char **, char **);
 122 int     pre_execve(struct thread *td, struct vmspace **oldvmspace);
 123 void    post_execve(struct thread *td, int error, struct vmspace *oldvmspace);
 124 #endif
 125
 126 #endif /* !_SYS_IMGACT_H_ */