sys/sys/imgact_elf.h

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