/* * Copyright (C) 2019 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #define LOG_TAG "nativeloader" #include "public_libraries.h" #include #include #include #include #include #include #include #include #include #include #if defined(ART_TARGET_ANDROID) #include #endif #include "utils.h" namespace android::nativeloader { using android::base::ErrnoError; using android::base::Result; using internal::ConfigEntry; using internal::ParseConfig; using internal::ParseJniConfig; using std::literals::string_literals::operator""s; namespace { constexpr const char* kDefaultPublicLibrariesFile = "/etc/public.libraries.txt"; constexpr const char* kExtendedPublicLibrariesFilePrefix = "public.libraries-"; constexpr const char* kExtendedPublicLibrariesFileSuffix = ".txt"; constexpr const char* kJniConfigFile = "/linkerconfig/jni.config.txt"; constexpr const char* kVendorPublicLibrariesFile = "/vendor/etc/public.libraries.txt"; constexpr const char* kLlndkLibrariesFile = "/apex/com.android.vndk.v{}/etc/llndk.libraries.{}.txt"; constexpr const char* kVndkLibrariesFile = "/apex/com.android.vndk.v{}/etc/vndksp.libraries.{}.txt"; const std::vector kArtApexPublicLibraries = { "libnativehelper.so", }; const std::vector ki18nApexPublicLibraries = { "libicuuc.so", "libicui18n.so", }; constexpr const char* kI18nApexLibPath = "/apex/com.android.i18n/" LIB; constexpr const char* kNeuralNetworksApexPublicLibrary = "libneuralnetworks.so"; constexpr const char* kStatsdApexPublicLibrary = "libstats_jni.so"; // TODO(b/130388701): do we need this? std::string root_dir() { static const char* android_root_env = getenv("ANDROID_ROOT"); return android_root_env != nullptr ? android_root_env : "/system"; } bool debuggable() { static bool debuggable = android::base::GetBoolProperty("ro.debuggable", false); return debuggable; } std::string vndk_version_str(bool use_product_vndk) { if (use_product_vndk) { static std::string product_vndk_version = get_vndk_version(true); return product_vndk_version; } else { static std::string vendor_vndk_version = get_vndk_version(false); return vendor_vndk_version; } } // For debuggable platform builds use ANDROID_ADDITIONAL_PUBLIC_LIBRARIES environment // variable to add libraries to the list. This is intended for platform tests only. std::string additional_public_libraries() { if (debuggable()) { const char* val = getenv("ANDROID_ADDITIONAL_PUBLIC_LIBRARIES"); return val ? val : ""; } return ""; } // insert vndk version in every {} placeholder void InsertVndkVersionStr(std::string* file_name, bool use_product_vndk) { CHECK(file_name != nullptr); auto version = vndk_version_str(use_product_vndk); size_t pos = file_name->find("{}"); while (pos != std::string::npos) { file_name->replace(pos, 2, version); pos = file_name->find("{}", pos + version.size()); } } const std::function(const struct ConfigEntry&)> always_true = [](const struct ConfigEntry&) -> Result { return true; }; Result> ReadConfig( const std::string& configFile, const std::function(const ConfigEntry& /* entry */)>& filter_fn) { std::string file_content; if (!base::ReadFileToString(configFile, &file_content)) { return ErrnoError(); } Result> result = ParseConfig(file_content, filter_fn); if (!result.ok()) { return Errorf("Cannot parse {}: {}", configFile, result.error().message()); } return result; } void ReadExtensionLibraries(const char* dirname, std::vector* sonames) { std::unique_ptr dir(opendir(dirname), closedir); if (dir != nullptr) { // Failing to opening the dir is not an error, which can happen in // webview_zygote. while (struct dirent* ent = readdir(dir.get())) { if (ent->d_type != DT_REG && ent->d_type != DT_LNK) { continue; } const std::string filename(ent->d_name); std::string_view fn = filename; if (android::base::ConsumePrefix(&fn, kExtendedPublicLibrariesFilePrefix) && android::base::ConsumeSuffix(&fn, kExtendedPublicLibrariesFileSuffix)) { const std::string company_name(fn); const std::string config_file_path = dirname + "/"s + filename; LOG_ALWAYS_FATAL_IF( company_name.empty(), "Error extracting company name from public native library list file path \"%s\"", config_file_path.c_str()); auto ret = ReadConfig( config_file_path, [&company_name](const struct ConfigEntry& entry) -> Result { if (android::base::StartsWith(entry.soname, "lib") && android::base::EndsWith(entry.soname, "." + company_name + ".so")) { return true; } else { return Errorf("Library name \"{}\" does not end with the company name {}.", entry.soname, company_name); } }); if (ret.ok()) { sonames->insert(sonames->end(), ret->begin(), ret->end()); } else { LOG_ALWAYS_FATAL("Error reading public native library list from \"%s\": %s", config_file_path.c_str(), ret.error().message().c_str()); } } } } } static std::string InitDefaultPublicLibraries(bool for_preload) { std::string config_file = root_dir() + kDefaultPublicLibrariesFile; auto sonames = ReadConfig(config_file, [&for_preload](const struct ConfigEntry& entry) -> Result { if (for_preload) { return !entry.nopreload; } else { return true; } }); if (!sonames.ok()) { LOG_ALWAYS_FATAL("Error reading public native library list from \"%s\": %s", config_file.c_str(), sonames.error().message().c_str()); return ""; } std::string additional_libs = additional_public_libraries(); if (!additional_libs.empty()) { auto vec = base::Split(additional_libs, ":"); std::copy(vec.begin(), vec.end(), std::back_inserter(*sonames)); } // If this is for preloading libs, don't remove the libs from APEXes. if (for_preload) { return android::base::Join(*sonames, ':'); } // Remove the public libs in the i18n namespace. // These libs are listed in public.android.txt, but we don't want the rest of android // in default namespace to dlopen the libs. // For example, libicuuc.so is exposed to classloader namespace from art namespace. // Unfortunately, it does not have stable C symbols, and default namespace should only use // stable symbols in libandroidicu.so. http://b/120786417 for (const std::string& lib_name : ki18nApexPublicLibraries) { std::string path(kI18nApexLibPath); path.append("/").append(lib_name); struct stat s; // Do nothing if the path in /apex does not exist. // Runtime APEX must be mounted since libnativeloader is in the same APEX if (stat(path.c_str(), &s) != 0) { continue; } auto it = std::find(sonames->begin(), sonames->end(), lib_name); if (it != sonames->end()) { sonames->erase(it); } } // Remove the public libs in the nnapi namespace. auto it = std::find(sonames->begin(), sonames->end(), kNeuralNetworksApexPublicLibrary); if (it != sonames->end()) { sonames->erase(it); } return android::base::Join(*sonames, ':'); } static std::string InitArtPublicLibraries() { CHECK_GT((int)kArtApexPublicLibraries.size(), 0); std::string list = android::base::Join(kArtApexPublicLibraries, ":"); std::string additional_libs = additional_public_libraries(); if (!additional_libs.empty()) { list = list + ':' + additional_libs; } return list; } static std::string InitI18nPublicLibraries() { static_assert(sizeof(ki18nApexPublicLibraries) > 0, "ki18nApexPublicLibraries is empty"); std::string list = android::base::Join(ki18nApexPublicLibraries, ":"); return list; } static std::string InitVendorPublicLibraries() { // This file is optional, quietly ignore if the file does not exist. auto sonames = ReadConfig(kVendorPublicLibrariesFile, always_true); if (!sonames.ok()) { return ""; } return android::base::Join(*sonames, ':'); } // read /system/etc/public.libraries-.txt, // /system_ext/etc/public.libraries-.txt and // /product/etc/public.libraries-.txt which contain partner defined // system libs that are exposed to apps. The libs in the txt files must be // named as lib..so. static std::string InitExtendedPublicLibraries() { std::vector sonames; ReadExtensionLibraries("/system/etc", &sonames); ReadExtensionLibraries("/system_ext/etc", &sonames); ReadExtensionLibraries("/product/etc", &sonames); return android::base::Join(sonames, ':'); } static std::string InitLlndkLibrariesVendor() { std::string config_file = kLlndkLibrariesFile; InsertVndkVersionStr(&config_file, false); auto sonames = ReadConfig(config_file, always_true); if (!sonames.ok()) { LOG_ALWAYS_FATAL("%s: %s", config_file.c_str(), sonames.error().message().c_str()); return ""; } return android::base::Join(*sonames, ':'); } static std::string InitLlndkLibrariesProduct() { if (!is_product_vndk_version_defined()) { return ""; } std::string config_file = kLlndkLibrariesFile; InsertVndkVersionStr(&config_file, true); auto sonames = ReadConfig(config_file, always_true); if (!sonames.ok()) { LOG_ALWAYS_FATAL("%s: %s", config_file.c_str(), sonames.error().message().c_str()); return ""; } return android::base::Join(*sonames, ':'); } static std::string InitVndkspLibrariesVendor() { std::string config_file = kVndkLibrariesFile; InsertVndkVersionStr(&config_file, false); auto sonames = ReadConfig(config_file, always_true); if (!sonames.ok()) { LOG_ALWAYS_FATAL("%s", sonames.error().message().c_str()); return ""; } return android::base::Join(*sonames, ':'); } static std::string InitVndkspLibrariesProduct() { if (!is_product_vndk_version_defined()) { return ""; } std::string config_file = kVndkLibrariesFile; InsertVndkVersionStr(&config_file, true); auto sonames = ReadConfig(config_file, always_true); if (!sonames.ok()) { LOG_ALWAYS_FATAL("%s", sonames.error().message().c_str()); return ""; } return android::base::Join(*sonames, ':'); } static std::string InitNeuralNetworksPublicLibraries() { return kNeuralNetworksApexPublicLibrary; } static std::string InitStatsdPublicLibraries() { return kStatsdApexPublicLibrary; } static std::map InitApexJniLibraries() { std::string file_content; if (!base::ReadFileToString(kJniConfigFile, &file_content)) { // jni config is optional return {}; } auto config = ParseJniConfig(file_content); if (!config.ok()) { LOG_ALWAYS_FATAL("%s: %s", kJniConfigFile, config.error().message().c_str()); // not reach here return {}; } return *config; } } // namespace const std::string& preloadable_public_libraries() { static std::string list = InitDefaultPublicLibraries(/*for_preload*/ true); return list; } const std::string& default_public_libraries() { static std::string list = InitDefaultPublicLibraries(/*for_preload*/ false); return list; } const std::string& art_public_libraries() { static std::string list = InitArtPublicLibraries(); return list; } const std::string& i18n_public_libraries() { static std::string list = InitI18nPublicLibraries(); return list; } const std::string& vendor_public_libraries() { static std::string list = InitVendorPublicLibraries(); return list; } const std::string& extended_public_libraries() { static std::string list = InitExtendedPublicLibraries(); return list; } const std::string& neuralnetworks_public_libraries() { static std::string list = InitNeuralNetworksPublicLibraries(); return list; } const std::string& statsd_public_libraries() { static std::string list = InitStatsdPublicLibraries(); return list; } const std::string& llndk_libraries_product() { static std::string list = InitLlndkLibrariesProduct(); return list; } const std::string& llndk_libraries_vendor() { static std::string list = InitLlndkLibrariesVendor(); return list; } const std::string& vndksp_libraries_product() { static std::string list = InitVndkspLibrariesProduct(); return list; } const std::string& vndksp_libraries_vendor() { static std::string list = InitVndkspLibrariesVendor(); return list; } const std::string& apex_jni_libraries(const std::string& apex_ns_name) { static std::map jni_libraries = InitApexJniLibraries(); return jni_libraries[apex_ns_name]; } bool is_product_vndk_version_defined() { #if defined(ART_TARGET_ANDROID) return android::sysprop::VndkProperties::product_vndk_version().has_value(); #else return false; #endif } std::string get_vndk_version(bool is_product_vndk) { #if defined(ART_TARGET_ANDROID) if (is_product_vndk) { return android::sysprop::VndkProperties::product_vndk_version().value_or(""); } return android::sysprop::VndkProperties::vendor_vndk_version().value_or(""); #else if (is_product_vndk) { return android::base::GetProperty("ro.product.vndk.version", ""); } return android::base::GetProperty("ro.vndk.version", ""); #endif } namespace internal { // Exported for testing Result> ParseConfig( const std::string& file_content, const std::function(const ConfigEntry& /* entry */)>& filter_fn) { std::vector lines = base::Split(file_content, "\n"); std::vector sonames; for (auto& line : lines) { auto trimmed_line = base::Trim(line); if (trimmed_line[0] == '#' || trimmed_line.empty()) { continue; } std::vector tokens = android::base::Split(trimmed_line, " "); if (tokens.size() < 1 || tokens.size() > 3) { return Errorf("Malformed line \"{}\"", line); } struct ConfigEntry entry = {.soname = "", .nopreload = false, .bitness = ALL}; size_t i = tokens.size(); while (i-- > 0) { if (tokens[i] == "nopreload") { entry.nopreload = true; } else if (tokens[i] == "32" || tokens[i] == "64") { if (entry.bitness != ALL) { return Errorf("Malformed line \"{}\": bitness can be specified only once", line); } entry.bitness = tokens[i] == "32" ? ONLY_32 : ONLY_64; } else { if (i != 0) { return Errorf("Malformed line \"{}\"", line); } entry.soname = tokens[i]; } } // skip 32-bit lib on 64-bit process and vice versa #if defined(__LP64__) if (entry.bitness == ONLY_32) continue; #else if (entry.bitness == ONLY_64) continue; #endif Result ret = filter_fn(entry); if (!ret.ok()) { return ret.error(); } if (*ret) { // filter_fn has returned true. sonames.push_back(entry.soname); } } return sonames; } Result> ParseJniConfig(const std::string& file_content) { std::map entries; std::vector lines = base::Split(file_content, "\n"); for (auto& line : lines) { auto trimmed_line = base::Trim(line); if (trimmed_line[0] == '#' || trimmed_line.empty()) { continue; } std::vector tokens = base::Split(trimmed_line, " "); if (tokens.size() < 2) { return Errorf( "Malformed line \"{}\"", line); } entries[tokens[0]] = tokens[1]; } return entries; } } // namespace internal } // namespace android::nativeloader