blob: 1860ccc144cd6bc7cc7e1a0b9fb1a2e785a92472 [file] [log] [blame]
Dimitry Ivanov3f660572016-09-09 10:00:39 -07001/*
2 * Copyright (C) 2016 The Android Open Source Project
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in
12 * the documentation and/or other materials provided with the
13 * distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
28
29#include "linker_main.h"
30
Ryan Prichard701bd0c2018-11-21 16:23:03 -080031#include <link.h>
32#include <sys/auxv.h>
33
Collin Fijalkovich47d27aa2021-03-24 10:17:39 -070034#include "linker.h"
Elliott Hughes838dbac2023-08-22 14:07:48 -070035#include "linker_auxv.h"
Collin Fijalkovich47d27aa2021-03-24 10:17:39 -070036#include "linker_cfi.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070037#include "linker_debug.h"
Ryan Prichard80e40f02019-10-31 19:54:46 -070038#include "linker_debuggerd.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070039#include "linker_gdb_support.h"
40#include "linker_globals.h"
41#include "linker_phdr.h"
Ryan Prichard339ecef2020-01-02 16:36:06 -080042#include "linker_relocate.h"
Peter Collingbourne1583cd22021-08-18 17:04:23 -070043#include "linker_relocs.h"
Ryan Prichard45d13492019-01-03 02:51:30 -080044#include "linker_tls.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070045#include "linker_utils.h"
46
Ryan Prichard9a027c72023-07-21 23:04:50 -070047#include "private/KernelArgumentBlock.h"
Ryan Prichard249757b2019-11-01 17:18:28 -070048#include "private/bionic_call_ifunc_resolver.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070049#include "private/bionic_globals.h"
50#include "private/bionic_tls.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070051
Ryan Prichard8f639a42018-10-01 23:10:05 -070052#include "android-base/unique_fd.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070053#include "android-base/strings.h"
54#include "android-base/stringprintf.h"
Dimitry Ivanov3f660572016-09-09 10:00:39 -070055
Christopher Ferris7a3681e2017-04-24 17:48:32 -070056#include <async_safe/log.h>
Ryan Prichard701bd0c2018-11-21 16:23:03 -080057#include <bionic/libc_init_common.h>
Ryan Prichard45d13492019-01-03 02:51:30 -080058#include <bionic/pthread_internal.h>
Christopher Ferris7a3681e2017-04-24 17:48:32 -070059
Dimitry Ivanov3f660572016-09-09 10:00:39 -070060#include <vector>
61
Ryan Prichard8f639a42018-10-01 23:10:05 -070062__LIBC_HIDDEN__ extern "C" void _start();
Dimitry Ivanov3f660572016-09-09 10:00:39 -070063
64static ElfW(Addr) get_elf_exec_load_bias(const ElfW(Ehdr)* elf);
65
Ryan Prichard9729f352018-07-13 22:40:26 -070066static void get_elf_base_from_phdr(const ElfW(Phdr)* phdr_table, size_t phdr_count,
67 ElfW(Addr)* base, ElfW(Addr)* load_bias);
68
Vic Yang1bf62b22019-08-13 14:53:28 -070069static void set_bss_vma_name(soinfo* si);
70
Mitch Phillips7c1f3772023-09-28 13:45:59 +020071void __libc_init_mte(const memtag_dynamic_entries_t* memtag_dynamic_entries, const void* phdr_start,
72 size_t phdr_count, uintptr_t load_bias, void* stack_top);
Evgenii Stepanov8564b8d2020-12-15 13:55:32 -080073
Dimitry Ivanov3f660572016-09-09 10:00:39 -070074// These should be preserved static to avoid emitting
75// RELATIVE relocations for the part of the code running
76// before linker links itself.
77
78// TODO (dimtiry): remove somain, rename solist to solist_head
79static soinfo* solist;
80static soinfo* sonext;
Evgenii Stepanov6bbb75a2023-12-06 18:54:45 +000081static soinfo* somain; // main process, always the one after libdl_info
Ryan Prichard04896452018-08-20 17:44:42 -070082static soinfo* solinker;
dimitry8b142562018-05-09 15:22:38 +020083static soinfo* vdso; // vdso if present
Dimitry Ivanov3f660572016-09-09 10:00:39 -070084
85void solist_add_soinfo(soinfo* si) {
86 sonext->next = si;
87 sonext = si;
88}
89
90bool solist_remove_soinfo(soinfo* si) {
91 soinfo *prev = nullptr, *trav;
92 for (trav = solist; trav != nullptr; trav = trav->next) {
93 if (trav == si) {
94 break;
95 }
96 prev = trav;
97 }
98
99 if (trav == nullptr) {
100 // si was not in solist
101 PRINT("name \"%s\"@%p is not in solist!", si->get_realpath(), si);
102 return false;
103 }
104
105 // prev will never be null, because the first entry in solist is
106 // always the static libdl_info.
George Burgess IV70591002017-06-27 16:23:45 -0700107 CHECK(prev != nullptr);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700108 prev->next = si->next;
109 if (si == sonext) {
110 sonext = prev;
111 }
112
113 return true;
114}
115
116soinfo* solist_get_head() {
117 return solist;
118}
119
120soinfo* solist_get_somain() {
121 return somain;
122}
123
dimitry8b142562018-05-09 15:22:38 +0200124soinfo* solist_get_vdso() {
125 return vdso;
126}
127
Elliott Hughes90f96b92019-05-09 15:56:39 -0700128bool g_is_ldd;
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700129int g_ld_debug_verbosity;
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700130
131static std::vector<std::string> g_ld_preload_names;
132
133static std::vector<soinfo*> g_ld_preloads;
134
135static void parse_path(const char* path, const char* delimiters,
136 std::vector<std::string>* resolved_paths) {
137 std::vector<std::string> paths;
138 split_path(path, delimiters, &paths);
139 resolve_paths(paths, resolved_paths);
140}
141
142static void parse_LD_LIBRARY_PATH(const char* path) {
143 std::vector<std::string> ld_libary_paths;
144 parse_path(path, ":", &ld_libary_paths);
145 g_default_namespace.set_ld_library_paths(std::move(ld_libary_paths));
146}
147
148static void parse_LD_PRELOAD(const char* path) {
149 g_ld_preload_names.clear();
150 if (path != nullptr) {
151 // We have historically supported ':' as well as ' ' in LD_PRELOAD.
152 g_ld_preload_names = android::base::Split(path, " :");
Josh Gao44f6e182017-10-18 17:25:24 -0700153 g_ld_preload_names.erase(std::remove_if(g_ld_preload_names.begin(), g_ld_preload_names.end(),
Josh Gao27242c62017-10-20 17:45:13 -0700154 [](const std::string& s) { return s.empty(); }),
155 g_ld_preload_names.end());
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700156 }
157}
158
159// An empty list of soinfos
160static soinfo_list_t g_empty_list;
161
Ryan Prichard07440a82018-11-22 03:16:06 -0800162static void add_vdso() {
163 ElfW(Ehdr)* ehdr_vdso = reinterpret_cast<ElfW(Ehdr)*>(getauxval(AT_SYSINFO_EHDR));
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700164 if (ehdr_vdso == nullptr) {
165 return;
166 }
167
168 soinfo* si = soinfo_alloc(&g_default_namespace, "[vdso]", nullptr, 0, 0);
169
170 si->phdr = reinterpret_cast<ElfW(Phdr)*>(reinterpret_cast<char*>(ehdr_vdso) + ehdr_vdso->e_phoff);
171 si->phnum = ehdr_vdso->e_phnum;
172 si->base = reinterpret_cast<ElfW(Addr)>(ehdr_vdso);
173 si->size = phdr_table_get_load_size(si->phdr, si->phnum);
174 si->load_bias = get_elf_exec_load_bias(ehdr_vdso);
175
176 si->prelink_image();
Ryan Prichard339ecef2020-01-02 16:36:06 -0800177 si->link_image(SymbolLookupList(si), si, nullptr, nullptr);
dimitryc18de1b2017-09-26 14:31:35 +0200178 // prevents accidental unloads...
179 si->set_dt_flags_1(si->get_dt_flags_1() | DF_1_NODELETE);
180 si->set_linked();
181 si->call_constructors();
dimitry8b142562018-05-09 15:22:38 +0200182
183 vdso = si;
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700184}
185
Ryan Prichard04896452018-08-20 17:44:42 -0700186// Initializes an soinfo's link_map_head field using other fields from the
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700187// soinfo (phdr, phnum, load_bias). The soinfo's realpath must not change after
188// this function is called.
189static void init_link_map_head(soinfo& info) {
Ryan Prichard04896452018-08-20 17:44:42 -0700190 auto& map = info.link_map_head;
191 map.l_addr = info.load_bias;
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700192 map.l_name = const_cast<char*>(info.get_realpath());
Ryan Prichard04896452018-08-20 17:44:42 -0700193 phdr_table_get_dynamic_section(info.phdr, info.phnum, info.load_bias, &map.l_ld, nullptr);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700194}
195
196extern "C" int __system_properties_init(void);
197
Ryan Prichard8f639a42018-10-01 23:10:05 -0700198struct ExecutableInfo {
199 std::string path;
200 struct stat file_stat;
201 const ElfW(Phdr)* phdr;
202 size_t phdr_count;
203 ElfW(Addr) entry_point;
Kalesh Singh4084b552024-03-13 13:35:49 -0700204 bool should_pad_segments;
Ryan Prichard8f639a42018-10-01 23:10:05 -0700205};
206
Vincent Donnefort2efa0172023-01-24 18:00:03 +0000207static ExecutableInfo get_executable_info(const char* arg_path) {
Ryan Prichard8f639a42018-10-01 23:10:05 -0700208 ExecutableInfo result = {};
Vincent Donnefort2efa0172023-01-24 18:00:03 +0000209 char const* exe_path = "/proc/self/exe";
Ryan Prichard8f639a42018-10-01 23:10:05 -0700210
Vincent Donnefort2efa0172023-01-24 18:00:03 +0000211 // Stat "/proc/self/exe" instead of executable_path because
212 // the executable could be unlinked by this point and it should
213 // not cause a crash (see http://b/31084669)
214 if (TEMP_FAILURE_RETRY(stat(exe_path, &result.file_stat) == -1)) {
215 // Fallback to argv[0] for the case where /proc isn't available
216 if (TEMP_FAILURE_RETRY(stat(arg_path, &result.file_stat) == -1)) {
217 async_safe_fatal("unable to stat either \"/proc/self/exe\" or \"%s\": %s",
218 arg_path, strerror(errno));
Tom Cherry66bc4282018-11-08 13:40:52 -0800219 }
Vincent Donnefort2efa0172023-01-24 18:00:03 +0000220 exe_path = arg_path;
221 }
222
223 // Path might be a symlink
224 char sym_path[PATH_MAX];
225 ssize_t sym_path_len = readlink(exe_path, sym_path, sizeof(sym_path));
226 if (sym_path_len > 0 && sym_path_len < static_cast<ssize_t>(sizeof(sym_path))) {
227 result.path = std::string(sym_path, sym_path_len);
Ryan Prichard8f639a42018-10-01 23:10:05 -0700228 } else {
Vincent Donnefort2efa0172023-01-24 18:00:03 +0000229 result.path = std::string(exe_path, strlen(exe_path));
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700230 }
231
Ryan Prichard07440a82018-11-22 03:16:06 -0800232 result.phdr = reinterpret_cast<const ElfW(Phdr)*>(getauxval(AT_PHDR));
233 result.phdr_count = getauxval(AT_PHNUM);
234 result.entry_point = getauxval(AT_ENTRY);
Ryan Prichard8f639a42018-10-01 23:10:05 -0700235 return result;
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700236}
237
Dimitry Ivanovd9e427c2016-11-22 16:55:25 -0800238#if defined(__LP64__)
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700239static char kFallbackLinkerPath[] = "/system/bin/linker64";
Dimitry Ivanovd9e427c2016-11-22 16:55:25 -0800240#else
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700241static char kFallbackLinkerPath[] = "/system/bin/linker";
Dimitry Ivanovd9e427c2016-11-22 16:55:25 -0800242#endif
243
Ryan Prichard8f639a42018-10-01 23:10:05 -0700244__printflike(1, 2)
245static void __linker_error(const char* fmt, ...) {
246 va_list ap;
dimitry04f7a792017-09-29 11:52:17 +0200247
Ryan Prichard8f639a42018-10-01 23:10:05 -0700248 va_start(ap, fmt);
249 async_safe_format_fd_va_list(STDERR_FILENO, fmt, ap);
250 va_end(ap);
251
252 va_start(ap, fmt);
253 async_safe_format_log_va_list(ANDROID_LOG_FATAL, "linker", fmt, ap);
254 va_end(ap);
255
dimitry04f7a792017-09-29 11:52:17 +0200256 _exit(EXIT_FAILURE);
Elliott Hughesad2d0382017-07-31 11:43:34 -0700257}
258
Ryan Prichard8f639a42018-10-01 23:10:05 -0700259static void __linker_cannot_link(const char* argv0) {
260 __linker_error("CANNOT LINK EXECUTABLE \"%s\": %s\n",
261 argv0,
262 linker_get_error_buffer());
263}
264
265// Load an executable. Normally the kernel has already loaded the executable when the linker
266// starts. The linker can be invoked directly on an executable, though, and then the linker must
267// load it. This function doesn't load dependencies or resolve relocations.
268static ExecutableInfo load_executable(const char* orig_path) {
269 ExecutableInfo result = {};
270
271 if (orig_path[0] != '/') {
272 __linker_error("error: expected absolute path: \"%s\"\n", orig_path);
273 }
274
275 off64_t file_offset;
276 android::base::unique_fd fd(open_executable(orig_path, &file_offset, &result.path));
277 if (fd.get() == -1) {
278 __linker_error("error: unable to open file \"%s\"\n", orig_path);
279 }
280
281 if (TEMP_FAILURE_RETRY(fstat(fd.get(), &result.file_stat)) == -1) {
282 __linker_error("error: unable to stat \"%s\": %s\n", result.path.c_str(), strerror(errno));
283 }
284
285 ElfReader elf_reader;
286 if (!elf_reader.Read(result.path.c_str(), fd.get(), file_offset, result.file_stat.st_size)) {
287 __linker_error("error: %s\n", linker_get_error_buffer());
288 }
Torne (Richard Coles)efbe9a52018-10-17 15:59:38 -0400289 address_space_params address_space;
290 if (!elf_reader.Load(&address_space)) {
Ryan Prichard8f639a42018-10-01 23:10:05 -0700291 __linker_error("error: %s\n", linker_get_error_buffer());
292 }
293
294 result.phdr = elf_reader.loaded_phdr();
295 result.phdr_count = elf_reader.phdr_count();
296 result.entry_point = elf_reader.entry_point();
Kalesh Singh4084b552024-03-13 13:35:49 -0700297 result.should_pad_segments = elf_reader.should_pad_segments();
Ryan Prichard8f639a42018-10-01 23:10:05 -0700298 return result;
299}
300
Tamas Petz8d55d182020-02-24 14:15:25 +0100301static void platform_properties_init() {
302#if defined(__aarch64__)
303 const unsigned long hwcap2 = getauxval(AT_HWCAP2);
304 g_platform_properties.bti_supported = (hwcap2 & HWCAP2_BTI) != 0;
305#endif
306}
307
Ryan Prichard8f639a42018-10-01 23:10:05 -0700308static ElfW(Addr) linker_main(KernelArgumentBlock& args, const char* exe_to_load) {
Dimitry Ivanov4cabfaa2017-03-07 11:19:05 -0800309 ProtectedDataGuard guard;
310
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700311#if TIMING
312 struct timeval t0, t1;
313 gettimeofday(&t0, 0);
314#endif
315
316 // Sanitize the environment.
Ryan Prichard48b11592018-11-22 02:41:36 -0800317 __libc_init_AT_SECURE(args.envp);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700318
319 // Initialize system properties
320 __system_properties_init(); // may use 'environ'
321
Tamas Petz8d55d182020-02-24 14:15:25 +0100322 // Initialize platform properties.
323 platform_properties_init();
324
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700325 // Register the debuggerd signal handler.
Ryan Prichard80e40f02019-10-31 19:54:46 -0700326 linker_debuggerd_init();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700327
328 g_linker_logger.ResetState();
329
Elliott Hughes838dbac2023-08-22 14:07:48 -0700330 // Enable debugging logs?
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700331 const char* LD_DEBUG = getenv("LD_DEBUG");
332 if (LD_DEBUG != nullptr) {
333 g_ld_debug_verbosity = atoi(LD_DEBUG);
334 }
335
Elliott Hughes838dbac2023-08-22 14:07:48 -0700336 if (getenv("LD_SHOW_AUXV") != nullptr) ld_show_auxv(args.auxv);
337
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700338#if defined(__LP64__)
339 INFO("[ Android dynamic linker (64-bit) ]");
340#else
341 INFO("[ Android dynamic linker (32-bit) ]");
342#endif
343
344 // These should have been sanitized by __libc_init_AT_SECURE, but the test
345 // doesn't cost us anything.
346 const char* ldpath_env = nullptr;
347 const char* ldpreload_env = nullptr;
348 if (!getauxval(AT_SECURE)) {
349 ldpath_env = getenv("LD_LIBRARY_PATH");
350 if (ldpath_env != nullptr) {
351 INFO("[ LD_LIBRARY_PATH set to \"%s\" ]", ldpath_env);
352 }
353 ldpreload_env = getenv("LD_PRELOAD");
354 if (ldpreload_env != nullptr) {
355 INFO("[ LD_PRELOAD set to \"%s\" ]", ldpreload_env);
356 }
357 }
358
Ryan Prichard8f639a42018-10-01 23:10:05 -0700359 const ExecutableInfo exe_info = exe_to_load ? load_executable(exe_to_load) :
Vincent Donnefort2efa0172023-01-24 18:00:03 +0000360 get_executable_info(args.argv[0]);
Ryan Prichard8f639a42018-10-01 23:10:05 -0700361
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700362 INFO("[ Linking executable \"%s\" ]", exe_info.path.c_str());
Martin Stjernholm95252ee2019-02-22 22:48:59 +0000363
Ryan Prichard04896452018-08-20 17:44:42 -0700364 // Initialize the main exe's soinfo.
Ryan Prichard8f639a42018-10-01 23:10:05 -0700365 soinfo* si = soinfo_alloc(&g_default_namespace,
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700366 exe_info.path.c_str(), &exe_info.file_stat,
Ryan Prichard8f639a42018-10-01 23:10:05 -0700367 0, RTLD_GLOBAL);
Ryan Prichard04896452018-08-20 17:44:42 -0700368 somain = si;
Ryan Prichard8f639a42018-10-01 23:10:05 -0700369 si->phdr = exe_info.phdr;
370 si->phnum = exe_info.phdr_count;
Kalesh Singh4084b552024-03-13 13:35:49 -0700371 si->set_should_pad_segments(exe_info.should_pad_segments);
Ryan Prichard04896452018-08-20 17:44:42 -0700372 get_elf_base_from_phdr(si->phdr, si->phnum, &si->base, &si->load_bias);
373 si->size = phdr_table_get_load_size(si->phdr, si->phnum);
374 si->dynamic = nullptr;
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700375 si->set_main_executable();
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700376 init_link_map_head(*si);
377
Vic Yang1bf62b22019-08-13 14:53:28 -0700378 set_bss_vma_name(si);
379
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700380 // Use the executable's PT_INTERP string as the solinker filename in the
381 // dynamic linker's module list. gdb reads both PT_INTERP and the module list,
382 // and if the paths for the linker are different, gdb will report that the
383 // PT_INTERP linker path was unloaded once the module list is initialized.
384 // There are three situations to handle:
385 // - the APEX linker (/system/bin/linker[64] -> /apex/.../linker[64])
386 // - the ASAN linker (/system/bin/linker_asan[64] -> /apex/.../linker[64])
387 // - the bootstrap linker (/system/bin/bootstrap/linker[64])
388 const char *interp = phdr_table_get_interpreter_name(somain->phdr, somain->phnum,
389 somain->load_bias);
390 if (interp == nullptr) {
391 // This case can happen if the linker attempts to execute itself
392 // (e.g. "linker64 /system/bin/linker64").
393 interp = kFallbackLinkerPath;
394 }
395 solinker->set_realpath(interp);
396 init_link_map_head(*solinker);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700397
Tamas Petz8d55d182020-02-24 14:15:25 +0100398#if defined(__aarch64__)
399 if (exe_to_load == nullptr) {
400 // Kernel does not add PROT_BTI to executable pages of the loaded ELF.
401 // Apply appropriate protections here if it is needed.
402 auto note_gnu_property = GnuPropertySection(somain);
403 if (note_gnu_property.IsBTICompatible() &&
404 (phdr_table_protect_segments(somain->phdr, somain->phnum, somain->load_bias,
Kalesh Singh4084b552024-03-13 13:35:49 -0700405 somain->should_pad_segments(), &note_gnu_property) < 0)) {
Tamas Petz8d55d182020-02-24 14:15:25 +0100406 __linker_error("error: can't protect segments for \"%s\": %s", exe_info.path.c_str(),
407 strerror(errno));
408 }
409 }
410#endif
411
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700412 // Register the main executable and the linker upfront to have
413 // gdb aware of them before loading the rest of the dependency
414 // tree.
Ryan Prichard04896452018-08-20 17:44:42 -0700415 //
416 // gdb expects the linker to be in the debug shared object list.
417 // Without this, gdb has trouble locating the linker's ".text"
418 // and ".plt" sections. Gdb could also potentially use this to
419 // relocate the offset of our exported 'rtld_db_dlactivity' symbol.
420 //
421 insert_link_map_into_debug_map(&si->link_map_head);
422 insert_link_map_into_debug_map(&solinker->link_map_head);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700423
Ryan Prichard07440a82018-11-22 03:16:06 -0800424 add_vdso();
Ryan Prichard14dd9922018-08-20 17:43:44 -0700425
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700426 ElfW(Ehdr)* elf_hdr = reinterpret_cast<ElfW(Ehdr)*>(si->base);
Elliott Hughes3bdb31b2017-01-07 10:38:20 -0800427
428 // We haven't supported non-PIE since Lollipop for security reasons.
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700429 if (elf_hdr->e_type != ET_DYN) {
Elliott Hughesad2d0382017-07-31 11:43:34 -0700430 // We don't use async_safe_fatal here because we don't want a tombstone:
431 // even after several years we still find ourselves on app compatibility
Elliott Hughes3bdb31b2017-01-07 10:38:20 -0800432 // investigations because some app's trying to launch an executable that
433 // hasn't worked in at least three years, and we've "helpfully" dropped a
434 // tombstone for them. The tombstone never provided any detail relevant to
435 // fixing the problem anyway, and the utility of drawing extra attention
436 // to the problem is non-existent at this late date.
Christopher Ferris7a3681e2017-04-24 17:48:32 -0700437 async_safe_format_fd(STDERR_FILENO,
Elliott Hughesad2d0382017-07-31 11:43:34 -0700438 "\"%s\": error: Android 5.0 and later only support "
439 "position-independent executables (-fPIE).\n",
440 g_argv[0]);
Elliott Hughes90f96b92019-05-09 15:56:39 -0700441 _exit(EXIT_FAILURE);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700442 }
443
444 // Use LD_LIBRARY_PATH and LD_PRELOAD (but only if we aren't setuid/setgid).
445 parse_LD_LIBRARY_PATH(ldpath_env);
446 parse_LD_PRELOAD(ldpreload_env);
447
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700448 std::vector<android_namespace_t*> namespaces = init_default_namespaces(exe_info.path.c_str());
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700449
Elliott Hughesad2d0382017-07-31 11:43:34 -0700450 if (!si->prelink_image()) __linker_cannot_link(g_argv[0]);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700451
452 // add somain to global group
453 si->set_dt_flags_1(si->get_dt_flags_1() | DF_1_GLOBAL);
Jiyong Park02586a22017-05-20 01:01:24 +0900454 // ... and add it to all other linked namespaces
455 for (auto linked_ns : namespaces) {
456 if (linked_ns != &g_default_namespace) {
457 linked_ns->add_soinfo(somain);
458 somain->add_secondary_namespace(linked_ns);
459 }
460 }
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700461
Ryan Pricharde5e69e02019-01-01 18:53:48 -0800462 linker_setup_exe_static_tls(g_argv[0]);
463
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700464 // Load ld_preloads and dependencies.
465 std::vector<const char*> needed_library_name_list;
466 size_t ld_preloads_count = 0;
467
468 for (const auto& ld_preload_name : g_ld_preload_names) {
469 needed_library_name_list.push_back(ld_preload_name.c_str());
470 ++ld_preloads_count;
471 }
472
473 for_each_dt_needed(si, [&](const char* name) {
474 needed_library_name_list.push_back(name);
475 });
476
477 const char** needed_library_names = &needed_library_name_list[0];
478 size_t needed_libraries_count = needed_library_name_list.size();
479
480 if (needed_libraries_count > 0 &&
Dimitry Ivanov7d429d32017-02-01 15:28:52 -0800481 !find_libraries(&g_default_namespace,
482 si,
483 needed_library_names,
484 needed_libraries_count,
485 nullptr,
486 &g_ld_preloads,
487 ld_preloads_count,
488 RTLD_GLOBAL,
489 nullptr,
490 true /* add_as_children */,
Jiyong Park02586a22017-05-20 01:01:24 +0900491 &namespaces)) {
Elliott Hughesad2d0382017-07-31 11:43:34 -0700492 __linker_cannot_link(g_argv[0]);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700493 } else if (needed_libraries_count == 0) {
Ryan Prichard339ecef2020-01-02 16:36:06 -0800494 if (!si->link_image(SymbolLookupList(si), si, nullptr, nullptr)) {
Elliott Hughesad2d0382017-07-31 11:43:34 -0700495 __linker_cannot_link(g_argv[0]);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700496 }
497 si->increment_ref_count();
498 }
Florian Mayere65e1932024-02-15 22:20:54 +0000499#if defined(__aarch64__)
500 // This has to happen after the find_libraries, which will have collected any possible
501 // libraries that request memtag_stack in the dynamic section.
502 __libc_init_mte(somain->memtag_dynamic_entries(), somain->phdr, somain->phnum, somain->load_bias,
503 args.argv);
504#endif
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700505
Ryan Pricharde5e69e02019-01-01 18:53:48 -0800506 linker_finalize_static_tls();
Ryan Prichard45d13492019-01-03 02:51:30 -0800507 __libc_init_main_thread_final();
508
Elliott Hughesad2d0382017-07-31 11:43:34 -0700509 if (!get_cfi_shadow()->InitialLinkDone(solist)) __linker_cannot_link(g_argv[0]);
Evgenii Stepanov0a3637d2016-07-06 13:20:59 -0700510
Dimitry Ivanov4cabfaa2017-03-07 11:19:05 -0800511 si->call_pre_init_constructors();
Dimitry Ivanov4cabfaa2017-03-07 11:19:05 -0800512 si->call_constructors();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700513
514#if TIMING
515 gettimeofday(&t1, nullptr);
Vic Yang7b9db342019-04-16 14:54:58 -0700516 PRINT("LINKER TIME: %s: %d microseconds", g_argv[0],
517 static_cast<int>(((static_cast<long long>(t1.tv_sec) * 1000000LL) +
518 static_cast<long long>(t1.tv_usec)) -
519 ((static_cast<long long>(t0.tv_sec) * 1000000LL) +
520 static_cast<long long>(t0.tv_usec))));
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700521#endif
522#if STATS
Vic Yang542db792019-07-25 10:39:27 -0700523 print_linker_stats();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700524#endif
Ryan Prichard78cd2832019-10-25 17:46:43 -0700525#if TIMING || STATS
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700526 fflush(stdout);
527#endif
528
Vic Yangbb7e1232019-01-29 20:23:16 -0800529 // We are about to hand control over to the executable loaded. We don't want
530 // to leave dirty pages behind unnecessarily.
531 purge_unused_memory();
532
Ryan Prichard8f639a42018-10-01 23:10:05 -0700533 ElfW(Addr) entry = exe_info.entry_point;
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700534 TRACE("[ Ready to execute \"%s\" @ %p ]", si->get_realpath(), reinterpret_cast<void*>(entry));
535 return entry;
536}
537
538/* Compute the load-bias of an existing executable. This shall only
539 * be used to compute the load bias of an executable or shared library
540 * that was loaded by the kernel itself.
541 *
542 * Input:
543 * elf -> address of ELF header, assumed to be at the start of the file.
544 * Return:
545 * load bias, i.e. add the value of any p_vaddr in the file to get
546 * the corresponding address in memory.
547 */
548static ElfW(Addr) get_elf_exec_load_bias(const ElfW(Ehdr)* elf) {
549 ElfW(Addr) offset = elf->e_phoff;
550 const ElfW(Phdr)* phdr_table =
551 reinterpret_cast<const ElfW(Phdr)*>(reinterpret_cast<uintptr_t>(elf) + offset);
552 const ElfW(Phdr)* phdr_end = phdr_table + elf->e_phnum;
553
554 for (const ElfW(Phdr)* phdr = phdr_table; phdr < phdr_end; phdr++) {
555 if (phdr->p_type == PT_LOAD) {
556 return reinterpret_cast<ElfW(Addr)>(elf) + phdr->p_offset - phdr->p_vaddr;
557 }
558 }
559 return 0;
560}
561
Ryan Prichard9729f352018-07-13 22:40:26 -0700562/* Find the load bias and base address of an executable or shared object loaded
563 * by the kernel. The ELF file's PHDR table must have a PT_PHDR entry.
564 *
565 * A VDSO doesn't have a PT_PHDR entry in its PHDR table.
566 */
567static void get_elf_base_from_phdr(const ElfW(Phdr)* phdr_table, size_t phdr_count,
568 ElfW(Addr)* base, ElfW(Addr)* load_bias) {
569 for (size_t i = 0; i < phdr_count; ++i) {
570 if (phdr_table[i].p_type == PT_PHDR) {
571 *load_bias = reinterpret_cast<ElfW(Addr)>(phdr_table) - phdr_table[i].p_vaddr;
572 *base = reinterpret_cast<ElfW(Addr)>(phdr_table) - phdr_table[i].p_offset;
573 return;
574 }
575 }
576 async_safe_fatal("Could not find a PHDR: broken executable?");
577}
578
Vic Yang1bf62b22019-08-13 14:53:28 -0700579/*
580 * Set anonymous VMA name for .bss section. For DSOs loaded by the linker, this
581 * is done by ElfReader. This function is here for DSOs loaded by the kernel,
582 * namely the linker itself and the main executable.
583 */
584static void set_bss_vma_name(soinfo* si) {
585 for (size_t i = 0; i < si->phnum; ++i) {
586 auto phdr = &si->phdr[i];
587
588 if (phdr->p_type != PT_LOAD) {
589 continue;
590 }
591
592 ElfW(Addr) seg_start = phdr->p_vaddr + si->load_bias;
Peter Collingbournebb11ee62022-05-02 12:26:16 -0700593 ElfW(Addr) seg_page_end = page_end(seg_start + phdr->p_memsz);
594 ElfW(Addr) seg_file_end = page_end(seg_start + phdr->p_filesz);
Vic Yang1bf62b22019-08-13 14:53:28 -0700595
596 if (seg_page_end > seg_file_end) {
597 prctl(PR_SET_VMA, PR_SET_VMA_ANON_NAME,
598 reinterpret_cast<void*>(seg_file_end), seg_page_end - seg_file_end,
599 ".bss");
600 }
601 }
602}
603
Ryan Prichard249757b2019-11-01 17:18:28 -0700604#if defined(USE_RELA)
Peter Collingbourne1583cd22021-08-18 17:04:23 -0700605using RelType = ElfW(Rela);
606const unsigned kRelTag = DT_RELA;
607const unsigned kRelSzTag = DT_RELASZ;
Ryan Prichard249757b2019-11-01 17:18:28 -0700608#else
Peter Collingbourne1583cd22021-08-18 17:04:23 -0700609using RelType = ElfW(Rel);
610const unsigned kRelTag = DT_REL;
611const unsigned kRelSzTag = DT_RELSZ;
612#endif
Ryan Prichard249757b2019-11-01 17:18:28 -0700613
Evgenii Stepanov6bbb75a2023-12-06 18:54:45 +0000614extern __LIBC_HIDDEN__ ElfW(Ehdr) __ehdr_start;
Peter Collingbourne1583cd22021-08-18 17:04:23 -0700615
616static void call_ifunc_resolvers_for_section(RelType* begin, RelType* end) {
617 auto ehdr = reinterpret_cast<ElfW(Addr)>(&__ehdr_start);
618 for (RelType *r = begin; r != end; ++r) {
619 if (ELFW(R_TYPE)(r->r_info) != R_GENERIC_IRELATIVE) {
620 continue;
621 }
622 ElfW(Addr)* offset = reinterpret_cast<ElfW(Addr)*>(ehdr + r->r_offset);
623#if defined(USE_RELA)
624 ElfW(Addr) resolver = ehdr + r->r_addend;
625#else
626 ElfW(Addr) resolver = ehdr + *offset;
627#endif
Ryan Prichard249757b2019-11-01 17:18:28 -0700628 *offset = __bionic_call_ifunc_resolver(resolver);
629 }
630}
Peter Collingbourne1583cd22021-08-18 17:04:23 -0700631
632static void call_ifunc_resolvers() {
633 // Find the IRELATIVE relocations using the DT_JMPREL and DT_PLTRELSZ, or DT_RELA? and DT_RELA?SZ
634 // dynamic tags.
635 auto ehdr = reinterpret_cast<ElfW(Addr)>(&__ehdr_start);
636 auto* phdr = reinterpret_cast<ElfW(Phdr)*>(ehdr + __ehdr_start.e_phoff);
637 for (size_t i = 0; i != __ehdr_start.e_phnum; ++i) {
638 if (phdr[i].p_type != PT_DYNAMIC) {
639 continue;
640 }
641 auto *dyn = reinterpret_cast<ElfW(Dyn)*>(ehdr + phdr[i].p_vaddr);
642 ElfW(Addr) pltrel = 0, pltrelsz = 0, rel = 0, relsz = 0;
643 for (size_t j = 0, size = phdr[i].p_filesz / sizeof(ElfW(Dyn)); j != size; ++j) {
644 if (dyn[j].d_tag == DT_JMPREL) {
645 pltrel = dyn[j].d_un.d_ptr;
646 } else if (dyn[j].d_tag == DT_PLTRELSZ) {
647 pltrelsz = dyn[j].d_un.d_ptr;
648 } else if (dyn[j].d_tag == kRelTag) {
649 rel = dyn[j].d_un.d_ptr;
650 } else if (dyn[j].d_tag == kRelSzTag) {
651 relsz = dyn[j].d_un.d_ptr;
652 }
653 }
654 if (pltrel && pltrelsz) {
655 call_ifunc_resolvers_for_section(reinterpret_cast<RelType*>(ehdr + pltrel),
656 reinterpret_cast<RelType*>(ehdr + pltrel + pltrelsz));
657 }
658 if (rel && relsz) {
659 call_ifunc_resolvers_for_section(reinterpret_cast<RelType*>(ehdr + rel),
660 reinterpret_cast<RelType*>(ehdr + rel + relsz));
661 }
662 }
663}
Ryan Prichard249757b2019-11-01 17:18:28 -0700664
Ryan Prichard94a8e852019-11-05 14:19:18 -0800665// Usable before ifunc resolvers have been called. This function is compiled with -ffreestanding.
666static void linker_memclr(void* dst, size_t cnt) {
667 for (size_t i = 0; i < cnt; ++i) {
668 reinterpret_cast<char*>(dst)[i] = '\0';
669 }
670}
671
Ryan Prichard1990ba52019-02-07 21:31:31 -0800672// Detect an attempt to run the linker on itself. e.g.:
673// /system/bin/linker64 /system/bin/linker64
674// Use priority-1 to run this constructor before other constructors.
675__attribute__((constructor(1))) static void detect_self_exec() {
676 // Normally, the linker initializes the auxv global before calling its
677 // constructors. If the linker loads itself, though, the first loader calls
678 // the second loader's constructors before calling __linker_init.
679 if (__libc_shared_globals()->auxv != nullptr) {
680 return;
681 }
682#if defined(__i386__)
683 // We don't have access to the auxv struct from here, so use the int 0x80
684 // fallback.
685 __libc_sysinfo = reinterpret_cast<void*>(__libc_int0x80);
686#endif
687 __linker_error("error: linker cannot load itself\n");
688}
689
Ryan Prichard742982d2018-05-30 22:32:17 -0700690static ElfW(Addr) __attribute__((noinline))
Ryan Prichard04896452018-08-20 17:44:42 -0700691__linker_init_post_relocation(KernelArgumentBlock& args, soinfo& linker_so);
Ryan Prichard742982d2018-05-30 22:32:17 -0700692
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700693/*
694 * This is the entry point for the linker, called from begin.S. This
695 * method is responsible for fixing the linker's own relocations, and
696 * then calling __linker_init_post_relocation().
697 *
698 * Because this method is called before the linker has fixed it's own
699 * relocations, any attempt to reference an extern variable, extern
700 * function, or other GOT reference will generate a segfault.
701 */
702extern "C" ElfW(Addr) __linker_init(void* raw_args) {
Ryan Prichard67e8f222023-08-18 16:21:48 -0700703 // Unlock the loader mutex immediately before transferring to the executable's
704 // entry point. This must happen after destructors are called in this function
705 // (e.g. ~soinfo), so declare this variable very early.
706 struct DlMutexUnlocker {
707 ~DlMutexUnlocker() { pthread_mutex_unlock(&g_dl_mutex); }
708 } unlocker;
709
Ryan Prichard9cfca862018-11-22 02:44:09 -0800710 // Initialize TLS early so system calls and errno work.
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700711 KernelArgumentBlock args(raw_args);
Ryan Prichard94a8e852019-11-05 14:19:18 -0800712 bionic_tcb temp_tcb __attribute__((uninitialized));
713 linker_memclr(&temp_tcb, sizeof(temp_tcb));
Ryan Prichard45d13492019-01-03 02:51:30 -0800714 __libc_init_main_thread_early(args, &temp_tcb);
Ryan Prichard27475b52018-05-17 17:14:18 -0700715
Ryan Prichard8f639a42018-10-01 23:10:05 -0700716 // When the linker is run by itself (rather than as an interpreter for
717 // another program), AT_BASE is 0.
Ryan Prichard07440a82018-11-22 03:16:06 -0800718 ElfW(Addr) linker_addr = getauxval(AT_BASE);
Ryan Prichard9729f352018-07-13 22:40:26 -0700719 if (linker_addr == 0) {
Ryan Prichard1990ba52019-02-07 21:31:31 -0800720 // The AT_PHDR and AT_PHNUM aux values describe this linker instance, so use
721 // the phdr to find the linker's base address.
Ryan Prichard9729f352018-07-13 22:40:26 -0700722 ElfW(Addr) load_bias;
723 get_elf_base_from_phdr(
Ryan Prichard07440a82018-11-22 03:16:06 -0800724 reinterpret_cast<ElfW(Phdr)*>(getauxval(AT_PHDR)), getauxval(AT_PHNUM),
Ryan Prichard9729f352018-07-13 22:40:26 -0700725 &linker_addr, &load_bias);
726 }
George Burgess IV70591002017-06-27 16:23:45 -0700727
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700728 ElfW(Ehdr)* elf_hdr = reinterpret_cast<ElfW(Ehdr)*>(linker_addr);
729 ElfW(Phdr)* phdr = reinterpret_cast<ElfW(Phdr)*>(linker_addr + elf_hdr->e_phoff);
730
Ryan Prichard249757b2019-11-01 17:18:28 -0700731 // string.h functions must not be used prior to calling the linker's ifunc resolvers.
Peter Collingbourne1583cd22021-08-18 17:04:23 -0700732 call_ifunc_resolvers();
Ryan Prichard249757b2019-11-01 17:18:28 -0700733
Ryan Prichard04896452018-08-20 17:44:42 -0700734 soinfo tmp_linker_so(nullptr, nullptr, nullptr, 0, 0);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700735
Ryan Prichard04896452018-08-20 17:44:42 -0700736 tmp_linker_so.base = linker_addr;
737 tmp_linker_so.size = phdr_table_get_load_size(phdr, elf_hdr->e_phnum);
Peter Collingbourne1583cd22021-08-18 17:04:23 -0700738 tmp_linker_so.load_bias = get_elf_exec_load_bias(elf_hdr);
Ryan Prichard04896452018-08-20 17:44:42 -0700739 tmp_linker_so.dynamic = nullptr;
740 tmp_linker_so.phdr = phdr;
741 tmp_linker_so.phnum = elf_hdr->e_phnum;
742 tmp_linker_so.set_linker_flag();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700743
744 // Prelink the linker so we can access linker globals.
Ryan Prichard04896452018-08-20 17:44:42 -0700745 if (!tmp_linker_so.prelink_image()) __linker_cannot_link(args.argv[0]);
Ryan Prichard339ecef2020-01-02 16:36:06 -0800746 if (!tmp_linker_so.link_image(SymbolLookupList(&tmp_linker_so), &tmp_linker_so, nullptr, nullptr)) __linker_cannot_link(args.argv[0]);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700747
Ryan Prichard04896452018-08-20 17:44:42 -0700748 return __linker_init_post_relocation(args, tmp_linker_so);
Ryan Prichard742982d2018-05-30 22:32:17 -0700749}
750
751/*
752 * This code is called after the linker has linked itself and fixed its own
753 * GOT. It is safe to make references to externs and other non-local data at
754 * this point. The compiler sometimes moves GOT references earlier in a
755 * function, so avoid inlining this function (http://b/80503879).
756 */
757static ElfW(Addr) __attribute__((noinline))
Ryan Prichard04896452018-08-20 17:44:42 -0700758__linker_init_post_relocation(KernelArgumentBlock& args, soinfo& tmp_linker_so) {
Ryan Prichard9cfca862018-11-22 02:44:09 -0800759 // Finish initializing the main thread.
Ryan Prichard07440a82018-11-22 03:16:06 -0800760 __libc_init_main_thread_late();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700761
762 // We didn't protect the linker's RELRO pages in link_image because we
763 // couldn't make system calls on x86 at that point, but we can now...
Ryan Prichard04896452018-08-20 17:44:42 -0700764 if (!tmp_linker_so.protect_relro()) __linker_cannot_link(args.argv[0]);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700765
Vic Yang1bf62b22019-08-13 14:53:28 -0700766 // And we can set VMA name for the bss section now
767 set_bss_vma_name(&tmp_linker_so);
768
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700769 // Initialize the linker's static libc's globals
Ryan Prichard07440a82018-11-22 03:16:06 -0800770 __libc_init_globals();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700771
Ryan Prichard67e8f222023-08-18 16:21:48 -0700772 // A constructor could spawn a thread that calls into the loader, so as soon
773 // as we've called a constructor, we need to hold the lock until transferring
774 // to the entry point.
775 pthread_mutex_lock(&g_dl_mutex);
776
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700777 // Initialize the linker's own global variables
Ryan Prichard04896452018-08-20 17:44:42 -0700778 tmp_linker_so.call_constructors();
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700779
Ryan Prichardbb1e3732021-01-12 23:09:10 -0800780 // Setting the linker soinfo's soname can allocate heap memory, so delay it until here.
781 for (const ElfW(Dyn)* d = tmp_linker_so.dynamic; d->d_tag != DT_NULL; ++d) {
782 if (d->d_tag == DT_SONAME) {
783 tmp_linker_so.set_soname(tmp_linker_so.get_string(d->d_un.d_val));
784 }
785 }
786
Ryan Prichard8f639a42018-10-01 23:10:05 -0700787 // When the linker is run directly rather than acting as PT_INTERP, parse
788 // arguments and determine the executable to load. When it's instead acting
789 // as PT_INTERP, AT_ENTRY will refer to the loaded executable rather than the
790 // linker's _start.
791 const char* exe_to_load = nullptr;
Ryan Prichard07440a82018-11-22 03:16:06 -0800792 if (getauxval(AT_ENTRY) == reinterpret_cast<uintptr_t>(&_start)) {
Elliott Hughes90f96b92019-05-09 15:56:39 -0700793 if (args.argc == 3 && !strcmp(args.argv[1], "--list")) {
794 // We're being asked to behave like ldd(1).
795 g_is_ldd = true;
796 exe_to_load = args.argv[2];
797 } else if (args.argc <= 1 || !strcmp(args.argv[1], "--help")) {
Ryan Prichard8f639a42018-10-01 23:10:05 -0700798 async_safe_format_fd(STDOUT_FILENO,
Elliott Hughes90f96b92019-05-09 15:56:39 -0700799 "Usage: %s [--list] PROGRAM [ARGS-FOR-PROGRAM...]\n"
800 " %s [--list] path.zip!/PROGRAM [ARGS-FOR-PROGRAM...]\n"
Ryan Prichard8f639a42018-10-01 23:10:05 -0700801 "\n"
802 "A helper program for linking dynamic executables. Typically, the kernel loads\n"
803 "this program because it's the PT_INTERP of a dynamic executable.\n"
804 "\n"
805 "This program can also be run directly to load and run a dynamic executable. The\n"
806 "executable can be inside a zip file if it's stored uncompressed and at a\n"
Elliott Hughes90f96b92019-05-09 15:56:39 -0700807 "page-aligned offset.\n"
808 "\n"
809 "The --list option gives behavior equivalent to ldd(1) on other systems.\n",
Ryan Prichard8f639a42018-10-01 23:10:05 -0700810 args.argv[0], args.argv[0]);
Elliott Hughes90f96b92019-05-09 15:56:39 -0700811 _exit(EXIT_SUCCESS);
812 } else {
813 exe_to_load = args.argv[1];
814 __libc_shared_globals()->initial_linker_arg_count = 1;
Ryan Prichard8f639a42018-10-01 23:10:05 -0700815 }
Dimitry Ivanov9b1cc4b2017-03-23 16:17:15 -0700816 }
817
Ryan Prichard8f639a42018-10-01 23:10:05 -0700818 // store argc/argv/envp to use them for calling constructors
Ryan Prichardabf736a2018-11-22 02:40:17 -0800819 g_argc = args.argc - __libc_shared_globals()->initial_linker_arg_count;
820 g_argv = args.argv + __libc_shared_globals()->initial_linker_arg_count;
Ryan Prichard8f639a42018-10-01 23:10:05 -0700821 g_envp = args.envp;
Ryan Prichard48b11592018-11-22 02:41:36 -0800822 __libc_shared_globals()->init_progname = g_argv[0];
Ryan Prichard8f639a42018-10-01 23:10:05 -0700823
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700824 // Initialize static variables. Note that in order to
825 // get correct libdl_info we need to call constructors
826 // before get_libdl_info().
Ryan Prichardcf9ed122019-06-04 20:56:56 -0700827 sonext = solist = solinker = get_libdl_info(tmp_linker_so);
Ryan Prichard04896452018-08-20 17:44:42 -0700828 g_default_namespace.add_soinfo(solinker);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700829
Ryan Prichard8f639a42018-10-01 23:10:05 -0700830 ElfW(Addr) start_address = linker_main(args, exe_to_load);
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700831
Elliott Hughes90f96b92019-05-09 15:56:39 -0700832 if (g_is_ldd) _exit(EXIT_SUCCESS);
833
Dimitry Ivanov3f660572016-09-09 10:00:39 -0700834 INFO("[ Jumping to _start (%p)... ]", reinterpret_cast<void*>(start_address));
835
836 // Return the address that the calling assembly stub should jump to.
837 return start_address;
838}