xref: /illumos-gate/usr/src/cmd/sgs/rtld/common/util.c (revision 94cad3fef5d199c4897e68d856995cdb44e20dbb)
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 2007 Sun Microsystems, Inc.  All rights reserved.
27  * Use is subject to license terms.
28  */
29 #pragma ident	"%Z%%M%	%I%	%E% SMI"
30 
31 /*
32  * Utility routines for run-time linker.  some are duplicated here from libc
33  * (with different names) to avoid name space collisions.
34  */
35 #include	"_synonyms.h"
36 #include	<stdio.h>
37 #include	<sys/types.h>
38 #include	<sys/mman.h>
39 #include	<sys/lwp.h>
40 #include	<sys/debug.h>
41 #include	<stdarg.h>
42 #include	<fcntl.h>
43 #include	<string.h>
44 #include	<ctype.h>
45 #include	<dlfcn.h>
46 #include	<unistd.h>
47 #include	<stdlib.h>
48 #include	<sys/auxv.h>
49 #include	<debug.h>
50 #include	<conv.h>
51 #include	"_rtld.h"
52 #include	"_audit.h"
53 #include	"_elf.h"
54 #include	"msg.h"
55 
56 static int ld_flags_env(const char *, Word *, Word *, uint_t, int);
57 
58 /*
59  * All error messages go through eprintf().  During process initialization these
60  * messages should be directed to the standard error, however once control has
61  * been passed to the applications code these messages should be stored in an
62  * internal buffer for use with dlerror().  Note, fatal error conditions that
63  * may occur while running the application will still cause a standard error
64  * message, see rtldexit() in this file for details.
65  * The `application' flag serves to indicate the transition between process
66  * initialization and when the applications code is running.
67  */
68 
69 /*
70  * Null function used as place where a debugger can set a breakpoint.
71  */
72 void
73 rtld_db_dlactivity(Lm_list *lml)
74 {
75 	DBG_CALL(Dbg_util_dbnotify(lml, r_debug.rtd_rdebug.r_rdevent,
76 	    r_debug.rtd_rdebug.r_state));
77 }
78 
79 /*
80  * Null function used as place where debugger can set a pre .init
81  * processing breakpoint.
82  */
83 void
84 rtld_db_preinit(Lm_list *lml)
85 {
86 	DBG_CALL(Dbg_util_dbnotify(lml, r_debug.rtd_rdebug.r_rdevent,
87 	    r_debug.rtd_rdebug.r_state));
88 }
89 
90 /*
91  * Null function used as place where debugger can set a post .init
92  * processing breakpoint.
93  */
94 void
95 rtld_db_postinit(Lm_list *lml)
96 {
97 	DBG_CALL(Dbg_util_dbnotify(lml, r_debug.rtd_rdebug.r_rdevent,
98 	    r_debug.rtd_rdebug.r_state));
99 }
100 
101 /*
102  * Debugger Event Notification
103  *
104  * This function centralizes all debugger event notification (ala rtld_db).
105  *
106  * There's a simple intent, focused on insuring the primary link-map control
107  * list (or each link-map list) is consistent, and the indication that objects
108  * have been added or deleted from this list.  Although an RD_ADD and RD_DELETE
109  * event are posted for each of these, most debuggers don't care, as their
110  * view is that these events simply convey an "inconsistent" state.
111  *
112  * We also don't want to trigger multiple RD_ADD/RD_DELETE events any time we
113  * enter ld.so.1.
114  *
115  * With auditors, we may be in the process of relocating a collection of
116  * objects, and will leave() ld.so.1 to call the auditor.  At this point we
117  * must indicate an RD_CONSISTENT event, but librtld_db will not report an
118  * object to the debuggers until relocation processing has been completed on it.
119  * To allow for the collection of these objects that are pending relocation, an
120  * RD_ADD event is set after completing a series of relocations on the primary
121  * link-map control list.
122  *
123  * Set an RD_ADD/RD_DELETE event and indicate that an RD_CONSISTENT event is
124  * required later (LML_FLG_DBNOTIF):
125  *
126  *  i	the first time we add or delete an object to the primary link-map
127  *	control list.
128  *  ii	the first time we move a secondary link-map control list to the primary
129  *	link-map control list (effectively, this is like adding a group of
130  *	objects to the primary link-map control list).
131  *
132  * Set an RD_CONSISTENT event when it is required (LML_FLG_DBNOTIF is set) and
133  *
134  *  i	each time we leave the runtime linker.
135  */
136 void
137 rd_event(Lm_list *lml, rd_event_e event, r_state_e state)
138 {
139 	void	(*fptr)(Lm_list *);
140 
141 	switch (event) {
142 	case RD_PREINIT:
143 		fptr = rtld_db_preinit;
144 		break;
145 	case RD_POSTINIT:
146 		fptr = rtld_db_postinit;
147 		break;
148 	case RD_DLACTIVITY:
149 		switch (state) {
150 		case RT_CONSISTENT:
151 			lml->lm_flags &= ~LML_FLG_DBNOTIF;
152 
153 			/*
154 			 * Do we need to send a notification?
155 			 */
156 			if ((rtld_flags & RT_FL_DBNOTIF) == 0)
157 				return;
158 			rtld_flags &= ~RT_FL_DBNOTIF;
159 			break;
160 		case RT_ADD:
161 		case RT_DELETE:
162 			lml->lm_flags |= LML_FLG_DBNOTIF;
163 
164 			/*
165 			 * If we are already in an inconsistent state, no
166 			 * notification is required.
167 			 */
168 			if (rtld_flags & RT_FL_DBNOTIF)
169 				return;
170 			rtld_flags |= RT_FL_DBNOTIF;
171 			break;
172 		};
173 		fptr = rtld_db_dlactivity;
174 		break;
175 	default:
176 		/*
177 		 * RD_NONE - do nothing
178 		 */
179 		break;
180 	};
181 
182 	/*
183 	 * Set event state and call 'notification' function.
184 	 *
185 	 * The debugging clients have previously been told about these
186 	 * notification functions and have set breakpoints on them if they
187 	 * are interested in the notification.
188 	 */
189 	r_debug.rtd_rdebug.r_state = state;
190 	r_debug.rtd_rdebug.r_rdevent = event;
191 	fptr(lml);
192 	r_debug.rtd_rdebug.r_rdevent = RD_NONE;
193 }
194 
195 #if	defined(sparc) || defined(i386) || defined(__amd64)
196 /*
197  * Stack Cleanup.
198  *
199  * This function is invoked to 'remove' arguments that were passed in on the
200  * stack.  This is most likely if ld.so.1 was invoked directly.  In that case
201  * we want to remove ld.so.1 as well as it's arguments from the argv[] array.
202  * Which means we then need to slide everything above it on the stack down
203  * accordingly.
204  *
205  * While the stack layout is platform specific - it just so happens that x86,
206  * sparc, sparcv9, and amd64 all share the following initial stack layout.
207  *
208  *	!_______________________!  high addresses
209  *	!			!
210  *	!	Information	!
211  *	!	Block		!
212  *	!	(size varies)	!
213  *	!_______________________!
214  *	!	0 word		!
215  *	!_______________________!
216  *	!	Auxiliary	!
217  *	!	vector		!
218  *	!	2 word entries	!
219  *	!			!
220  *	!_______________________!
221  *	!	0 word		!
222  *	!_______________________!
223  *	!	Environment	!
224  *	!	pointers	!
225  *	!	...		!
226  *	!	(one word each)	!
227  *	!_______________________!
228  *	!	0 word		!
229  *	!_______________________!
230  *	!	Argument	! low addresses
231  *	!	pointers	!
232  *	!	Argc words	!
233  *	!_______________________!
234  *	!			!
235  *	!	Argc		!
236  *	!_______________________!
237  *	!	...		!
238  *
239  */
240 static void
241 stack_cleanup(char **argv, char ***envp, auxv_t **auxv, int rmcnt)
242 {
243 	int		ndx;
244 	long		*argc;
245 	char		**oargv, **nargv;
246 	char		**oenvp, **nenvp;
247 	auxv_t		*oauxv, *nauxv;
248 
249 	/*
250 	 * Slide ARGV[] and update argc.  The argv pointer remains the same,
251 	 * however slide the applications arguments over the arguments to
252 	 * ld.so.1.
253 	 */
254 	nargv = &argv[0];
255 	oargv = &argv[rmcnt];
256 
257 	for (ndx = 0; oargv[ndx]; ndx++)
258 		nargv[ndx] = oargv[ndx];
259 	nargv[ndx] = oargv[ndx];
260 
261 	argc = (long *)((uintptr_t)argv - sizeof (long *));
262 	*argc -= rmcnt;
263 
264 	/*
265 	 * Slide ENVP[], and update the environment array pointer.
266 	 */
267 	ndx++;
268 	nenvp = &nargv[ndx];
269 	oenvp = &oargv[ndx];
270 	*envp = nenvp;
271 
272 	for (ndx = 0; oenvp[ndx]; ndx++)
273 		nenvp[ndx] = oenvp[ndx];
274 	nenvp[ndx] = oenvp[ndx];
275 
276 	/*
277 	 * Slide AUXV[], and update the aux vector pointer.
278 	 */
279 	ndx++;
280 	nauxv = (auxv_t *)&nenvp[ndx];
281 	oauxv = (auxv_t *)&oenvp[ndx];
282 	*auxv = nauxv;
283 
284 	for (ndx = 0; (oauxv[ndx].a_type != AT_NULL); ndx++)
285 		nauxv[ndx] = oauxv[ndx];
286 	nauxv[ndx] = oauxv[ndx];
287 }
288 #else
289 /*
290  * Verify that the above routine is appropriate for any new platforms.
291  */
292 #error	unsupported architecture!
293 #endif
294 
295 /*
296  * The only command line argument recognized is -e, followed by a runtime
297  * linker environment variable.
298  */
299 int
300 rtld_getopt(char **argv, char ***envp, auxv_t **auxv, Word *lmflags,
301     Word *lmtflags, int aout)
302 {
303 	int	ndx;
304 
305 	for (ndx = 1; argv[ndx]; ndx++) {
306 		char	*str;
307 
308 		if (argv[ndx][0] != '-')
309 			break;
310 
311 		if (argv[ndx][1] == '\0') {
312 			ndx++;
313 			break;
314 		}
315 
316 		if (argv[ndx][1] != 'e')
317 			return (1);
318 
319 		if (argv[ndx][2] == '\0') {
320 			ndx++;
321 			if (argv[ndx] == NULL)
322 				return (1);
323 			str = argv[ndx];
324 		} else
325 			str = &argv[ndx][2];
326 
327 		/*
328 		 * If the environment variable starts with LD_, strip the LD_.
329 		 * Otherwise, take things as is.
330 		 */
331 		if ((str[0] == 'L') && (str[1] == 'D') && (str[2] == '_') &&
332 		    (str[3] != '\0'))
333 			str += 3;
334 		if (ld_flags_env(str, lmflags, lmtflags, 0, aout) == 1)
335 			return (1);
336 	}
337 
338 	/*
339 	 * Make sure an object file has been specified.
340 	 */
341 	if (argv[ndx] == 0)
342 		return (1);
343 
344 	/*
345 	 * Having gotten the arguments, clean ourselves off of the stack.
346 	 */
347 	stack_cleanup(argv, envp, auxv, ndx);
348 	return (0);
349 }
350 
351 /*
352  * Compare function for FullpathNode AVL tree.
353  */
354 static int
355 fpavl_compare(const void * n1, const void * n2)
356 {
357 	uint_t		hash1, hash2;
358 	const char	*st1, *st2;
359 	int		rc;
360 
361 	hash1 = ((FullpathNode *)n1)->fpn_hash;
362 	hash2 = ((FullpathNode *)n2)->fpn_hash;
363 
364 	if (hash1 > hash2)
365 		return (1);
366 	if (hash1 < hash2)
367 		return (-1);
368 
369 	st1 = ((FullpathNode *)n1)->fpn_name;
370 	st2 = ((FullpathNode *)n2)->fpn_name;
371 
372 	rc = strcmp(st1, st2);
373 	if (rc > 0)
374 		return (1);
375 	if (rc < 0)
376 		return (-1);
377 	return (0);
378 }
379 
380 
381 /*
382  * Determine if a given pathname has already been loaded in the AVL tree.
383  * If the pathname does not exist in the AVL tree, the next insertion point
384  * is deposited in "where".  This value can be used by fpavl_insert() to
385  * expedite the insertion.
386  */
387 Rt_map *
388 fpavl_loaded(Lm_list *lml, const char *name, avl_index_t *where)
389 {
390 	FullpathNode	fpn, *fpnp;
391 	avl_tree_t	*avlt;
392 
393 	/*
394 	 * Create the avl tree if required.
395 	 */
396 	if ((avlt = lml->lm_fpavl) == NULL) {
397 		if ((avlt = calloc(sizeof (avl_tree_t), 1)) == 0)
398 			return (0);
399 		avl_create(avlt, fpavl_compare, sizeof (FullpathNode),
400 		    SGSOFFSETOF(FullpathNode, fpn_avl));
401 		lml->lm_fpavl = avlt;
402 	}
403 
404 	fpn.fpn_name = name;
405 	fpn.fpn_hash = sgs_str_hash(name);
406 
407 	if ((fpnp = avl_find(lml->lm_fpavl, &fpn, where)) == NULL)
408 		return (NULL);
409 
410 	return (fpnp->fpn_lmp);
411 }
412 
413 
414 /*
415  * Insert a name into the FullpathNode AVL tree for the link-map list.  The
416  * objects NAME() is the path that would have originally been searched for, and
417  * is therefore the name to associate with any "where" value.  If the object has
418  * a different PATHNAME(), perhaps because it has resolved to a different file
419  * (see fullpath), then this name is recorded also.  See load_file().
420  */
421 int
422 fpavl_insert(Lm_list *lml, Rt_map *lmp, const char *name, avl_index_t where)
423 {
424 	FullpathNode	*fpnp;
425 
426 	if (where == 0) {
427 		/* LINTED */
428 		Rt_map	*_lmp = fpavl_loaded(lml, name, &where);
429 
430 		/*
431 		 * We better not get a hit now, we do not want duplicates in
432 		 * the tree.
433 		 */
434 		ASSERT(_lmp == 0);
435 	}
436 
437 	/*
438 	 * Insert new node in tree
439 	 */
440 	if ((fpnp = calloc(sizeof (FullpathNode), 1)) == 0)
441 		return (0);
442 
443 	fpnp->fpn_name = name;
444 	fpnp->fpn_hash = sgs_str_hash(name);
445 	fpnp->fpn_lmp = lmp;
446 
447 	if (alist_append(&FPNODE(lmp), &fpnp, sizeof (FullpathNode *),
448 	    AL_CNT_FPNODE) == 0) {
449 		free(fpnp);
450 		return (0);
451 	}
452 
453 	ASSERT(lml->lm_fpavl != NULL);
454 	avl_insert(lml->lm_fpavl, fpnp, where);
455 	return (1);
456 }
457 
458 /*
459  * Remove an object from the Fullpath AVL tree.  Note, this is called *before*
460  * the objects link-map is torn down (remove_so), which is where any NAME() and
461  * PATHNAME() strings will be deallocated.
462  */
463 void
464 fpavl_remove(Rt_map *lmp)
465 {
466 	FullpathNode	**fpnpp;
467 	Aliste		off;
468 
469 	for (ALIST_TRAVERSE(FPNODE(lmp), off, fpnpp)) {
470 		FullpathNode	*fpnp = *fpnpp;
471 
472 		avl_remove(LIST(lmp)->lm_fpavl, fpnp);
473 		free(fpnp);
474 	}
475 	free(FPNODE(lmp));
476 	FPNODE(lmp) = 0;
477 }
478 
479 
480 /*
481  * Prior to calling an object, either via a .plt or through dlsym(), make sure
482  * its .init has fired.  Through topological sorting, ld.so.1 attempts to fire
483  * init's in the correct order, however, this order is typically based on needed
484  * dependencies and non-lazy relocation bindings.  Lazy relocations (.plts) can
485  * still occur and result in bindings that were not captured during topological
486  * sorting.  This routine compensates for this lack of binding information, and
487  * provides for dynamic .init firing.
488  */
489 void
490 is_dep_init(Rt_map * dlmp, Rt_map * clmp)
491 {
492 	Rt_map **	tobj;
493 
494 	/*
495 	 * If the caller is an auditor, and the destination isn't, then don't
496 	 * run any .inits (see comments in load_completion()).
497 	 */
498 	if ((LIST(clmp)->lm_flags & LML_FLG_NOAUDIT) &&
499 	    (LIST(clmp) != LIST(dlmp)))
500 		return;
501 
502 	if ((dlmp == clmp) || (rtld_flags & (RT_FL_BREADTH | RT_FL_INITFIRST)))
503 		return;
504 
505 	if ((FLAGS(dlmp) & (FLG_RT_RELOCED | FLG_RT_INITDONE)) ==
506 	    (FLG_RT_RELOCED | FLG_RT_INITDONE))
507 		return;
508 
509 	if ((FLAGS(dlmp) & (FLG_RT_RELOCED | FLG_RT_INITCALL)) ==
510 	    (FLG_RT_RELOCED | FLG_RT_INITCALL)) {
511 		DBG_CALL(Dbg_util_no_init(dlmp));
512 		return;
513 	}
514 
515 	if ((tobj = calloc(2, sizeof (Rt_map *))) != NULL) {
516 		tobj[0] = dlmp;
517 		call_init(tobj, DBG_INIT_DYN);
518 	}
519 }
520 
521 /*
522  * In a threaded environment insure the thread responsible for loading an object
523  * has completed .init processing for that object before any new thread is
524  * allowed to access the object.  This check is only valid with libthread
525  * TI_VERSION 2, where ld.so.1 implements locking through low level mutexes.
526  *
527  * When a new link-map is created, the thread that causes it to be loaded is
528  * identified by THREADID(dlmp).  Compare this with the current thread to
529  * determine if it must be blocked.
530  *
531  * NOTE, there are a number of instances (typically only for .plt processing)
532  * where we must skip this test:
533  *
534  *   .	any thread id of 0 - threads that call thr_exit() may be in this state
535  *	thus we can't deduce what tid they used to be.  Also some of the
536  *	lib/libthread worker threads have this id and must bind (to themselves
537  *	or libc) for libthread to function.
538  *
539  *   .	libthread itself binds to libc, and as libthread is INITFIRST
540  *	libc's .init can't have fired yet.  Luckly libc's .init is not required
541  *	by libthreads binding.
542  *
543  *   .	if the caller is an auditor, and the destination isn't, then don't
544  *	block (see comments in load_completion()).
545  */
546 void
547 is_dep_ready(Rt_map * dlmp, Rt_map * clmp, int what)
548 {
549 	thread_t	tid;
550 
551 	if ((LIST(clmp)->lm_flags & LML_FLG_NOAUDIT) &&
552 	    (LIST(clmp) != LIST(dlmp)))
553 		return;
554 
555 	if ((rtld_flags & RT_FL_CONCUR) &&
556 	    ((FLAGS(dlmp) & FLG_RT_INITDONE) == 0) &&
557 	    ((FLAGS(clmp) & FLG_RT_INITFRST) == 0) &&
558 	    ((tid = rt_thr_self()) != 0) && (THREADID(dlmp) != tid)) {
559 		while ((FLAGS(dlmp) & FLG_RT_INITDONE) == 0) {
560 			FLAGS1(dlmp) |= FL1_RT_INITWAIT;
561 			DBG_CALL(Dbg_util_wait(clmp, dlmp, what));
562 			(void) rt_cond_wait(CONDVAR(dlmp), &rtldlock);
563 		}
564 	}
565 }
566 
567 /*
568  * Execute .{preinit|init|fini}array sections
569  */
570 void
571 call_array(Addr *array, uint_t arraysz, Rt_map *lmp, Word shtype)
572 {
573 	int	start, stop, incr, ndx;
574 	uint_t	arraycnt = (uint_t)(arraysz / sizeof (Addr));
575 
576 	if (array == NULL)
577 		return;
578 
579 	/*
580 	 * initarray & preinitarray are walked from beginning to end - while
581 	 * finiarray is walked from end to beginning.
582 	 */
583 	if (shtype == SHT_FINI_ARRAY) {
584 		start = arraycnt - 1;
585 		stop = incr = -1;
586 	} else {
587 		start = 0;
588 		stop = arraycnt;
589 		incr = 1;
590 	}
591 
592 	/*
593 	 * Call the .*array[] entries
594 	 */
595 	for (ndx = start; ndx != stop; ndx += incr) {
596 		void (*fptr)(void) = (void(*)())array[ndx];
597 
598 		DBG_CALL(Dbg_util_call_array(lmp, (void *)fptr, ndx, shtype));
599 
600 		leave(LIST(lmp));
601 		(*fptr)();
602 		(void) enter();
603 	}
604 }
605 
606 
607 /*
608  * Execute any .init sections.  These are passed to us in an lmp array which
609  * (by default) will have been sorted.
610  */
611 void
612 call_init(Rt_map ** tobj, int flag)
613 {
614 	Rt_map **	_tobj, ** _nobj;
615 	static List	pending = { NULL, NULL };
616 
617 	/*
618 	 * If we're in the middle of an INITFIRST, this must complete before
619 	 * any new init's are fired.  In this case add the object list to the
620 	 * pending queue and return.  We'll pick up the queue after any
621 	 * INITFIRST objects have their init's fired.
622 	 */
623 	if (rtld_flags & RT_FL_INITFIRST) {
624 		(void) list_append(&pending, tobj);
625 		return;
626 	}
627 
628 	/*
629 	 * Traverse the tobj array firing each objects init.
630 	 */
631 	for (_tobj = _nobj = tobj, _nobj++; *_tobj != NULL; _tobj++, _nobj++) {
632 		Rt_map *	lmp = *_tobj;
633 		void (*		iptr)() = INIT(lmp);
634 
635 		if (FLAGS(lmp) & FLG_RT_INITCALL)
636 			continue;
637 
638 		FLAGS(lmp) |= FLG_RT_INITCALL;
639 
640 		/*
641 		 * Establish an initfirst state if necessary - no other inits
642 		 * will be fired (because of additional relocation bindings)
643 		 * when in this state.
644 		 */
645 		if (FLAGS(lmp) & FLG_RT_INITFRST)
646 			rtld_flags |= RT_FL_INITFIRST;
647 
648 		if (INITARRAY(lmp) || iptr) {
649 			Aliste		off;
650 			Bnd_desc **	bdpp;
651 
652 			/*
653 			 * Make sure that all dependencies that have been
654 			 * relocated to are initialized before this objects
655 			 * .init is executed.  This insures that a dependency
656 			 * on an external item that must first be initialized
657 			 * by its associated object is satisfied.
658 			 */
659 			for (ALIST_TRAVERSE(DEPENDS(lmp), off, bdpp)) {
660 				Bnd_desc *	bdp = *bdpp;
661 
662 				if ((bdp->b_flags & BND_REFER) == 0)
663 					continue;
664 				is_dep_ready(bdp->b_depend, lmp, DBG_WAIT_INIT);
665 			}
666 			DBG_CALL(Dbg_util_call_init(lmp, flag));
667 		}
668 
669 		if (iptr) {
670 			leave(LIST(lmp));
671 			(*iptr)();
672 			(void) enter();
673 		}
674 
675 		call_array(INITARRAY(lmp), INITARRAYSZ(lmp), lmp,
676 		    SHT_INIT_ARRAY);
677 
678 		if (INITARRAY(lmp) || iptr)
679 			DBG_CALL(Dbg_util_call_init(lmp, DBG_INIT_DONE));
680 
681 		/*
682 		 * Set the initdone flag regardless of whether this object
683 		 * actually contains an .init section.  This flag prevents us
684 		 * from processing this section again for an .init and also
685 		 * signifies that a .fini must be called should it exist.
686 		 * Clear the sort field for use in later .fini processing.
687 		 */
688 		FLAGS(lmp) |= FLG_RT_INITDONE;
689 		SORTVAL(lmp) = -1;
690 
691 		/*
692 		 * Wake anyone up who might be waiting on this .init.
693 		 */
694 		if (FLAGS1(lmp) & FL1_RT_INITWAIT) {
695 			DBG_CALL(Dbg_util_broadcast(lmp));
696 			(void) rt_cond_broadcast(CONDVAR(lmp));
697 			FLAGS1(lmp) &= ~FL1_RT_INITWAIT;
698 		}
699 
700 		/*
701 		 * If we're firing an INITFIRST object, and other objects must
702 		 * be fired which are not INITFIRST, make sure we grab any
703 		 * pending objects that might have been delayed as this
704 		 * INITFIRST was processed.
705 		 */
706 		if ((rtld_flags & RT_FL_INITFIRST) &&
707 		    ((*_nobj == NULL) || !(FLAGS(*_nobj) & FLG_RT_INITFRST))) {
708 			Listnode *	lnp;
709 			Rt_map **	pobj;
710 
711 			rtld_flags &= ~RT_FL_INITFIRST;
712 
713 			while ((lnp = pending.head) != NULL) {
714 				if ((pending.head = lnp->next) == NULL)
715 					pending.tail = NULL;
716 				pobj = lnp->data;
717 				free(lnp);
718 
719 				call_init(pobj, DBG_INIT_PEND);
720 			}
721 		}
722 	}
723 	free(tobj);
724 }
725 
726 /*
727  * Function called by atexit(3C).  Calls all .fini sections related with the
728  * mains dependent shared libraries in the order in which the shared libraries
729  * have been loaded.  Skip any .fini defined in the main executable, as this
730  * will be called by crt0 (main was never marked as initdone).
731  */
732 void
733 call_fini(Lm_list * lml, Rt_map ** tobj)
734 {
735 	Rt_map **_tobj;
736 
737 	for (_tobj = tobj; *_tobj != NULL; _tobj++) {
738 		Rt_map *	clmp, * lmp = *_tobj;
739 		Aliste		off;
740 		Bnd_desc **	bdpp;
741 
742 		/*
743 		 * If concurrency checking isn't enabled only fire .fini if
744 		 * .init has completed.  We collect all .fini sections of
745 		 * objects that had their .init collected, but that doesn't
746 		 * mean at the time that the .init had completed.
747 		 */
748 		if ((rtld_flags & RT_FL_CONCUR) ||
749 		    (FLAGS(lmp) & FLG_RT_INITDONE)) {
750 			void	(*fptr)(void) = FINI(lmp);
751 
752 			if (FINIARRAY(lmp) || fptr) {
753 				/*
754 				 * If concurrency checking is enabled make sure
755 				 * this object's .init is completed before
756 				 * calling any .fini.
757 				 */
758 				is_dep_ready(lmp, lmp, DBG_WAIT_FINI);
759 				DBG_CALL(Dbg_util_call_fini(lmp));
760 			}
761 
762 			call_array(FINIARRAY(lmp), FINIARRAYSZ(lmp), lmp,
763 			    SHT_FINI_ARRAY);
764 
765 			if (fptr) {
766 				leave(LIST(lmp));
767 				(*fptr)();
768 				(void) enter();
769 			}
770 		}
771 
772 		/*
773 		 * Skip main, this is explicitly called last in atexit_fini().
774 		 */
775 		if (FLAGS(lmp) & FLG_RT_ISMAIN)
776 			continue;
777 
778 		/*
779 		 * Audit `close' operations at this point.  The library has
780 		 * exercised its last instructions (regardless of whether it
781 		 * will be unmapped or not).
782 		 *
783 		 * First call any global auditing.
784 		 */
785 		if (lml->lm_tflags & LML_TFLG_AUD_OBJCLOSE)
786 			_audit_objclose(&(auditors->ad_list), lmp);
787 
788 		/*
789 		 * Finally determine whether this object has local auditing
790 		 * requirements by inspecting itself and then its dependencies.
791 		 */
792 		if ((lml->lm_flags & LML_FLG_LOCAUDIT) == 0)
793 			continue;
794 
795 		if (FLAGS1(lmp) & LML_TFLG_AUD_OBJCLOSE)
796 			_audit_objclose(&(AUDITORS(lmp)->ad_list), lmp);
797 
798 		for (ALIST_TRAVERSE(CALLERS(lmp), off, bdpp)) {
799 			Bnd_desc *	bdp = *bdpp;
800 
801 			clmp = bdp->b_caller;
802 
803 			if (FLAGS1(clmp) & LML_TFLG_AUD_OBJCLOSE) {
804 			    _audit_objclose(&(AUDITORS(clmp)->ad_list), lmp);
805 			    break;
806 			}
807 		}
808 	}
809 	DBG_CALL(Dbg_bind_plt_summary(lml, M_MACH, pltcnt21d, pltcnt24d,
810 	    pltcntu32, pltcntu44, pltcntfull, pltcntfar));
811 
812 	free(tobj);
813 }
814 
815 void
816 atexit_fini()
817 {
818 	Rt_map **	tobj, * lmp;
819 	Lm_list *	lml;
820 	Listnode *	lnp;
821 
822 	(void) enter();
823 
824 	rtld_flags |= RT_FL_ATEXIT;
825 
826 	lml = &lml_main;
827 	lml->lm_flags |= LML_FLG_ATEXIT;
828 	lmp = (Rt_map *)lml->lm_head;
829 
830 	/*
831 	 * Display any objects that haven't been referenced so far.
832 	 */
833 	unused(lml);
834 
835 	/*
836 	 * Reverse topologically sort the main link-map for .fini execution.
837 	 */
838 	if (((tobj = tsort(lmp, lml->lm_obj, RT_SORT_FWD)) != 0) &&
839 	    (tobj != (Rt_map **)S_ERROR))
840 		call_fini(lml, tobj);
841 
842 	/*
843 	 * Add an explicit close to main and ld.so.1.  Although main's .fini is
844 	 * collected in call_fini() to provide for FINITARRAY processing, its
845 	 * audit_objclose is explicitly skipped.  This provides for it to be
846 	 * called last, here.  This is the reverse of the explicit calls to
847 	 * audit_objopen() made in setup().
848 	 */
849 	if ((lml->lm_tflags | FLAGS1(lmp)) & LML_TFLG_AUD_MASK) {
850 		audit_objclose(lmp, (Rt_map *)lml_rtld.lm_head);
851 		audit_objclose(lmp, lmp);
852 	}
853 
854 	/*
855 	 * Now that all .fini code has been run, see what unreferenced objects
856 	 * remain.  Any difference between this and the above unused() would
857 	 * indicate an object is only being used for .fini processing, which
858 	 * might be fine, but might also indicate an overhead whose removal
859 	 * would be worth considering.
860 	 */
861 	unused(lml);
862 
863 	/*
864 	 * Traverse any alternative link-map lists.
865 	 */
866 	for (LIST_TRAVERSE(&dynlm_list, lnp, lml)) {
867 		/*
868 		 * Ignore the base-link-map list, which has already been
869 		 * processed, and the runtime linkers link-map list, which is
870 		 * typically processed last.
871 		 */
872 		if (lml->lm_flags & (LML_FLG_BASELM | LML_FLG_RTLDLM))
873 			continue;
874 
875 		if ((lmp = (Rt_map *)lml->lm_head) == 0)
876 			continue;
877 
878 		lml->lm_flags |= LML_FLG_ATEXIT;
879 
880 		/*
881 		 * Reverse topologically sort the link-map for .fini execution.
882 		 */
883 		if (((tobj = tsort(lmp, lml->lm_obj, RT_SORT_FWD)) != 0) &&
884 		    (tobj != (Rt_map **)S_ERROR))
885 			call_fini(lml, tobj);
886 
887 		unused(lml);
888 	}
889 
890 	/*
891 	 * Finally reverse topologically sort the runtime linkers link-map for
892 	 * .fini execution.
893 	 */
894 	lml = &lml_rtld;
895 	lml->lm_flags |= LML_FLG_ATEXIT;
896 	lmp = (Rt_map *)lml->lm_head;
897 
898 	if (((tobj = tsort(lmp, lml->lm_obj, RT_SORT_FWD)) != 0) &&
899 	    (tobj != (Rt_map **)S_ERROR))
900 		call_fini(lml, tobj);
901 
902 	leave(&lml_main);
903 }
904 
905 
906 /*
907  * This routine is called to complete any runtime linker activity which may have
908  * resulted in objects being loaded.  This is called from all user entry points
909  * and from any internal dl*() requests.
910  */
911 void
912 load_completion(Rt_map *nlmp, Rt_map *clmp)
913 {
914 	Rt_map	**tobj = 0;
915 	Lm_list	*nlml, *clml;
916 
917 	/*
918 	 * Establish any .init processing.  Note, in a world of lazy loading,
919 	 * objects may have been loaded regardless of whether the users request
920 	 * was fulfilled (i.e., a dlsym() request may have failed to find a
921 	 * symbol but objects might have been loaded during its search).  Thus,
922 	 * any tsorting starts from the nlmp (new link-maps) pointer and not
923 	 * necessarily from the link-map that may have satisfied the request.
924 	 *
925 	 * Note, the primary link-map has an initialization phase where dynamic
926 	 * .init firing is suppressed.  This provides for a simple and clean
927 	 * handshake with the primary link-maps libc, which is important for
928 	 * establishing uberdata.  In addition, auditors often obtain handles
929 	 * to primary link-map objects as the objects are loaded, so as to
930 	 * inspect the link-map for symbols.  This inspection is allowed without
931 	 * running any code on the primary link-map, as running this code may
932 	 * reenter the auditor, who may not yet have finished its own
933 	 * initialization.
934 	 */
935 	if (nlmp)
936 		nlml = LIST(nlmp);
937 	if (clmp)
938 		clml = LIST(clmp);
939 
940 	if (nlmp && nlml->lm_init &&
941 	    ((nlml != &lml_main) || (rtld_flags2 & RT_FL2_PLMSETUP))) {
942 		if ((tobj = tsort(nlmp, LIST(nlmp)->lm_init,
943 		    RT_SORT_REV)) == (Rt_map **)S_ERROR)
944 			tobj = 0;
945 	}
946 
947 	/*
948 	 * Make sure any alternative link-map retrieves any external interfaces
949 	 * and initializes threads.
950 	 */
951 	if (nlmp && (nlml != &lml_main)) {
952 		(void) rt_get_extern(nlml, nlmp);
953 		rt_thr_init(nlml);
954 	}
955 
956 	/*
957 	 * Traverse the list of new link-maps and register any dynamic TLS.
958 	 * This storage is established for any objects not on the primary
959 	 * link-map, and for any objects added to the primary link-map after
960 	 * static TLS has been registered.
961 	 */
962 	if (nlmp && nlml->lm_tls &&
963 	    ((nlml != &lml_main) || (rtld_flags2 & RT_FL2_PLMSETUP))) {
964 		Rt_map	*lmp;
965 
966 		for (lmp = nlmp; lmp; lmp = (Rt_map *)NEXT(lmp)) {
967 			if (PTTLS(lmp) && PTTLS(lmp)->p_memsz)
968 				tls_modaddrem(lmp, TM_FLG_MODADD);
969 		}
970 		nlml->lm_tls = 0;
971 	}
972 
973 	/*
974 	 * Indicate the link-map list is consistent.
975 	 */
976 	if (clmp && ((clml->lm_tflags | FLAGS1(clmp)) & LML_TFLG_AUD_ACTIVITY))
977 		audit_activity(clmp, LA_ACT_CONSISTENT);
978 
979 	/*
980 	 * Fire any .init's.
981 	 */
982 	if (tobj)
983 		call_init(tobj, DBG_INIT_SORT);
984 }
985 
986 /*
987  * Append an item to the specified list, and return a pointer to the list
988  * node created.
989  */
990 Listnode *
991 list_append(List *lst, const void *item)
992 {
993 	Listnode *	_lnp;
994 
995 	if ((_lnp = malloc(sizeof (Listnode))) == 0)
996 		return (0);
997 
998 	_lnp->data = (void *)item;
999 	_lnp->next = NULL;
1000 
1001 	if (lst->head == NULL)
1002 		lst->tail = lst->head = _lnp;
1003 	else {
1004 		lst->tail->next = _lnp;
1005 		lst->tail = lst->tail->next;
1006 	}
1007 	return (_lnp);
1008 }
1009 
1010 
1011 /*
1012  * Add an item after specified listnode, and return a pointer to the list
1013  * node created.
1014  */
1015 Listnode *
1016 list_insert(List *lst, const void *item, Listnode *lnp)
1017 {
1018 	Listnode *	_lnp;
1019 
1020 	if ((_lnp = malloc(sizeof (Listnode))) == (Listnode *)0)
1021 		return (0);
1022 
1023 	_lnp->data = (void *)item;
1024 	_lnp->next = lnp->next;
1025 	if (_lnp->next == NULL)
1026 		lst->tail = _lnp;
1027 	lnp->next = _lnp;
1028 	return (_lnp);
1029 }
1030 
1031 /*
1032  * Prepend an item to the specified list, and return a pointer to the
1033  * list node created.
1034  */
1035 Listnode *
1036 list_prepend(List * lst, const void * item)
1037 {
1038 	Listnode *	_lnp;
1039 
1040 	if ((_lnp = malloc(sizeof (Listnode))) == (Listnode *)0)
1041 		return (0);
1042 
1043 	_lnp->data = (void *)item;
1044 
1045 	if (lst->head == NULL) {
1046 		_lnp->next = NULL;
1047 		lst->tail = lst->head = _lnp;
1048 	} else {
1049 		_lnp->next = lst->head;
1050 		lst->head = _lnp;
1051 	}
1052 	return (_lnp);
1053 }
1054 
1055 
1056 /*
1057  * Delete a 'listnode' from a list.
1058  */
1059 void
1060 list_delete(List * lst, void * item)
1061 {
1062 	Listnode *	clnp, * plnp;
1063 
1064 	for (plnp = NULL, clnp = lst->head; clnp; clnp = clnp->next) {
1065 		if (item == clnp->data)
1066 			break;
1067 		plnp = clnp;
1068 	}
1069 
1070 	if (clnp == 0)
1071 		return;
1072 
1073 	if (lst->head == clnp)
1074 		lst->head = clnp->next;
1075 	if (lst->tail == clnp)
1076 		lst->tail = plnp;
1077 
1078 	if (plnp)
1079 		plnp->next = clnp->next;
1080 
1081 	free(clnp);
1082 }
1083 
1084 /*
1085  * Append an item to the specified link map control list.
1086  */
1087 void
1088 lm_append(Lm_list *lml, Aliste lmco, Rt_map *lmp)
1089 {
1090 	Lm_cntl	*lmc;
1091 	int	add = 1;
1092 
1093 	/*
1094 	 * Indicate that this link-map list has a new object.
1095 	 */
1096 	(lml->lm_obj)++;
1097 
1098 	/*
1099 	 * If we're about to add a new object to the main link-map control list,
1100 	 * alert the debuggers that we are about to mess with this list.
1101 	 * Additions of individual objects to the main link-map control list
1102 	 * occur during initial setup as the applications immediate dependencies
1103 	 * are loaded.  Individual objects are also loaded on the main link-map
1104 	 * control list of new alternative link-map control lists.
1105 	 */
1106 	if ((lmco == ALO_DATA) && ((lml->lm_flags & LML_FLG_DBNOTIF) == 0))
1107 		rd_event(lml, RD_DLACTIVITY, RT_ADD);
1108 
1109 	/* LINTED */
1110 	lmc = (Lm_cntl *)((char *)lml->lm_lists + lmco);
1111 
1112 	/*
1113 	 * A link-map list header points to one of more link-map control lists
1114 	 * (see include/rtld.h).  The initial list, pointed to by lm_cntl, is
1115 	 * the list of relocated objects.  Other lists maintain objects that
1116 	 * are still being analyzed or relocated.  This list provides the core
1117 	 * link-map list information used by all ld.so.1 routines.
1118 	 */
1119 	if (lmc->lc_head == NULL) {
1120 		/*
1121 		 * If this is the first link-map for the given control list,
1122 		 * initialize the list.
1123 		 */
1124 		lmc->lc_head = lmc->lc_tail = lmp;
1125 		add = 0;
1126 
1127 	} else if (FLAGS(lmp) & FLG_RT_OBJINTPO) {
1128 		Rt_map	*tlmp;
1129 
1130 		/*
1131 		 * If this is an interposer then append the link-map following
1132 		 * any other interposers (these are objects that have been
1133 		 * previously preloaded, or were identified with -z interpose).
1134 		 * Interposers can only be inserted on the first link-map
1135 		 * control list, as once relocation has started, interposition
1136 		 * from new interposers can't be guaranteed.
1137 		 *
1138 		 * NOTE: We do not interpose on the head of a list.  This model
1139 		 * evolved because dynamic executables have already been fully
1140 		 * relocated within themselves and thus can't be interposed on.
1141 		 * Nowadays it's possible to have shared objects at the head of
1142 		 * a list, which conceptually means they could be interposed on.
1143 		 * But, shared objects can be created via dldump() and may only
1144 		 * be partially relocated (just relatives), in which case they
1145 		 * are interposable, but are marked as fixed (ET_EXEC).
1146 		 *
1147 		 * Thus we really don't have a clear method of deciding when the
1148 		 * head of a link-map is interposable.  So, to be consistent,
1149 		 * for now only add interposers after the link-map lists head
1150 		 * object.
1151 		 */
1152 		for (tlmp = (Rt_map *)NEXT(lmc->lc_head); tlmp;
1153 		    tlmp = (Rt_map *)NEXT(tlmp)) {
1154 
1155 			if (FLAGS(tlmp) & FLG_RT_OBJINTPO)
1156 				continue;
1157 
1158 			/*
1159 			 * Insert the new link-map before this non-interposer,
1160 			 * and indicate an interposer is found.
1161 			 */
1162 			NEXT((Rt_map *)PREV(tlmp)) = (Link_map *)lmp;
1163 			PREV(lmp) = PREV(tlmp);
1164 
1165 			NEXT(lmp) = (Link_map *)tlmp;
1166 			PREV(tlmp) = (Link_map *)lmp;
1167 
1168 			lmc->lc_flags |= LMC_FLG_REANALYZE;
1169 			add = 0;
1170 			break;
1171 		}
1172 	}
1173 
1174 	/*
1175 	 * Fall through to appending the new link map to the tail of the list.
1176 	 * If we're processing the initial objects of this link-map list, add
1177 	 * them to the backward compatibility list.
1178 	 */
1179 	if (add) {
1180 		NEXT(lmc->lc_tail) = (Link_map *)lmp;
1181 		PREV(lmp) = (Link_map *)lmc->lc_tail;
1182 		lmc->lc_tail = lmp;
1183 	}
1184 
1185 	/*
1186 	 * Having added this link-map to a control list, indicate which control
1187 	 * list the link-map belongs to.  Note, control list information is
1188 	 * always maintained as an offset, as the Alist can be reallocated.
1189 	 */
1190 	CNTL(lmp) = lmco;
1191 
1192 	/*
1193 	 * Indicate if an interposer is found.  Note that the first object on a
1194 	 * link-map can be explicitly defined as an interposer so that it can
1195 	 * provide interposition over direct binding requests.
1196 	 */
1197 	if (FLAGS(lmp) & MSK_RT_INTPOSE)
1198 		lml->lm_flags |= LML_FLG_INTRPOSE;
1199 
1200 	/*
1201 	 * For backward compatibility with debuggers, the link-map list contains
1202 	 * pointers to the main control list.
1203 	 */
1204 	if (lmco == ALO_DATA) {
1205 		lml->lm_head = lmc->lc_head;
1206 		lml->lm_tail = lmc->lc_tail;
1207 	}
1208 }
1209 
1210 /*
1211  * Delete an item from the specified link map control list.
1212  */
1213 void
1214 lm_delete(Lm_list *lml, Rt_map *lmp)
1215 {
1216 	Lm_cntl	*lmc;
1217 
1218 	/*
1219 	 * If the control list pointer hasn't been initialized, this object
1220 	 * never got added to a link-map list.
1221 	 */
1222 	if (CNTL(lmp) == 0)
1223 		return;
1224 
1225 	/*
1226 	 * If we're about to delete an object from the main link-map control
1227 	 * list, alert the debuggers that we are about to mess with this list.
1228 	 */
1229 	if ((CNTL(lmp) == ALO_DATA) && ((lml->lm_flags & LML_FLG_DBNOTIF) == 0))
1230 		rd_event(lml, RD_DLACTIVITY, RT_DELETE);
1231 
1232 	/* LINTED */
1233 	lmc = (Lm_cntl *)((char *)lml->lm_lists + CNTL(lmp));
1234 
1235 	if (lmc->lc_head == lmp)
1236 		lmc->lc_head = (Rt_map *)NEXT(lmp);
1237 	else
1238 		NEXT((Rt_map *)PREV(lmp)) = (void *)NEXT(lmp);
1239 
1240 	if (lmc->lc_tail == lmp)
1241 		lmc->lc_tail = (Rt_map *)PREV(lmp);
1242 	else
1243 		PREV((Rt_map *)NEXT(lmp)) = PREV(lmp);
1244 
1245 	/*
1246 	 * For backward compatibility with debuggers, the link-map list contains
1247 	 * pointers to the main control list.
1248 	 */
1249 	if (lmc == (Lm_cntl *)&(lml->lm_lists->al_data)) {
1250 		lml->lm_head = lmc->lc_head;
1251 		lml->lm_tail = lmc->lc_tail;
1252 	}
1253 
1254 	/*
1255 	 * Indicate we have one less object on this control list.
1256 	 */
1257 	(lml->lm_obj)--;
1258 }
1259 
1260 /*
1261  * Move a link-map control list to another.  Objects that are being relocated
1262  * are maintained on secondary control lists.  Once their relocation is
1263  * complete, the entire list is appended to the previous control list, as this
1264  * list must have been the trigger for generating the new control list.
1265  */
1266 void
1267 lm_move(Lm_list *lml, Aliste nlmco, Aliste plmco, Lm_cntl *nlmc, Lm_cntl *plmc)
1268 {
1269 	Rt_map	*lmp;
1270 
1271 	/*
1272 	 * If we're about to add a new family of objects to the main link-map
1273 	 * control list, alert the debuggers that we are about to mess with this
1274 	 * list.  Additions of object families to the main link-map control
1275 	 * list occur during lazy loading, filtering and dlopen().
1276 	 */
1277 	if ((plmco == ALO_DATA) && ((lml->lm_flags & LML_FLG_DBNOTIF) == 0))
1278 		rd_event(lml, RD_DLACTIVITY, RT_ADD);
1279 
1280 	DBG_CALL(Dbg_file_cntl(lml, nlmco, plmco));
1281 
1282 	/*
1283 	 * Indicate each new link-map has been moved to the previous link-map
1284 	 * control list.
1285 	 */
1286 	for (lmp = nlmc->lc_head; lmp; lmp = (Rt_map *)NEXT(lmp))
1287 		CNTL(lmp) = plmco;
1288 
1289 	/*
1290 	 * Move the new link-map control list, to the callers link-map control
1291 	 * list.
1292 	 */
1293 	if (plmc->lc_head == 0) {
1294 		plmc->lc_head = nlmc->lc_head;
1295 		PREV(nlmc->lc_head) = 0;
1296 	} else {
1297 		NEXT(plmc->lc_tail) = (Link_map *)nlmc->lc_head;
1298 		PREV(nlmc->lc_head) = (Link_map *)plmc->lc_tail;
1299 	}
1300 
1301 	plmc->lc_tail = nlmc->lc_tail;
1302 	nlmc->lc_head = nlmc->lc_tail = 0;
1303 
1304 	/*
1305 	 * For backward compatibility with debuggers, the link-map list contains
1306 	 * pointers to the main control list.
1307 	 */
1308 	if (plmco == ALO_DATA) {
1309 		lml->lm_head = plmc->lc_head;
1310 		lml->lm_tail = plmc->lc_tail;
1311 	}
1312 }
1313 
1314 /*
1315  * Dlopening a family of objects occurs on a new link-map control list.  If the
1316  * dlopen fails, then its handle is used to tear down the family (dlclose).
1317  * However, the relocation of this family may have triggered other objects to
1318  * be loaded, and after their relocation they will have been moved to the
1319  * dlopen families control list.  After a dlopen() failure, see if there are
1320  * any objects that can be savaged before tearing down this control list.
1321  */
1322 int
1323 lm_salvage(Lm_list *lml, int test, Aliste nlmco)
1324 {
1325 	Lm_cntl	*nlmc;
1326 
1327 	/*
1328 	 * If a dlopen occurred on a new link-map list, then its dlclose may
1329 	 * have completely torn down the link-map list.  Check that the link-map
1330 	 * list still exists before proceeding.
1331 	 */
1332 	if (test) {
1333 		Listnode	*lnp;
1334 		Lm_list		*tlml;
1335 		int		found = 0;
1336 
1337 		for (LIST_TRAVERSE(&dynlm_list, lnp, tlml)) {
1338 			if (tlml == lml) {
1339 				found++;
1340 				break;
1341 			}
1342 		}
1343 		if (found == 0)
1344 			return (0);
1345 	}
1346 
1347 	/* LINTED */
1348 	nlmc = (Lm_cntl *)((char *)lml->lm_lists + nlmco);
1349 
1350 	/*
1351 	 * If this link-map control list still contains objects, determine the
1352 	 * previous control list and move the objects.
1353 	 */
1354 	if (nlmc->lc_head) {
1355 		Lm_cntl *plmc;
1356 		Aliste  plmco;
1357 
1358 		plmco = nlmco - lml->lm_lists->al_size;
1359 		/* LINTED */
1360 		plmc = (Lm_cntl *)((char *)lml->lm_lists + plmco);
1361 
1362 		lm_move(lml, nlmco, plmco, nlmc, plmc);
1363 	}
1364 	return (1);
1365 }
1366 
1367 /*
1368  * Environment variables can have a variety of defined permutations, and thus
1369  * the following infrastructure exists to allow this variety and to select the
1370  * required definition.
1371  *
1372  * Environment variables can be defined as 32- or 64-bit specific, and if so
1373  * they will take precedence over any instruction set neutral form.  Typically
1374  * this is only useful when the environment value is an informational string.
1375  *
1376  * Environment variables may be obtained from the standard user environment or
1377  * from a configuration file.  The latter provides a fallback if no user
1378  * environment setting is found, and can take two forms:
1379  *
1380  *  .	a replaceable definition - this will be used if no user environment
1381  *	setting has been seen, or
1382  *
1383  *  .	an permanent definition - this will be used no matter what user
1384  *	environment setting is seen.  In the case of list variables it will be
1385  *	appended to any process environment setting seen.
1386  *
1387  * Environment variables can be defined without a value (ie. LD_XXXX=) so as to
1388  * override any replaceable environment variables from a configuration file.
1389  */
1390 static	u_longlong_t		rplgen;		/* replaceable generic */
1391 						/*	variables */
1392 static	u_longlong_t		rplisa;		/* replaceable ISA specific */
1393 						/*	variables */
1394 static	u_longlong_t		prmgen;		/* permanent generic */
1395 						/*	variables */
1396 static	u_longlong_t		prmisa;		/* permanent ISA specific */
1397 						/*	variables */
1398 
1399 /*
1400  * Classify an environment variables type.
1401  */
1402 #define	ENV_TYP_IGNORE		0x1		/* ignore - variable is for */
1403 						/*	the wrong ISA */
1404 #define	ENV_TYP_ISA		0x2		/* variable is ISA specific */
1405 #define	ENV_TYP_CONFIG		0x4		/* variable obtained from a */
1406 						/*	config file */
1407 #define	ENV_TYP_PERMANT		0x8		/* variable is permanent */
1408 
1409 /*
1410  * Identify all environment variables.
1411  */
1412 #define	ENV_FLG_AUDIT		0x0000000001ULL
1413 #define	ENV_FLG_AUDIT_ARGS	0x0000000002ULL
1414 #define	ENV_FLG_BIND_NOW	0x0000000004ULL
1415 #define	ENV_FLG_BIND_NOT	0x0000000008ULL
1416 #define	ENV_FLG_BINDINGS	0x0000000010ULL
1417 #define	ENV_FLG_CONCURRENCY	0x0000000020ULL
1418 #define	ENV_FLG_CONFGEN		0x0000000040ULL
1419 #define	ENV_FLG_CONFIG		0x0000000080ULL
1420 #define	ENV_FLG_DEBUG		0x0000000100ULL
1421 #define	ENV_FLG_DEBUG_OUTPUT	0x0000000200ULL
1422 #define	ENV_FLG_DEMANGLE	0x0000000400ULL
1423 #define	ENV_FLG_FLAGS		0x0000000800ULL
1424 #define	ENV_FLG_INIT		0x0000001000ULL
1425 #define	ENV_FLG_LIBPATH		0x0000002000ULL
1426 #define	ENV_FLG_LOADAVAIL	0x0000004000ULL
1427 #define	ENV_FLG_LOADFLTR	0x0000008000ULL
1428 #define	ENV_FLG_NOAUDIT		0x0000010000ULL
1429 #define	ENV_FLG_NOAUXFLTR	0x0000020000ULL
1430 #define	ENV_FLG_NOBAPLT		0x0000040000ULL
1431 #define	ENV_FLG_NOCONFIG	0x0000080000ULL
1432 #define	ENV_FLG_NODIRCONFIG	0x0000100000ULL
1433 #define	ENV_FLG_NODIRECT	0x0000200000ULL
1434 #define	ENV_FLG_NOENVCONFIG	0x0000400000ULL
1435 #define	ENV_FLG_NOLAZY		0x0000800000ULL
1436 #define	ENV_FLG_NOOBJALTER	0x0001000000ULL
1437 #define	ENV_FLG_NOVERSION	0x0002000000ULL
1438 #define	ENV_FLG_PRELOAD		0x0004000000ULL
1439 #define	ENV_FLG_PROFILE		0x0008000000ULL
1440 #define	ENV_FLG_PROFILE_OUTPUT	0x0010000000ULL
1441 #define	ENV_FLG_SIGNAL		0x0020000000ULL
1442 #define	ENV_FLG_TRACE_OBJS	0x0040000000ULL
1443 #define	ENV_FLG_TRACE_PTHS	0x0080000000ULL
1444 #define	ENV_FLG_UNREF		0x0100000000ULL
1445 #define	ENV_FLG_UNUSED		0x0200000000ULL
1446 #define	ENV_FLG_VERBOSE		0x0400000000ULL
1447 #define	ENV_FLG_WARN		0x0800000000ULL
1448 #define	ENV_FLG_NOFLTCONFIG	0x1000000000ULL
1449 #define	ENV_FLG_BIND_LAZY	0x2000000000ULL
1450 
1451 #ifdef	SIEBEL_DISABLE
1452 #define	ENV_FLG_FIX_1		0x8000000000ULL
1453 #endif
1454 
1455 #define	SEL_REPLACE		0x0001
1456 #define	SEL_PERMANT		0x0002
1457 #define	SEL_ACT_RT		0x0100	/* setting rtld_flags */
1458 #define	SEL_ACT_RT2		0x0200	/* setting rtld_flags2 */
1459 #define	SEL_ACT_STR		0x0400	/* setting string value */
1460 #define	SEL_ACT_LML		0x0800	/* setting lml_flags */
1461 #define	SEL_ACT_LMLT		0x1000	/* setting lml_tflags */
1462 #define	SEL_ACT_SPEC_1		0x2000	/* For FLG_{FLAGS, LIBPATH} */
1463 #define	SEL_ACT_SPEC_2		0x4000	/* need special handling */
1464 
1465 /*
1466  * Pattern match an LD_XXXX environment variable.  s1 points to the XXXX part
1467  * and len specifies its length (comparing a strings length before the string
1468  * itself speed things up).  s2 points to the token itself which has already
1469  * had any leading white-space removed.
1470  */
1471 static void
1472 ld_generic_env(const char *s1, size_t len, const char *s2, Word *lmflags,
1473     Word *lmtflags, uint_t env_flags, int aout)
1474 {
1475 	u_longlong_t	variable = 0;
1476 	ushort_t	select = 0;
1477 	const char	**str;
1478 	Word		val = 0;
1479 
1480 	/*
1481 	 * Determine whether we're dealing with a replaceable or permanent
1482 	 * string.
1483 	 */
1484 	if (env_flags & ENV_TYP_PERMANT) {
1485 		/*
1486 		 * If the string is from a configuration file and defined as
1487 		 * permanent, assign it as permanent.
1488 		 */
1489 		select |= SEL_PERMANT;
1490 	} else
1491 		select |= SEL_REPLACE;
1492 
1493 	/*
1494 	 * Parse the variable given.
1495 	 *
1496 	 * The LD_AUDIT family.
1497 	 */
1498 	if (*s1 == 'A') {
1499 		if ((len == MSG_LD_AUDIT_SIZE) && (strncmp(s1,
1500 		    MSG_ORIG(MSG_LD_AUDIT), MSG_LD_AUDIT_SIZE) == 0)) {
1501 			/*
1502 			 * Replaceable and permanent audit objects can exist.
1503 			 */
1504 			select |= SEL_ACT_STR;
1505 			if (select & SEL_REPLACE)
1506 				str = &rpl_audit;
1507 			else {
1508 				str = &prm_audit;
1509 				rpl_audit = 0;
1510 			}
1511 			variable = ENV_FLG_AUDIT;
1512 		} else if ((len == MSG_LD_AUDIT_ARGS_SIZE) &&
1513 		    (strncmp(s1, MSG_ORIG(MSG_LD_AUDIT_ARGS),
1514 		    MSG_LD_AUDIT_ARGS_SIZE) == 0)) {
1515 			/*
1516 			 * A specialized variable for plt_exit() use, not
1517 			 * documented for general use.
1518 			 */
1519 			select |= SEL_ACT_SPEC_2;
1520 			variable = ENV_FLG_AUDIT_ARGS;
1521 		}
1522 	}
1523 	/*
1524 	 * The LD_BIND family and LD_BREADTH (historic).
1525 	 */
1526 	else if (*s1 == 'B') {
1527 		if ((len == MSG_LD_BIND_LAZY_SIZE) && (strncmp(s1,
1528 		    MSG_ORIG(MSG_LD_BIND_LAZY),
1529 		    MSG_LD_BIND_LAZY_SIZE) == 0)) {
1530 			select |= SEL_ACT_RT2;
1531 			val = RT_FL2_BINDLAZY;
1532 			variable = ENV_FLG_BIND_LAZY;
1533 		} else if ((len == MSG_LD_BIND_NOW_SIZE) && (strncmp(s1,
1534 		    MSG_ORIG(MSG_LD_BIND_NOW), MSG_LD_BIND_NOW_SIZE) == 0)) {
1535 			select |= SEL_ACT_RT2;
1536 			val = RT_FL2_BINDNOW;
1537 			variable = ENV_FLG_BIND_NOW;
1538 		} else if ((len == MSG_LD_BIND_NOT_SIZE) && (strncmp(s1,
1539 		    MSG_ORIG(MSG_LD_BIND_NOT), MSG_LD_BIND_NOT_SIZE) == 0)) {
1540 			/*
1541 			 * Another trick, enabled to help debug AOUT
1542 			 * applications under BCP, but not documented for
1543 			 * general use.
1544 			 */
1545 			select |= SEL_ACT_RT;
1546 			val = RT_FL_NOBIND;
1547 			variable = ENV_FLG_BIND_NOT;
1548 		} else if ((len == MSG_LD_BINDINGS_SIZE) && (strncmp(s1,
1549 		    MSG_ORIG(MSG_LD_BINDINGS), MSG_LD_BINDINGS_SIZE) == 0)) {
1550 			/*
1551 			 * This variable is simply for backward compatibility.
1552 			 * If this and LD_DEBUG are both specified, only one of
1553 			 * the strings is going to get processed.
1554 			 */
1555 			select |= SEL_ACT_SPEC_2;
1556 			variable = ENV_FLG_BINDINGS;
1557 #ifndef LD_BREADTH_DISABLED
1558 		} else if ((len == MSG_LD_BREADTH_SIZE) && (strncmp(s1,
1559 		    MSG_ORIG(MSG_LD_BREADTH), MSG_LD_BREADTH_SIZE) == 0)) {
1560 			/*
1561 			 * Besides some old patches this is no longer available.
1562 			 */
1563 			rtld_flags |= RT_FL_BREADTH;
1564 			return;
1565 #endif
1566 		}
1567 	}
1568 	/*
1569 	 * LD_CONCURRENCY and LD_CONFIG family.
1570 	 */
1571 	else if (*s1 == 'C') {
1572 		if ((len == MSG_LD_CONCURRENCY_SIZE) && (strncmp(s1,
1573 		    MSG_ORIG(MSG_LD_CONCURRENCY),
1574 		    MSG_LD_CONCURRENCY_SIZE) == 0)) {
1575 			/*
1576 			 * Waiting in the wings, as concurrency checking isn't
1577 			 * yet enabled.
1578 			 */
1579 			select |= SEL_ACT_SPEC_2;
1580 			variable = ENV_FLG_CONCURRENCY;
1581 		} else if ((len == MSG_LD_CONFGEN_SIZE) && (strncmp(s1,
1582 		    MSG_ORIG(MSG_LD_CONFGEN), MSG_LD_CONFGEN_SIZE) == 0)) {
1583 			/*
1584 			 * Set by crle(1) to indicate it's building a
1585 			 * configuration file, not documented for general use.
1586 			 */
1587 			select |= SEL_ACT_SPEC_2;
1588 			variable = ENV_FLG_CONFGEN;
1589 		} else if ((len == MSG_LD_CONFIG_SIZE) && (strncmp(s1,
1590 		    MSG_ORIG(MSG_LD_CONFIG), MSG_LD_CONFIG_SIZE) == 0)) {
1591 			/*
1592 			 * Secure applications must use a default configuration
1593 			 * file.  A setting from a configuration file doesn't
1594 			 * make sense (given we must be reading a configuration
1595 			 * file to have gotten this).
1596 			 */
1597 			if ((rtld_flags & RT_FL_SECURE) ||
1598 			    (env_flags & ENV_TYP_CONFIG))
1599 				return;
1600 			select |= SEL_ACT_STR;
1601 			str = &config->c_name;
1602 			variable = ENV_FLG_CONFIG;
1603 		}
1604 	}
1605 	/*
1606 	 * The LD_DEBUG family and LD_DEMANGLE.
1607 	 */
1608 	else if (*s1 == 'D') {
1609 		if ((len == MSG_LD_DEBUG_SIZE) && (strncmp(s1,
1610 		    MSG_ORIG(MSG_LD_DEBUG), MSG_LD_DEBUG_SIZE) == 0)) {
1611 			select |= SEL_ACT_STR;
1612 			if (select & SEL_REPLACE)
1613 				str = &rpl_debug;
1614 			else {
1615 				str = &prm_debug;
1616 				rpl_debug = 0;
1617 			}
1618 			variable = ENV_FLG_DEBUG;
1619 		} else if ((len == MSG_LD_DEBUG_OUTPUT_SIZE) && (strncmp(s1,
1620 		    MSG_ORIG(MSG_LD_DEBUG_OUTPUT),
1621 		    MSG_LD_DEBUG_OUTPUT_SIZE) == 0)) {
1622 			select |= SEL_ACT_STR;
1623 			str = &dbg_file;
1624 			variable = ENV_FLG_DEBUG_OUTPUT;
1625 		} else if ((len == MSG_LD_DEMANGLE_SIZE) && (strncmp(s1,
1626 		    MSG_ORIG(MSG_LD_DEMANGLE), MSG_LD_DEMANGLE_SIZE) == 0)) {
1627 			select |= SEL_ACT_RT;
1628 			val = RT_FL_DEMANGLE;
1629 			variable = ENV_FLG_DEMANGLE;
1630 		}
1631 	}
1632 	/*
1633 	 * LD_FLAGS - collect the best variable definition.  On completion of
1634 	 * environment variable processing pass the result to ld_flags_env()
1635 	 * where they'll be decomposed and passed back to this routine.
1636 	 */
1637 	else if (*s1 == 'F') {
1638 		if ((len == MSG_LD_FLAGS_SIZE) && (strncmp(s1,
1639 		    MSG_ORIG(MSG_LD_FLAGS), MSG_LD_FLAGS_SIZE) == 0)) {
1640 			select |= SEL_ACT_SPEC_1;
1641 			if (select & SEL_REPLACE)
1642 				str = &rpl_ldflags;
1643 			else {
1644 				str = &prm_ldflags;
1645 				rpl_ldflags = 0;
1646 			}
1647 			variable = ENV_FLG_FLAGS;
1648 		}
1649 	}
1650 	/*
1651 	 * LD_INIT (internal, used by ldd(1)).
1652 	 */
1653 	else if (*s1 == 'I') {
1654 		if ((len == MSG_LD_INIT_SIZE) && (strncmp(s1,
1655 		    MSG_ORIG(MSG_LD_INIT), MSG_LD_INIT_SIZE) == 0)) {
1656 			select |= SEL_ACT_LML;
1657 			val = LML_FLG_TRC_INIT;
1658 			variable = ENV_FLG_INIT;
1659 		}
1660 	}
1661 	/*
1662 	 * The LD_LIBRARY_PATH and LD_LOAD families.
1663 	 */
1664 	else if (*s1 == 'L') {
1665 		if ((len == MSG_LD_LIBPATH_SIZE) && (strncmp(s1,
1666 		    MSG_ORIG(MSG_LD_LIBPATH), MSG_LD_LIBPATH_SIZE) == 0)) {
1667 			select |= SEL_ACT_SPEC_1;
1668 			if (select & SEL_REPLACE)
1669 				str = &rpl_libpath;
1670 			else {
1671 				str = &prm_libpath;
1672 				rpl_libpath = 0;
1673 			}
1674 			variable = ENV_FLG_LIBPATH;
1675 		} else if ((len == MSG_LD_LOADAVAIL_SIZE) && (strncmp(s1,
1676 		    MSG_ORIG(MSG_LD_LOADAVAIL), MSG_LD_LOADAVAIL_SIZE) == 0)) {
1677 			/*
1678 			 * Internal use by crle(1), not documented for general
1679 			 * use.
1680 			 */
1681 			select |= SEL_ACT_LML;
1682 			val = LML_FLG_LOADAVAIL;
1683 			variable = ENV_FLG_LOADAVAIL;
1684 		} else if ((len == MSG_LD_LOADFLTR_SIZE) && (strncmp(s1,
1685 		    MSG_ORIG(MSG_LD_LOADFLTR), MSG_LD_LOADFLTR_SIZE) == 0)) {
1686 			select |= SEL_ACT_SPEC_2;
1687 			variable = ENV_FLG_LOADFLTR;
1688 		}
1689 	}
1690 	/*
1691 	 * The LD_NO family.
1692 	 */
1693 	else if (*s1 == 'N') {
1694 		if ((len == MSG_LD_NOAUDIT_SIZE) && (strncmp(s1,
1695 		    MSG_ORIG(MSG_LD_NOAUDIT), MSG_LD_NOAUDIT_SIZE) == 0)) {
1696 			select |= SEL_ACT_RT;
1697 			val = RT_FL_NOAUDIT;
1698 			variable = ENV_FLG_NOAUDIT;
1699 		} else if ((len == MSG_LD_NOAUXFLTR_SIZE) && (strncmp(s1,
1700 		    MSG_ORIG(MSG_LD_NOAUXFLTR), MSG_LD_NOAUXFLTR_SIZE) == 0)) {
1701 			select |= SEL_ACT_RT;
1702 			val = RT_FL_NOAUXFLTR;
1703 			variable = ENV_FLG_NOAUXFLTR;
1704 		} else if ((len == MSG_LD_NOBAPLT_SIZE) && (strncmp(s1,
1705 		    MSG_ORIG(MSG_LD_NOBAPLT), MSG_LD_NOBAPLT_SIZE) == 0)) {
1706 			select |= SEL_ACT_RT;
1707 			val = RT_FL_NOBAPLT;
1708 			variable = ENV_FLG_NOBAPLT;
1709 		} else if ((len == MSG_LD_NOCONFIG_SIZE) && (strncmp(s1,
1710 		    MSG_ORIG(MSG_LD_NOCONFIG), MSG_LD_NOCONFIG_SIZE) == 0)) {
1711 			select |= SEL_ACT_RT;
1712 			val = RT_FL_NOCFG;
1713 			variable = ENV_FLG_NOCONFIG;
1714 		} else if ((len == MSG_LD_NODIRCONFIG_SIZE) && (strncmp(s1,
1715 		    MSG_ORIG(MSG_LD_NODIRCONFIG),
1716 		    MSG_LD_NODIRCONFIG_SIZE) == 0)) {
1717 			select |= SEL_ACT_RT;
1718 			val = RT_FL_NODIRCFG;
1719 			variable = ENV_FLG_NODIRCONFIG;
1720 		} else if ((len == MSG_LD_NODIRECT_SIZE) && (strncmp(s1,
1721 		    MSG_ORIG(MSG_LD_NODIRECT), MSG_LD_NODIRECT_SIZE) == 0)) {
1722 			select |= SEL_ACT_LMLT;
1723 			val = LML_TFLG_NODIRECT;
1724 			variable = ENV_FLG_NODIRECT;
1725 		} else if ((len == MSG_LD_NOENVCONFIG_SIZE) && (strncmp(s1,
1726 		    MSG_ORIG(MSG_LD_NOENVCONFIG),
1727 		    MSG_LD_NOENVCONFIG_SIZE) == 0)) {
1728 			select |= SEL_ACT_RT;
1729 			val = RT_FL_NOENVCFG;
1730 			variable = ENV_FLG_NOENVCONFIG;
1731 		} else if ((len == MSG_LD_NOFLTCONFIG_SIZE) && (strncmp(s1,
1732 		    MSG_ORIG(MSG_LD_NOFLTCONFIG),
1733 		    MSG_LD_NOFLTCONFIG_SIZE) == 0)) {
1734 			select |= SEL_ACT_RT2;
1735 			val = RT_FL2_NOFLTCFG;
1736 			variable = ENV_FLG_NOFLTCONFIG;
1737 		} else if ((len == MSG_LD_NOLAZY_SIZE) && (strncmp(s1,
1738 		    MSG_ORIG(MSG_LD_NOLAZY), MSG_LD_NOLAZY_SIZE) == 0)) {
1739 			select |= SEL_ACT_LMLT;
1740 			val = LML_TFLG_NOLAZYLD;
1741 			variable = ENV_FLG_NOLAZY;
1742 		} else if ((len == MSG_LD_NOOBJALTER_SIZE) && (strncmp(s1,
1743 		    MSG_ORIG(MSG_LD_NOOBJALTER),
1744 		    MSG_LD_NOOBJALTER_SIZE) == 0)) {
1745 			select |= SEL_ACT_RT;
1746 			val = RT_FL_NOOBJALT;
1747 			variable = ENV_FLG_NOOBJALTER;
1748 		} else if ((len == MSG_LD_NOVERSION_SIZE) && (strncmp(s1,
1749 		    MSG_ORIG(MSG_LD_NOVERSION), MSG_LD_NOVERSION_SIZE) == 0)) {
1750 			select |= SEL_ACT_RT;
1751 			val = RT_FL_NOVERSION;
1752 			variable = ENV_FLG_NOVERSION;
1753 		}
1754 	}
1755 	/*
1756 	 * LD_ORIGIN.
1757 	 */
1758 	else if (*s1 == 'O') {
1759 #ifndef	EXPAND_RELATIVE
1760 		if ((len == MSG_LD_ORIGIN_SIZE) && (strncmp(s1,
1761 		    MSG_ORIG(MSG_LD_ORIGIN), MSG_LD_ORIGIN_SIZE) == 0)) {
1762 			/*
1763 			 * Besides some old patches this is no longer required.
1764 			 */
1765 			rtld_flags |= RT_FL_RELATIVE;
1766 		}
1767 #endif
1768 		return;
1769 	}
1770 	/*
1771 	 * LD_PRELOAD and LD_PROFILE family.
1772 	 */
1773 	else if (*s1 == 'P') {
1774 		if ((len == MSG_LD_PRELOAD_SIZE) && (strncmp(s1,
1775 		    MSG_ORIG(MSG_LD_PRELOAD), MSG_LD_PRELOAD_SIZE) == 0)) {
1776 			select |= SEL_ACT_STR;
1777 			if (select & SEL_REPLACE)
1778 				str = &rpl_preload;
1779 			else  {
1780 				str = &prm_preload;
1781 				rpl_preload = 0;
1782 			}
1783 			variable = ENV_FLG_PRELOAD;
1784 		} else if ((len == MSG_LD_PROFILE_SIZE) && (strncmp(s1,
1785 		    MSG_ORIG(MSG_LD_PROFILE), MSG_LD_PROFILE_SIZE) == 0)) {
1786 			/*
1787 			 * Only one user library can be profiled at a time.
1788 			 */
1789 			select |= SEL_ACT_SPEC_2;
1790 			variable = ENV_FLG_PROFILE;
1791 		} else if ((len == MSG_LD_PROFILE_OUTPUT_SIZE) && (strncmp(s1,
1792 		    MSG_ORIG(MSG_LD_PROFILE_OUTPUT),
1793 		    MSG_LD_PROFILE_OUTPUT_SIZE) == 0)) {
1794 			/*
1795 			 * Only one user library can be profiled at a time.
1796 			 */
1797 			select |= SEL_ACT_STR;
1798 			str = &profile_out;
1799 			variable = ENV_FLG_PROFILE_OUTPUT;
1800 		}
1801 	}
1802 	/*
1803 	 * LD_SIGNAL.
1804 	 */
1805 	else if (*s1 == 'S') {
1806 		if (rtld_flags & RT_FL_SECURE)
1807 			return;
1808 		if ((len == MSG_LD_SIGNAL_SIZE) &&
1809 		    (strncmp(s1, MSG_ORIG(MSG_LD_SIGNAL),
1810 		    MSG_LD_SIGNAL_SIZE) == 0)) {
1811 			select |= SEL_ACT_SPEC_2;
1812 			variable = ENV_FLG_SIGNAL;
1813 		}
1814 	}
1815 	/*
1816 	 * The LD_TRACE family (internal, used by ldd(1)).  This definition is
1817 	 * the key to enabling all other ldd(1) specific environment variables.
1818 	 * In case an auditor is called, which in turn might exec(2) a
1819 	 * subprocess, this variable is disabled, so that any subprocess
1820 	 * escapes ldd(1) processing.
1821 	 */
1822 	else if (*s1 == 'T') {
1823 		if (((len == MSG_LD_TRACE_OBJS_SIZE) &&
1824 		    (strncmp(s1, MSG_ORIG(MSG_LD_TRACE_OBJS),
1825 		    MSG_LD_TRACE_OBJS_SIZE) == 0)) ||
1826 		    ((len == MSG_LD_TRACE_OBJS_E_SIZE) &&
1827 		    (((strncmp(s1, MSG_ORIG(MSG_LD_TRACE_OBJS_E),
1828 		    MSG_LD_TRACE_OBJS_E_SIZE) == 0) && !aout) ||
1829 		    ((strncmp(s1, MSG_ORIG(MSG_LD_TRACE_OBJS_A),
1830 		    MSG_LD_TRACE_OBJS_A_SIZE) == 0) && aout)))) {
1831 			char	*s0 = (char *)s1;
1832 
1833 			select |= SEL_ACT_SPEC_2;
1834 			variable = ENV_FLG_TRACE_OBJS;
1835 
1836 #if	defined(sparc) || defined(i386) || defined(__amd64)
1837 			/*
1838 			 * The simplest way to "disable" this variable is to
1839 			 * truncate this string to "LD_'\0'". This string is
1840 			 * ignored by any ld.so.1 environment processing.
1841 			 * Use of such interfaces as unsetenv(3c) are overkill,
1842 			 * and would drag too much libc implementation detail
1843 			 * into ld.so.1.
1844 			 */
1845 			 *s0 = '\0';
1846 #else
1847 /*
1848  * Verify that the above write is appropriate for any new platforms.
1849  */
1850 #error	unsupported architecture!
1851 #endif
1852 		} else if ((len == MSG_LD_TRACE_PTHS_SIZE) && (strncmp(s1,
1853 		    MSG_ORIG(MSG_LD_TRACE_PTHS),
1854 		    MSG_LD_TRACE_PTHS_SIZE) == 0)) {
1855 			select |= SEL_ACT_LML;
1856 			val = LML_FLG_TRC_SEARCH;
1857 			variable = ENV_FLG_TRACE_PTHS;
1858 		}
1859 	}
1860 	/*
1861 	 * LD_UNREF and LD_UNUSED (internal, used by ldd(1)).
1862 	 */
1863 	else if (*s1 == 'U') {
1864 		if ((len == MSG_LD_UNREF_SIZE) && (strncmp(s1,
1865 		    MSG_ORIG(MSG_LD_UNREF), MSG_LD_UNREF_SIZE) == 0)) {
1866 			select |= SEL_ACT_LML;
1867 			val = LML_FLG_TRC_UNREF;
1868 			variable = ENV_FLG_UNREF;
1869 		} else if ((len == MSG_LD_UNUSED_SIZE) && (strncmp(s1,
1870 		    MSG_ORIG(MSG_LD_UNUSED), MSG_LD_UNUSED_SIZE) == 0)) {
1871 			select |= SEL_ACT_LML;
1872 			val = LML_FLG_TRC_UNUSED;
1873 			variable = ENV_FLG_UNUSED;
1874 		}
1875 	}
1876 	/*
1877 	 * LD_VERBOSE (internal, used by ldd(1)).
1878 	 */
1879 	else if (*s1 == 'V') {
1880 		if ((len == MSG_LD_VERBOSE_SIZE) && (strncmp(s1,
1881 		    MSG_ORIG(MSG_LD_VERBOSE), MSG_LD_VERBOSE_SIZE) == 0)) {
1882 			select |= SEL_ACT_LML;
1883 			val = LML_FLG_TRC_VERBOSE;
1884 			variable = ENV_FLG_VERBOSE;
1885 		}
1886 	}
1887 	/*
1888 	 * LD_WARN (internal, used by ldd(1)).
1889 	 */
1890 	else if (*s1 == 'W') {
1891 		if ((len == MSG_LD_WARN_SIZE) && (strncmp(s1,
1892 		    MSG_ORIG(MSG_LD_WARN), MSG_LD_WARN_SIZE) == 0)) {
1893 			select |= SEL_ACT_LML;
1894 			val = LML_FLG_TRC_WARN;
1895 			variable = ENV_FLG_WARN;
1896 		}
1897 #ifdef	SIEBEL_DISABLE
1898 	}
1899 	/*
1900 	 * LD__FIX__ (undocumented, enable future technology that can't be
1901 	 * delivered in a patch release).
1902 	 */
1903 	else if (*s1 == '_') {
1904 		if ((len == MSG_LD_FIX_1_SIZE) && (strncmp(s1,
1905 		    MSG_ORIG(MSG_LD_FIX_1), MSG_LD_FIX_1_SIZE) == 0)) {
1906 			select |= SEL_ACT_RT;
1907 			val = RT_FL_DISFIX_1;
1908 			variable = ENV_FLG_FIX_1;
1909 		}
1910 #endif
1911 	}
1912 	if (variable == 0)
1913 		return;
1914 
1915 	/*
1916 	 * If the variable is already processed with ISA specific variable,
1917 	 * no further processing needed.
1918 	 */
1919 	if (((select & SEL_REPLACE) && (rplisa & variable)) ||
1920 	    ((select & SEL_PERMANT) && (prmisa & variable)))
1921 		return;
1922 
1923 	/*
1924 	 * Now mark the appropriate variables.
1925 	 * If the replaceable variable is already set, then the
1926 	 * process environment variable must be set. Any replaceable
1927 	 * variable specified in a configuration file can be ignored.
1928 	 */
1929 	if (env_flags & ENV_TYP_ISA) {
1930 		/*
1931 		 * This is ISA setting. We do the setting
1932 		 * even if s2 is NULL.
1933 		 * If s2 is NULL, we might need to undo
1934 		 * the setting.
1935 		 */
1936 		if (select & SEL_REPLACE) {
1937 			if (rplisa & variable)
1938 				return;
1939 			rplisa |= variable;
1940 		} else {
1941 			prmisa |= variable;
1942 		}
1943 	} else if (s2) {
1944 		/*
1945 		 * This is non0-ISA setting
1946 		 */
1947 		if (select & SEL_REPLACE) {
1948 			if (rplgen & variable)
1949 				return;
1950 			rplgen |= variable;
1951 		} else
1952 			prmgen |= variable;
1953 	} else
1954 		/*
1955 		 * This is non-ISA setting which
1956 		 * can be ignored.
1957 		 */
1958 		return;
1959 
1960 	/*
1961 	 * Now perform the setting.
1962 	 */
1963 	if (select & SEL_ACT_RT) {
1964 		if (s2)
1965 			rtld_flags |= val;
1966 		else
1967 			rtld_flags &= ~val;
1968 	} else if (select & SEL_ACT_RT2) {
1969 		if (s2)
1970 			rtld_flags2 |= val;
1971 		else
1972 			rtld_flags2 &= ~val;
1973 	} else if (select & SEL_ACT_STR)
1974 		*str = s2;
1975 	else if (select & SEL_ACT_LML) {
1976 		if (s2)
1977 			*lmflags |= val;
1978 		else
1979 			*lmflags &= ~val;
1980 	} else if (select & SEL_ACT_LMLT) {
1981 		if (s2)
1982 			*lmtflags |= val;
1983 		else
1984 			*lmtflags &= ~val;
1985 	} else if (select & SEL_ACT_SPEC_1) {
1986 		/*
1987 		 * variable is either ENV_FLG_FLAGS or ENV_FLG_LIBPATH
1988 		 */
1989 		*str = s2;
1990 		if ((select & SEL_REPLACE) && (env_flags & ENV_TYP_CONFIG)) {
1991 			if (s2) {
1992 				if (variable == ENV_FLG_FLAGS)
1993 					env_info |= ENV_INF_FLAGCFG;
1994 				else
1995 					env_info |= ENV_INF_PATHCFG;
1996 			} else {
1997 				if (variable == ENV_FLG_FLAGS)
1998 					env_info &= ~ENV_INF_FLAGCFG;
1999 				else
2000 					env_info &= ~ENV_INF_PATHCFG;
2001 			}
2002 		}
2003 	} else if (select & SEL_ACT_SPEC_2) {
2004 		/*
2005 		 * variables can be: ENV_FLG_
2006 		 * 	AUDIT_ARGS, BINDING, CONCURRENCY, CONFGEN,
2007 		 *	LOADFLTR, PROFILE, SIGNAL, TRACE_OBJS
2008 		 */
2009 		if (variable == ENV_FLG_AUDIT_ARGS) {
2010 			if (s2) {
2011 				audit_argcnt = atoi(s2);
2012 				audit_argcnt += audit_argcnt % 2;
2013 			} else
2014 				audit_argcnt = 0;
2015 		} else if (variable == ENV_FLG_BINDINGS) {
2016 			if (s2)
2017 				rpl_debug = MSG_ORIG(MSG_TKN_BINDINGS);
2018 			else
2019 				rpl_debug = 0;
2020 		} else if (variable == ENV_FLG_CONCURRENCY) {
2021 			if (s2)
2022 				rtld_flags &= ~RT_FL_NOCONCUR;
2023 			else
2024 				rtld_flags |= RT_FL_NOCONCUR;
2025 		} else if (variable == ENV_FLG_CONFGEN) {
2026 			if (s2) {
2027 				rtld_flags |= RT_FL_CONFGEN;
2028 				*lmflags |= LML_FLG_IGNRELERR;
2029 			} else {
2030 				rtld_flags &= ~RT_FL_CONFGEN;
2031 				*lmflags &= ~LML_FLG_IGNRELERR;
2032 			}
2033 		} else if (variable == ENV_FLG_LOADFLTR) {
2034 			if (s2) {
2035 				*lmtflags |= LML_TFLG_LOADFLTR;
2036 				if (*s2 == '2')
2037 					rtld_flags |= RT_FL_WARNFLTR;
2038 			} else {
2039 				*lmtflags &= ~LML_TFLG_LOADFLTR;
2040 				rtld_flags &= ~RT_FL_WARNFLTR;
2041 			}
2042 		} else if (variable == ENV_FLG_PROFILE) {
2043 			profile_name = s2;
2044 			if (s2) {
2045 				if (strcmp(s2, MSG_ORIG(MSG_FIL_RTLD)) == 0) {
2046 					return;
2047 				}
2048 				if (rtld_flags & RT_FL_SECURE) {
2049 					profile_lib =
2050 #if	defined(_ELF64)
2051 					    MSG_ORIG(MSG_PTH_LDPROFSE_64);
2052 #else
2053 					    MSG_ORIG(MSG_PTH_LDPROFSE);
2054 #endif
2055 				} else {
2056 					profile_lib =
2057 #if	defined(_ELF64)
2058 					    MSG_ORIG(MSG_PTH_LDPROF_64);
2059 #else
2060 					    MSG_ORIG(MSG_PTH_LDPROF);
2061 #endif
2062 				}
2063 			} else
2064 				profile_lib = 0;
2065 		} else if (variable == ENV_FLG_SIGNAL) {
2066 			killsig = s2 ? atoi(s2) : SIGKILL;
2067 		} else if (variable == ENV_FLG_TRACE_OBJS) {
2068 			if (s2) {
2069 				*lmflags |= LML_FLG_TRC_ENABLE;
2070 				if (*s2 == '2')
2071 					*lmflags |= LML_FLG_TRC_LDDSTUB;
2072 			} else
2073 				*lmflags &=
2074 				~(LML_FLG_TRC_ENABLE|LML_FLG_TRC_LDDSTUB);
2075 		}
2076 	}
2077 }
2078 
2079 /*
2080  * Determine whether we have an architecture specific environment variable.
2081  * If we do, and we're the wrong architecture, it'll just get ignored.
2082  * Otherwise the variable is processed in it's architecture neutral form.
2083  */
2084 static int
2085 ld_arch_env(const char *s1, size_t *len)
2086 {
2087 	size_t	_len = *len - 3;
2088 
2089 	if (s1[_len++] == '_') {
2090 		if ((s1[_len] == '3') && (s1[_len + 1] == '2')) {
2091 #if	defined(_ELF64)
2092 			return (ENV_TYP_IGNORE);
2093 #else
2094 			*len = *len - 3;
2095 			return (ENV_TYP_ISA);
2096 #endif
2097 		}
2098 		if ((s1[_len] == '6') && (s1[_len + 1] == '4')) {
2099 #if	defined(_ELF64)
2100 			*len = *len - 3;
2101 			return (ENV_TYP_ISA);
2102 #else
2103 			return (ENV_TYP_IGNORE);
2104 #endif
2105 		}
2106 	}
2107 	return (0);
2108 }
2109 
2110 
2111 /*
2112  * Process an LD_FLAGS environment variable.  The value can be a comma
2113  * separated set of tokens, which are sent (in upper case) into the generic
2114  * LD_XXXX environment variable engine.  For example:
2115  *
2116  *	LD_FLAGS=bind_now		->	LD_BIND_NOW=1
2117  *	LD_FLAGS=library_path=/foo:.	->	LD_LIBRARY_PATH=/foo:.
2118  *	LD_FLAGS=debug=files:detail	->	LD_DEBUG=files:detail
2119  * or
2120  *	LD_FLAGS=bind_now,library_path=/foo:.,debug=files:detail
2121  */
2122 static int
2123 ld_flags_env(const char *str, Word *lmflags, Word *lmtflags,
2124     uint_t env_flags, int aout)
2125 {
2126 	char	*nstr, *sstr, *estr = 0;
2127 	size_t	nlen, len;
2128 
2129 	if (str == 0)
2130 		return (0);
2131 
2132 	/*
2133 	 * Create a new string as we're going to transform the token(s) into
2134 	 * uppercase and separate tokens with nulls.
2135 	 */
2136 	len = strlen(str);
2137 	if ((nstr = malloc(len + 1)) == 0)
2138 		return (1);
2139 	(void) strcpy(nstr, str);
2140 
2141 	for (sstr = nstr; sstr; sstr++, len--) {
2142 		int	flags;
2143 
2144 		if ((*sstr != '\0') && (*sstr != ',')) {
2145 			if (estr == 0) {
2146 				if (*sstr == '=')
2147 					estr = sstr;
2148 				else {
2149 					/*
2150 					 * Translate token to uppercase.  Don't
2151 					 * use toupper(3C) as including this
2152 					 * code doubles the size of ld.so.1.
2153 					 */
2154 					if ((*sstr >= 'a') && (*sstr <= 'z'))
2155 						*sstr = *sstr - ('a' - 'A');
2156 				}
2157 			}
2158 			continue;
2159 		}
2160 
2161 		*sstr = '\0';
2162 		if (estr) {
2163 			nlen = estr - nstr;
2164 			if ((*++estr == '\0') || (*estr == ','))
2165 				estr = 0;
2166 		} else
2167 			nlen = sstr - nstr;
2168 
2169 		/*
2170 		 * Fabricate a boolean definition for any unqualified variable.
2171 		 * Thus LD_FLAGS=bind_now is represented as BIND_NOW=(null).
2172 		 * The value is sufficient to assert any boolean variables, plus
2173 		 * the term "(null)" is specifically chosen in case someone
2174 		 * mistakenly supplies something like LD_FLAGS=library_path.
2175 		 */
2176 		if (estr == 0)
2177 			estr = (char *)MSG_INTL(MSG_STR_NULL);
2178 
2179 		/*
2180 		 * Determine whether the environment variable is 32- or 64-bit
2181 		 * specific.  The length, len, will reflect the architecture
2182 		 * neutral portion of the string.
2183 		 */
2184 		if ((flags = ld_arch_env(nstr, &nlen)) != ENV_TYP_IGNORE) {
2185 			ld_generic_env(nstr, nlen, estr, lmflags,
2186 			    lmtflags, (env_flags | flags), aout);
2187 		}
2188 		if (len == 0)
2189 			return (0);
2190 
2191 		nstr = sstr + 1;
2192 		estr = 0;
2193 	}
2194 	return (0);
2195 }
2196 
2197 
2198 /*
2199  * Process a single environment string.  Only strings starting with `LD_' are
2200  * reserved for our use.  By convention, all strings should be of the form
2201  * `LD_XXXX=', if the string is followed by a non-null value the appropriate
2202  * functionality is enabled.  Also pick off applicable locale variables.
2203  */
2204 #define	LOC_LANG	1
2205 #define	LOC_MESG	2
2206 #define	LOC_ALL		3
2207 
2208 static void
2209 ld_str_env(const char *s1, Word *lmflags, Word *lmtflags, uint_t env_flags,
2210     int aout)
2211 {
2212 	const char	*s2;
2213 	static		size_t	loc = 0;
2214 
2215 	if (*s1++ != 'L')
2216 		return;
2217 
2218 	/*
2219 	 * See if we have any locale environment settings.  These environment
2220 	 * variables have a precedence, LC_ALL is higher than LC_MESSAGES which
2221 	 * is higher than LANG.
2222 	 */
2223 	s2 = s1;
2224 	if ((*s2++ == 'C') && (*s2++ == '_') && (*s2 != '\0')) {
2225 		if (strncmp(s2, MSG_ORIG(MSG_LC_ALL), MSG_LC_ALL_SIZE) == 0) {
2226 			s2 += MSG_LC_ALL_SIZE;
2227 			if ((*s2 != '\0') && (loc < LOC_ALL)) {
2228 				glcs[CI_LCMESSAGES].lc_un.lc_ptr = (char *)s2;
2229 				loc = LOC_ALL;
2230 			}
2231 		} else if (strncmp(s2, MSG_ORIG(MSG_LC_MESSAGES),
2232 		    MSG_LC_MESSAGES_SIZE) == 0) {
2233 			s2 += MSG_LC_MESSAGES_SIZE;
2234 			if ((*s2 != '\0') && (loc < LOC_MESG)) {
2235 				glcs[CI_LCMESSAGES].lc_un.lc_ptr = (char *)s2;
2236 				loc = LOC_MESG;
2237 			}
2238 		}
2239 		return;
2240 	}
2241 
2242 	s2 = s1;
2243 	if ((*s2++ == 'A') && (*s2++ == 'N') && (*s2++ == 'G') &&
2244 	    (*s2++ == '=') && (*s2 != '\0') && (loc < LOC_LANG)) {
2245 		glcs[CI_LCMESSAGES].lc_un.lc_ptr = (char *)s2;
2246 		loc = LOC_LANG;
2247 		return;
2248 	}
2249 
2250 	/*
2251 	 * Pick off any LD_XXXX environment variables.
2252 	 */
2253 	if ((*s1++ == 'D') && (*s1++ == '_') && (*s1 != '\0')) {
2254 		size_t	len;
2255 		int	flags;
2256 
2257 		/*
2258 		 * In a branded process we must ignore all LD_XXXX env vars
2259 		 * because they are intended for the brand's linker.
2260 		 * To affect the Solaris linker, use LD_BRAND_XXXX instead.
2261 		 */
2262 		if (rtld_flags2 & RT_FL2_BRANDED) {
2263 			if (strncmp(s1, MSG_ORIG(MSG_LD_BRAND_PREFIX),
2264 			    MSG_LD_BRAND_PREFIX_SIZE) != 0)
2265 				return;
2266 			s1 += MSG_LD_BRAND_PREFIX_SIZE;
2267 		}
2268 
2269 		/*
2270 		 * Environment variables with no value (ie. LD_XXXX=) typically
2271 		 * have no impact, however if environment variables are defined
2272 		 * within a configuration file, these null user settings can be
2273 		 * used to disable any configuration replaceable definitions.
2274 		 */
2275 		if ((s2 = strchr(s1, '=')) == 0) {
2276 			len = strlen(s1);
2277 			s2 = 0;
2278 		} else if (*++s2 == '\0') {
2279 			len = strlen(s1) - 1;
2280 			s2 = 0;
2281 		} else {
2282 			len = s2 - s1 - 1;
2283 			while (isspace(*s2))
2284 				s2++;
2285 		}
2286 
2287 		/*
2288 		 * Determine whether the environment variable is 32- or 64-bit
2289 		 * specific.  The length, len, will reflect the architecture
2290 		 * neutral portion of the string.
2291 		 */
2292 		if ((flags = ld_arch_env(s1, &len)) == ENV_TYP_IGNORE)
2293 			return;
2294 		env_flags |= flags;
2295 
2296 		ld_generic_env(s1, len, s2, lmflags, lmtflags, env_flags, aout);
2297 	}
2298 }
2299 
2300 /*
2301  * Internal getenv routine.  Called immediately after ld.so.1 initializes
2302  * itself.
2303  */
2304 int
2305 readenv_user(const char ** envp, Word *lmflags, Word *lmtflags, int aout)
2306 {
2307 	char	*locale;
2308 
2309 	if (envp == (const char **)0)
2310 		return (0);
2311 
2312 	while (*envp != (const char *)0)
2313 		ld_str_env(*envp++, lmflags, lmtflags, 0, aout);
2314 
2315 	/*
2316 	 * Having collected the best representation of any LD_FLAGS, process
2317 	 * these strings.
2318 	 */
2319 	if (ld_flags_env(rpl_ldflags, lmflags, lmtflags, 0, aout) == 1)
2320 		return (1);
2321 
2322 	/*
2323 	 * Don't allow environment controlled auditing when tracing or if
2324 	 * explicitly disabled.  Trigger all tracing modes from
2325 	 * LML_FLG_TRC_ENABLE.
2326 	 */
2327 	if ((*lmflags & LML_FLG_TRC_ENABLE) || (rtld_flags & RT_FL_NOAUDIT))
2328 		rpl_audit = profile_lib = profile_name = 0;
2329 	if ((*lmflags & LML_FLG_TRC_ENABLE) == 0)
2330 		*lmflags &= ~LML_MSK_TRC;
2331 
2332 	/*
2333 	 * If both LD_BIND_NOW and LD_BIND_LAZY are specified, the former wins.
2334 	 */
2335 	if ((rtld_flags2 & (RT_FL2_BINDNOW | RT_FL2_BINDLAZY)) ==
2336 	    (RT_FL2_BINDNOW | RT_FL2_BINDLAZY))
2337 		rtld_flags2 &= ~RT_FL2_BINDLAZY;
2338 
2339 	/*
2340 	 * If we have a locale setting make sure its worth processing further.
2341 	 * C and POSIX locales don't need any processing.  In addition, to
2342 	 * ensure no one escapes the /usr/lib/locale hierarchy, don't allow
2343 	 * the locale to contain a segment that leads upward in the file system
2344 	 * hierarchy (i.e. no '..' segments).   Given that we'll be confined to
2345 	 * the /usr/lib/locale hierarchy, there is no need to extensively
2346 	 * validate the mode or ownership of any message file (as libc's
2347 	 * generic handling of message files does).  Duplicate the string so
2348 	 * that new locale setting can generically cleanup any previous locales.
2349 	 */
2350 	if ((locale = glcs[CI_LCMESSAGES].lc_un.lc_ptr) != 0) {
2351 		if (((*locale == 'C') && (*(locale + 1) == '\0')) ||
2352 		    (strcmp(locale, MSG_ORIG(MSG_TKN_POSIX)) == 0) ||
2353 		    (strstr(locale, MSG_ORIG(MSG_TKN_DOTDOT)) != NULL))
2354 			glcs[CI_LCMESSAGES].lc_un.lc_ptr = 0;
2355 		else
2356 			glcs[CI_LCMESSAGES].lc_un.lc_ptr = strdup(locale);
2357 	}
2358 	return (0);
2359 }
2360 
2361 /*
2362  * Configuration environment processing.  Called after the a.out has been
2363  * processed (as the a.out can specify its own configuration file).
2364  */
2365 int
2366 readenv_config(Rtc_env * envtbl, Addr addr, int aout)
2367 {
2368 	Word *	lmflags = &(lml_main.lm_flags);
2369 	Word *	lmtflags = &(lml_main.lm_tflags);
2370 
2371 	if (envtbl == (Rtc_env *)0)
2372 		return (0);
2373 
2374 	while (envtbl->env_str) {
2375 		uint_t	env_flags = ENV_TYP_CONFIG;
2376 
2377 		if (envtbl->env_flags & RTC_ENV_PERMANT)
2378 			env_flags |= ENV_TYP_PERMANT;
2379 
2380 		ld_str_env((const char *)(envtbl->env_str + addr),
2381 		    lmflags, lmtflags, env_flags, 0);
2382 		envtbl++;
2383 	}
2384 
2385 	/*
2386 	 * Having collected the best representation of any LD_FLAGS, process
2387 	 * these strings.
2388 	 */
2389 	if (ld_flags_env(rpl_ldflags, lmflags, lmtflags, 0, aout) == 1)
2390 		return (1);
2391 	if (ld_flags_env(prm_ldflags, lmflags, lmtflags, ENV_TYP_CONFIG,
2392 	    aout) == 1)
2393 		return (1);
2394 
2395 	/*
2396 	 * Don't allow environment controlled auditing when tracing or if
2397 	 * explicitly disabled.  Trigger all tracing modes from
2398 	 * LML_FLG_TRC_ENABLE.
2399 	 */
2400 	if ((*lmflags & LML_FLG_TRC_ENABLE) || (rtld_flags & RT_FL_NOAUDIT))
2401 		prm_audit = profile_lib = profile_name = 0;
2402 	if ((*lmflags & LML_FLG_TRC_ENABLE) == 0)
2403 		*lmflags &= ~LML_MSK_TRC;
2404 
2405 	return (0);
2406 }
2407 
2408 int
2409 dowrite(Prfbuf * prf)
2410 {
2411 	/*
2412 	 * We do not have a valid file descriptor, so we are unable
2413 	 * to flush the buffer.
2414 	 */
2415 	if (prf->pr_fd == -1)
2416 		return (0);
2417 	(void) write(prf->pr_fd, prf->pr_buf, prf->pr_cur - prf->pr_buf);
2418 	prf->pr_cur = prf->pr_buf;
2419 	return (1);
2420 }
2421 
2422 /*
2423  * Simplified printing.  The following conversion specifications are supported:
2424  *
2425  *	% [#] [-] [min field width] [. precision] s|d|x|c
2426  *
2427  *
2428  * dorprf takes the output buffer in the form of Prfbuf which permits
2429  * the verification of the output buffer size and the concatenation
2430  * of data to an already existing output buffer.  The Prfbuf
2431  * structure contains the following:
2432  *
2433  *  pr_buf	pointer to the beginning of the output buffer.
2434  *  pr_cur	pointer to the next available byte in the output buffer.  By
2435  *		setting pr_cur ahead of pr_buf you can append to an already
2436  *		existing buffer.
2437  *  pr_len	the size of the output buffer.  By setting pr_len to '0' you
2438  *		disable protection from overflows in the output buffer.
2439  *  pr_fd	a pointer to the file-descriptor the buffer will eventually be
2440  *		output to.  If pr_fd is set to '-1' then it's assumed there is
2441  *		no output buffer, and doprf() will return with an error to
2442  *		indicate an output buffer overflow.  If pr_fd is > -1 then when
2443  *		the output buffer is filled it will be flushed to pr_fd and will
2444  *		then be	available for additional data.
2445  */
2446 #define	FLG_UT_MINUS	0x0001	/* - */
2447 #define	FLG_UT_SHARP	0x0002	/* # */
2448 #define	FLG_UT_DOTSEEN	0x0008	/* dot appeared in format spec */
2449 
2450 /*
2451  * This macro is for use from within doprf only.  It is to be used for checking
2452  * the output buffer size and placing characters into the buffer.
2453  */
2454 #define	PUTC(c) \
2455 	{ \
2456 		char tmpc; \
2457 		\
2458 		tmpc = (c); \
2459 		if (bufsiz && (bp >= bufend)) { \
2460 			prf->pr_cur = bp; \
2461 			if (dowrite(prf) == 0) \
2462 				return (0); \
2463 			bp = prf->pr_cur; \
2464 		} \
2465 		*bp++ = tmpc; \
2466 	}
2467 
2468 /*
2469  * Define a local buffer size for building a numeric value - large enough to
2470  * hold a 64-bit value.
2471  */
2472 #define	NUM_SIZE	22
2473 
2474 size_t
2475 doprf(const char *format, va_list args, Prfbuf *prf)
2476 {
2477 	char	c;
2478 	char	*bp = prf->pr_cur;
2479 	char	*bufend = prf->pr_buf + prf->pr_len;
2480 	size_t	bufsiz = prf->pr_len;
2481 
2482 	while ((c = *format++) != '\0') {
2483 		if (c != '%') {
2484 			PUTC(c);
2485 		} else {
2486 			int	base = 0, flag = 0, width = 0, prec = 0;
2487 			size_t	_i;
2488 			int	_c, _n;
2489 			char	*_s;
2490 			int	ls = 0;
2491 again:
2492 			c = *format++;
2493 			switch (c) {
2494 			case '-':
2495 				flag |= FLG_UT_MINUS;
2496 				goto again;
2497 			case '#':
2498 				flag |= FLG_UT_SHARP;
2499 				goto again;
2500 			case '.':
2501 				flag |= FLG_UT_DOTSEEN;
2502 				goto again;
2503 			case '0':
2504 			case '1':
2505 			case '2':
2506 			case '3':
2507 			case '4':
2508 			case '5':
2509 			case '6':
2510 			case '7':
2511 			case '8':
2512 			case '9':
2513 				if (flag & FLG_UT_DOTSEEN)
2514 					prec = (prec * 10) + c - '0';
2515 				else
2516 					width = (width * 10) + c - '0';
2517 				goto again;
2518 			case 'x':
2519 			case 'X':
2520 				base = 16;
2521 				break;
2522 			case 'd':
2523 			case 'D':
2524 			case 'u':
2525 				base = 10;
2526 				flag &= ~FLG_UT_SHARP;
2527 				break;
2528 			case 'l':
2529 				base = 10;
2530 				ls++; /* number of l's (long or long long) */
2531 				if ((*format == 'l') ||
2532 				    (*format == 'd') || (*format == 'D') ||
2533 				    (*format == 'x') || (*format == 'X') ||
2534 				    (*format == 'o') || (*format == 'O'))
2535 					goto again;
2536 				break;
2537 			case 'o':
2538 			case 'O':
2539 				base = 8;
2540 				break;
2541 			case 'c':
2542 				_c = va_arg(args, int);
2543 
2544 				for (_i = 24; _i > 0; _i -= 8) {
2545 					if ((c = ((_c >> _i) & 0x7f)) != 0) {
2546 						PUTC(c);
2547 					}
2548 				}
2549 				if ((c = ((_c >> _i) & 0x7f)) != 0) {
2550 					PUTC(c);
2551 				}
2552 				break;
2553 			case 's':
2554 				_s = va_arg(args, char *);
2555 				_i = strlen(_s);
2556 				/* LINTED */
2557 				_n = (int)(width - _i);
2558 				if (!prec)
2559 					/* LINTED */
2560 					prec = (int)_i;
2561 
2562 				if (width && !(flag & FLG_UT_MINUS)) {
2563 					while (_n-- > 0)
2564 						PUTC(' ');
2565 				}
2566 				while (((c = *_s++) != 0) && prec--) {
2567 					PUTC(c);
2568 				}
2569 				if (width && (flag & FLG_UT_MINUS)) {
2570 					while (_n-- > 0)
2571 						PUTC(' ');
2572 				}
2573 				break;
2574 			case '%':
2575 				PUTC('%');
2576 				break;
2577 			default:
2578 				break;
2579 			}
2580 
2581 			/*
2582 			 * Numeric processing
2583 			 */
2584 			if (base) {
2585 				char		local[NUM_SIZE];
2586 				size_t		ssize = 0, psize = 0;
2587 				const char	*string =
2588 						    MSG_ORIG(MSG_STR_HEXNUM);
2589 				const char	*prefix =
2590 						    MSG_ORIG(MSG_STR_EMPTY);
2591 				u_longlong_t	num;
2592 
2593 				switch (ls) {
2594 				case 0:	/* int */
2595 					num = (u_longlong_t)
2596 					    va_arg(args, uint_t);
2597 					break;
2598 				case 1:	/* long */
2599 					num = (u_longlong_t)
2600 					    va_arg(args, ulong_t);
2601 					break;
2602 				case 2:	/* long long */
2603 					num = va_arg(args, u_longlong_t);
2604 					break;
2605 				}
2606 
2607 				if (flag & FLG_UT_SHARP) {
2608 					if (base == 16) {
2609 						prefix = MSG_ORIG(MSG_STR_HEX);
2610 						psize = 2;
2611 					} else {
2612 						prefix = MSG_ORIG(MSG_STR_ZERO);
2613 						psize = 1;
2614 					}
2615 				}
2616 				if ((base == 10) && (long)num < 0) {
2617 					prefix = MSG_ORIG(MSG_STR_NEGATE);
2618 					psize = MSG_STR_NEGATE_SIZE;
2619 					num = (u_longlong_t)(-(longlong_t)num);
2620 				}
2621 
2622 				/*
2623 				 * Convert the numeric value into a local
2624 				 * string (stored in reverse order).
2625 				 */
2626 				_s = local;
2627 				do {
2628 					*_s++ = string[num % base];
2629 					num /= base;
2630 					ssize++;
2631 				} while (num);
2632 
2633 				ASSERT(ssize < sizeof (local));
2634 
2635 				/*
2636 				 * Provide any precision or width padding.
2637 				 */
2638 				if (prec) {
2639 					/* LINTED */
2640 					_n = (int)(prec - ssize);
2641 					while ((_n-- > 0) &&
2642 					    (ssize < sizeof (local))) {
2643 						*_s++ = '0';
2644 						ssize++;
2645 					}
2646 				}
2647 				if (width && !(flag & FLG_UT_MINUS)) {
2648 					/* LINTED */
2649 					_n = (int)(width - ssize - psize);
2650 					while (_n-- > 0) {
2651 						PUTC(' ');
2652 					}
2653 				}
2654 
2655 				/*
2656 				 * Print any prefix and the numeric string
2657 				 */
2658 				while (*prefix)
2659 					PUTC(*prefix++);
2660 				do {
2661 					PUTC(*--_s);
2662 				} while (_s > local);
2663 
2664 				/*
2665 				 * Provide any width padding.
2666 				 */
2667 				if (width && (flag & FLG_UT_MINUS)) {
2668 					/* LINTED */
2669 					_n = (int)(width - ssize - psize);
2670 					while (_n-- > 0)
2671 						PUTC(' ');
2672 				}
2673 			}
2674 		}
2675 	}
2676 
2677 	PUTC('\0');
2678 	prf->pr_cur = bp;
2679 	return (1);
2680 }
2681 
2682 static int
2683 doprintf(const char *format, va_list args, Prfbuf *prf)
2684 {
2685 	char	*ocur = prf->pr_cur;
2686 
2687 	if (doprf(format, args, prf) == 0)
2688 		return (0);
2689 	/* LINTED */
2690 	return ((int)(prf->pr_cur - ocur));
2691 }
2692 
2693 /* VARARGS2 */
2694 int
2695 sprintf(char *buf, const char *format, ...)
2696 {
2697 	va_list	args;
2698 	int	len;
2699 	Prfbuf	prf;
2700 
2701 	va_start(args, format);
2702 	prf.pr_buf = prf.pr_cur = buf;
2703 	prf.pr_len = 0;
2704 	prf.pr_fd = -1;
2705 	len = doprintf(format, args, &prf);
2706 	va_end(args);
2707 
2708 	/*
2709 	 * sprintf() return value excludes the terminating null byte.
2710 	 */
2711 	return (len - 1);
2712 }
2713 
2714 /* VARARGS3 */
2715 int
2716 snprintf(char *buf, size_t n, const char *format, ...)
2717 {
2718 	va_list	args;
2719 	int	len;
2720 	Prfbuf	prf;
2721 
2722 	va_start(args, format);
2723 	prf.pr_buf = prf.pr_cur = buf;
2724 	prf.pr_len = n;
2725 	prf.pr_fd = -1;
2726 	len = doprintf(format, args, &prf);
2727 	va_end(args);
2728 
2729 	return (len);
2730 }
2731 
2732 /* VARARGS2 */
2733 int
2734 bufprint(Prfbuf *prf, const char *format, ...)
2735 {
2736 	va_list	args;
2737 	int	len;
2738 
2739 	va_start(args, format);
2740 	len = doprintf(format, args, prf);
2741 	va_end(args);
2742 
2743 	return (len);
2744 }
2745 
2746 /*PRINTFLIKE1*/
2747 int
2748 printf(const char *format, ...)
2749 {
2750 	va_list	args;
2751 	char 	buffer[ERRSIZE];
2752 	Prfbuf	prf;
2753 
2754 	va_start(args, format);
2755 	prf.pr_buf = prf.pr_cur = buffer;
2756 	prf.pr_len = ERRSIZE;
2757 	prf.pr_fd = 1;
2758 	(void) doprf(format, args, &prf);
2759 	va_end(args);
2760 	/*
2761 	 * Trim trailing '\0' form buffer
2762 	 */
2763 	prf.pr_cur--;
2764 	return (dowrite(&prf));
2765 }
2766 
2767 static char	errbuf[ERRSIZE], *nextptr = errbuf, *prevptr = 0;
2768 
2769 /*PRINTFLIKE3*/
2770 void
2771 eprintf(Lm_list *lml, Error error, const char *format, ...)
2772 {
2773 	va_list		args;
2774 	int		overflow = 0;
2775 	static int	lock = 0;
2776 	Prfbuf		prf;
2777 
2778 	if (lock || (nextptr == (errbuf + ERRSIZE)))
2779 		return;
2780 
2781 	/*
2782 	 * Note: this lock is here to prevent the same thread from recursively
2783 	 * entering itself during a eprintf.  ie: during eprintf malloc() fails
2784 	 * and we try and call eprintf ... and then malloc() fails ....
2785 	 */
2786 	lock = 1;
2787 
2788 	/*
2789 	 * If we have completed startup initialization, all error messages
2790 	 * must be saved.  These are reported through dlerror().  If we're
2791 	 * still in the initialization stage, output the error directly and
2792 	 * add a newline.
2793 	 */
2794 	va_start(args, format);
2795 
2796 	prf.pr_buf = prf.pr_cur = nextptr;
2797 	prf.pr_len = ERRSIZE - (nextptr - errbuf);
2798 
2799 	if (!(rtld_flags & RT_FL_APPLIC))
2800 		prf.pr_fd = 2;
2801 	else
2802 		prf.pr_fd = -1;
2803 
2804 	if (error > ERR_NONE) {
2805 		if ((error == ERR_FATAL) && (rtld_flags2 & RT_FL2_FTL2WARN))
2806 			error = ERR_WARNING;
2807 		if (error == ERR_WARNING) {
2808 			if (err_strs[ERR_WARNING] == 0)
2809 			    err_strs[ERR_WARNING] = MSG_INTL(MSG_ERR_WARNING);
2810 		} else if (error == ERR_FATAL) {
2811 			if (err_strs[ERR_FATAL] == 0)
2812 			    err_strs[ERR_FATAL] = MSG_INTL(MSG_ERR_FATAL);
2813 		} else if (error == ERR_ELF) {
2814 			if (err_strs[ERR_ELF] == 0)
2815 			    err_strs[ERR_ELF] = MSG_INTL(MSG_ERR_ELF);
2816 		}
2817 		if (procname) {
2818 			if (bufprint(&prf, MSG_ORIG(MSG_STR_EMSGFOR1),
2819 			    rtldname, procname, err_strs[error]) == 0)
2820 				overflow = 1;
2821 		} else {
2822 			if (bufprint(&prf, MSG_ORIG(MSG_STR_EMSGFOR2),
2823 			    rtldname, err_strs[error]) == 0)
2824 				overflow = 1;
2825 		}
2826 		if (overflow == 0) {
2827 			/*
2828 			 * Remove the terminating '\0'.
2829 			 */
2830 			prf.pr_cur--;
2831 		}
2832 	}
2833 
2834 	if ((overflow == 0) && doprf(format, args, &prf) == 0)
2835 		overflow = 1;
2836 
2837 	/*
2838 	 * If this is an ELF error, it will have been generated by a support
2839 	 * object that has a dependency on libelf.  ld.so.1 doesn't generate any
2840 	 * ELF error messages as it doesn't interact with libelf.  Determine the
2841 	 * ELF error string.
2842 	 */
2843 	if ((overflow == 0) && (error == ERR_ELF)) {
2844 		static int		(*elfeno)() = 0;
2845 		static const char	*(*elfemg)();
2846 		const char		*emsg;
2847 		Rt_map			*dlmp, *lmp = lml_rtld.lm_head;
2848 
2849 		if (NEXT(lmp) && (elfeno == 0)) {
2850 			if (((elfemg = (const char *(*)())dlsym_intn(RTLD_NEXT,
2851 			    MSG_ORIG(MSG_SYM_ELFERRMSG), lmp, &dlmp)) == 0) ||
2852 			    ((elfeno = (int (*)())dlsym_intn(RTLD_NEXT,
2853 			    MSG_ORIG(MSG_SYM_ELFERRNO), lmp, &dlmp)) == 0))
2854 				elfeno = 0;
2855 		}
2856 
2857 		/*
2858 		 * Lookup the message; equivalent to elf_errmsg(elf_errno()).
2859 		 */
2860 		if (elfeno && ((emsg = (* elfemg)((* elfeno)())) != 0)) {
2861 			prf.pr_cur--;
2862 			if (bufprint(&prf, MSG_ORIG(MSG_STR_EMSGFOR2),
2863 			    emsg) == 0)
2864 				overflow = 1;
2865 		}
2866 	}
2867 
2868 	/*
2869 	 * Push out any message that's been built.  Note, in the case of an
2870 	 * overflow condition, this message may be incomplete, in which case
2871 	 * make sure any partial string is null terminated.
2872 	 */
2873 	if (overflow)
2874 		*(prf.pr_cur) = '\0';
2875 	if ((rtld_flags & (RT_FL_APPLIC | RT_FL_SILENCERR)) == 0) {
2876 		*(prf.pr_cur - 1) = '\n';
2877 		(void) dowrite(&prf);
2878 	}
2879 
2880 	DBG_CALL(Dbg_util_str(lml, nextptr));
2881 	va_end(args);
2882 
2883 	/*
2884 	 * Determine if there was insufficient space left in the buffer to
2885 	 * complete the message.  If so, we'll have printed out as much as had
2886 	 * been processed if we're not yet executing the application.
2887 	 * Otherwise, there will be some debugging diagnostic indicating
2888 	 * as much of the error message as possible.  Write out a final buffer
2889 	 * overflow diagnostic - unlocalized, so we don't chance more errors.
2890 	 */
2891 	if (overflow) {
2892 		char	*str = (char *)MSG_INTL(MSG_EMG_BUFOVRFLW);
2893 
2894 		if ((rtld_flags & RT_FL_SILENCERR) == 0) {
2895 			lasterr = str;
2896 
2897 			if ((rtld_flags & RT_FL_APPLIC) == 0) {
2898 				(void) write(2, str, strlen(str));
2899 				(void) write(2, MSG_ORIG(MSG_STR_NL),
2900 				    MSG_STR_NL_SIZE);
2901 			}
2902 		}
2903 		DBG_CALL(Dbg_util_str(lml, str));
2904 
2905 		lock = 0;
2906 		nextptr = errbuf + ERRSIZE;
2907 		return;
2908 	}
2909 
2910 	/*
2911 	 * If the application has started, then error messages are being saved
2912 	 * for retrieval by dlerror(), or possible flushing from rtldexit() in
2913 	 * the case of a fatal error.  In this case, establish the next error
2914 	 * pointer.  If we haven't started the application, the whole message
2915 	 * buffer can be reused.
2916 	 */
2917 	if ((rtld_flags & RT_FL_SILENCERR) == 0) {
2918 		lasterr = nextptr;
2919 
2920 		/*
2921 		 * Note, should we encounter an error such as ENOMEM, there may
2922 		 * be a number of the same error messages (ie. an operation
2923 		 * fails with ENOMEM, and then the attempts to construct the
2924 		 * error message itself, which incurs additional ENOMEM errors).
2925 		 * Compare any previous error message with the one we've just
2926 		 * created to prevent any duplication clutter.
2927 		 */
2928 		if ((rtld_flags & RT_FL_APPLIC) &&
2929 		    ((prevptr == 0) || (strcmp(prevptr, nextptr) != 0))) {
2930 			prevptr = nextptr;
2931 			nextptr = prf.pr_cur;
2932 			*nextptr = '\0';
2933 		}
2934 	}
2935 	lock = 0;
2936 }
2937 
2938 
2939 #if	DEBUG
2940 /*
2941  * Provide assfail() for ASSERT() statements,
2942  * see <sys/debug.h> for further details.
2943  */
2944 int
2945 assfail(const char *a, const char *f, int l)
2946 {
2947 	(void) printf("assertion failed: %s, file: %s, line: %d\n", a, f, l);
2948 	(void) _lwp_kill(_lwp_self(), SIGABRT);
2949 	return (0);
2950 }
2951 #endif
2952 
2953 /*
2954  * Exit.  If we arrive here with a non zero status it's because of a fatal
2955  * error condition (most commonly a relocation error).  If the application has
2956  * already had control, then the actual fatal error message will have been
2957  * recorded in the dlerror() message buffer.  Print the message before really
2958  * exiting.
2959  */
2960 void
2961 rtldexit(Lm_list * lml, int status)
2962 {
2963 	if (status) {
2964 		if (rtld_flags & RT_FL_APPLIC) {
2965 			/*
2966 			 * If the error buffer has been used, write out all
2967 			 * pending messages - lasterr is simply a pointer to
2968 			 * the last message in this buffer.  However, if the
2969 			 * buffer couldn't be created at all, lasterr points
2970 			 * to a constant error message string.
2971 			 */
2972 			if (*errbuf) {
2973 				char	*errptr = errbuf;
2974 				char	*errend = errbuf + ERRSIZE;
2975 
2976 				while ((errptr < errend) && *errptr) {
2977 					size_t	size = strlen(errptr);
2978 					(void) write(2, errptr, size);
2979 					(void) write(2, MSG_ORIG(MSG_STR_NL),
2980 					    MSG_STR_NL_SIZE);
2981 					errptr += (size + 1);
2982 				}
2983 			}
2984 			if (lasterr && ((lasterr < errbuf) ||
2985 			    (lasterr > (errbuf + ERRSIZE)))) {
2986 				(void) write(2, lasterr, strlen(lasterr));
2987 				(void) write(2, MSG_ORIG(MSG_STR_NL),
2988 				    MSG_STR_NL_SIZE);
2989 			}
2990 		}
2991 		leave(lml);
2992 		(void) _lwp_kill(_lwp_self(), killsig);
2993 	}
2994 	_exit(status);
2995 }
2996 
2997 /*
2998  * Routines to co-ordinate the opening of /dev/zero and /proc.
2999  * dz_fd is exported for possible use by libld.so, and to insure it gets
3000  * closed on leaving ld.so.1.
3001  */
3002 int	dz_fd = FD_UNAVAIL;
3003 
3004 void
3005 dz_init(int fd)
3006 {
3007 	dz_fd = fd;
3008 }
3009 
3010 
3011 /*
3012  * mmap() a page from MAP_ANON
3013  *
3014  * Note: MAP_ANON is only on Solaris8++, we use this routine to
3015  *       not only mmap(MAP_ANON) but to also probe if it is available
3016  *	 on the current OS.
3017  */
3018 Am_ret
3019 anon_map(Lm_list *lml, caddr_t *addr, size_t len, int prot, int flags)
3020 {
3021 #if defined(MAP_ANON)
3022 	static int	noanon = 0;
3023 	caddr_t		va;
3024 
3025 	if (noanon == 0) {
3026 		if ((va = (caddr_t)mmap(*addr, len, prot,
3027 		    (flags | MAP_ANON), -1, 0)) != MAP_FAILED) {
3028 			*addr = va;
3029 			return (AM_OK);
3030 		}
3031 
3032 		if ((errno != EBADF) && (errno != EINVAL)) {
3033 			int	err = errno;
3034 			eprintf(lml, ERR_FATAL, MSG_INTL(MSG_SYS_MMAPANON),
3035 			    MSG_ORIG(MSG_PTH_DEVZERO), strerror(err));
3036 			return (AM_ERROR);
3037 		} else
3038 			noanon = 1;
3039 	}
3040 #endif
3041 	return (AM_NOSUP);
3042 }
3043 
3044 /*
3045  * Map anonymous memory from /dev/zero, or via MAP_ANON.
3046  *
3047  * (MAP_ANON only appears on Solaris 8, so we need fall-back
3048  * behavior for older systems.)
3049  */
3050 caddr_t
3051 dz_map(Lm_list *lml, caddr_t addr, size_t len, int prot, int flags)
3052 {
3053 	caddr_t	va;
3054 	int	err;
3055 	Am_ret	amret;
3056 
3057 	amret = anon_map(lml, &addr, len, prot, flags);
3058 
3059 	if (amret == AM_OK)
3060 		return (addr);
3061 	if (amret == AM_ERROR)
3062 		return (MAP_FAILED);
3063 
3064 	/* amret == AM_NOSUP -> fallback to a devzero mmaping */
3065 
3066 	if (dz_fd == FD_UNAVAIL) {
3067 		if ((dz_fd = open(MSG_ORIG(MSG_PTH_DEVZERO),
3068 		    O_RDONLY)) == FD_UNAVAIL) {
3069 			err = errno;
3070 			eprintf(lml, ERR_FATAL, MSG_INTL(MSG_SYS_OPEN),
3071 			    MSG_ORIG(MSG_PTH_DEVZERO), strerror(err));
3072 			return (MAP_FAILED);
3073 		}
3074 	}
3075 
3076 	if ((va = mmap(addr, len, prot, flags, dz_fd, 0)) == MAP_FAILED) {
3077 		err = errno;
3078 		eprintf(lml, ERR_FATAL, MSG_INTL(MSG_SYS_MMAP),
3079 		    MSG_ORIG(MSG_PTH_DEVZERO), strerror(err));
3080 	}
3081 	return (va);
3082 }
3083 
3084 static int	pr_fd = FD_UNAVAIL;
3085 
3086 int
3087 pr_open(Lm_list *lml)
3088 {
3089 	char	proc[16];
3090 
3091 	if (pr_fd == FD_UNAVAIL) {
3092 		(void) snprintf(proc, 16, MSG_ORIG(MSG_FMT_PROC),
3093 			(int)getpid());
3094 		if ((pr_fd = open(proc, O_RDONLY)) == FD_UNAVAIL) {
3095 			int	err = errno;
3096 
3097 			eprintf(lml, ERR_FATAL, MSG_INTL(MSG_SYS_OPEN), proc,
3098 			    strerror(err));
3099 		}
3100 	}
3101 	return (pr_fd);
3102 }
3103 
3104 static int	nu_fd = FD_UNAVAIL;
3105 
3106 caddr_t
3107 nu_map(Lm_list *lml, caddr_t addr, size_t len, int prot, int flags)
3108 {
3109 	caddr_t	va;
3110 	int	err;
3111 
3112 	if (nu_fd == FD_UNAVAIL) {
3113 		if ((nu_fd = open(MSG_ORIG(MSG_PTH_DEVNULL),
3114 		    O_RDONLY)) == FD_UNAVAIL) {
3115 			err = errno;
3116 			eprintf(lml, ERR_FATAL, MSG_INTL(MSG_SYS_OPEN),
3117 			    MSG_ORIG(MSG_PTH_DEVNULL), strerror(err));
3118 			return (MAP_FAILED);
3119 		}
3120 	}
3121 
3122 	if ((va = (caddr_t)mmap(addr, len, prot, flags, nu_fd, 0)) ==
3123 	    MAP_FAILED) {
3124 		err = errno;
3125 		eprintf(lml, ERR_FATAL, MSG_INTL(MSG_SYS_MMAP),
3126 		    MSG_ORIG(MSG_PTH_DEVNULL), strerror(err));
3127 	}
3128 	return (va);
3129 }
3130 
3131 /*
3132  * Generic entry point from user code - simply grabs a lock.
3133  */
3134 int
3135 enter(void)
3136 {
3137 	if (rt_bind_guard(THR_FLG_RTLD)) {
3138 		(void) rt_mutex_lock(&rtldlock);
3139 		return (1);
3140 	}
3141 	return (0);
3142 }
3143 
3144 /*
3145  * Generate diagnostics as to whether an object has been used.  A symbolic
3146  * reference that gets bound to an object marks it as used.  Dependencies that
3147  * are unused when RTLD_NOW is in effect should be removed from future builds
3148  * of an object.  Dependencies that are unused without RTLD_NOW in effect are
3149  * candidates for lazy-loading.
3150  * Unreferenced objects identify objects that are defined as dependencies but
3151  * are unreferenced by the caller (they may however be referenced by other
3152  * objects within the process, and therefore don't qualify as completely unused.
3153  */
3154 void
3155 unused(Lm_list *lml)
3156 {
3157 	Rt_map		*lmp;
3158 	int		nl = 0;
3159 	Word		tracing;
3160 
3161 	/*
3162 	 * If we're not tracing unused references or dependencies, or debugging
3163 	 * there's nothing to do.
3164 	 */
3165 	tracing = lml->lm_flags & (LML_FLG_TRC_UNREF | LML_FLG_TRC_UNUSED);
3166 
3167 	if ((tracing == 0) && (DBG_ENABLED == 0))
3168 		return;
3169 
3170 	/*
3171 	 * Traverse the link-maps looking for unreferenced or unused
3172 	 * dependencies.  Ignore the first object on a link-map list, as this
3173 	 * is effectively always used.
3174 	 */
3175 	for (lmp = (Rt_map *)NEXT(lml->lm_head); lmp;
3176 	    lmp = (Rt_map *)NEXT(lmp)) {
3177 		/*
3178 		 * If tracing unreferenced objects, or under debugging,
3179 		 * determine whether any of this objects callers haven't
3180 		 * referenced it.
3181 		 */
3182 		if ((tracing & LML_FLG_TRC_UNREF) || DBG_ENABLED) {
3183 			Bnd_desc **	bdpp;
3184 			Aliste		off;
3185 
3186 			for (ALIST_TRAVERSE(CALLERS(lmp), off, bdpp)) {
3187 				Bnd_desc *	bdp = *bdpp;
3188 				Rt_map *	clmp;
3189 
3190 				if (bdp->b_flags & BND_REFER)
3191 					continue;
3192 
3193 				clmp = bdp->b_caller;
3194 				if (FLAGS1(clmp) & FL1_RT_LDDSTUB)
3195 					continue;
3196 
3197 				if (nl++ == 0) {
3198 					if (tracing & LML_FLG_TRC_UNREF)
3199 					    (void) printf(MSG_ORIG(MSG_STR_NL));
3200 					else
3201 					    DBG_CALL(Dbg_util_nl(lml,
3202 						DBG_NL_STD));
3203 				}
3204 
3205 				if (tracing & LML_FLG_TRC_UNREF)
3206 				    (void) printf(MSG_INTL(MSG_LDD_UNREF_FMT),
3207 					NAME(lmp), NAME(clmp));
3208 				else
3209 				    DBG_CALL(Dbg_unused_unref(lmp, NAME(clmp)));
3210 			}
3211 		}
3212 
3213 		/*
3214 		 * If tracing unused objects simply display those objects that
3215 		 * haven't been referenced by anyone.
3216 		 */
3217 		if (FLAGS1(lmp) & FL1_RT_USED)
3218 			continue;
3219 
3220 		if (nl++ == 0) {
3221 			if (tracing)
3222 				(void) printf(MSG_ORIG(MSG_STR_NL));
3223 			else
3224 				DBG_CALL(Dbg_util_nl(lml, DBG_NL_STD));
3225 		}
3226 		if (CYCGROUP(lmp)) {
3227 			if (tracing)
3228 				(void) printf(MSG_INTL(MSG_LDD_UNCYC_FMT),
3229 				    NAME(lmp), CYCGROUP(lmp));
3230 			else
3231 				DBG_CALL(Dbg_unused_file(lml, NAME(lmp), 0,
3232 				    CYCGROUP(lmp)));
3233 		} else {
3234 			if (tracing)
3235 				(void) printf(MSG_INTL(MSG_LDD_UNUSED_FMT),
3236 				    NAME(lmp));
3237 			else
3238 				DBG_CALL(Dbg_unused_file(lml, NAME(lmp), 0, 0));
3239 		}
3240 	}
3241 
3242 	DBG_CALL(Dbg_util_nl(lml, DBG_NL_STD));
3243 }
3244 
3245 /*
3246  * Initialization routine for the Fmap structure.  If the fmap structure is
3247  * already in use, any mapping is released.  The structure is then initialized
3248  * in preparation for further use.
3249  */
3250 void
3251 fmap_setup()
3252 {
3253 #if defined(MAP_ALIGN)
3254 	/*
3255 	 * If MAP_ALIGN is set, the fm_addr has been seeded with an alignment
3256 	 * value.  Otherwise, if fm_addr is non-null it indicates a mapping that
3257 	 * should now be freed.
3258 	 */
3259 	if (fmap->fm_maddr && ((fmap->fm_mflags & MAP_ALIGN) == 0))
3260 		(void) munmap((caddr_t)fmap->fm_maddr, fmap->fm_msize);
3261 
3262 	/*
3263 	 * Providing we haven't determined that this system doesn't support
3264 	 * MAP_ALIGN, initialize the mapping address with the default segment
3265 	 * alignment.
3266 	 */
3267 	if ((rtld_flags2 & RT_FL2_NOMALIGN) == 0) {
3268 		fmap->fm_maddr = (char *)M_SEGM_ALIGN;
3269 		fmap->fm_mflags = MAP_PRIVATE | MAP_ALIGN;
3270 	} else {
3271 		fmap->fm_maddr = 0;
3272 		fmap->fm_mflags = MAP_PRIVATE;
3273 	}
3274 #else
3275 	if (fmap->fm_maddr)
3276 		(void) munmap((caddr_t)fmap->fm_maddr, fmap->fm_msize);
3277 
3278 	fmap->fm_maddr = 0;
3279 	fmap->fm_mflags = MAP_PRIVATE;
3280 #endif
3281 
3282 	fmap->fm_msize = syspagsz;
3283 	fmap->fm_hwptr = 0;
3284 }
3285 
3286 /*
3287  * Generic cleanup routine called prior to returning control to the user.
3288  * Insures that any ld.so.1 specific file descriptors or temporary mapping are
3289  * released, and any locks dropped.
3290  */
3291 void
3292 leave(Lm_list *lml)
3293 {
3294 	Lm_list	*elml = lml;
3295 
3296 	/*
3297 	 * Alert the debuggers that the link-maps are consistent.  Note, in the
3298 	 * case of tearing down a whole link-map list, lml will be null.  In
3299 	 * this case use the main link-map list to test for a notification.
3300 	 */
3301 	if (elml == 0)
3302 		elml = &lml_main;
3303 	if (elml->lm_flags & LML_FLG_DBNOTIF)
3304 		rd_event(elml, RD_DLACTIVITY, RT_CONSISTENT);
3305 
3306 	if (dz_fd != FD_UNAVAIL) {
3307 		(void) close(dz_fd);
3308 		dz_fd = FD_UNAVAIL;
3309 	}
3310 
3311 	if (pr_fd != FD_UNAVAIL) {
3312 		(void) close(pr_fd);
3313 		pr_fd = FD_UNAVAIL;
3314 	}
3315 
3316 	if (nu_fd != FD_UNAVAIL) {
3317 		(void) close(nu_fd);
3318 		nu_fd = FD_UNAVAIL;
3319 	}
3320 
3321 	fmap_setup();
3322 
3323 	/*
3324 	 * Reinitialize error message pointer, and any overflow indication.
3325 	 */
3326 	nextptr = errbuf;
3327 	prevptr = 0;
3328 
3329 	/*
3330 	 * Don't drop our lock if we are running on our link-map list as
3331 	 * there's little point in doing so since we are single-threaded.
3332 	 *
3333 	 * LML_FLG_HOLDLOCK is set for:
3334 	 *	*) The ld.so.1's link-map list.
3335 	 *	*) The auditor's link-map if the environment is
3336 	 *	   libc/libthread un-unified.
3337 	 */
3338 	if (lml && (lml->lm_flags & LML_FLG_HOLDLOCK))
3339 		return;
3340 
3341 	if (rt_bind_clear(0) & THR_FLG_RTLD) {
3342 		(void) rt_mutex_unlock(&rtldlock);
3343 		(void) rt_bind_clear(THR_FLG_RTLD);
3344 	}
3345 }
3346 
3347 int
3348 callable(Rt_map * clmp, Rt_map * dlmp, Grp_hdl * ghp)
3349 {
3350 	Alist *		calp, * dalp;
3351 	Aliste		cnt1, cnt2;
3352 	Grp_hdl **	ghpp1, ** ghpp2;
3353 
3354 	/*
3355 	 * An object can always find symbols within itself.
3356 	 */
3357 	if (clmp == dlmp)
3358 		return (1);
3359 
3360 	/*
3361 	 * Don't allow an object to bind to an object that is being deleted
3362 	 * unless the binder is also being deleted.
3363 	 */
3364 	if ((FLAGS(dlmp) & FLG_RT_DELETE) &&
3365 	    ((FLAGS(clmp) & FLG_RT_DELETE) == 0))
3366 		return (0);
3367 
3368 	/*
3369 	 * An object with world access can always bind to an object with global
3370 	 * visibility.
3371 	 */
3372 	if ((MODE(clmp) & RTLD_WORLD) && (MODE(dlmp) & RTLD_GLOBAL))
3373 		return (1);
3374 
3375 	/*
3376 	 * An object with local access can only bind to an object that is a
3377 	 * member of the same group.
3378 	 */
3379 	if (((MODE(clmp) & RTLD_GROUP) == 0) ||
3380 	    ((calp = GROUPS(clmp)) == 0) || ((dalp = GROUPS(dlmp)) == 0))
3381 		return (0);
3382 
3383 	/*
3384 	 * Traverse the list of groups the caller is a part of.
3385 	 */
3386 	for (ALIST_TRAVERSE(calp, cnt1, ghpp1)) {
3387 		/*
3388 		 * If we're testing for the ability of two objects to bind to
3389 		 * each other regardless of a specific group, ignore that group.
3390 		 */
3391 		if (ghp && (*ghpp1 == ghp))
3392 			continue;
3393 
3394 		/*
3395 		 * Traverse the list of groups the destination is a part of.
3396 		 */
3397 		for (ALIST_TRAVERSE(dalp, cnt2, ghpp2)) {
3398 			if (*ghpp1 == *ghpp2)
3399 				return (1);
3400 		}
3401 	}
3402 	return (0);
3403 }
3404 
3405 /*
3406  * Initialize the environ symbol.  Traditionally this is carried out by the crt
3407  * code prior to jumping to main.  However, init sections get fired before this
3408  * variable is initialized, so ld.so.1 sets this directly from the AUX vector
3409  * information.  In addition, a process may have multiple link-maps (ld.so.1's
3410  * debugging and preloading objects), and link auditing, and each may need an
3411  * environ variable set.
3412  *
3413  * This routine is called after a relocation() pass, and thus provides for:
3414  *
3415  *  o	setting environ on the main link-map after the initial application and
3416  *	its dependencies have been established.  Typically environ lives in the
3417  *	application (provided by its crt), but in older applications it might
3418  *	be in libc.  Who knows what's expected of applications not built on
3419  *	Solaris.
3420  *
3421  *  o	after loading a new shared object.  We can add shared objects to various
3422  *	link-maps, and any link-map dependencies requiring getopt() require
3423  *	their own environ.  In addition, lazy loading might bring in the
3424  *	supplier of environ (libc used to be a lazy loading candidate) after
3425  *	the link-map has been established and other objects are present.
3426  *
3427  * This routine handles all these scenarios, without adding unnecessary overhead
3428  * to ld.so.1.
3429  */
3430 void
3431 set_environ(Lm_list *lml)
3432 {
3433 	Rt_map *	dlmp;
3434 	Sym *		sym;
3435 	Slookup		sl;
3436 	uint_t		binfo;
3437 
3438 	sl.sl_name = MSG_ORIG(MSG_SYM_ENVIRON);
3439 	sl.sl_cmap = lml->lm_head;
3440 	sl.sl_imap = lml->lm_head;
3441 	sl.sl_hash = 0;
3442 	sl.sl_rsymndx = 0;
3443 	sl.sl_flags = LKUP_WEAK;
3444 
3445 	if (sym = LM_LOOKUP_SYM(lml->lm_head)(&sl, &dlmp, &binfo)) {
3446 		lml->lm_environ = (char ***)sym->st_value;
3447 
3448 		if (!(FLAGS(dlmp) & FLG_RT_FIXED))
3449 			lml->lm_environ =
3450 			    (char ***)((uintptr_t)lml->lm_environ +
3451 			    (uintptr_t)ADDR(dlmp));
3452 		*(lml->lm_environ) = (char **)environ;
3453 		lml->lm_flags |= LML_FLG_ENVIRON;
3454 	}
3455 }
3456 
3457 /*
3458  * Determine whether we have a secure executable.  Uid and gid information
3459  * can be passed to us via the aux vector, however if these values are -1
3460  * then use the appropriate system call to obtain them.
3461  *
3462  *  o	If the user is the root they can do anything
3463  *
3464  *  o	If the real and effective uid's don't match, or the real and
3465  *	effective gid's don't match then this is determined to be a `secure'
3466  *	application.
3467  *
3468  * This function is called prior to any dependency processing (see _setup.c).
3469  * Any secure setting will remain in effect for the life of the process.
3470  */
3471 void
3472 security(uid_t uid, uid_t euid, gid_t gid, gid_t egid, int auxflags)
3473 {
3474 #ifdef AT_SUN_AUXFLAGS
3475 	if (auxflags != -1) {
3476 		if ((auxflags & AF_SUN_SETUGID) != 0)
3477 			rtld_flags |= RT_FL_SECURE;
3478 		return;
3479 	}
3480 #endif
3481 	if (uid == -1)
3482 		uid = getuid();
3483 	if (uid) {
3484 		if (euid == -1)
3485 			euid = geteuid();
3486 		if (uid != euid)
3487 			rtld_flags |= RT_FL_SECURE;
3488 		else {
3489 			if (gid == -1)
3490 				gid = getgid();
3491 			if (egid == -1)
3492 				egid = getegid();
3493 			if (gid != egid)
3494 				rtld_flags |= RT_FL_SECURE;
3495 		}
3496 	}
3497 }
3498 
3499 /*
3500  * _REENTRANT code gets errno redefined to a function so provide for return
3501  * of the thread errno if applicable.  This has no meaning in ld.so.1 which
3502  * is basically singled threaded.  Provide the interface for our dependencies.
3503  */
3504 #undef errno
3505 #pragma weak _private___errno = ___errno
3506 int *
3507 ___errno()
3508 {
3509 	extern	int	errno;
3510 
3511 	return (&errno);
3512 }
3513 
3514 /*
3515  * The interface with the c library which is supplied through libdl.so.1.
3516  * A non-null argument allows a function pointer array to be passed to us which
3517  * is used to re-initialize the linker libc table.
3518  */
3519 void
3520 _ld_libc(void * ptr)
3521 {
3522 	get_lcinterface(_caller(caller(), CL_EXECDEF), (Lc_interface *)ptr);
3523 }
3524 
3525 /*
3526  * Determine whether a symbol name should be demangled.
3527  */
3528 const char *
3529 demangle(const char *name)
3530 {
3531 	if (rtld_flags & RT_FL_DEMANGLE)
3532 		return (conv_demangle_name(name));
3533 	else
3534 		return (name);
3535 }
3536