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. */
27 #include <sys/param.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. */
52 /* The arguments to openaux. */
58 /* The return value of openaux. */
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
),
75 /* We use a very special kind of list to track the path
76 through the list of loaded shared objects. We have to
77 produce a flat list with unique members of all involved objects.
81 int done
; /* Nonzero if this map was processed. */
82 struct link_map
*map
; /* The data. */
83 struct list
*next
; /* Elements for normal list. */
87 /* Macro to expand DST. It is an macro since we use `alloca'. */
88 #define expand_dst(l, str, fatal) \
90 const char *__str = (str); \
91 const char *__result = __str; \
92 size_t __cnt = DL_DST_COUNT(__str, 0); \
98 /* DST must not appear in SUID/SGID programs. */ \
99 if (__libc_enable_secure) \
100 _dl_signal_error (0, __str, \
101 N_("DST not allowed in SUID/SGID programs")); \
103 __newp = (char *) alloca (DL_DST_REQUIRED (l, __str, strlen (__str), \
106 __result = DL_DST_SUBSTITUTE (l, __str, __newp, 0); \
108 if (*__result == '\0') \
110 /* The replacement for the DST is not known. We can't \
113 _dl_signal_error (0, __str, N_("\
114 empty dynamics string token substitution")); \
117 /* This is for DT_AUXILIARY. */ \
118 if (__builtin_expect (_dl_debug_mask & DL_DEBUG_LIBS, 0)) \
119 _dl_debug_printf ("cannot load auxiliary `%s' because of" \
120 "empty dynamic string token " \
121 "substitution\n", __str); \
132 _dl_map_object_deps (struct link_map
*map
,
133 struct link_map
**preloads
, unsigned int npreloads
,
136 struct list known
[1 + npreloads
+ 1];
137 struct list
*runp
, *tail
;
138 unsigned int nlist
, i
;
143 const char *errstring
;
146 auto inline void preload (struct link_map
*map
);
148 inline void preload (struct link_map
*map
)
150 known
[nlist
].done
= 0;
151 known
[nlist
].map
= map
;
152 known
[nlist
].next
= &known
[nlist
+ 1];
155 /* We use `l_reserved' as a mark bit to detect objects we have
156 already put in the search list and avoid adding duplicate
157 elements later in the list. */
161 /* No loaded object so far. */
164 /* First load MAP itself. */
167 /* Add the preloaded items after MAP but before any of its dependencies. */
168 for (i
= 0; i
< npreloads
; ++i
)
169 preload (preloads
[i
]);
171 /* Terminate the lists. */
172 known
[nlist
- 1].next
= NULL
;
174 /* Pointer to last unique object. */
175 tail
= &known
[nlist
- 1];
177 /* Process each element of the search list, loading each of its
178 auxiliary objects and immediate dependencies. Auxiliary objects
179 will be added in the list before the object itself and
180 dependencies will be appended to the list as we step through it.
181 This produces a flat, ordered list that represents a
182 breadth-first search of the dependency tree.
184 The whole process is complicated by the fact that we better
185 should use alloca for the temporary list elements. But using
186 alloca means we cannot use recursive function calls. */
192 for (runp
= known
; runp
; )
194 struct link_map
*l
= runp
->map
;
195 struct link_map
**needed
= NULL
;
196 unsigned int nneeded
= 0;
198 /* Unless otherwise stated, this object is handled. */
201 /* Allocate a temporary record to contain the references to the
202 dependencies of this object. */
203 if (l
->l_searchlist
.r_list
== NULL
&& l
->l_initfini
== NULL
204 && l
!= map
&& l
->l_ldnum
> 0)
205 needed
= (struct link_map
**) alloca (l
->l_ldnum
206 * sizeof (struct link_map
*));
208 if (l
->l_info
[DT_NEEDED
] || l
->l_info
[AUXTAG
] || l
->l_info
[FILTERTAG
])
210 const char *strtab
= (const void *) D_PTR (l
, l_info
[DT_STRTAB
]);
211 struct openaux_args args
;
215 args
.strtab
= strtab
;
217 args
.trace_mode
= trace_mode
;
220 for (d
= l
->l_ld
; d
->d_tag
!= DT_NULL
; ++d
)
221 if (__builtin_expect (d
->d_tag
, DT_NEEDED
) == DT_NEEDED
)
223 /* Map in the needed object. */
224 struct link_map
*dep
;
227 /* Recognize DSTs. */
228 name
= expand_dst (l
, strtab
+ d
->d_un
.d_val
, 0);
229 /* Store the tag in the argument structure. */
232 err
= _dl_catch_error (&objname
, &errstring
, openaux
, &args
);
233 if (__builtin_expect (errstring
!= NULL
, 0))
244 if (! dep
->l_reserved
)
246 /* Allocate new entry. */
249 newp
= alloca (sizeof (struct list
));
251 /* Append DEP to the list. */
258 /* Set the mark bit that says it's already in the list. */
262 /* Remember this dependency. */
264 needed
[nneeded
++] = dep
;
266 else if (d
->d_tag
== DT_AUXILIARY
|| d
->d_tag
== DT_FILTER
)
270 /* Recognize DSTs. */
271 name
= expand_dst (l
, strtab
+ d
->d_un
.d_val
,
272 d
->d_tag
== DT_AUXILIARY
);
273 /* Store the tag in the argument structure. */
276 if (d
->d_tag
== DT_AUXILIARY
)
280 /* Say that we are about to load an auxiliary library. */
281 if (__builtin_expect (_dl_debug_mask
& DL_DEBUG_LIBS
, 0))
282 _dl_debug_printf ("load auxiliary object=%s"
283 " requested by file=%s\n", name
,
285 ? l
->l_name
: _dl_argv
[0]);
287 /* We must be prepared that the addressed shared
288 object is not available. */
289 err
= _dl_catch_error (&objname
, &errstring
, openaux
,
291 if (__builtin_expect (errstring
!= NULL
, 0))
293 /* We are not interested in the error message. */
294 assert (errstring
!= NULL
);
295 if (errstring
!= _dl_out_of_memory
)
296 free ((char *) errstring
);
298 /* Simply ignore this error and continue the work. */
306 /* Say that we are about to load an auxiliary library. */
307 if (__builtin_expect (_dl_debug_mask
& DL_DEBUG_LIBS
, 0))
308 _dl_debug_printf ("load filtered object=%s"
309 " requested by file=%s\n", name
,
311 ? l
->l_name
: _dl_argv
[0]);
313 /* For filter objects the dependency must be available. */
314 err
= _dl_catch_error (&objname
, &errstring
, openaux
,
316 if (__builtin_expect (errstring
!= NULL
, 0))
326 /* The auxiliary object is actually available.
327 Incorporate the map in all the lists. */
329 /* Allocate new entry. This always has to be done. */
330 newp
= alloca (sizeof (struct list
));
332 /* We want to insert the new map before the current one,
333 but we have no back links. So we copy the contents of
334 the current entry over. Note that ORIG and NEWP now
335 have switched their meanings. */
336 memcpy (newp
, orig
, sizeof (*newp
));
338 /* Initialize new entry. */
340 orig
->map
= args
.aux
;
342 /* Remember this dependency. */
344 needed
[nneeded
++] = args
.aux
;
346 /* We must handle two situations here: the map is new,
347 so we must add it in all three lists. If the map
348 is already known, we have two further possibilities:
349 - if the object is before the current map in the
350 search list, we do nothing. It is already found
352 - if the object is after the current one, we must
353 move it just before the current map to make sure
354 the symbols are found early enough
356 if (args
.aux
->l_reserved
)
358 /* The object is already somewhere in the list.
362 /* This object is already in the search list we
363 are building. Don't add a duplicate pointer.
364 Just added by _dl_map_object. */
365 for (late
= newp
; late
->next
; late
= late
->next
)
366 if (late
->next
->map
== args
.aux
)
371 /* The object is somewhere behind the current
372 position in the search path. We have to
373 move it to this earlier position. */
376 /* Now remove the later entry from the list
377 and adjust the tail pointer. */
378 if (tail
== late
->next
)
380 late
->next
= late
->next
->next
;
382 /* We must move the object earlier in the chain. */
383 if (args
.aux
->l_prev
)
384 args
.aux
->l_prev
->l_next
= args
.aux
->l_next
;
385 if (args
.aux
->l_next
)
386 args
.aux
->l_next
->l_prev
= args
.aux
->l_prev
;
388 args
.aux
->l_prev
= newp
->map
->l_prev
;
389 newp
->map
->l_prev
= args
.aux
;
390 if (args
.aux
->l_prev
!= NULL
)
391 args
.aux
->l_prev
->l_next
= args
.aux
;
392 args
.aux
->l_next
= newp
->map
;
396 /* The object must be somewhere earlier in the
397 list. That's good, we only have to insert
398 an entry for the duplicate list. */
399 orig
->next
= NULL
; /* Never used. */
401 /* Now we have a problem. The element
402 pointing to ORIG in the list must
403 point to NEWP now. This is the only place
404 where we need this backreference and this
405 situation is really not that frequent. So
406 we don't use a double-linked list but
407 instead search for the preceding element. */
409 while (late
->next
!= orig
)
416 /* This is easy. We just add the symbol right here. */
419 /* Set the mark bit that says it's already in the list. */
420 args
.aux
->l_reserved
= 1;
422 /* The only problem is that in the double linked
423 list of all objects we don't have this new
424 object at the correct place. Correct this here. */
425 if (args
.aux
->l_prev
)
426 args
.aux
->l_prev
->l_next
= args
.aux
->l_next
;
427 if (args
.aux
->l_next
)
428 args
.aux
->l_next
->l_prev
= args
.aux
->l_prev
;
430 args
.aux
->l_prev
= newp
->map
->l_prev
;
431 newp
->map
->l_prev
= args
.aux
;
432 if (args
.aux
->l_prev
!= NULL
)
433 args
.aux
->l_prev
->l_next
= args
.aux
;
434 args
.aux
->l_next
= newp
->map
;
437 /* Move the tail pointer if necessary. */
441 /* Move on the insert point. */
446 /* Terminate the list of dependencies and store the array address. */
449 needed
[nneeded
++] = NULL
;
451 l
->l_initfini
= malloc (nneeded
* sizeof needed
[0]);
452 if (l
->l_initfini
== NULL
)
453 _dl_signal_error (ENOMEM
, map
->l_name
,
454 N_("cannot allocate dependency list"));
455 memcpy (l
->l_initfini
, needed
, nneeded
* sizeof needed
[0]);
458 /* If we have no auxiliary objects just go on to the next map. */
462 while (runp
!= NULL
&& runp
->done
);
466 if (errno
== 0 && errno_saved
!= 0)
467 __set_errno (errno_saved
);
469 if (map
->l_initfini
!= NULL
&& map
->l_type
== lt_loaded
)
471 /* This object was previously loaded as a dependency and we have
472 a separate l_initfini list. We don't need it anymore. */
473 assert (map
->l_searchlist
.r_list
== NULL
);
474 free (map
->l_initfini
);
477 /* Store the search list we built in the object. It will be used for
478 searches in the scope of this object. */
480 (struct link_map
**) malloc ((2 * nlist
+ 1)
481 * sizeof (struct link_map
*));
482 if (map
->l_initfini
== NULL
)
483 _dl_signal_error (ENOMEM
, map
->l_name
,
484 N_("cannot allocate symbol search list"));
487 map
->l_searchlist
.r_list
= &map
->l_initfini
[nlist
+ 1];
488 map
->l_searchlist
.r_nlist
= nlist
;
490 for (nlist
= 0, runp
= known
; runp
; runp
= runp
->next
)
492 if (trace_mode
&& runp
->map
->l_faked
)
493 /* This can happen when we trace the loading. */
494 --map
->l_searchlist
.r_nlist
;
496 map
->l_searchlist
.r_list
[nlist
++] = runp
->map
;
498 /* Now clear all the mark bits we set in the objects on the search list
499 to avoid duplicates, so the next call starts fresh. */
500 runp
->map
->l_reserved
= 0;
503 /* Now determine the order in which the initialization has to happen. */
504 memcpy (map
->l_initfini
, map
->l_searchlist
.r_list
,
505 nlist
* sizeof (struct link_map
*));
506 /* We can skip looking for the binary itself which is at the front
507 of the search list. Look through the list backward so that circular
508 dependencies are not changing the order. */
509 for (i
= 1; i
< nlist
; ++i
)
511 struct link_map
*l
= map
->l_searchlist
.r_list
[i
];
515 /* Find the place in the initfini list where the map is currently
517 for (j
= 1; map
->l_initfini
[j
] != l
; ++j
)
520 /* Find all object for which the current one is a dependency and
521 move the found object (if necessary) in front. */
522 for (k
= j
+ 1; k
< nlist
; ++k
)
524 struct link_map
**runp
;
526 runp
= map
->l_initfini
[k
]->l_initfini
;
529 while (*runp
!= NULL
)
532 struct link_map
*here
= map
->l_initfini
[k
];
535 memmove (&map
->l_initfini
[j
] + 1,
537 (k
- j
) * sizeof (struct link_map
*));
538 map
->l_initfini
[j
] = here
;
547 /* Terminate the list of dependencies. */
548 map
->l_initfini
[nlist
] = NULL
;
551 _dl_signal_error (errno_reason
== -1 ? 0 : errno_reason
,