FreeBSD/Linux Kernel Cross Reference
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 #if (defined(__LP64__) && __ELF_WORD_SIZE == 32)
43 #define AUXARGS_ENTRY_PTR(pos, id, ptr) \
44 {(pos)->a_type = (id); (pos)->a_un.a_val = (uintptr_t)(ptr); (pos)++;}
45 #else
46 #define AUXARGS_ENTRY_PTR(pos, id, ptr) \
47 {(pos)->a_type = (id); (pos)->a_un.a_ptr = (ptr); (pos)++;}
48 #endif
49
50 struct image_params;
51 struct thread;
52 struct vnode;
53 struct note_info_list;
54 struct sbuf;
55
56 /*
57 * Structure used to pass information from the loader to the
58 * stack fixup routine.
59 */
60 typedef struct {
61 Elf_Ssize execfd;
62 Elf_Size phdr;
63 Elf_Size phent;
64 Elf_Size phnum;
65 Elf_Size pagesz;
66 Elf_Size base;
67 Elf_Size flags;
68 Elf_Size entry;
69 Elf_Word hdr_eflags; /* e_flags field from ehdr */
70 } __ElfN(Auxargs);
71
72 typedef struct {
73 Elf_Note hdr;
74 const char * vendor;
75 int flags;
76 bool (*trans_osrel)(const Elf_Note *, int32_t *);
77 #define BN_CAN_FETCH_OSREL 0x0001 /* Deprecated. */
78 #define BN_TRANSLATE_OSREL 0x0002 /* Use trans_osrel to fetch osrel */
79 /* after checking the image ABI specification, if needed. */
80 } Elf_Brandnote;
81
82 typedef struct {
83 int brand;
84 int machine;
85 const char *compat_3_brand; /* pre Binutils 2.10 method (FBSD 3) */
86 const char *emul_path;
87 const char *interp_path;
88 struct sysentvec *sysvec;
89 const char *interp_newpath;
90 int flags;
91 Elf_Brandnote *brand_note;
92 boolean_t (*header_supported)(struct image_params *,
93 int32_t *, uint32_t *);
94 /* High 8 bits of flags is private to the ABI */
95 #define BI_CAN_EXEC_DYN 0x0001
96 #define BI_BRAND_NOTE 0x0002 /* May have note.ABI-tag section. */
97 #define BI_BRAND_NOTE_MANDATORY 0x0004 /* Must have note.ABI-tag section. */
98 #define BI_BRAND_ONLY_STATIC 0x0008 /* Match only interp-less binaries. */
99 } __ElfN(Brandinfo);
100
101 __ElfType(Auxargs);
102 __ElfType(Brandinfo);
103
104 #define MAX_BRANDS 8
105 #define FREEBSD_ABI_VENDOR "FreeBSD"
106
107 typedef void (*outfunc_t)(void *, struct sbuf *, size_t *);
108
109 /* Closure for __elfN(size_segments)(). */
110 struct sseg_closure {
111 int count; /* Count of writable segments. */
112 size_t size; /* Total size of all writable segments. */
113 };
114
115 bool __elfN(brand_inuse)(Elf_Brandinfo *entry);
116 int __elfN(insert_brand_entry)(Elf_Brandinfo *entry);
117 int __elfN(remove_brand_entry)(Elf_Brandinfo *entry);
118 int __elfN(freebsd_fixup)(uintptr_t *, struct image_params *);
119 int __elfN(coredump)(struct thread *, struct vnode *, off_t, int);
120 size_t __elfN(populate_note)(int, void *, void *, size_t, void **);
121 int __elfN(freebsd_copyout_auxargs)(struct image_params *, uintptr_t);
122 void __elfN(puthdr)(struct thread *, void *, size_t, int, size_t, int);
123 void __elfN(prepare_notes)(struct thread *, struct note_info_list *,
124 size_t *);
125 void __elfN(size_segments)(struct thread *, struct sseg_closure *, int);
126 size_t __elfN(register_note)(struct thread *, struct note_info_list *,
127 int, outfunc_t, void *);
128
129 /* Machine specific function to dump per-thread information. */
130 void __elfN(dump_thread)(struct thread *, void *, size_t *);
131
132 extern int __elfN(fallback_brand);
133 extern Elf_Brandnote __elfN(freebsd_brandnote);
134 extern Elf_Brandnote __elfN(kfreebsd_brandnote);
135 #endif /* _KERNEL */
136
137 #endif /* !_SYS_IMGACT_ELF_H_ */
Cache object: b3df1e778ffa75df29ae407762403472
|