• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2008 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 "libc_init_common.h"
30 
31 #include <async_safe/log.h>
32 #include <elf.h>
33 #include <errno.h>
34 #include <fcntl.h>
35 #include <inttypes.h>
36 #include <stddef.h>
37 #include <stdint.h>
38 #include <stdio.h>
39 #include <stdlib.h>
40 #include <string.h>
41 #include <sys/auxv.h>
42 #include <sys/personality.h>
43 #include <sys/time.h>
44 #include <unistd.h>
45 
46 #include "heap_tagging.h"
47 #include "private/ScopedPthreadMutexLocker.h"
48 #include "private/WriteProtected.h"
49 #include "private/bionic_defs.h"
50 #include "private/bionic_globals.h"
51 #include "private/bionic_tls.h"
52 #include "private/thread_private.h"
53 #include "pthread_internal.h"
54 
55 extern "C" int __system_properties_init(void);
56 extern "C" void scudo_malloc_set_zero_contents(int);
57 extern "C" void scudo_malloc_set_pattern_fill_contents(int);
58 
59 __LIBC_HIDDEN__ WriteProtected<libc_globals> __libc_globals;
60 
61 // Not public, but well-known in the BSDs.
62 __BIONIC_WEAK_VARIABLE_FOR_NATIVE_BRIDGE
63 const char* __progname;
64 
__libc_init_globals()65 void __libc_init_globals() {
66   // Initialize libc globals that are needed in both the linker and in libc.
67   // In dynamic binaries, this is run at least twice for different copies of the
68   // globals, once for the linker's copy and once for the one in libc.so.
69   __libc_globals.initialize();
70   __libc_globals.mutate([](libc_globals* globals) {
71     __libc_init_vdso(globals);
72     __libc_init_setjmp_cookie(globals);
73   });
74 }
75 
76 #if !defined(__LP64__)
__check_max_thread_id()77 static void __check_max_thread_id() {
78   if (gettid() > 65535) {
79     async_safe_fatal("Limited by the size of pthread_mutex_t, 32 bit bionic libc only accepts "
80                      "pid <= 65535, but current pid is %d", gettid());
81   }
82 }
83 #endif
84 
arc4random_fork_handler()85 static void arc4random_fork_handler() {
86   _rs_forked = 1;
87   _thread_arc4_lock();
88 }
89 
90 __BIONIC_WEAK_FOR_NATIVE_BRIDGE
__libc_init_scudo()91 void __libc_init_scudo() {
92   // Heap tagging level *must* be set before interacting with Scudo, otherwise
93   // the primary will be mapped with PROT_MTE even if MTE is is not enabled in
94   // this process.
95   SetDefaultHeapTaggingLevel();
96 
97 // TODO(b/158870657) make this unconditional when all devices support SCUDO.
98 #if defined(USE_SCUDO)
99 #if defined(SCUDO_PATTERN_FILL_CONTENTS)
100   scudo_malloc_set_pattern_fill_contents(1);
101 #elif defined(SCUDO_ZERO_CONTENTS)
102   scudo_malloc_set_zero_contents(1);
103 #endif
104 #endif
105 }
106 
107 __BIONIC_WEAK_FOR_NATIVE_BRIDGE
108 __attribute__((no_sanitize("hwaddress", "memtag"))) void
__libc_init_mte_late()109 __libc_init_mte_late() {
110 #if defined(__aarch64__)
111   if (!__libc_shared_globals()->heap_tagging_upgrade_timer_sec) {
112     return;
113   }
114   struct sigevent event = {};
115   static timer_t timer;
116   event.sigev_notify = SIGEV_THREAD;
117   event.sigev_notify_function = [](union sigval) {
118     async_safe_format_log(ANDROID_LOG_INFO, "libc",
119                           "Downgrading MTE to async.");
120     ScopedPthreadMutexLocker l(&g_heap_tagging_lock);
121     SetHeapTaggingLevel(M_HEAP_TAGGING_LEVEL_ASYNC);
122     timer_delete(timer);
123   };
124 
125   if (timer_create(CLOCK_REALTIME, &event, &timer) == -1) {
126     async_safe_format_log(ANDROID_LOG_ERROR, "libc",
127                           "Failed to create MTE downgrade timer: %m");
128     // Revert back to ASYNC. If we fail to create or arm the timer, otherwise
129     // the process would be indefinitely stuck in SYNC.
130     SetHeapTaggingLevel(M_HEAP_TAGGING_LEVEL_ASYNC);
131     return;
132   }
133 
134   struct itimerspec timerspec = {};
135   timerspec.it_value.tv_sec =
136       __libc_shared_globals()->heap_tagging_upgrade_timer_sec;
137   if (timer_settime(timer, /* flags= */ 0, &timerspec, nullptr) == -1) {
138     async_safe_format_log(ANDROID_LOG_ERROR, "libc",
139                           "Failed to arm MTE downgrade timer: %m");
140     // Revert back to ASYNC. If we fail to create or arm the timer, otherwise
141     // the process would be indefinitely stuck in SYNC.
142     SetHeapTaggingLevel(M_HEAP_TAGGING_LEVEL_ASYNC);
143     timer_delete(timer);
144     return;
145   }
146   async_safe_format_log(
147       ANDROID_LOG_INFO, "libc", "Armed MTE downgrade timer for %" PRId64 " s",
148       __libc_shared_globals()->heap_tagging_upgrade_timer_sec);
149 #endif
150 }
151 
152 __BIONIC_WEAK_FOR_NATIVE_BRIDGE
__libc_add_main_thread()153 void __libc_add_main_thread() {
154   // Get the main thread from TLS and add it to the thread list.
155   pthread_internal_t* main_thread = __get_thread();
156   __pthread_internal_add(main_thread);
157 }
158 
__libc_init_common()159 void __libc_init_common() {
160   // Initialize various globals.
161   environ = __libc_shared_globals()->init_environ;
162   errno = 0;
163   setprogname(__libc_shared_globals()->init_progname ?: "<unknown>");
164 
165 #if !defined(__LP64__)
166   __check_max_thread_id();
167 #endif
168 
169   __libc_add_main_thread();
170 
171   __system_properties_init(); // Requires 'environ'.
172   __libc_init_fdsan(); // Requires system properties (for debug.fdsan).
173   __libc_init_fdtrack();
174 }
175 
__libc_init_fork_handler()176 void __libc_init_fork_handler() {
177   // Register atfork handlers to take and release the arc4random lock.
178   pthread_atfork(arc4random_fork_handler, _thread_arc4_unlock, _thread_arc4_unlock);
179 }
180 
181 extern "C" void scudo_malloc_set_add_large_allocation_slack(int add_slack);
182 
__libc_set_target_sdk_version(int target __unused)183 __BIONIC_WEAK_FOR_NATIVE_BRIDGE void __libc_set_target_sdk_version(int target __unused) {
184 #if defined(USE_SCUDO)
185   scudo_malloc_set_add_large_allocation_slack(target < __ANDROID_API_S__);
186 #endif
187 }
188 
__early_abort(int line)189 __noreturn static void __early_abort(int line) {
190   // We can't write to stdout or stderr because we're aborting before we've checked that
191   // it's safe for us to use those file descriptors. We probably can't strace either, so
192   // we rely on the fact that if we dereference a low address, either debuggerd or the
193   // kernel's crash dump will show the fault address.
194   *reinterpret_cast<int*>(line) = 0;
195   _exit(EXIT_FAILURE);
196 }
197 
198 // Force any of the stdin/stdout/stderr file descriptors that aren't
199 // open to be associated with /dev/null.
__nullify_closed_stdio()200 static void __nullify_closed_stdio() {
201   for (int i = 0; i < 3; i++) {
202     if (TEMP_FAILURE_RETRY(fcntl(i, F_GETFL)) == -1) {
203       // The only error we allow is that the file descriptor does not exist.
204       if (errno != EBADF) __early_abort(__LINE__);
205 
206       // This file descriptor wasn't open, so open /dev/null.
207       // init won't have /dev/null available, but SELinux provides an equivalent.
208       // This takes advantage of the fact that open() will take the lowest free
209       // file descriptor, and we're iterating in order from 0, but we'll
210       // double-check we got the right fd anyway...
211       int fd;
212       if (((fd = TEMP_FAILURE_RETRY(open("/dev/null", O_RDWR))) == -1 &&
213            (fd = TEMP_FAILURE_RETRY(open("/sys/fs/selinux/null", O_RDWR))) == -1) ||
214           fd != i) {
215         __early_abort(__LINE__);
216       }
217     }
218   }
219 }
220 
221 // Check if the environment variable definition at 'envstr'
222 // starts with '<name>=', and if so return the address of the
223 // first character after the equal sign. Otherwise return null.
env_match(const char * envstr,const char * name)224 static const char* env_match(const char* envstr, const char* name) {
225   size_t i = 0;
226 
227   while (envstr[i] == name[i] && name[i] != '\0') {
228     ++i;
229   }
230 
231   if (name[i] == '\0' && envstr[i] == '=') {
232     return envstr + i + 1;
233   }
234 
235   return nullptr;
236 }
237 
__is_valid_environment_variable(const char * name)238 static bool __is_valid_environment_variable(const char* name) {
239   // According to the kernel source, by default the kernel uses 32*PAGE_SIZE
240   // as the maximum size for an environment variable definition.
241   const int MAX_ENV_LEN = 32*4096;
242 
243   if (name == nullptr) {
244     return false;
245   }
246 
247   // Parse the string, looking for the first '=' there, and its size.
248   int pos = 0;
249   int first_equal_pos = -1;
250   while (pos < MAX_ENV_LEN) {
251     if (name[pos] == '\0') {
252       break;
253     }
254     if (name[pos] == '=' && first_equal_pos < 0) {
255       first_equal_pos = pos;
256     }
257     pos++;
258   }
259 
260   // Check that it's smaller than MAX_ENV_LEN (to detect non-zero terminated strings).
261   if (pos >= MAX_ENV_LEN) {
262     return false;
263   }
264 
265   // Check that it contains at least one equal sign that is not the first character
266   if (first_equal_pos < 1) {
267     return false;
268   }
269 
270   return true;
271 }
272 
__is_unsafe_environment_variable(const char * name)273 static bool __is_unsafe_environment_variable(const char* name) {
274   // None of these should be allowed when the AT_SECURE auxv
275   // flag is set. This flag is set to inform userspace that a
276   // security transition has occurred, for example, as a result
277   // of executing a setuid program or the result of an SELinux
278   // security transition.
279   static constexpr const char* UNSAFE_VARIABLE_NAMES[] = {
280       "ANDROID_DNS_MODE",
281       "GCONV_PATH",
282       "GETCONF_DIR",
283       "HOSTALIASES",
284       "JE_MALLOC_CONF",
285       "LD_AOUT_LIBRARY_PATH",
286       "LD_AOUT_PRELOAD",
287       "LD_AUDIT",
288       "LD_CONFIG_FILE",
289       "LD_DEBUG",
290       "LD_DEBUG_OUTPUT",
291       "LD_DYNAMIC_WEAK",
292       "LD_HWASAN",
293       "LD_LIBRARY_PATH",
294       "LD_ORIGIN_PATH",
295       "LD_PRELOAD",
296       "LD_PROFILE",
297       "LD_SHOW_AUXV",
298       "LD_USE_LOAD_BIAS",
299       "LIBC_DEBUG_MALLOC_OPTIONS",
300       "LIBC_HOOKS_ENABLE",
301       "LOCALDOMAIN",
302       "LOCPATH",
303       "MALLOC_CHECK_",
304       "MALLOC_CONF",
305       "MALLOC_TRACE",
306       "NIS_PATH",
307       "NLSPATH",
308       "RESOLV_HOST_CONF",
309       "RES_OPTIONS",
310       "SCUDO_OPTIONS",
311       "TMPDIR",
312       "TZDIR",
313   };
314   for (const auto& unsafe_variable_name : UNSAFE_VARIABLE_NAMES) {
315     if (env_match(name, unsafe_variable_name) != nullptr) {
316       return true;
317     }
318   }
319   return false;
320 }
321 
__sanitize_environment_variables(char ** env)322 static void __sanitize_environment_variables(char** env) {
323   char** src = env;
324   char** dst = env;
325   for (; src[0] != nullptr; ++src) {
326     if (!__is_valid_environment_variable(src[0])) {
327       continue;
328     }
329     // Remove various unsafe environment variables if we're loading a setuid program.
330     if (__is_unsafe_environment_variable(src[0])) {
331       continue;
332     }
333     dst[0] = src[0];
334     ++dst;
335   }
336   dst[0] = nullptr;
337 }
338 
__initialize_personality()339 static void __initialize_personality() {
340 #if !defined(__LP64__)
341   int old_value = personality(0xffffffff);
342   if (old_value == -1) {
343     async_safe_fatal("error getting old personality value: %s", strerror(errno));
344   }
345 
346   if (personality((static_cast<unsigned int>(old_value) & ~PER_MASK) | PER_LINUX32) == -1) {
347     async_safe_fatal("error setting PER_LINUX32 personality: %s", strerror(errno));
348   }
349 #endif
350 }
351 
__libc_init_AT_SECURE(char ** env)352 void __libc_init_AT_SECURE(char** env) {
353   // Check that the kernel provided a value for AT_SECURE.
354   errno = 0;
355   unsigned long is_AT_SECURE = getauxval(AT_SECURE);
356   if (errno != 0) __early_abort(__LINE__);
357 
358   // Always ensure that STDIN/STDOUT/STDERR exist. This prevents file
359   // descriptor confusion bugs where a parent process closes
360   // STD*, the exec()d process calls open() for an unrelated reason,
361   // the newly created file descriptor is assigned
362   // 0<=FD<=2, and unrelated code attempts to read / write to the STD*
363   // FDs.
364   // In particular, this can be a security bug for setuid/setgid programs.
365   // For example:
366   // https://www.freebsd.org/security/advisories/FreeBSD-SA-02:23.stdio.asc
367   // However, for robustness reasons, we don't limit these protections to
368   // just security critical executables.
369   //
370   // Init is excluded from these protections unless AT_SECURE is set, as
371   // /dev/null and/or /sys/fs/selinux/null will not be available at
372   // early boot.
373   if ((getpid() != 1) || is_AT_SECURE) {
374     __nullify_closed_stdio();
375   }
376 
377   if (is_AT_SECURE) {
378     __sanitize_environment_variables(env);
379   }
380 
381   // Now the environment has been sanitized, make it available.
382   environ = __libc_shared_globals()->init_environ = env;
383 
384   __initialize_personality();
385 }
386 
387 /* This function will be called during normal program termination
388  * to run the destructors that are listed in the .fini_array section
389  * of the executable, if any.
390  *
391  * 'fini_array' points to a list of function addresses. The first
392  * entry in the list has value -1, the last one has value 0.
393  */
__libc_fini(void * array)394 void __libc_fini(void* array) {
395   typedef void (*Dtor)();
396   Dtor* fini_array = reinterpret_cast<Dtor*>(array);
397   const Dtor minus1 = reinterpret_cast<Dtor>(static_cast<uintptr_t>(-1));
398 
399   // Validity check: the first entry must be -1.
400   if (array == nullptr || fini_array[0] != minus1) return;
401 
402   // Skip over it.
403   fini_array += 1;
404 
405   // Count the number of destructors.
406   int count = 0;
407   while (fini_array[count] != nullptr) {
408     ++count;
409   }
410 
411   // Now call each destructor in reverse order, ignoring any -1s.
412   while (count > 0) {
413     Dtor dtor = fini_array[--count];
414     if (dtor != minus1) dtor();
415   }
416 }
417