Skip to content

Latest commit

 

History

History
101 lines (89 loc) · 2.92 KB

README.md

File metadata and controls

101 lines (89 loc) · 2.92 KB
Raw

sold

NOTE: The development is taken over by @akawashiro. Check out this repository instead: https://github.com/akawashiro/sold/

sold is a linker software which links a shared objects and its depending shared objects. For example,

% ldd libhoge.so
    linux-vdso.so.1 (0x00007ffee03bb000)
    libfuga.so (0x00007fb6550b2000)
    libstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x00007fb654eb5000)
    libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fb654cc3000)
    libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007fb654b74000)
    /lib64/ld-linux-x86-64.so.2 (0x00007fb6550be000)
    libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x00007fb654b59000)
% sold -i libhoge.so -o libhoge2.so
% ldd libhoge2.so
    /lib64/ld-linux-x86-64.so.2 (0x00007f78a666b000)
    linux-vdso.so.1 (0x00007fffd89d1000)
    libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f789644f000)
    libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x00007f7896434000)
    libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007f78962e5000)
    libstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x00007f7896104000)

Requirements

sold works only on Linux on x86-64 and aarch64 architectures.

How to build

git clone https://github.com/shinh/sold.git
cd sold
mkdir -p build
cd build
cmake ..
make

Now you can see the sold in build directory.

How to use

sold -i [INPUT] -o [OUTPUT]

Options

  • --section-headers: Emit section headers. Output shared objects work without section headers but they are useful for debugging.
  • --check-output: Check integrity of the output by parsing it again.
  • --exclude-so: Specify a shared object not to combine.

Renamer

renamer is software to rename symbols in shared objects. You can rename symbols in shared objects like the following.

% cat mapping
hoge fugafuga
% renamer libhoge_original.so --output libhoge_renamed.so --rename-mapping-file mapping

Requirements & How to build

Just same as sold.

How to use

renamer [INPUT] --output [OUTPUT] --rename-mapping-file [MAPPING]

All lines in [MAPPING] must be a space separated pair of the old name of a symbol and the new name.

For developers

Please run "./run-format.sh" before merging to master branch.

TODO

  • Executables
  • TLS in executables
    • Initial exec and local exec
  • x86-32
  • Test Fedora linux in CI

Integration test with practical libraries

pybind test

The purpose of this test is to check sold can preserve the complex ABI.

git clone https://github.com/shinh/sold.git
cd sold
mkdir -p build
cd build
cmake .. -DSOLD_PYBIND_TEST=ON
make
ctest

libtorch test

mkdir -p build
cd build
cmake -DCMAKE_PREFIX_PATH=/absolute/path/to/libtorch/dir -DSOLD_LIBTORCH_TEST=ON -GNinja ..
ninja

Test with Docker

sudo docker build -f ubuntu18.04.Dockerfile .
sudo docker build -f ubuntu20.04.Dockerfile .
sudo docker build -f fedora-latest.Dockerfile .