imgact_elf.h revision 331722 
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: stable/11/sys/sys/imgact_elf.h 331722 2018-03-29 02:50:57Z eadler $
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
40struct image_params;
41struct thread;
42struct vnode;
43
44/*
45 * Structure used to pass information from the loader to the
46 * stack fixup routine.
47 */
48typedef 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
60typedef struct {
61	Elf_Note	hdr;
62	const char *	vendor;
63	int		flags;
64	boolean_t	(*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
70typedef 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
92int	__elfN(brand_inuse)(Elf_Brandinfo *entry);
93int	__elfN(insert_brand_entry)(Elf_Brandinfo *entry);
94int	__elfN(remove_brand_entry)(Elf_Brandinfo *entry);
95int	__elfN(freebsd_fixup)(register_t **, struct image_params *);
96int	__elfN(coredump)(struct thread *, struct vnode *, off_t, int);
97size_t	__elfN(populate_note)(int, void *, void *, size_t, void **);
98
99/* Machine specific function to dump per-thread information. */
100void	__elfN(dump_thread)(struct thread *, void *, size_t *);
101
102extern int __elfN(fallback_brand);
103extern Elf_Brandnote __elfN(freebsd_brandnote);
104extern Elf_Brandnote __elfN(kfreebsd_brandnote);
105#endif /* _KERNEL */
106
107#endif /* !_SYS_IMGACT_ELF_H_ */
108