xref: /freebsd/sys/sys/link_elf.h (revision 848ee2a3a8b47c9905fc51fefcf60eb371edbb98)
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  * $FreeBSD$
33  */
34 
35 /*
36  * RRS section definitions.
37  *
38  * The layout of some data structures defined in this header file is
39  * such that we can provide compatibility with the SunOS 4.x shared
40  * library scheme.
41  */
42 
43 #ifndef _SYS_LINK_ELF_H_
44 #define	_SYS_LINK_ELF_H_
45 
46 #include <sys/elf.h>
47 
48 /*
49  * Flags that describe the origin of the entries in Dl_serinfo.
50  * SunOS has these in <sys/link.h>, we follow the suit.
51  */
52 #define	LA_SER_ORIG	0x01	/* original (needed) name */
53 #define	LA_SER_LIBPATH	0x02	/* LD_LIBRARY_PATH entry prepended */
54 #define	LA_SER_RUNPATH	0x04	/* runpath entry prepended */
55 #define	LA_SER_CONFIG	0x08	/* configuration entry prepended */
56 #define	LA_SER_DEFAULT	0x40	/* default path prepended */
57 #define	LA_SER_SECURE	0x80	/* default (secure) path prepended */
58 
59 typedef struct link_map {
60 	caddr_t		l_base;			/* Base Address of library */
61 #ifdef __mips__
62 	caddr_t		l_xxx;			/* unused */
63 #endif
64 	const char	*l_name;		/* Absolute Path to Library */
65 	const void	*l_ld;			/* Pointer to .dynamic in memory */
66 	struct link_map	*l_next, *l_prev;	/* linked list of of mapped libs */
67 	caddr_t		l_addr;			/* Load Offset of library */
68 	const char	*l_refname;		/* object we are filtering for */
69 } Link_map;
70 
71 struct r_debug {
72 	int		r_version;		/* Currently '1' */
73 	struct link_map *r_map;			/* list of loaded images */
74 	void		(*r_brk)(struct r_debug *, struct link_map *);
75 						/* pointer to break point */
76 	enum {
77 		RT_CONSISTENT,			/* things are stable */
78 		RT_ADD,				/* adding a shared library */
79 		RT_DELETE			/* removing a shared library */
80 	}		r_state;
81 	void		*r_ldbase;		/* Base address of rtld */
82 };
83 
84 #define	R_DEBUG_VERSION		1
85 
86 struct dl_phdr_info
87 {
88 	Elf_Addr dlpi_addr;			/* module relocation base */
89 	const char *dlpi_name;			/* module name */
90 	const Elf_Phdr *dlpi_phdr;		/* pointer to module's phdr */
91 	Elf_Half dlpi_phnum;			/* number of entries in phdr */
92 	unsigned long long int dlpi_adds;	/* total # of loads */
93 	unsigned long long int dlpi_subs;	/* total # of unloads */
94 	size_t dlpi_tls_modid;
95 	void *dlpi_tls_data;
96 };
97 
98 __BEGIN_DECLS
99 
100 typedef int (*__dl_iterate_hdr_callback)(struct dl_phdr_info *, size_t, void *);
101 extern int dl_iterate_phdr(__dl_iterate_hdr_callback, void *);
102 int _rtld_addr_phdr(const void *, struct dl_phdr_info *);
103 int _rtld_get_stack_prot(void);
104 int _rtld_is_dlopened(void *);
105 
106 #ifdef __ARM_EABI__
107 void * dl_unwind_find_exidx(const void *, int *);
108 #endif
109 
110 __END_DECLS
111 
112 #endif /* _SYS_LINK_ELF_H_ */
113