xref: /illumos-gate/usr/src/cmd/sgs/libld/common/_libld.h (revision 24fe0b3bf671e123467ce1df0b67cadd3614c8e4)
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 
30 /*
31  * Local include file for ld library.
32  */
33 
34 #ifndef	_LIBLD_DOT_H
35 #define	_LIBLD_DOT_H
36 
37 #include <libld.h>
38 #include <_libelf.h>
39 #include <debug.h>
40 #include <conv.h>
41 #include <msg.h>
42 #include <reloc_defs.h>
43 
44 #ifdef	__cplusplus
45 extern "C" {
46 #endif
47 
48 /*
49  * In order to allow for cross linking, we need to be able to build
50  * libld with support for multiple targets within a single object.
51  * This is done using a global variable (ld_targ) of type Target to
52  * access target-specific code for the current target via indirection.
53  */
54 
55 /*
56  * Machine information for target
57  */
58 typedef struct {
59 	Half		m_mach;		/* ELF machine code for target */
60 	Half		m_machplus;	/* Alt ELF machine code for target */
61 					/*	Used for EM_SPARC32PLUS */
62 	Word		m_flagsplus;	/* ELF header flags used to identify */
63 					/*	a machplus object */
64 	uchar_t		m_class;	/* Target ELFCLASS */
65 	uchar_t		m_data;		/* Target byte order */
66 
67 	Xword		m_segm_align;	/* segment alignment */
68 	Xword		m_segm_origin;	/* Default 1st segment origin */
69 	Xword		m_segm_aorigin;	/* Alternative 1st segment origin */
70 	Word		m_dataseg_perm;	/* data segment permission mask */
71 	Word		m_word_align;	/* alignment to use for Word sections */
72 	const char	*m_def_interp;	/* Def. interpreter for dyn objects */
73 
74 	/* Relocation type codes */
75 	Word		m_r_arrayaddr;
76 	Word		m_r_copy;
77 	Word		m_r_glob_dat;
78 	Word		m_r_jmp_slot;
79 	Word		m_r_num;
80 	Word		m_r_none;
81 	Word		m_r_relative;
82 	Word		m_r_register;
83 
84 	/* Relocation related constants */
85 	Word		m_rel_dt_count;	/* Either DT_REL or DT_RELA */
86 	Word		m_rel_dt_ent;	/* Either DT_RELENT or DT_RELAENT */
87 	Word		m_rel_dt_size;	/* Either DT_RELSZ or DT_RELASZ */
88 	Word		m_rel_dt_type;	/* Either DT_RELCOUNT or DT_RELACOUNT */
89 	Word		m_rel_sht_type;	/* Either SHT_REL or SHT_RELA */
90 
91 	/* GOT related constants */
92 	Word		m_got_entsize;
93 	Word		m_got_xnumber;	/* reserved # of got ents */
94 
95 	/* PLT related constants */
96 	Word		m_plt_align;
97 	Word		m_plt_entsize;
98 	Word		m_plt_reservsz;
99 	Word		m_plt_shf_flags;
100 
101 	/* Section type of .eh_frame/.eh_frame_hdr sections */
102 	Word		m_sht_unwind;
103 
104 	Word		m_dt_register;
105 } Target_mach;
106 
107 
108 /*
109  * Section identifiers, used to order sections in output object
110  */
111 typedef struct {
112 	Word		id_array;
113 	Word		id_bss;
114 	Word		id_cap;
115 	Word		id_data;
116 	Word		id_dynamic;
117 	Word		id_dynsort;
118 	Word		id_dynstr;
119 	Word		id_dynsym;
120 	Word		id_dynsym_ndx;
121 	Word		id_got;
122 	Word		id_gotdata;
123 	Word		id_hash;
124 	Word		id_interp;
125 	Word		id_lbss;
126 	Word		id_ldynsym;
127 	Word		id_note;
128 	Word		id_null;
129 	Word		id_plt;
130 	Word		id_rel;
131 	Word		id_strtab;
132 	Word		id_syminfo;
133 	Word		id_symtab;
134 	Word		id_symtab_ndx;
135 	Word		id_text;
136 	Word		id_tls;
137 	Word		id_tlsbss;
138 	Word		id_unknown;
139 	Word		id_unwind;
140 	Word		id_unwindhdr;
141 	Word		id_user;
142 	Word		id_version;
143 } Target_machid;
144 
145 /*
146  * Target_nullfunc supplies machine code for generating a
147  *
148  *	void (*)(void)
149  *
150  * unnamed function. Such a function can be called, and returns
151  * immediately without doing any work. This is used to back FUNC
152  * symbol definitions added with a mapfile.
153  *
154  * The machine instructions are specified as an array of bytes rather
155  * than a larger integer type in order to avoid byte order issues that
156  * can otherwise occur in cross linking.
157  */
158 typedef struct {
159 	const uchar_t	*nf_template;	/* Array of machine inst. bytes */
160 	size_t		nf_size;	/* # bytes in nf_template */
161 } Target_nullfunc;
162 
163 /*
164  * Target_machrel holds pointers to the reloc_table and machrel functions
165  * for a given target machine.
166  *
167  * The following function pointers are allowed to be NULL, if the
168  * underlying target does not require the specified operation. All
169  * other functions must be supplied:
170  *
171  *	mr_assign_got
172  *	mr_reloc_register
173  *	mr_reloc_GOTOP
174  *	mr_allocate_got
175  */
176 typedef struct {
177 	const Rel_entry	*mr_reloc_table;
178 
179 	Word		(* mr_init_rel)(Rel_desc *, void *);
180 	void 		(* mr_mach_eflags)(Ehdr *, Ofl_desc *);
181 	void		(* mr_mach_make_dynamic)(Ofl_desc *, size_t *);
182 	void		(* mr_mach_update_odynamic)(Ofl_desc *, Dyn **);
183 	Xword		(* mr_calc_plt_addr)(Sym_desc *, Ofl_desc *);
184 	uintptr_t	(* mr_perform_outreloc)(Rel_desc *, Ofl_desc *);
185 	uintptr_t	(* mr_do_activerelocs)(Ofl_desc *);
186 	uintptr_t	(* mr_add_outrel)(Word, Rel_desc *, Ofl_desc *);
187 	uintptr_t	(* mr_reloc_register)(Rel_desc *, Is_desc *,
188 			    Ofl_desc *);
189 	uintptr_t	(* mr_reloc_local)(Rel_desc *, Ofl_desc *);
190 	uintptr_t	(* mr_reloc_GOTOP)(Boolean, Rel_desc *, Ofl_desc *);
191 	uintptr_t	(* mr_reloc_TLS)(Boolean, Rel_desc *, Ofl_desc *);
192 	uintptr_t	(* mr_assign_got)(Ofl_desc *, Sym_desc *);
193 
194 	Gotndx		*(* mr_find_got_ndx)(Alist *, Gotref, Ofl_desc *,
195 			    Rel_desc *);
196 	Xword		(* mr_calc_got_offset)(Rel_desc *, Ofl_desc *);
197 	uintptr_t	(* mr_assign_got_ndx)(Alist **, Gotndx *, Gotref,
198 			    Ofl_desc *, Rel_desc *, Sym_desc *);
199 	void		(* mr_assign_plt_ndx)(Sym_desc *, Ofl_desc *);
200 	uintptr_t	(* mr_allocate_got)(Ofl_desc *);
201 	uintptr_t	(* mr_fillin_gotplt)(Ofl_desc *);
202 } Target_machrel;
203 
204 
205 /*
206  * Target_machsym holds pointers to the machsym functions
207  * for a given target machine.
208  *
209  * These fields are allowed to be NULL for targets that do not require
210  * special handling of register symbols. Register symbols are used by
211  * sparc targets. If any of these fields are non-NULL, all of them are
212  * required to be present (use empty stub routines if necessary).
213  */
214 typedef struct {
215 	int		(* ms_reg_check)(Sym_desc *, Sym *, const char *,
216 			    Ifl_desc *, Ofl_desc *);
217 	int		(* ms_mach_sym_typecheck)(Sym_desc *, Sym *,
218 			    Ifl_desc *, Ofl_desc *);
219 	const char	*(* ms_is_regsym)(Ofl_desc *, Ifl_desc *, Sym *,
220 			    const char *, int, Word, const char *, Word *);
221 	Sym_desc	*(* ms_reg_find)(Sym * sym, Ofl_desc * ofl);
222 	int		(* ms_reg_enter)(Sym_desc *, Ofl_desc *);
223 } Target_machsym;
224 
225 typedef struct {
226 	Target_mach	t_m;
227 	Target_machid	t_id;
228 	Target_nullfunc	t_nf;
229 	Target_machrel	t_mr;
230 	Target_machsym	t_ms;
231 } Target;
232 
233 /*
234  * Structure to manage the update of weak symbols from their associated alias.
235  */
236 typedef	struct wk_desc {
237 	Sym		*wk_symtab;	/* the .symtab entry */
238 	Sym		*wk_dynsym;	/* the .dynsym entry */
239 	Sym_desc	*wk_weak;	/* the original weak symbol */
240 	Sym_desc	*wk_alias;	/* the real symbol */
241 } Wk_desc;
242 
243 /*
244  * Structure to manage the support library interfaces.
245  */
246 typedef struct func_list {
247 	const char	*fl_obj;	/* name of support object */
248 					/*	function is from */
249 	void		(*fl_fptr)();	/* function pointer */
250 	uint_t		fl_version;	/* ld_version() level */
251 } Func_list;
252 
253 typedef	struct support_list {
254 	const char	*sup_name;	/* ld_support function name */
255 	Alist		*sup_funcs;	/* list of support functions */
256 } Support_list;
257 
258 /*
259  * Structure to manage a sorted output relocation list.
260  *
261  *	rl_key1		->	pointer to needed ndx
262  *	rl_key2		->	pointer to symbol relocation is against
263  *	rl_key3		->	virtual offset of relocation
264  */
265 typedef struct reloc_list {
266 	Sym_desc	*rl_key2;
267 	Xword		rl_key3;
268 	Rel_desc	*rl_rsp;
269 	Half		rl_key1;
270 } Reloc_list;
271 
272 
273 typedef struct sym_s_list {
274 	Word		sl_hval;
275 	Sym_desc	*sl_sdp;
276 } Sym_s_list;
277 
278 /*
279  * ld heap management structure
280  */
281 typedef struct _ld_heap Ld_heap;
282 struct _ld_heap {
283 	Ld_heap		*lh_next;
284 	void		*lh_free;
285 	void		*lh_end;
286 };
287 
288 #define	HEAPBLOCK	0x800000	/* default allocation block size */
289 #define	HEAPALIGN	0x8		/* heap blocks alignment requirement */
290 
291 /*
292  * Dynamic per-symbol filtee string table descriptor.  This associates filtee
293  * strings that will be created in the .dynstr, with .dynamic entries.
294  */
295 typedef struct {
296 	char		*dft_str;	/* dynstr string */
297 	Word		dft_flag;	/* auxiliary/filtee type */
298 	Half		dft_ndx;	/* eventual ndx into .dynamic */
299 } Dfltr_desc;
300 
301 /*
302  * Per-symbol filtee descriptor.  This associates symbol definitions with
303  * their filtees.
304  */
305 typedef struct {
306 	Sym_desc	*sft_sdp;	/* symbol descriptor */
307 	Aliste		sft_idx;	/* index into dtstr descriptor */
308 } Sfltr_desc;
309 
310 /*
311  * Define Alist initialization sizes.
312  */
313 #define	AL_CNT_IFL_GROUPS	20	/* ifl_groups */
314 #define	AL_CNT_IFL_RELSECS	6	/* ifl_relsect */
315 
316 #define	AL_CNT_OFL_DTSFLTRS	4	/* ofl_dtsfltrs */
317 #define	AL_CNT_OFL_SYMFLTRS	20	/* ofl_symfltrs */
318 #define	AL_CNT_OFL_MAPSECS	10	/* ofl_map{text|data} */
319 #define	AL_CNT_OFL_OBJS		50	/* ofl_objs */
320 #define	AL_CNT_OFL_LIBS		10	/* ofl_sos */
321 #define	AL_CNT_OFL_LIBDIRS	10	/* ofl_[ud]libdirs */
322 #define	AL_CNT_OFL_MAPFILES	6	/* ofl_maps */
323 #define	AL_CNT_OFL_ENTRANCE	10	/* ofl_ents */
324 #define	AL_CNT_OFL_RELS		4	/* ofl_outrels */
325 #define	AL_CNT_OFL_COPYRELS	10	/* ofl_copyrels */
326 #define	AL_CNT_OFL_ARRAYS	10	/* ofl_{init|fini|prei}array */
327 #define	AL_CNT_OFL_OSGROUPS	10	/* ofl_osgroups */
328 #define	AL_CNT_OFL_OSTLSSEG	4	/* ofl_ostlsseg */
329 #define	AL_CNT_OFL_ORDERED	4	/* ofl_ordered */
330 #define	AL_CNT_OFL_SYMINFOSYMS	50	/* ofl_syminfsyms */
331 #define	AL_CNT_OFL_MOVE		10	/* ofl_ismove */
332 #define	AL_CNT_OFL_UNWIND	1	/* ofl_unwind */
333 #define	AL_CNT_OFL_PARSYMS	10	/* ofl_parsyms */
334 
335 #define	AL_CNT_OS_MSTRISDESCS	10	/* os_mstrisdescs */
336 #define	AL_CNT_OS_RELISDESCS	100	/* os_relisdescs */
337 #define	AL_CNT_OS_COMDATS	20	/* os_comdats */
338 #define	AL_CNT_OS_ISDESCS_BA	4	/* os_isdesc: BEFORE|AFTER */
339 #define	AL_CNT_OS_ISDESCS	60	/* os_isdesc: ORDERED|DEFAULT */
340 
341 #define	AL_CNT_SG_OSDESC	40	/* sg_osdescs */
342 #define	AL_CNT_SG_SECORDER	40	/* sg_secorder */
343 
344 #define	AL_CNT_SDP_GOT		1	/* sd_GOTndxs */
345 #define	AL_CNT_SDP_MOVE		1	/* sd_move */
346 #define	AL_CNT_SDP_DFILES	1	/* sa_dfiles */
347 
348 #define	AL_CNT_SDF_VERSIONS	2	/* sdf_{vers|verneed} */
349 
350 #define	AL_CNT_EC_FILES		1	/* ec_files */
351 
352 #define	AL_CNT_VERDESCS		20	/* version desc */
353 #define	AL_CNT_WEAK		20	/* weak desc */
354 #define	AL_CNT_SUPPORT		2	/* support libraries */
355 #define	AL_CNT_STRMRGREL	500	/* ld_make_strmerge() reloc alist cnt */
356 #define	AL_CNT_STRMRGSYM	20	/* ld_make_strmerge() sym alist cnt */
357 #define	AL_CNT_SEGMENTS		20	/* ofl_segs */
358 
359 /*
360  * Return codes for {tls|got}_fixups() routines
361  */
362 typedef enum {
363 	FIX_ERROR,	/* fatal error - time to punt */
364 	FIX_DONE,	/* relocation done - no further processing required */
365 	FIX_RELOC	/* do_reloc() relocation processing required */
366 } Fixupret;
367 
368 #ifndef	FILENAME_MAX
369 #define	FILENAME_MAX	BUFSIZ		/* maximum length of a path name */
370 #endif
371 
372 /*
373  * We pad the end of the .dynstr section with a block of DYNSTR_EXTRA_PAD
374  * bytes, and we insert DYNAMIC_EXTRA_ELTS unused items into the
375  * .dynamic section (with value DT_NULL). This provides the resources needed
376  * to add and/or alter string items in the .dynamic section, such as runpath.
377  */
378 #define	DYNSTR_EXTRA_PAD	512
379 #define	DYNAMIC_EXTRA_ELTS	10
380 
381 /*
382  * Relocation buckets are sized based on the number of input relocations and
383  * the following constants.
384  */
385 #define	REL_HAIDESCNO	1000		/* high water mark active buckets */
386 #define	REL_LAIDESCNO	50		/* low water mark active buckets */
387 #define	REL_HOIDESCNO	500		/* high water mark output buckets */
388 #define	REL_LOIDESCNO	10		/* low water mark output buckets */
389 
390 /*
391  * Given a symbol of a type that is allowed within a .SUNW_dynsymsort or
392  * .SUNW_dyntlssort section, examine the symbol attributes to determine
393  * if this particular symbol should be included or not.
394  *
395  * entry:
396  *	The symbol must have an allowed type: Either a type verified by
397  *	dynsymsort_symtype[] or STT_TLS.
398  *
399  *	_sdp - Pointer to symbol descriptor
400  *	_sym - Pointer to symbol referenced by _sdp.
401  *
402  *	_sym is derivable from _sdp: _sdp->sd_sym
403  *	However, most callers assign it to a local variable for efficiency,
404  *	and this macro allows such a variable to be used within. If you
405  *	don't have such a variable, supply _sdp->sd_sym.
406  *
407  * The tests used require some explanation:
408  *
409  *	(_sdp->sd_flags & FLG_SY_DYNSORT)
410  *		Some special symbols are kept even if they don't meet the
411  *		usual requirements. These symbols have the FLG_SY_DYNSORT
412  *		bit set. If this bit isn't set then we look at the other
413  *		attributes.
414  *
415  *	(((_sdp->sd_ref != REF_DYN_NEED) &&
416  *		(_sdp->sd_sym->st_shndx != SHN_UNDEF))
417  *	|| (_sdp->sd_flags & FLG_SY_MVTOCOMM))
418  *		We do not want to include symbols that are not defined within
419  *		the object we are creating. REF_DYN_NEED corresponds to those
420  *		UNDEF items. However, if the symbol is the target of a copy
421  *		relocation, then it effectively becomes defined within the
422  *		object after all. FLG_SY_MVTOCOMM indicates a copy relocation,
423  *		and prevents us from culling those exceptions.
424  *
425  *	(_sym->st_size != 0)
426  *		Symbols with 0 length are labels injected by the compilers
427  *		or the linker for purposes of code generation, and do
428  *		not directly correspond to actual code. In fact, most of the
429  *		symbols we mark with FLG_SY_DYNSORT need that flag set because
430  *		they have size 0. This size test filters out the others.
431  *
432  *	!(_sdp->sd_flags & FLG_SY_NODYNSORT)
433  *		Some symbols are not kept, even though they do meet the usual
434  *		requirements. These symbols have FLG_SY_NODYNSORT set.
435  *		For example, if there are weak and non-weak versions of a given
436  *		symbol, we only want to keep one of them. So, we set
437  *		FLG_SY_NODYNSORT on the one we don't want.
438  */
439 #define	DYNSORT_TEST_ATTR(_sdp, _sym) \
440 	((_sdp->sd_flags & FLG_SY_DYNSORT) || \
441 	((((_sdp->sd_ref != REF_DYN_NEED) && \
442 		(_sdp->sd_sym->st_shndx != SHN_UNDEF)) || \
443 		(_sdp->sd_flags & FLG_SY_MVTOCOMM)) && \
444 	(_sym->st_size != 0) && \
445 	!(_sdp->sd_flags & FLG_SY_NODYNSORT)))
446 
447 /*
448  * We use output section descriptor counters to add up the number of
449  * symbol indexes to put in the .SUNW_dynsort and .SUNW_dyntlssort sections.
450  * Non-TLS symbols are counted by ofl->ofl_dynsymsortcnt, while TLS symbols are
451  * counted by ofl->ofl_dyntlssortcnt. This computation is done inline in
452  * several places. The DYNSORT_COUNT macro allows us to generate this from
453  * a single description.
454  *
455  * entry:
456  *	_sdp, _sym - As per DYNSORT_TEST_ATTR
457  *	_type - Type of symbol (STT_*)
458  *	_inc_or_dec_op - Either ++, or --. This specifies the operation
459  *		to be applied to the counter, and determines whether we
460  *		are adding, or removing, a symbol from .SUNW_dynsymsort.
461  *
462  * Note that _type is derivable from _sym: ELF_ST_TYPE(_sdp->sd_sym->st_info).
463  * Most callers already have it in a variable, so this allows us to use that
464  * variable. If you don't have such a variable, use ELF_ST_TYPE() as shown.
465  */
466 #define	DYNSORT_COUNT(_sdp, _sym, _type, _inc_or_dec_op) \
467 { \
468 	Word *_cnt_var; \
469 	\
470 	if (dynsymsort_symtype[_type]) {	/* Non-TLS counter */ \
471 		_cnt_var = &ofl->ofl_dynsymsortcnt; \
472 	} else if ((_type) == STT_TLS) {	/* TLS counter */ \
473 		_cnt_var = &ofl->ofl_dyntlssortcnt; \
474 	} else {				/* Don't count this symbol */ \
475 		_cnt_var = NULL; \
476 	} \
477 	if ((_cnt_var != NULL) && DYNSORT_TEST_ATTR(_sdp, _sym)) \
478 		(*_cnt_var)_inc_or_dec_op;	/* Increment/Decrement */ \
479 }
480 
481 /*
482  * The OFL_SWAP_RELOC macros are used to determine whether
483  * relocation processing needs to swap the data being relocated.
484  * It is an optimization to ld_swap_reloc_data(), as it avoids
485  * the function call in the case where the linker host and the
486  * target have the same byte order.
487  */
488 #define	OFL_SWAP_RELOC_DATA(_ofl, _rel) \
489 	(((_ofl)->ofl_flags1 & FLG_OF1_ENCDIFF) && \
490 	ld_swap_reloc_data(_ofl, _rel))
491 
492 /*
493  * Define an AVL node for maintaining input section descriptors.  AVL trees of
494  * these descriptors are used to process group and COMDAT section.
495  */
496 typedef struct {
497 	avl_node_t	isd_avl;	/* avl book-keeping (see SGSOFFSETOF) */
498 	Is_desc		*isd_isp;	/* input section descriptor */
499 	uint_t		isd_hash;	/* input section name hash value */
500 } Isd_node;
501 
502 /*
503  * Local data items.
504  */
505 extern char		*Plibpath;
506 extern char		*Llibdir;
507 extern char		*Ulibdir;
508 extern Ld_heap		*ld_heap;
509 extern APlist		*lib_support;
510 extern int		demangle_flag;
511 extern const Msg	reject[];
512 extern int		Verbose;
513 extern const int	ldynsym_symtype[];
514 extern const int	dynsymsort_symtype[];
515 
516 /*
517  * Local functions.
518  */
519 extern char		*add_string(char *, char *);
520 extern const char	*demangle(const char *);
521 
522 extern void		lds_atexit(Ofl_desc *, int);
523 
524 extern void		libld_free(void *);
525 extern void		*libld_malloc(size_t);
526 extern void		*libld_realloc(void *, size_t);
527 
528 extern int		isdavl_compare(const void *, const void *);
529 
530 extern Sdf_desc		*sdf_add(const char *, APlist **);
531 extern Sdf_desc		*sdf_find(const char *, APlist *);
532 
533 #if	defined(_ELF64)
534 
535 #define	ld_add_actrel		ld64_add_actrel
536 #define	ld_add_libdir		ld64_add_libdir
537 #define	ld_add_rel_cache	ld64_add_rel_cache
538 #define	ld_adj_movereloc	ld64_adj_movereloc
539 #define	ld_am_I_partial		ld64_am_I_partial
540 #define	ld_ar_member		ld64_ar_member
541 #define	ld_ar_setup		ld64_ar_setup
542 #define	ld_assign_got_TLS	ld64_assign_got_TLS
543 #define	ld_bswap_Word		ld64_bswap_Word
544 #define	ld_bswap_Xword		ld64_bswap_Xword
545 #define	ld_disp_errmsg		ld64_disp_errmsg
546 #define	ld_ent_check		ld64_ent_check
547 #define	ld_exit			ld64_exit
548 #define	ld_find_library		ld64_find_library
549 #define	ld_finish_libs		ld64_finish_libs
550 #define	ld_get_group		ld64_get_group
551 #define	ld_group_process	ld64_group_process
552 #define	ld_lib_setup		ld64_lib_setup
553 #define	ld_init_sighandler	ld64_init_sighandler
554 #define	ld_lcm			ld64_lcm
555 #define	ld_make_bss		ld64_make_bss
556 #define	ld_make_data		ld64_make_data
557 #define	ld_make_got		ld64_make_got
558 #define	ld_make_parexpn_data	ld64_make_parexpn_data
559 #define	ld_make_sunwmove	ld64_make_sunmove
560 #define	ld_make_text		ld64_make_text
561 #define	ld_map_out		ld64_map_out
562 #define	ld_map_parse		ld64_map_parse
563 #define	ld_open_outfile		ld64_open_outfile
564 #define	ld_os_first_isdesc	ld64_os_first_isdesc
565 #define	ld_place_section	ld64_place_section
566 #define	ld_process_archive	ld64_process_archive
567 #define	ld_process_files	ld64_process_files
568 #define	ld_process_flags	ld64_process_flags
569 #define	ld_process_ifl		ld64_process_ifl
570 #define	ld_process_move		ld64_process_move
571 #define	ld_process_open		ld64_process_open
572 #define	ld_process_ordered	ld64_process_ordered
573 #define	ld_process_sym_reloc	ld64_process_sym_reloc
574 #define	ld_reloc_GOT_relative	ld64_reloc_GOT_relative
575 #define	ld_reloc_plt		ld64_reloc_plt
576 #define	ld_reloc_remain_entry	ld64_reloc_remain_entry
577 #define	ld_reloc_targval_get	ld64_reloc_targval_get
578 #define	ld_reloc_targval_set	ld64_reloc_targval_set
579 #define	ld_sec_validate		ld64_sec_validate
580 #define	ld_sort_ordered		ld64_sort_ordered
581 #define	ld_sort_seg_list	ld64_sort_seg_list
582 #define	ld_stt_section_sym_name	ld64_stt_section_sym_name
583 #define	ld_sunw_ldmach		ld64_sunw_ldmach
584 #define	ld_sup_atexit		ld64_sup_atexit
585 #define	ld_sup_open		ld64_sup_open
586 #define	ld_sup_file		ld64_sup_file
587 #define	ld_sup_loadso		ld64_sup_loadso
588 #define	ld_sup_input_done	ld64_sup_input_done
589 #define	ld_sup_input_section	ld64_sup_input_section
590 #define	ld_sup_section		ld64_sup_section
591 #define	ld_sup_start		ld64_sup_start
592 #define	ld_swap_reloc_data	ld64_swap_reloc_data
593 #define	ld_sym_add_u		ld64_sym_add_u
594 #define	ld_sym_adjust_vis	ld64_sym_adjust_vis
595 #define	ld_sym_avl_comp		ld64_sym_avl_comp
596 #define	ld_sym_copy		ld64_sym_copy
597 #define	ld_sym_enter		ld64_sym_enter
598 #define	ld_sym_find		ld64_sym_find
599 #define	ld_sym_nodirect		ld64_sym_nodirect
600 #define	ld_sym_process		ld64_sym_process
601 #define	ld_sym_resolve		ld64_sym_resolve
602 #define	ld_sym_spec		ld64_sym_spec
603 #define	ld_targ			ld64_targ
604 #define	ld_targ_init_sparc	ld64_targ_init_sparc
605 #define	ld_targ_init_x86	ld64_targ_init_x86
606 #define	ld_unwind_make_hdr	ld64_unwind_make_hdr
607 #define	ld_unwind_populate_hdr	ld64_unwind_populate_hdr
608 #define	ld_unwind_register	ld64_unwind_register
609 #define	ld_vers_base		ld64_vers_base
610 #define	ld_vers_check_defs	ld64_vers_check_defs
611 #define	ld_vers_check_need	ld64_vers_check_need
612 #define	ld_vers_def_process	ld64_vers_def_process
613 #define	ld_vers_desc		ld64_vers_desc
614 #define	ld_vers_find		ld64_vers_find
615 #define	ld_vers_need_process	ld64_vers_need_process
616 #define	ld_vers_promote		ld64_vers_promote
617 #define	ld_vers_sym_process	ld64_vers_sym_process
618 #define	ld_vers_verify		ld64_vers_verify
619 
620 #else
621 
622 #define	ld_add_actrel		ld32_add_actrel
623 #define	ld_add_libdir		ld32_add_libdir
624 #define	ld_add_rel_cache	ld32_add_rel_cache
625 #define	ld_adj_movereloc	ld32_adj_movereloc
626 #define	ld_am_I_partial		ld32_am_I_partial
627 #define	ld_ar_member		ld32_ar_member
628 #define	ld_ar_setup		ld32_ar_setup
629 #define	ld_assign_got_TLS	ld32_assign_got_TLS
630 #define	ld_bswap_Word		ld32_bswap_Word
631 #define	ld_bswap_Xword		ld32_bswap_Xword
632 #define	ld_disp_errmsg		ld32_disp_errmsg
633 #define	ld_ent_check		ld32_ent_check
634 #define	ld_exit			ld32_exit
635 #define	ld_find_library		ld32_find_library
636 #define	ld_finish_libs		ld32_finish_libs
637 #define	ld_get_group		ld32_get_group
638 #define	ld_group_process	ld32_group_process
639 #define	ld_lib_setup		ld32_lib_setup
640 #define	ld_init_sighandler	ld32_init_sighandler
641 #define	ld_lcm			ld32_lcm
642 #define	ld_make_bss		ld32_make_bss
643 #define	ld_make_data		ld32_make_data
644 #define	ld_make_got		ld32_make_got
645 #define	ld_make_parexpn_data	ld32_make_parexpn_data
646 #define	ld_make_sunwmove	ld32_make_sunmove
647 #define	ld_make_text		ld32_make_text
648 #define	ld_map_out		ld32_map_out
649 #define	ld_map_parse		ld32_map_parse
650 #define	ld_open_outfile		ld32_open_outfile
651 #define	ld_os_first_isdesc	ld32_os_first_isdesc
652 #define	ld_place_section	ld32_place_section
653 #define	ld_process_archive	ld32_process_archive
654 #define	ld_process_files	ld32_process_files
655 #define	ld_process_flags	ld32_process_flags
656 #define	ld_process_ifl		ld32_process_ifl
657 #define	ld_process_move		ld32_process_move
658 #define	ld_process_open		ld32_process_open
659 #define	ld_process_ordered	ld32_process_ordered
660 #define	ld_process_sym_reloc	ld32_process_sym_reloc
661 #define	ld_reloc_GOT_relative	ld32_reloc_GOT_relative
662 #define	ld_reloc_plt		ld32_reloc_plt
663 #define	ld_reloc_remain_entry	ld32_reloc_remain_entry
664 #define	ld_reloc_targval_get	ld32_reloc_targval_get
665 #define	ld_reloc_targval_set	ld32_reloc_targval_set
666 #define	ld_sec_validate		ld32_sec_validate
667 #define	ld_sort_ordered		ld32_sort_ordered
668 #define	ld_sort_seg_list	ld32_sort_seg_list
669 #define	ld_stt_section_sym_name	ld32_stt_section_sym_name
670 #define	ld_sunw_ldmach		ld32_sunw_ldmach
671 #define	ld_sup_atexit		ld32_sup_atexit
672 #define	ld_sup_open		ld32_sup_open
673 #define	ld_sup_file		ld32_sup_file
674 #define	ld_sup_loadso		ld32_sup_loadso
675 #define	ld_sup_input_done	ld32_sup_input_done
676 #define	ld_sup_input_section	ld32_sup_input_section
677 #define	ld_sup_section		ld32_sup_section
678 #define	ld_sup_start		ld32_sup_start
679 #define	ld_swap_reloc_data	ld32_swap_reloc_data
680 #define	ld_sym_add_u		ld32_sym_add_u
681 #define	ld_sym_adjust_vis	ld32_sym_adjust_vis
682 #define	ld_sym_avl_comp		ld32_sym_avl_comp
683 #define	ld_sym_copy		ld32_sym_copy
684 #define	ld_sym_enter		ld32_sym_enter
685 #define	ld_sym_find		ld32_sym_find
686 #define	ld_sym_nodirect		ld32_sym_nodirect
687 #define	ld_sym_process		ld32_sym_process
688 #define	ld_sym_resolve		ld32_sym_resolve
689 #define	ld_sym_spec		ld32_sym_spec
690 #define	ld_targ			ld32_targ
691 #define	ld_targ_init_sparc	ld32_targ_init_sparc
692 #define	ld_targ_init_x86	ld32_targ_init_x86
693 #define	ld_unwind_make_hdr	ld32_unwind_make_hdr
694 #define	ld_unwind_populate_hdr	ld32_unwind_populate_hdr
695 #define	ld_unwind_register	ld32_unwind_register
696 #define	ld_vers_base		ld32_vers_base
697 #define	ld_vers_check_defs	ld32_vers_check_defs
698 #define	ld_vers_check_need	ld32_vers_check_need
699 #define	ld_vers_def_process	ld32_vers_def_process
700 #define	ld_vers_desc		ld32_vers_desc
701 #define	ld_vers_find		ld32_vers_find
702 #define	ld_vers_need_process	ld32_vers_need_process
703 #define	ld_vers_promote		ld32_vers_promote
704 #define	ld_vers_sym_process	ld32_vers_sym_process
705 #define	ld_vers_verify		ld32_vers_verify
706 
707 #endif
708 
709 extern void		dbg_cleanup(void);
710 extern int		dbg_setup(Ofl_desc *, const char *, int);
711 
712 extern uintptr_t	ld_add_actrel(Word, Rel_desc *, Ofl_desc *);
713 extern uintptr_t	ld_add_libdir(Ofl_desc *, const char *);
714 extern Rel_cache	*ld_add_rel_cache(Ofl_desc *, APlist **, size_t *,
715 			    size_t, size_t);
716 extern void 		ld_adj_movereloc(Ofl_desc *, Rel_desc *);
717 extern Sym_desc * 	ld_am_I_partial(Rel_desc *, Xword);
718 extern void		ld_ar_member(Ar_desc *, Elf_Arsym *, Ar_aux *,
719 			    Ar_mem *);
720 extern Ar_desc		*ld_ar_setup(const char *, Elf *, Ofl_desc *);
721 extern uintptr_t	ld_assign_got_TLS(Boolean, Rel_desc *, Ofl_desc *,
722 			    Sym_desc *, Gotndx *, Gotref, Word, Word,
723 			    Word, Word);
724 
725 extern Word		ld_bswap_Word(Word);
726 extern Xword		ld_bswap_Xword(Xword);
727 
728 extern void		ld_disp_errmsg(const char *, Rel_desc *, Ofl_desc *);
729 
730 extern void		ld_ent_check(Ofl_desc *);
731 extern int		ld_exit(Ofl_desc *);
732 
733 extern uintptr_t	ld_find_library(const char *, Ofl_desc *);
734 extern uintptr_t	ld_finish_libs(Ofl_desc *);
735 
736 extern const char	*ld_stt_section_sym_name(Is_desc *);
737 
738 extern Group_desc	*ld_get_group(Ofl_desc *, Is_desc *);
739 extern uintptr_t	ld_group_process(Is_desc *, Ofl_desc *);
740 
741 extern uintptr_t	ld_lib_setup(Ofl_desc *);
742 
743 extern void		ld_init_sighandler(Ofl_desc *);
744 
745 extern Xword		ld_lcm(Xword, Xword);
746 
747 extern uintptr_t	ld_make_bss(Ofl_desc *, Xword, Xword, uint_t);
748 extern Is_desc		*ld_make_data(Ofl_desc *, size_t);
749 extern uintptr_t	ld_make_got(Ofl_desc *);
750 extern uintptr_t	ld_make_parexpn_data(Ofl_desc *, size_t, Xword);
751 extern uintptr_t	ld_make_sunwmove(Ofl_desc *, int);
752 extern Is_desc		*ld_make_text(Ofl_desc *, size_t);
753 extern void		ld_map_out(Ofl_desc *);
754 extern uintptr_t	ld_map_parse(const char *, Ofl_desc *);
755 
756 extern uintptr_t	ld_open_outfile(Ofl_desc *);
757 
758 extern Is_desc		*ld_os_first_isdesc(Os_desc *);
759 extern Os_desc		*ld_place_section(Ofl_desc *, Is_desc *, int,
760 			    const char *);
761 extern uintptr_t	ld_process_archive(const char *, int, Ar_desc *,
762 			    Ofl_desc *);
763 extern uintptr_t	ld_process_files(Ofl_desc *, int, char **);
764 extern uintptr_t	ld_process_flags(Ofl_desc *, int, char **);
765 extern Ifl_desc		*ld_process_ifl(const char *, const char *, int, Elf *,
766 			    Word, Ofl_desc *, Rej_desc *);
767 extern uintptr_t	ld_process_move(Ofl_desc *);
768 extern Ifl_desc		*ld_process_open(const char *, const char *, int *,
769 			    Ofl_desc *, Word, Rej_desc *);
770 extern uintptr_t	ld_process_ordered(Ifl_desc *, Ofl_desc *, Word);
771 extern uintptr_t	ld_process_sym_reloc(Ofl_desc *, Rel_desc *, Rel *,
772 			    Is_desc *, const char *, Word);
773 
774 extern uintptr_t	ld_reloc_GOT_relative(Boolean, Rel_desc *, Ofl_desc *);
775 extern uintptr_t	ld_reloc_plt(Rel_desc *, Ofl_desc *);
776 extern void		ld_reloc_remain_entry(Rel_desc *, Os_desc *,
777 			    Ofl_desc *);
778 extern int		ld_reloc_targval_get(Ofl_desc *, Rel_desc *,
779 			    uchar_t *, Xword *);
780 extern int		ld_reloc_targval_set(Ofl_desc *, Rel_desc *,
781 			    uchar_t *, Xword);
782 
783 extern void		ld_sec_validate(Ofl_desc *);
784 extern uintptr_t	ld_sort_ordered(Ofl_desc *);
785 extern uintptr_t	ld_sort_seg_list(Ofl_desc *);
786 extern Half		ld_sunw_ldmach();
787 extern void		ld_sup_atexit(Ofl_desc *, int);
788 extern void		ld_sup_open(Ofl_desc *, const char **, const char **,
789 			    int *, int, Elf **, Elf *ref, size_t,
790 			    const Elf_Kind);
791 extern void		ld_sup_file(Ofl_desc *, const char *, const Elf_Kind,
792 			    int flags, Elf *);
793 extern uintptr_t	ld_sup_loadso(Ofl_desc *, const char *);
794 extern void		ld_sup_input_done(Ofl_desc *);
795 extern void		ld_sup_section(Ofl_desc *, const char *, Shdr *, Word,
796 			    Elf_Data *, Elf *);
797 extern uintptr_t	ld_sup_input_section(Ofl_desc*, Ifl_desc *,
798 			    const char *, Shdr **, Word, Elf_Scn *, Elf *);
799 extern void		ld_sup_start(Ofl_desc *, const Half, const char *);
800 extern int		ld_swap_reloc_data(Ofl_desc *, Rel_desc *);
801 extern Sym_desc		*ld_sym_add_u(const char *, Ofl_desc *, Msg);
802 extern void		ld_sym_adjust_vis(Sym_desc *, Ofl_desc *);
803 extern int		ld_sym_avl_comp(const void *, const void *);
804 extern uintptr_t	ld_sym_copy(Sym_desc *);
805 extern Sym_desc		*ld_sym_enter(const char *, Sym *, Word, Ifl_desc *,
806 			    Ofl_desc *, Word, Word, Word, Half, avl_index_t *);
807 extern Sym_desc		*ld_sym_find(const char *, Word, avl_index_t *,
808 			    Ofl_desc *);
809 extern uintptr_t	ld_sym_nodirect(Is_desc *, Ifl_desc *, Ofl_desc *);
810 extern uintptr_t	ld_sym_process(Is_desc *, Ifl_desc *, Ofl_desc *);
811 extern uintptr_t	ld_sym_resolve(Sym_desc *, Sym *, Ifl_desc *,
812 			    Ofl_desc *, int, Word, Word);
813 extern uintptr_t	ld_sym_spec(Ofl_desc *);
814 
815 extern Target		ld_targ;
816 extern const Target	*ld_targ_init_sparc(void);
817 extern const Target	*ld_targ_init_x86(void);
818 
819 extern uintptr_t	ld_unwind_make_hdr(Ofl_desc *);
820 extern uintptr_t	ld_unwind_populate_hdr(Ofl_desc *);
821 extern uintptr_t	ld_unwind_register(Os_desc *, Ofl_desc *);
822 
823 extern Ver_desc		*ld_vers_base(Ofl_desc *);
824 extern uintptr_t	ld_vers_check_defs(Ofl_desc *);
825 extern uintptr_t	ld_vers_check_need(Ofl_desc *);
826 extern uintptr_t	ld_vers_def_process(Is_desc *, Ifl_desc *, Ofl_desc *);
827 extern Ver_desc		*ld_vers_desc(const char *, Word, APlist **);
828 extern Ver_desc		*ld_vers_find(const char *, Word, APlist *);
829 extern uintptr_t	ld_vers_need_process(Is_desc *, Ifl_desc *, Ofl_desc *);
830 extern void		ld_vers_promote(Sym_desc *, Word, Ifl_desc *,
831 			    Ofl_desc *);
832 extern int		ld_vers_sym_process(Lm_list *, Is_desc *, Ifl_desc *);
833 extern int		ld_vers_verify(Ofl_desc *);
834 
835 extern uintptr_t	add_regsym(Sym_desc *, Ofl_desc *);
836 extern Word		hashbkts(Word);
837 extern Xword		lcm(Xword, Xword);
838 
839 /*
840  * Most platforms have both a 32 and 64-bit variant (e.g. EM_SPARC and
841  * EM_SPARCV9). To support this, there many files in libld that are built
842  * twice, once for ELFCLASS64 (_ELF64), and once for ELFCLASS32. In these
843  * files, we sometimes want to supply one value for the ELFCLASS32 case
844  * and another for ELFCLASS64. The LD_TARG_BYCLASS macro is used to do
845  * this. It is called with both both alternatives, and yields the one
846  * that applies to the current compilation environment.
847  */
848 #ifdef	_ELF64
849 #define	LD_TARG_BYCLASS(_ec32, _ec64) (_ec64)
850 #else
851 #define	LD_TARG_BYCLASS(_ec32, _ec64) (_ec32)
852 #endif
853 
854 
855 #ifdef	__cplusplus
856 }
857 #endif
858 
859 #endif /* _LIBLD_DOT_H */
860