• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2019 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef ART_LIBNATIVELOADER_PUBLIC_LIBRARIES_H_
18 #define ART_LIBNATIVELOADER_PUBLIC_LIBRARIES_H_
19 
20 #include <algorithm>
21 #include <map>
22 #include <string>
23 
24 #include <android-base/result.h>
25 
26 namespace android::nativeloader {
27 
28 using android::base::Result;
29 
30 // These provide the list of libraries that are available to the namespace for apps.
31 // Not all of the libraries are available to apps. Depending on the context,
32 // e.g., if it is a vendor app or not, different set of libraries are made available.
33 const std::string& preloadable_public_libraries();
34 const std::string& default_public_libraries();
35 const std::string& vendor_public_libraries();
36 const std::string& extended_public_libraries();
37 const std::string& llndk_libraries_product();
38 const std::string& llndk_libraries_vendor();
39 const std::string& vndksp_libraries_product();
40 const std::string& vndksp_libraries_vendor();
41 const std::string& apex_jni_libraries(const std::string& apex_name);
42 
43 // Returns the table of apexes and public libraries provided by the apexes.
44 // For example, com_android_foo -> libfoo.so:libbar.so
45 // Note that libfoo.so and libbar.so are listed in /system/etc/public.libraries.txt
46 // but provided by com.android.foo APEX.
47 const std::map<std::string, std::string>& apex_public_libraries();
48 
49 // Returns true if libnativeloader is running on devices and the device has
50 // ro.product.vndk.version property. It returns false for host.
51 bool is_product_vndk_version_defined();
52 
53 std::string get_vndk_version(bool is_product_vndk);
54 
55 // These are exported for testing
56 namespace internal {
57 
58 enum Bitness { ALL = 0, ONLY_32, ONLY_64 };
59 
60 struct ConfigEntry {
61   std::string soname;
62   bool nopreload;
63   Bitness bitness;
64 };
65 
66 Result<std::vector<std::string>> ParseConfig(
67     const std::string& file_content,
68     const std::function<Result<bool>(const ConfigEntry& /* entry */)>& filter_fn);
69 
70 // Parses apex.libraries.config.txt file generated by linkerconfig
71 // and returns mapping of <apex namespace> to <library list> which matches <tag>.
72 Result<std::map<std::string, std::string>> ParseApexLibrariesConfig(
73     const std::string& file_content, const std::string& tag);
74 
75 }  // namespace internal
76 
77 }  // namespace android::nativeloader
78 
79 #endif  // ART_LIBNATIVELOADER_PUBLIC_LIBRARIES_H_
80