xref: /freebsd/sys/sys/link_elf.h (revision c56df6ce71ae96f00b088790d3ad2e0ebebdd59a)
1 /*-
2  * SPDX-License-Identifier: BSD-4-Clause
3  *
4  * Copyright (c) 1993 Paul Kranenburg
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  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *      This product includes software developed by Paul Kranenburg.
18  * 4. The name of the author may not be used to endorse or promote products
19  *    derived from this software without specific prior written permission
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 /*
34  * RRS section definitions.
35  *
36  * The layout of some data structures defined in this header file is
37  * such that we can provide compatibility with the SunOS 4.x shared
38  * library scheme.
39  */
40 
41 #ifndef _SYS_LINK_ELF_H_
42 #define	_SYS_LINK_ELF_H_
43 
44 #include <sys/elf.h>
45 
46 /*
47  * Flags that describe the origin of the entries in Dl_serinfo.
48  * SunOS has these in <sys/link.h>, we follow the suit.
49  */
50 #define	LA_SER_ORIG	0x01	/* original (needed) name */
51 #define	LA_SER_LIBPATH	0x02	/* LD_LIBRARY_PATH entry prepended */
52 #define	LA_SER_RUNPATH	0x04	/* runpath entry prepended */
53 #define	LA_SER_CONFIG	0x08	/* configuration entry prepended */
54 #define	LA_SER_DEFAULT	0x40	/* default path prepended */
55 #define	LA_SER_SECURE	0x80	/* default (secure) path prepended */
56 
57 typedef struct link_map {
58 	caddr_t		l_base;			/* Base Address of library */
59 	const char	*l_name;		/* Absolute Path to Library */
60 	const void	*l_ld;			/* Pointer to .dynamic in memory */
61 	struct link_map	*l_next, *l_prev;	/* linked list of mapped libs */
62 	caddr_t		l_addr;			/* Load Offset of library */
63 	const char	*l_refname;		/* object we are filtering for */
64 } Link_map;
65 
66 struct r_debug {
67 	int		r_version;		/* Currently '1' */
68 	struct link_map *r_map;			/* list of loaded images */
69 	void		(*r_brk)(struct r_debug *, struct link_map *);
70 						/* pointer to break point */
71 	enum {
72 		RT_CONSISTENT,			/* things are stable */
73 		RT_ADD,				/* adding a shared library */
74 		RT_DELETE			/* removing a shared library */
75 	}		r_state;
76 	void		*r_ldbase;		/* Base address of rtld */
77 };
78 
79 #define	R_DEBUG_VERSION		1
80 
81 struct dl_phdr_info
82 {
83 	Elf_Addr dlpi_addr;			/* module relocation base */
84 	const char *dlpi_name;			/* module name */
85 	const Elf_Phdr *dlpi_phdr;		/* pointer to module's phdr */
86 	Elf_Half dlpi_phnum;			/* number of entries in phdr */
87 	unsigned long long int dlpi_adds;	/* total # of loads */
88 	unsigned long long int dlpi_subs;	/* total # of unloads */
89 	size_t dlpi_tls_modid;
90 	void *dlpi_tls_data;
91 };
92 
93 __BEGIN_DECLS
94 
95 typedef int (*__dl_iterate_hdr_callback)(struct dl_phdr_info *, size_t, void *);
96 int dl_iterate_phdr(__dl_iterate_hdr_callback, void *);
97 int _rtld_addr_phdr(const void *, struct dl_phdr_info *);
98 int _rtld_get_stack_prot(void);
99 int _rtld_is_dlopened(void *);
100 const char *rtld_get_var(const char *name);
101 int rtld_set_var(const char *name, const char *val);
102 
103 #ifdef __ARM_EABI__
104 void * dl_unwind_find_exidx(const void *, int *);
105 #endif
106 
107 __END_DECLS
108 
109 #endif /* _SYS_LINK_ELF_H_ */
110