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;       /* beginning of envv in buf */
  50         char *endp;             /* current `end' pointer of arg & env strings */
  51         char *fname;            /* pointer to filename of executable (system space) */
  52         char *fname_buf;        /* pointer to optional malloc(M_TEMP) buffer */
  53         int stringspace;        /* space left in arg & env buffer */
  54         int argc;               /* count of argument strings */
  55         int envc;               /* count of environment strings */
  56         int fd;                 /* file descriptor of the executable */
  57         struct filedesc *fdp;   /* new file descriptor table */
  58 };
  59
  60 struct image_params {
  61         struct proc *proc;      /* our process struct */
  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; /* head 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 vmspace_destroyed; /* flag - we've blown away original vm space */
  70 #define IMGACT_SHELL    0x1
  71 #define IMGACT_BINMISC  0x2
  72         unsigned char interpreted;      /* mask of interpreters that have run */
  73         char opened;            /* flag - we have opened executable vnode */
  74         char *interpreter_name; /* name of the interpreter */
  75         void *auxargs;          /* ELF Auxinfo structure pointer */
  76         struct sf_buf *firstpage;       /* first page that we mapped */
  77         unsigned long ps_strings; /* PS_STRINGS for BSD/OS binaries */
  78         struct image_args *args;        /* system call arguments */
  79         struct sysentvec *sysent;       /* system entry vector */
  80         char *execpath;
  81         unsigned long execpathp;
  82         char *freepath;
  83         unsigned long canary;
  84         int canarylen;
  85         unsigned long pagesizes;
  86         int pagesizeslen;
  87         vm_prot_t stack_prot;
  88         u_long stack_sz;
  89         u_long eff_stack_sz;
  90         struct ucred *newcred;          /* new credentials if changing */
  91         bool credential_setid;          /* true if becoming setid */
  92         bool textset;
  93         u_int map_flags;
  94 };
  95
  96 #ifdef _KERNEL
  97 struct sysentvec;
  98 struct thread;
  99 struct vmspace;
 100
 101 int     exec_alloc_args(struct image_args *);
 102 int     exec_check_permissions(struct image_params *);
 103 register_t *exec_copyout_strings(struct image_params *);
 104 void    exec_free_args(struct image_args *);
 105 int     exec_new_vmspace(struct image_params *, struct sysentvec *);
 106 void    exec_setregs(struct thread *, struct image_params *, u_long);
 107 int     exec_shell_imgact(struct image_params *);
 108 int     exec_copyin_args(struct image_args *, char *, enum uio_seg,
 109         char **, char **);
 110 int     exec_copyin_data_fds(struct thread *, struct image_args *, const void *,
 111         size_t, const int *, size_t);
 112 int     pre_execve(struct thread *td, struct vmspace **oldvmspace);
 113 void    post_execve(struct thread *td, int error, struct vmspace *oldvmspace);
 114 #endif
 115
 116 #endif /* !_SYS_IMGACT_H_ */