xref: /freebsd/sys/sys/imgact_elf.h (revision 325151a3)
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 thread;
41 
42 /*
43  * Structure used to pass infomation from the loader to the
44  * stack fixup routine.
45  */
46 typedef struct {
47 	Elf_Ssize	execfd;
48 	Elf_Size	phdr;
49 	Elf_Size	phent;
50 	Elf_Size	phnum;
51 	Elf_Size	pagesz;
52 	Elf_Size	base;
53 	Elf_Size	flags;
54 	Elf_Size	entry;
55 	Elf_Word	hdr_eflags;		/* e_flags field from ehdr */
56 } __ElfN(Auxargs);
57 
58 typedef struct {
59 	Elf_Note	hdr;
60 	const char *	vendor;
61 	int		flags;
62 	boolean_t	(*trans_osrel)(const Elf_Note *, int32_t *);
63 #define	BN_CAN_FETCH_OSREL	0x0001	/* Deprecated. */
64 #define	BN_TRANSLATE_OSREL	0x0002	/* Use trans_osrel to fetch osrel */
65 		/* after checking the image ABI specification, if needed. */
66 } Elf_Brandnote;
67 
68 typedef struct {
69 	int brand;
70 	int machine;
71 	const char *compat_3_brand;	/* pre Binutils 2.10 method (FBSD 3) */
72 	const char *emul_path;
73 	const char *interp_path;
74 	struct sysentvec *sysvec;
75 	const char *interp_newpath;
76 	int flags;
77 	Elf_Brandnote *brand_note;
78 	boolean_t	(*header_supported)(struct image_params *);
79 #define	BI_CAN_EXEC_DYN		0x0001
80 #define	BI_BRAND_NOTE		0x0002	/* May have note.ABI-tag section. */
81 #define	BI_BRAND_NOTE_MANDATORY	0x0004	/* Must have note.ABI-tag section. */
82 } __ElfN(Brandinfo);
83 
84 __ElfType(Auxargs);
85 __ElfType(Brandinfo);
86 
87 #define	MAX_BRANDS	8
88 
89 int	__elfN(brand_inuse)(Elf_Brandinfo *entry);
90 int	__elfN(insert_brand_entry)(Elf_Brandinfo *entry);
91 int	__elfN(remove_brand_entry)(Elf_Brandinfo *entry);
92 int	__elfN(freebsd_fixup)(register_t **, struct image_params *);
93 int	__elfN(coredump)(struct thread *, struct vnode *, off_t, int);
94 size_t	__elfN(populate_note)(int, void *, void *, size_t, void **);
95 
96 /* Machine specific function to dump per-thread information. */
97 void	__elfN(dump_thread)(struct thread *, void *, size_t *);
98 
99 extern int __elfN(fallback_brand);
100 extern Elf_Brandnote __elfN(freebsd_brandnote);
101 extern Elf_Brandnote __elfN(kfreebsd_brandnote);
102 #endif /* _KERNEL */
103 
104 #endif /* !_SYS_IMGACT_ELF_H_ */
105