commit: 4b41cba8a5a4c39a0665d35810000a126100fd23 Author: Michał Górny <mgorny <AT> gentoo <DOT> org> AuthorDate: Mon Sep 29 10:28:39 2025 +0000 Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> CommitDate: Mon Sep 29 10:28:39 2025 +0000 URL: https://gitweb.gentoo.org/proj/blas-lapack-aux-wrapper.git/commit/?id=4b41cba8
Add a README file Signed-off-by: Michał Górny <mgorny <AT> gentoo.org> README | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README b/README new file mode 100644 index 0000000..6b69be5 --- /dev/null +++ b/README @@ -0,0 +1,19 @@ +======================= +blas-lapack-aux-wrapper +======================= + +This package provides a series of library wrappers that provide +bidirectional compatibility between Netlib LAPACK and FlexiBLAS. +The goal is to ensure that the packages built after switching the system +BLAS / LAPACK provider to FlexiBLAS remain fully compatible with Netlib +LAPACK, and therefore users can switch back without having to rebuild +them. + +This compatibility is achieved through creating a series of libraries +compatible with Netlib LAPACK, i.e. `libblas.so`, `liblapack.so` +and so on, that feature the same SONAMEs as Netlib LAPACK libraries, +and export the symbols common to Netlib LAPACK and FlexiBLAS. +The libraries export only dummy symbols, for the purpose of ensuring +that the linker correctly links to these wrapper libraries, and uses +a `DT_AUXILIARY` entry to make the dynamic linker resolve the actual +symbols using FlexiBLAS libraries.
