Bug: 125060076

Clone this repo:
  1. c502af5 Verify extra paths from APEX linker config by Kiyoung Kim · 6 weeks ago master
  2. 6c7494c Do not fail on missing public.libraries.txt by Kiyoung Kim · 5 weeks ago
  3. cf2a7e7 Remove unused variable by Kiyoung Kim · 6 weeks ago
  4. a162d8b Merge "Refactor ScanActiveApexes to return android::base::Result" by Kiyoung Kim · 6 weeks ago
  5. b972763 Refactor ScanActiveApexes to return android::base::Result by Kiyoung Kim · 6 weeks ago

LinkerConfig

Introduction

Linkerconfig is a program to generate linker configuration based on the runtime environment. Linkerconfig generates one or more ld.config.txt files and some other files under /linkerconfig during init. Linker will read this generated configuration file(s) to find out link relationship between libraries and executable.

Inputs

TODO: explain inputs (e.g. /system/etc/public.libraries.txt, /apex/apex-info-list.xml, ..)

linker.config.json

Linker configuration file can be used to add extra information while linkerconfig creates linker configuration with the module. This module can be defined as ‘linker_config’ from Soong, and it will be translated as protobuf file at build time.

Format

linker.config.json file is in json format which can contain properties as below.

Property NameTypeDescriptionAllowed module
permittedPathsListAdditional permitted pathsAPEX
visibleboolForce APEX namespace to be visible from all sections if the value is trueAPEX
provideLibsListLibraries providing from the moduleSystem
requireLibsListLibraries required from the moduleSystem

Example

APEX module
{
    "permittedPaths" : [ "/a", "/b/c", "/d/e/f"],
    "visible": true
}
System
{
    "provideLibs" : [ "a.so", "b.so", "c.so" ],
    "requireLibs" : [ "foo.so", "bar.so", "baz.so" ]
}

Outputs

/linkerconfig/ld.config.txt & /linkerconfig/*/ld.config.txt

TODO: a few words about the files

Check ld.config.format.md.

/linkerconfig/apex.libraries.txt

The file describes libraries exposed from APEXes. libnativeloader is the main consumer of this file.

# comment line
jni com_android_foo libfoo_jni.so
public com_android_bar libbar.so:libbaz.so

The file is line-based and each line consists of tag apex_namespace library_list.

  • tag explains what library_list is.
  • apex_namespace is the namespace of the apex. Note that it is mangled like com_android_foo for the APEX(“com.android.foo”).
  • library_list is colon-separated list of library names.
    • if tag is jni, library_list is the list of JNI libraries exposed by apex_namespace.
    • if tag is public, library_list is the list of public libraries exposed by apex_namespace. Here, public libraries are the libs listed in /system/etc/public.libraries.txt.