sys/sys/imgact_elf.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-3-Clause
   3  *
   4  * Copyright (c) 1995-1996 Søren Schmidt
   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  *    in this position and unchanged.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  * 3. The name of the author may not be used to endorse or promote products
  17  *    derived from this software without specific prior written permission
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  20  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  21  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  22  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  23  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  24  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  28  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  *
  30  * $FreeBSD$
  31  */
  32
  33 #ifndef _SYS_IMGACT_ELF_H_
  34 #define _SYS_IMGACT_ELF_H_
  35
  36 #include <machine/elf.h>
  37
  38 #ifdef _KERNEL
  39
  40 #define AUXARGS_ENTRY(pos, id, val) \
  41     {(pos)->a_type = (id); (pos)->a_un.a_val = (val); (pos)++;}
  42
  43 struct image_params;
  44 struct thread;
  45 struct vnode;
  46
  47 /*
  48  * Structure used to pass information from the loader to the
  49  * stack fixup routine.
  50  */
  51 typedef struct {
  52         Elf_Ssize       execfd;
  53         Elf_Size        phdr;
  54         Elf_Size        phent;
  55         Elf_Size        phnum;
  56         Elf_Size        pagesz;
  57         Elf_Size        base;
  58         Elf_Size        flags;
  59         Elf_Size        entry;
  60         Elf_Word        hdr_eflags;             /* e_flags field from ehdr */
  61 } __ElfN(Auxargs);
  62
  63 typedef struct {
  64         Elf_Note        hdr;
  65         const char *    vendor;
  66         int             flags;
  67         bool            (*trans_osrel)(const Elf_Note *, int32_t *);
  68 #define BN_CAN_FETCH_OSREL      0x0001  /* Deprecated. */
  69 #define BN_TRANSLATE_OSREL      0x0002  /* Use trans_osrel to fetch osrel */
  70                 /* after checking the image ABI specification, if needed. */
  71 } Elf_Brandnote;
  72
  73 typedef struct {
  74         int brand;
  75         int machine;
  76         const char *compat_3_brand;     /* pre Binutils 2.10 method (FBSD 3) */
  77         const char *emul_path;
  78         const char *interp_path;
  79         struct sysentvec *sysvec;
  80         const char *interp_newpath;
  81         int flags;
  82         Elf_Brandnote *brand_note;
  83         boolean_t       (*header_supported)(struct image_params *);
  84 #define BI_CAN_EXEC_DYN         0x0001
  85 #define BI_BRAND_NOTE           0x0002  /* May have note.ABI-tag section. */
  86 #define BI_BRAND_NOTE_MANDATORY 0x0004  /* Must have note.ABI-tag section. */
  87 #define BI_BRAND_ONLY_STATIC    0x0008  /* Match only interp-less binaries. */
  88 } __ElfN(Brandinfo);
  89
  90 __ElfType(Auxargs);
  91 __ElfType(Brandinfo);
  92
  93 #define MAX_BRANDS      8
  94
  95 int     __elfN(brand_inuse)(Elf_Brandinfo *entry);
  96 int     __elfN(insert_brand_entry)(Elf_Brandinfo *entry);
  97 int     __elfN(remove_brand_entry)(Elf_Brandinfo *entry);
  98 int     __elfN(freebsd_fixup)(register_t **, struct image_params *);
  99 int     __elfN(coredump)(struct thread *, struct vnode *, off_t, int);
 100 size_t  __elfN(populate_note)(int, void *, void *, size_t, void **);
 101 void    __elfN(stackgap)(struct image_params *, u_long *);
 102
 103 /* Machine specific function to dump per-thread information. */
 104 void    __elfN(dump_thread)(struct thread *, void *, size_t *);
 105
 106 extern int __elfN(fallback_brand);
 107 extern Elf_Brandnote __elfN(freebsd_brandnote);
 108 extern Elf_Brandnote __elfN(kfreebsd_brandnote);
 109 #endif /* _KERNEL */
 110
 111 #endif /* !_SYS_IMGACT_ELF_H_ */