(elf_machine_rela): Add missing comma.
[glibc.git] / elf / dl-deps.c
blobc886ca8b185aaf6f1e6a5801c6296b0fb483bb86
1 /* Load the dependencies of a mapped object.
2 Copyright (C) 1996,1997,1998,1999,2000,2001 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 Library General Public License as
7 published by the Free Software Foundation; either version 2 of the
8 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 Library General Public License for more details.
15 You should have received a copy of the GNU Library General Public
16 License along with the GNU C Library; see the file COPYING.LIB. If not,
17 write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA. */
20 #include <assert.h>
21 #include <dlfcn.h>
22 #include <errno.h>
23 #include <libintl.h>
24 #include <stdlib.h>
25 #include <string.h>
26 #include <unistd.h>
27 #include <sys/param.h>
28 #include <ldsodefs.h>
30 #include <dl-dst.h>
32 /* Whether an shared object references one or more auxiliary objects
33 is signaled by the AUXTAG entry in l_info. */
34 #define AUXTAG (DT_NUM + DT_THISPROCNUM + DT_VERSIONTAGNUM \
35 + DT_EXTRATAGIDX (DT_AUXILIARY))
36 /* Whether an shared object references one or more auxiliary objects
37 is signaled by the AUXTAG entry in l_info. */
38 #define FILTERTAG (DT_NUM + DT_THISPROCNUM + DT_VERSIONTAGNUM \
39 + DT_EXTRATAGIDX (DT_FILTER))
41 /* This is zero at program start to signal that the global scope map is
42 allocated by rtld. Later it keeps the size of the map. It might be
43 reset if in _dl_close if the last global object is removed. */
44 size_t _dl_global_scope_alloc;
46 extern size_t _dl_platformlen;
48 /* When loading auxiliary objects we must ignore errors. It's ok if
49 an object is missing. */
50 struct openaux_args
52 /* The arguments to openaux. */
53 struct link_map *map;
54 int trace_mode;
55 const char *strtab;
56 const char *name;
58 /* The return value of openaux. */
59 struct link_map *aux;
62 static void
63 openaux (void *a)
65 struct openaux_args *args = (struct openaux_args *) a;
67 args->aux = _dl_map_object (args->map, args->name, 0,
68 (args->map->l_type == lt_executable
69 ? lt_library : args->map->l_type),
70 args->trace_mode, 0);
75 /* We use a very special kind of list to track the two kinds paths
76 through the list of loaded shared objects. We have to
78 - produce a flat list with unique members of all involved objects
80 - produce a flat list of all shared objects.
82 struct list
84 int done; /* Nonzero if this map was processed. */
85 struct link_map *map; /* The data. */
87 struct list *unique; /* Elements for normal list. */
88 struct list *dup; /* Elements in complete list. */
92 /* Macro to expand DST. It is an macro since we use `alloca'. */
93 #define expand_dst(l, str, fatal) \
94 ({ \
95 const char *__str = (str); \
96 const char *__result = __str; \
97 size_t __cnt = DL_DST_COUNT(__str, 0); \
99 if (__cnt != 0) \
101 char *__newp; \
103 /* DST must not appear in SUID/SGID programs. */ \
104 if (__libc_enable_secure) \
105 _dl_signal_error (0, __str, \
106 N_("DST not allowed in SUID/SGID programs")); \
108 __newp = (char *) alloca (DL_DST_REQUIRED (l, __str, strlen (__str), \
109 __cnt)); \
111 __result = DL_DST_SUBSTITUTE (l, __str, __newp, 0); \
113 if (*__result == '\0') \
115 /* The replacement for the DST is not known. We can't \
116 processed. */ \
117 if (fatal) \
118 _dl_signal_error (0, __str, N_("\
119 empty dynamics string token substitution")); \
120 else \
122 /* This is for DT_AUXILIARY. */ \
123 if (__builtin_expect (_dl_debug_mask & DL_DEBUG_LIBS, 0)) \
124 _dl_debug_printf ("cannot load auxiliary `%s' because of" \
125 "empty dynamic string token " \
126 "substitution\n", __str); \
127 continue; \
132 __result; })
135 void
136 internal_function
137 _dl_map_object_deps (struct link_map *map,
138 struct link_map **preloads, unsigned int npreloads,
139 int trace_mode)
141 struct list known[1 + npreloads + 1];
142 struct list *runp, *utail, *dtail;
143 unsigned int nlist, nduplist, i;
144 /* Object name. */
145 const char *name;
146 int errno_saved;
147 int errno_reason;
149 auto inline void preload (struct link_map *map);
151 inline void preload (struct link_map *map)
153 known[nlist].done = 0;
154 known[nlist].map = map;
156 known[nlist].unique = &known[nlist + 1];
157 known[nlist].dup = &known[nlist + 1];
159 ++nlist;
160 /* We use `l_reserved' as a mark bit to detect objects we have
161 already put in the search list and avoid adding duplicate
162 elements later in the list. */
163 map->l_reserved = 1;
166 /* No loaded object so far. */
167 nlist = 0;
169 /* First load MAP itself. */
170 preload (map);
172 /* Add the preloaded items after MAP but before any of its dependencies. */
173 for (i = 0; i < npreloads; ++i)
174 preload (preloads[i]);
176 /* Terminate the lists. */
177 known[nlist - 1].unique = NULL;
178 known[nlist - 1].dup = NULL;
180 /* Pointer to last unique object. */
181 utail = &known[nlist - 1];
182 /* Pointer to last loaded object. */
183 dtail = &known[nlist - 1];
185 /* Until now we have the same number of libraries in the normal and
186 the list with duplicates. */
187 nduplist = nlist;
189 /* Process each element of the search list, loading each of its
190 auxiliary objects and immediate dependencies. Auxiliary objects
191 will be added in the list before the object itself and
192 dependencies will be appended to the list as we step through it.
193 This produces a flat, ordered list that represents a
194 breadth-first search of the dependency tree.
196 The whole process is complicated by the fact that we better
197 should use alloca for the temporary list elements. But using
198 alloca means we cannot use recursive function calls. */
199 errno_saved = errno;
200 errno_reason = 0;
201 errno = 0;
202 name = NULL;
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. */
210 runp->done = 1;
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;
223 struct list *orig;
224 const ElfW(Dyn) *d;
226 args.strtab = strtab;
227 args.map = l;
228 args.trace_mode = trace_mode;
229 orig = runp;
231 for (d = l->l_ld; d->d_tag != DT_NULL; ++d)
232 if (__builtin_expect (d->d_tag, DT_NEEDED) == DT_NEEDED)
234 /* Map in the needed object. */
235 struct link_map *dep;
236 /* Allocate new entry. */
237 struct list *newp;
238 const char *objname;
239 const char *errstring;
241 /* Recognize DSTs. */
242 name = expand_dst (l, strtab + d->d_un.d_val, 0);
243 /* Store the tag in the argument structure. */
244 args.name = name;
246 if (_dl_catch_error (&objname, &errstring, openaux, &args))
248 if (errno)
249 errno_reason = errno;
250 else
251 errno_reason = -1;
252 goto out;
254 else
255 dep = args.aux;
257 /* Add it in any case to the duplicate list. */
258 newp = alloca (sizeof (struct list));
259 newp->map = dep;
260 newp->dup = NULL;
261 dtail->dup = newp;
262 dtail = newp;
263 ++nduplist;
265 if (! dep->l_reserved)
267 /* Append DEP to the unique list. */
268 newp->done = 0;
269 newp->unique = NULL;
270 utail->unique = newp;
271 utail = newp;
272 ++nlist;
273 /* Set the mark bit that says it's already in the list. */
274 dep->l_reserved = 1;
277 /* Remember this dependency. */
278 if (needed != NULL)
279 needed[nneeded++] = dep;
281 else if (d->d_tag == DT_AUXILIARY || d->d_tag == DT_FILTER)
283 const char *objname;
284 const char *errstring;
285 struct list *newp;
287 /* Recognize DSTs. */
288 name = expand_dst (l, strtab + d->d_un.d_val,
289 d->d_tag == DT_AUXILIARY);
290 /* Store the tag in the argument structure. */
291 args.name = name;
293 if (d->d_tag == DT_AUXILIARY)
295 /* Say that we are about to load an auxiliary library. */
296 if (__builtin_expect (_dl_debug_mask & DL_DEBUG_LIBS, 0))
297 _dl_debug_printf ("load auxiliary object=%s"
298 " requested by file=%s\n", name,
299 l->l_name[0]
300 ? l->l_name : _dl_argv[0]);
302 /* We must be prepared that the addressed shared
303 object is not available. */
304 if (_dl_catch_error (&objname, &errstring, openaux, &args))
306 /* We are not interested in the error message. */
307 assert (errstring != NULL);
308 if (errstring != _dl_out_of_memory)
309 free ((char *) errstring);
311 /* Simply ignore this error and continue the work. */
312 continue;
315 else
317 /* Say that we are about to load an auxiliary library. */
318 if (__builtin_expect (_dl_debug_mask & DL_DEBUG_LIBS, 0))
319 _dl_debug_printf ("load filtered object=%s"
320 " requested by file=%s\n", name,
321 l->l_name[0]
322 ? l->l_name : _dl_argv[0]);
324 /* For filter objects the dependency must be available. */
325 if (_dl_catch_error (&objname, &errstring, openaux, &args))
327 if (errno)
328 errno_reason = errno;
329 else
330 errno_reason = -1;
331 goto out;
335 /* The auxiliary object is actually available.
336 Incorporate the map in all the lists. */
338 /* Allocate new entry. This always has to be done. */
339 newp = alloca (sizeof (struct list));
341 /* We want to insert the new map before the current one,
342 but we have no back links. So we copy the contents of
343 the current entry over. Note that ORIG and NEWP now
344 have switched their meanings. */
345 orig->dup = memcpy (newp, orig, sizeof (*newp));
347 /* Initialize new entry. */
348 orig->done = 0;
349 orig->map = args.aux;
351 /* Remember this dependency. */
352 if (needed != NULL)
353 needed[nneeded++] = args.aux;
355 /* We must handle two situations here: the map is new,
356 so we must add it in all three lists. If the map
357 is already known, we have two further possibilities:
358 - if the object is before the current map in the
359 search list, we do nothing. It is already found
360 early
361 - if the object is after the current one, we must
362 move it just before the current map to make sure
363 the symbols are found early enough
365 if (args.aux->l_reserved)
367 /* The object is already somewhere in the list.
368 Locate it first. */
369 struct list *late;
371 /* This object is already in the search list we
372 are building. Don't add a duplicate pointer.
373 Just added by _dl_map_object. */
374 for (late = newp; late->unique; late = late->unique)
375 if (late->unique->map == args.aux)
376 break;
378 if (late->unique)
380 /* The object is somewhere behind the current
381 position in the search path. We have to
382 move it to this earlier position. */
383 orig->unique = newp;
385 /* Now remove the later entry from the unique list
386 and adjust the tail pointer. */
387 if (utail == late->unique)
388 utail = late;
389 late->unique = late->unique->unique;
391 /* We must move the object earlier in the chain. */
392 if (args.aux->l_prev)
393 args.aux->l_prev->l_next = args.aux->l_next;
394 if (args.aux->l_next)
395 args.aux->l_next->l_prev = args.aux->l_prev;
397 args.aux->l_prev = newp->map->l_prev;
398 newp->map->l_prev = args.aux;
399 if (args.aux->l_prev != NULL)
400 args.aux->l_prev->l_next = args.aux;
401 args.aux->l_next = newp->map;
403 else
405 /* The object must be somewhere earlier in the
406 list. That's good, we only have to insert
407 an entry for the duplicate list. */
408 orig->unique = NULL; /* Never used. */
410 /* Now we have a problem. The element
411 pointing to ORIG in the unique list must
412 point to NEWP now. This is the only place
413 where we need this backreference and this
414 situation is really not that frequent. So
415 we don't use a double-linked list but
416 instead search for the preceding element. */
417 late = known;
418 while (late->unique != orig)
419 late = late->unique;
420 late->unique = newp;
423 else
425 /* This is easy. We just add the symbol right here. */
426 orig->unique = newp;
427 ++nlist;
428 /* Set the mark bit that says it's already in the list. */
429 args.aux->l_reserved = 1;
431 /* The only problem is that in the double linked
432 list of all objects we don't have this new
433 object at the correct place. Correct this here. */
434 if (args.aux->l_prev)
435 args.aux->l_prev->l_next = args.aux->l_next;
436 if (args.aux->l_next)
437 args.aux->l_next->l_prev = args.aux->l_prev;
439 args.aux->l_prev = newp->map->l_prev;
440 newp->map->l_prev = args.aux;
441 if (args.aux->l_prev != NULL)
442 args.aux->l_prev->l_next = args.aux;
443 args.aux->l_next = newp->map;
446 /* Move the tail pointers if necessary. */
447 if (orig == utail)
448 utail = newp;
449 if (orig == dtail)
450 dtail = newp;
452 /* Move on the insert point. */
453 orig = newp;
455 /* We always add an entry to the duplicate list. */
456 ++nduplist;
460 /* Terminate the list of dependencies and store the array address. */
461 if (needed != NULL)
463 needed[nneeded++] = NULL;
465 l->l_initfini = malloc (nneeded * sizeof needed[0]);
466 if (l->l_initfini == NULL)
467 _dl_signal_error (ENOMEM, map->l_name,
468 N_("cannot allocate dependency list"));
469 memcpy (l->l_initfini, needed, nneeded * sizeof needed[0]);
472 /* If we have no auxiliary objects just go on to the next map. */
473 if (runp->done)
475 runp = runp->unique;
476 while (runp != NULL && runp->done);
479 out:
480 if (errno == 0 && errno_saved != 0)
481 __set_errno (errno_saved);
483 if (map->l_initfini != NULL && map->l_type == lt_loaded)
485 /* This object was previously loaded as a dependency and we have
486 a separate l_initfini list. We don't need it anymore. */
487 assert (map->l_searchlist.r_list == NULL);
488 free (map->l_initfini);
491 /* Store the search list we built in the object. It will be used for
492 searches in the scope of this object. */
493 map->l_initfini =
494 (struct link_map **) malloc ((2 * nlist + 1
495 + (nlist == nduplist ? 0 : nduplist))
496 * sizeof (struct link_map *));
497 if (map->l_initfini == NULL)
498 _dl_signal_error (ENOMEM, map->l_name,
499 N_("cannot allocate symbol search list"));
502 map->l_searchlist.r_list = &map->l_initfini[nlist + 1];
503 map->l_searchlist.r_nlist = nlist;
505 for (nlist = 0, runp = known; runp; runp = runp->unique)
507 if (trace_mode && runp->map->l_faked)
508 /* This can happen when we trace the loading. */
509 --map->l_searchlist.r_nlist;
510 else
511 map->l_searchlist.r_list[nlist++] = runp->map;
513 /* Now clear all the mark bits we set in the objects on the search list
514 to avoid duplicates, so the next call starts fresh. */
515 runp->map->l_reserved = 0;
518 map->l_searchlist.r_nduplist = nduplist;
519 if (nlist == nduplist)
520 map->l_searchlist.r_duplist = map->l_searchlist.r_list;
521 else
523 unsigned int cnt;
525 map->l_searchlist.r_duplist = map->l_searchlist.r_list + nlist;
527 for (cnt = 0, runp = known; runp; runp = runp->dup)
528 if (trace_mode && runp->map->l_faked)
529 /* This can happen when we trace the loading. */
530 --map->l_searchlist.r_nduplist;
531 else
532 map->l_searchlist.r_duplist[cnt++] = runp->map;
535 /* Now determine the order in which the initialization has to happen. */
536 memcpy (map->l_initfini, map->l_searchlist.r_list,
537 nlist * sizeof (struct link_map *));
538 /* We can skip looking for the binary itself which is at the front
539 of the search list. Look through the list backward so that circular
540 dependencies are not changing the order. */
541 for (i = 1; i < nlist; ++i)
543 struct link_map *l = map->l_searchlist.r_list[i];
544 unsigned int j;
545 unsigned int k;
547 /* Find the place in the initfini list where the map is currently
548 located. */
549 for (j = 1; map->l_initfini[j] != l; ++j)
552 /* Find all object for which the current one is a dependency and
553 move the found object (if necessary) in front. */
554 for (k = j + 1; k < nlist; ++k)
556 struct link_map **runp;
558 runp = map->l_initfini[k]->l_initfini;
559 if (runp != NULL)
561 while (*runp != NULL)
562 if (*runp == l)
564 struct link_map *here = map->l_initfini[k];
566 /* Move it now. */
567 memmove (&map->l_initfini[j] + 1,
568 &map->l_initfini[j],
569 (k - j) * sizeof (struct link_map *));
570 map->l_initfini[j] = here;
572 break;
574 else
575 ++runp;
579 /* Terminate the list of dependencies. */
580 map->l_initfini[nlist] = NULL;
582 if (errno_reason)
583 _dl_signal_error (errno_reason == -1 ? 0 : errno_reason,
584 name ?: "", N_("cannot load shared object file"));