1 /* Load the dependencies of a mapped object.
2 Copyright (C) 1996-2001, 2002, 2003 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, write to the Free
17 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
28 #include <sys/param.h>
33 /* Whether an shared object references one or more auxiliary objects
34 is signaled by the AUXTAG entry in l_info. */
35 #define AUXTAG (DT_NUM + DT_THISPROCNUM + DT_VERSIONTAGNUM \
36 + DT_EXTRATAGIDX (DT_AUXILIARY))
37 /* Whether an shared object references one or more auxiliary objects
38 is signaled by the AUXTAG entry in l_info. */
39 #define FILTERTAG (DT_NUM + DT_THISPROCNUM + DT_VERSIONTAGNUM \
40 + DT_EXTRATAGIDX (DT_FILTER))
43 /* When loading auxiliary objects we must ignore errors. It's ok if
44 an object is missing. */
47 /* The arguments to openaux. */
54 /* The return value of openaux. */
61 struct openaux_args
*args
= (struct openaux_args
*) a
;
63 args
->aux
= INTUSE(_dl_map_object
) (args
->map
, args
->name
, 0,
64 (args
->map
->l_type
== lt_executable
65 ? lt_library
: args
->map
->l_type
),
66 args
->trace_mode
, args
->open_mode
);
71 _dl_build_local_scope (struct link_map
**list
, struct link_map
*map
)
73 struct link_map
**p
= list
;
79 for (q
= map
->l_initfini
+ 1; *q
; ++q
)
80 if (! (*q
)->l_reserved
)
81 p
+= _dl_build_local_scope (p
, *q
);
86 /* We use a very special kind of list to track the path
87 through the list of loaded shared objects. We have to
88 produce a flat list with unique members of all involved objects.
92 int done
; /* Nonzero if this map was processed. */
93 struct link_map
*map
; /* The data. */
94 struct list
*next
; /* Elements for normal list. */
98 /* Macro to expand DST. It is an macro since we use `alloca'. */
99 #define expand_dst(l, str, fatal) \
101 const char *__str = (str); \
102 const char *__result = __str; \
103 size_t __cnt = DL_DST_COUNT(__str, 0); \
109 /* DST must not appear in SUID/SGID programs. */ \
110 if (INTUSE(__libc_enable_secure)) \
111 INTUSE(_dl_signal_error) (0, __str, NULL, N_("\
112 DST not allowed in SUID/SGID programs")); \
114 __newp = (char *) alloca (DL_DST_REQUIRED (l, __str, strlen (__str), \
117 __result = INTUSE(_dl_dst_substitute) (l, __str, __newp, 0); \
119 if (*__result == '\0') \
121 /* The replacement for the DST is not known. We can't \
124 INTUSE(_dl_signal_error) (0, __str, NULL, N_("\
125 empty dynamics string token substitution")); \
128 /* This is for DT_AUXILIARY. */ \
129 if (__builtin_expect (GL(dl_debug_mask) & DL_DEBUG_LIBS, 0)) \
130 INTUSE(_dl_debug_printf) (N_("\
131 cannot load auxiliary `%s' because of empty dynamic string token " \
132 "substitution\n"), __str); \
143 _dl_map_object_deps (struct link_map
*map
,
144 struct link_map
**preloads
, unsigned int npreloads
,
145 int trace_mode
, int open_mode
)
147 struct list known
[1 + npreloads
+ 1];
148 struct list
*runp
, *tail
;
149 unsigned int nlist
, i
;
154 const char *errstring
;
157 auto inline void preload (struct link_map
*map
);
159 inline void preload (struct link_map
*map
)
161 known
[nlist
].done
= 0;
162 known
[nlist
].map
= map
;
163 known
[nlist
].next
= &known
[nlist
+ 1];
166 /* We use `l_reserved' as a mark bit to detect objects we have
167 already put in the search list and avoid adding duplicate
168 elements later in the list. */
172 /* No loaded object so far. */
175 /* First load MAP itself. */
178 /* Add the preloaded items after MAP but before any of its dependencies. */
179 for (i
= 0; i
< npreloads
; ++i
)
180 preload (preloads
[i
]);
182 /* Terminate the lists. */
183 known
[nlist
- 1].next
= NULL
;
185 /* Pointer to last unique object. */
186 tail
= &known
[nlist
- 1];
188 /* Process each element of the search list, loading each of its
189 auxiliary objects and immediate dependencies. Auxiliary objects
190 will be added in the list before the object itself and
191 dependencies will be appended to the list as we step through it.
192 This produces a flat, ordered list that represents a
193 breadth-first search of the dependency tree.
195 The whole process is complicated by the fact that we better
196 should use alloca for the temporary list elements. But using
197 alloca means we cannot use recursive function calls. */
203 for (runp
= known
; runp
; )
205 struct link_map
*l
= runp
->map
;
206 struct link_map
**needed
= NULL
;
207 unsigned int nneeded
= 0;
209 /* Unless otherwise stated, this object is handled. */
212 /* Allocate a temporary record to contain the references to the
213 dependencies of this object. */
214 if (l
->l_searchlist
.r_list
== NULL
&& l
->l_initfini
== NULL
215 && l
!= map
&& l
->l_ldnum
> 0)
216 needed
= (struct link_map
**) alloca (l
->l_ldnum
217 * sizeof (struct link_map
*));
219 if (l
->l_info
[DT_NEEDED
] || l
->l_info
[AUXTAG
] || l
->l_info
[FILTERTAG
])
221 const char *strtab
= (const void *) D_PTR (l
, l_info
[DT_STRTAB
]);
222 struct openaux_args args
;
226 args
.strtab
= strtab
;
228 args
.trace_mode
= trace_mode
;
229 args
.open_mode
= open_mode
;
232 for (d
= l
->l_ld
; d
->d_tag
!= DT_NULL
; ++d
)
233 if (__builtin_expect (d
->d_tag
, DT_NEEDED
) == DT_NEEDED
)
235 /* Map in the needed object. */
236 struct link_map
*dep
;
239 /* Recognize DSTs. */
240 name
= expand_dst (l
, strtab
+ d
->d_un
.d_val
, 0);
241 /* Store the tag in the argument structure. */
244 err
= INTUSE(_dl_catch_error
) (&objname
, &errstring
, openaux
,
246 if (__builtin_expect (errstring
!= NULL
, 0))
257 if (! dep
->l_reserved
)
259 /* Allocate new entry. */
262 newp
= alloca (sizeof (struct list
));
264 /* Append DEP to the list. */
271 /* Set the mark bit that says it's already in the list. */
275 /* Remember this dependency. */
277 needed
[nneeded
++] = dep
;
279 else if (d
->d_tag
== DT_AUXILIARY
|| d
->d_tag
== DT_FILTER
)
283 /* Recognize DSTs. */
284 name
= expand_dst (l
, strtab
+ d
->d_un
.d_val
,
285 d
->d_tag
== DT_AUXILIARY
);
286 /* Store the tag in the argument structure. */
289 if (d
->d_tag
== DT_AUXILIARY
)
293 /* Say that we are about to load an auxiliary library. */
294 if (__builtin_expect (GL(dl_debug_mask
) & DL_DEBUG_LIBS
,
296 INTUSE(_dl_debug_printf
) ("load auxiliary object=%s"
297 " requested by file=%s\n",
300 ? l
->l_name
: rtld_progname
);
302 /* We must be prepared that the addressed shared
303 object is not available. */
304 err
= INTUSE(_dl_catch_error
) (&objname
, &errstring
,
306 if (__builtin_expect (errstring
!= NULL
, 0))
308 /* We are not interested in the error message. */
309 assert (errstring
!= NULL
);
310 if (errstring
!= INTUSE(_dl_out_of_memory
))
311 free ((char *) errstring
);
313 /* Simply ignore this error and continue the work. */
321 /* Say that we are about to load an auxiliary library. */
322 if (__builtin_expect (GL(dl_debug_mask
) & DL_DEBUG_LIBS
,
324 INTUSE(_dl_debug_printf
) ("load filtered object=%s"
325 " requested by file=%s\n",
328 ? l
->l_name
: rtld_progname
);
330 /* For filter objects the dependency must be available. */
331 err
= INTUSE(_dl_catch_error
) (&objname
, &errstring
,
333 if (__builtin_expect (errstring
!= NULL
, 0))
343 /* The auxiliary object is actually available.
344 Incorporate the map in all the lists. */
346 /* Allocate new entry. This always has to be done. */
347 newp
= alloca (sizeof (struct list
));
349 /* We want to insert the new map before the current one,
350 but we have no back links. So we copy the contents of
351 the current entry over. Note that ORIG and NEWP now
352 have switched their meanings. */
353 memcpy (newp
, orig
, sizeof (*newp
));
355 /* Initialize new entry. */
357 orig
->map
= args
.aux
;
359 /* Remember this dependency. */
361 needed
[nneeded
++] = args
.aux
;
363 /* We must handle two situations here: the map is new,
364 so we must add it in all three lists. If the map
365 is already known, we have two further possibilities:
366 - if the object is before the current map in the
367 search list, we do nothing. It is already found
369 - if the object is after the current one, we must
370 move it just before the current map to make sure
371 the symbols are found early enough
373 if (args
.aux
->l_reserved
)
375 /* The object is already somewhere in the list.
379 /* This object is already in the search list we
380 are building. Don't add a duplicate pointer.
381 Just added by _dl_map_object. */
382 for (late
= newp
; late
->next
!= NULL
; late
= late
->next
)
383 if (late
->next
->map
== args
.aux
)
386 if (late
->next
!= NULL
)
388 /* The object is somewhere behind the current
389 position in the search path. We have to
390 move it to this earlier position. */
393 /* Now remove the later entry from the list
394 and adjust the tail pointer. */
395 if (tail
== late
->next
)
397 late
->next
= late
->next
->next
;
399 /* We must move the object earlier in the chain. */
400 if (args
.aux
->l_prev
!= NULL
)
401 args
.aux
->l_prev
->l_next
= args
.aux
->l_next
;
402 if (args
.aux
->l_next
!= NULL
)
403 args
.aux
->l_next
->l_prev
= args
.aux
->l_prev
;
405 args
.aux
->l_prev
= newp
->map
->l_prev
;
406 newp
->map
->l_prev
= args
.aux
;
407 if (args
.aux
->l_prev
!= NULL
)
408 args
.aux
->l_prev
->l_next
= args
.aux
;
409 args
.aux
->l_next
= newp
->map
;
413 /* The object must be somewhere earlier in the
414 list. Undo to the current list element what
416 memcpy (orig
, newp
, sizeof (*newp
));
422 /* This is easy. We just add the symbol right here. */
425 /* Set the mark bit that says it's already in the list. */
426 args
.aux
->l_reserved
= 1;
428 /* The only problem is that in the double linked
429 list of all objects we don't have this new
430 object at the correct place. Correct this here. */
431 if (args
.aux
->l_prev
)
432 args
.aux
->l_prev
->l_next
= args
.aux
->l_next
;
433 if (args
.aux
->l_next
)
434 args
.aux
->l_next
->l_prev
= args
.aux
->l_prev
;
436 args
.aux
->l_prev
= newp
->map
->l_prev
;
437 newp
->map
->l_prev
= args
.aux
;
438 if (args
.aux
->l_prev
!= NULL
)
439 args
.aux
->l_prev
->l_next
= args
.aux
;
440 args
.aux
->l_next
= newp
->map
;
443 /* Move the tail pointer if necessary. */
447 /* Move on the insert point. */
452 /* Terminate the list of dependencies and store the array address. */
455 needed
[nneeded
++] = NULL
;
457 l
->l_initfini
= (struct link_map
**)
458 malloc ((2 * nneeded
+ 1) * sizeof needed
[0]);
459 if (l
->l_initfini
== NULL
)
460 INTUSE(_dl_signal_error
) (ENOMEM
, map
->l_name
, NULL
,
461 N_("cannot allocate dependency list"));
462 l
->l_initfini
[0] = l
;
463 memcpy (&l
->l_initfini
[1], needed
, nneeded
* sizeof needed
[0]);
464 memcpy (&l
->l_initfini
[nneeded
+ 1], l
->l_initfini
,
465 nneeded
* sizeof needed
[0]);
468 /* If we have no auxiliary objects just go on to the next map. */
472 while (runp
!= NULL
&& runp
->done
);
476 if (errno
== 0 && errno_saved
!= 0)
477 __set_errno (errno_saved
);
479 if (map
->l_initfini
!= NULL
&& map
->l_type
== lt_loaded
)
481 /* This object was previously loaded as a dependency and we have
482 a separate l_initfini list. We don't need it anymore. */
483 assert (map
->l_searchlist
.r_list
== NULL
);
484 free (map
->l_initfini
);
487 /* Store the search list we built in the object. It will be used for
488 searches in the scope of this object. */
490 (struct link_map
**) malloc ((2 * nlist
+ 1)
491 * sizeof (struct link_map
*));
492 if (map
->l_initfini
== NULL
)
493 INTUSE(_dl_signal_error
) (ENOMEM
, map
->l_name
, NULL
,
494 N_("cannot allocate symbol search list"));
497 map
->l_searchlist
.r_list
= &map
->l_initfini
[nlist
+ 1];
498 map
->l_searchlist
.r_nlist
= nlist
;
500 for (nlist
= 0, runp
= known
; runp
; runp
= runp
->next
)
502 if (__builtin_expect (trace_mode
, 0) && runp
->map
->l_faked
)
503 /* This can happen when we trace the loading. */
504 --map
->l_searchlist
.r_nlist
;
506 map
->l_searchlist
.r_list
[nlist
++] = runp
->map
;
508 /* Now clear all the mark bits we set in the objects on the search list
509 to avoid duplicates, so the next call starts fresh. */
510 runp
->map
->l_reserved
= 0;
513 if (__builtin_expect(GL(dl_debug_mask
) & DL_DEBUG_PRELINK
, 0) != 0
514 && map
== GL(dl_loaded
))
516 /* If we are to compute conflicts, we have to build local scope
517 for each library, not just the ultimate loader. */
518 for (i
= 0; i
< nlist
; ++i
)
520 struct link_map
*l
= map
->l_searchlist
.r_list
[i
];
523 /* The local scope has been already computed. */
525 || (l
->l_local_scope
[0]
526 && l
->l_local_scope
[0]->r_nlist
) != 0)
529 if (l
->l_info
[AUXTAG
] || l
->l_info
[FILTERTAG
])
531 /* As current DT_AUXILIARY/DT_FILTER implementation needs to be
532 rewritten, no need to bother with prelinking the old
534 INTUSE(_dl_signal_error
) (EINVAL
, l
->l_name
, NULL
, N_("\
535 Filters not supported with LD_TRACE_PRELINKING"));
538 cnt
= _dl_build_local_scope (map
->l_initfini
, l
);
539 assert (cnt
<= nlist
);
540 for (j
= 0; j
< cnt
; j
++)
541 map
->l_initfini
[j
]->l_reserved
= 0;
543 l
->l_local_scope
[0] =
544 (struct r_scope_elem
*) malloc (sizeof (struct r_scope_elem
)
546 * sizeof (struct link_map
*)));
547 if (l
->l_local_scope
[0] == NULL
)
548 INTUSE(_dl_signal_error
) (ENOMEM
, map
->l_name
, NULL
,
549 N_("cannot allocate symbol search list"));
550 l
->l_local_scope
[0]->r_nlist
= cnt
;
551 l
->l_local_scope
[0]->r_list
=
552 (struct link_map
**) (l
->l_local_scope
[0] + 1);
553 memcpy (l
->l_local_scope
[0]->r_list
, map
->l_initfini
,
554 cnt
* sizeof (struct link_map
*));
558 /* Maybe we can remove some relocation dependencies now. */
559 assert (map
->l_searchlist
.r_list
[0] == map
);
560 for (i
= 0; i
< map
->l_reldepsact
; ++i
)
564 for (j
= 1; j
< nlist
; ++j
)
565 if (map
->l_searchlist
.r_list
[j
] == map
->l_reldeps
[i
])
567 /* A direct or transitive dependency is also on the list
568 of relocation dependencies. Remove the latter. */
569 --map
->l_reldeps
[i
]->l_opencount
;
571 for (j
= i
+ 1; j
< map
->l_reldepsact
; ++j
)
572 map
->l_reldeps
[j
- 1] = map
->l_reldeps
[j
];
576 /* Account for the '++i' performed by the 'for'. */
582 /* Now determine the order in which the initialization has to happen. */
583 memcpy (map
->l_initfini
, map
->l_searchlist
.r_list
,
584 nlist
* sizeof (struct link_map
*));
585 /* We can skip looking for the binary itself which is at the front
586 of the search list. Look through the list backward so that circular
587 dependencies are not changing the order. */
588 for (i
= 1; i
< nlist
; ++i
)
590 struct link_map
*l
= map
->l_searchlist
.r_list
[i
];
594 /* Find the place in the initfini list where the map is currently
596 for (j
= 1; map
->l_initfini
[j
] != l
; ++j
)
599 /* Find all object for which the current one is a dependency and
600 move the found object (if necessary) in front. */
601 for (k
= j
+ 1; k
< nlist
; ++k
)
603 struct link_map
**runp
;
605 runp
= map
->l_initfini
[k
]->l_initfini
;
608 while (*runp
!= NULL
)
609 if (__builtin_expect (*runp
++ == l
, 0))
611 struct link_map
*here
= map
->l_initfini
[k
];
614 memmove (&map
->l_initfini
[j
] + 1,
616 (k
- j
) * sizeof (struct link_map
*));
617 map
->l_initfini
[j
] = here
;
619 /* Don't insert further matches before the last
620 entry moved to the front. */
628 /* Terminate the list of dependencies. */
629 map
->l_initfini
[nlist
] = NULL
;
632 INTUSE(_dl_signal_error
) (errno_reason
== -1 ? 0 : errno_reason
, objname
,
635 INTDEF (_dl_map_object_deps
)