xref: /freebsd/sys/sys/link_elf.h (revision fa9012aef1ad596a99950f986cf1fb31111c034a)
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;		/* not used */
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 };
82 
83 struct dl_phdr_info
84 {
85 	Elf_Addr dlpi_addr;			/* module relocation base */
86 	const char *dlpi_name;			/* module name */
87 	const Elf_Phdr *dlpi_phdr;		/* pointer to module's phdr */
88 	Elf_Half dlpi_phnum;			/* number of entries in phdr */
89 	unsigned long long int dlpi_adds;	/* total # of loads */
90 	unsigned long long int dlpi_subs;	/* total # of unloads */
91 	size_t dlpi_tls_modid;
92 	void *dlpi_tls_data;
93 };
94 
95 __BEGIN_DECLS
96 
97 typedef int (*__dl_iterate_hdr_callback)(struct dl_phdr_info *, size_t, void *);
98 extern int dl_iterate_phdr(__dl_iterate_hdr_callback, void *);
99 int _rtld_addr_phdr(const void *, struct dl_phdr_info *);
100 int _rtld_get_stack_prot(void);
101 int _rtld_is_dlopened(void *);
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