xref: /illumos-gate/usr/src/cmd/sgs/rtld/common/_elf.h (revision 2a8d6eba033e4713ab12b61178f0513f1f075482)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  *	Copyright (c) 1988 AT&T
24  *	  All Rights Reserved
25  *
26  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
27  * Use is subject to license terms.
28  */
29 #ifndef	__ELF_DOT_H
30 #define	__ELF_DOT_H
31 
32 #include <sys/types.h>
33 #include <sys/mman.h>
34 #include <elf.h>
35 #include <_rtld.h>
36 
37 #ifdef	__cplusplus
38 extern "C" {
39 #endif
40 
41 /*
42  * Common extern functions for ELF file class.
43  */
44 extern	int	elf_config(Rt_map *, int);
45 extern	Rtc_obj	*elf_config_ent(const char *, Word, int, const char **);
46 extern	void	elf_config_flt(Lm_list *, const char *, const char *,
47 		    Alist **, Aliste);
48 #if	defined(__i386)
49 extern	int	elf_copy_gen(Rt_map *);
50 #endif
51 extern	int	elf_copy_reloc(char *, Sym *, Rt_map *, void *, Sym *,
52 		    Rt_map *, const void *);
53 extern	Sym	*elf_find_sym(Slookup *, Rt_map **, uint_t *, int *);
54 extern	Sym	*elf_lazy_find_sym(Slookup *, Rt_map **, uint_t *, int *);
55 extern	Rt_map	*elf_lazy_load(Rt_map *, Slookup *, uint_t, const char *,
56 		    int *);
57 extern	Sym	*elf_lookup_filtee(Slookup *, Rt_map **, uint_t *, uint_t,
58 		    int *);
59 extern	int	elf_mach_flags_check(Rej_desc *, Ehdr *);
60 extern	Rt_map	*elf_new_lmp(Lm_list *, Aliste, Fdesc *, Addr, size_t, void *,
61 		    int *);
62 extern	Rt_map	*elf_obj_file(Lm_list *, Aliste, const char *,
63 		    mmapobj_result_t *, mmapobj_result_t *, uint_t);
64 extern	Rt_map	*elf_obj_fini(Lm_list *, Rt_map *, int *);
65 extern	void	elf_plt_init(void *, caddr_t);
66 #if	defined(__sparcv9)
67 extern	void	elf_plt2_init(uint_t *, Rt_map *);
68 #endif
69 extern	int	elf_reloc(Rt_map *, uint_t, int *, APlist **);
70 extern	void	elf_reloc_bad(Rt_map *, void *, uchar_t, ulong_t,
71 		    ulong_t);
72 extern	int	elf_reloc_error(Rt_map *, const char *, void *, uint_t);
73 extern	ulong_t	elf_reloc_relative(ulong_t, ulong_t, ulong_t, ulong_t,
74 		    Rt_map *, APlist **);
75 extern	ulong_t	elf_reloc_relative_count(ulong_t, ulong_t, ulong_t, ulong_t,
76 		    Rt_map *, APlist **);
77 extern	int	elf_rtld_load();
78 extern	long	elf_static_tls(Rt_map *, Sym *, void *, uchar_t, char *,
79 		    ulong_t, long);
80 extern	Fct	*elf_verify(caddr_t, size_t, Fdesc *, const char *, Rej_desc *);
81 extern	int	elf_verify_vers(const char *, Rt_map *, Rt_map *);
82 
83 /*
84  * Padinfo
85  *
86  * Used to track the which PLTpadd entries have been used and
87  * to where they are bound.
88  *
89  * NOTE: these are only currently used for SparcV9
90  */
91 typedef struct pltpadinfo {
92 	Addr	pp_addr;
93 	void	*pp_plt;
94 } Pltpadinfo;
95 
96 /*
97  * Private data for an ELF file class.
98  */
99 typedef struct _rt_elf_private {
100 	void		*e_symtab;	/* symbol table */
101 	void		*e_sunwsymtab;	/* symtab augmented with local fcns */
102 	uint_t		*e_hash;	/* hash table */
103 	char		*e_strtab;	/* string table */
104 	void		*e_reloc;	/* relocation table */
105 	uint_t		*e_pltgot;	/* addrs for procedure linkage table */
106 	void		*e_jmprel;	/* plt relocations */
107 	ulong_t		e_sunwsortent;	/* size of sunw[sym|tls]sort entry */
108 	uint_t		*e_sunwsymsort;	/* sunwsymtab indices sorted by addr */
109 	ulong_t		e_sunwsymsortsz; /* size of sunwsymtab */
110 	ulong_t		e_sunwsymsz;	/* size of e_sunwsymtab */
111 	ulong_t		e_pltrelsize;	/* size of PLT relocation entries */
112 	ulong_t		e_relsz;	/* size of relocs */
113 	ulong_t		e_relent;	/* size of base reloc entry */
114 	ulong_t		e_movesz;	/* size of movetabs */
115 	ulong_t		e_moveent;	/* size of base movetab entry */
116 	ulong_t		e_tlsstatoff;	/* TLS offset into static block */
117 	void		*e_movetab;	/* movetable address */
118 	Phdr		*e_pttls;	/* PT_TLS */
119 	Phdr		*e_ptunwind;	/* PT_SUNW_UNWIND (amd64 specific) */
120 	ulong_t		e_syment;	/* size of symtab entry */
121 	Verneed		*e_verneed;	/* versions needed by this image and */
122 	int		e_verneednum;	/*	their associated count */
123 	Verdef		*e_verdef;	/* versions defined by this image and */
124 	int		e_verdefnum;	/*	their associated count */
125 	Versym 		*e_versym;	/* Per-symbol versions */
126 	ulong_t		e_syminent;	/* syminfo entry size */
127 	void		*e_pltpad;	/* PLTpad table */
128 	void		*e_pltpadend;	/* end of PLTpad table */
129 } Rt_elfp;
130 
131 /*
132  * Macros for getting to linker ELF private data.
133  */
134 #define	ELFPRV(X)		((X)->rt_priv)
135 #define	SYMTAB(X)		(((Rt_elfp *)(X)->rt_priv)->e_symtab)
136 #define	SUNWSYMTAB(X)		(((Rt_elfp *)(X)->rt_priv)->e_sunwsymtab)
137 #define	HASH(X)			(((Rt_elfp *)(X)->rt_priv)->e_hash)
138 #define	STRTAB(X)		(((Rt_elfp *)(X)->rt_priv)->e_strtab)
139 #define	REL(X)			(((Rt_elfp *)(X)->rt_priv)->e_reloc)
140 #define	PLTGOT(X)		(((Rt_elfp *)(X)->rt_priv)->e_pltgot)
141 #define	MOVESZ(X)		(((Rt_elfp *)(X)->rt_priv)->e_movesz)
142 #define	MOVEENT(X)		(((Rt_elfp *)(X)->rt_priv)->e_moveent)
143 #define	MOVETAB(X)		(((Rt_elfp *)(X)->rt_priv)->e_movetab)
144 #define	JMPREL(X)		(((Rt_elfp *)(X)->rt_priv)->e_jmprel)
145 #define	SUNWSYMSZ(X)		(((Rt_elfp *)(X)->rt_priv)->e_sunwsymsz)
146 #define	PTTLS(X)		(((Rt_elfp *)(X)->rt_priv)->e_pttls)
147 #define	PTUNWIND(X)		(((Rt_elfp *)(X)->rt_priv)->e_ptunwind)
148 #define	TLSSTATOFF(X)		(((Rt_elfp *)(X)->rt_priv)->e_tlsstatoff)
149 #define	PLTRELSZ(X)		(((Rt_elfp *)(X)->rt_priv)->e_pltrelsize)
150 #define	RELSZ(X)		(((Rt_elfp *)(X)->rt_priv)->e_relsz)
151 #define	RELENT(X)		(((Rt_elfp *)(X)->rt_priv)->e_relent)
152 #define	SYMENT(X)		(((Rt_elfp *)(X)->rt_priv)->e_syment)
153 #define	VERNEED(X)		(((Rt_elfp *)(X)->rt_priv)->e_verneed)
154 #define	VERNEEDNUM(X)		(((Rt_elfp *)(X)->rt_priv)->e_verneednum)
155 #define	VERDEF(X)		(((Rt_elfp *)(X)->rt_priv)->e_verdef)
156 #define	VERDEFNUM(X)		(((Rt_elfp *)(X)->rt_priv)->e_verdefnum)
157 #define	VERSYM(X)		(((Rt_elfp *)(X)->rt_priv)->e_versym)
158 #define	SYMINENT(X)		(((Rt_elfp *)(X)->rt_priv)->e_syminent)
159 #define	PLTPAD(X)		(((Rt_elfp *)(X)->rt_priv)->e_pltpad)
160 #define	PLTPADEND(X)		(((Rt_elfp *)(X)->rt_priv)->e_pltpadend)
161 #define	SUNWSORTENT(X)		(((Rt_elfp *)(X)->rt_priv)->e_sunwsortent)
162 #define	SUNWSYMSORT(X)		(((Rt_elfp *)(X)->rt_priv)->e_sunwsymsort)
163 #define	SUNWSYMSORTSZ(X)	(((Rt_elfp *)(X)->rt_priv)->e_sunwsymsortsz)
164 
165 /*
166  * Most of the above macros are used from ELF specific routines, however there
167  * are a couple of instances where we need to ensure the file being processed
168  * is ELF before dereferencing the macro.
169  */
170 #define	THIS_IS_ELF(X)		(FCT(X) == &elf_fct)
171 #define	THIS_IS_NOT_ELF(X)	(FCT(X) != &elf_fct)
172 
173 #ifdef	__cplusplus
174 }
175 #endif
176 
177 #endif	/* __ELF_DOT_H */
178