document recommended usage of system blas/lapack (#2081)
* document recommended usage of system blas/lapack * update doc * minor * reword
This commit is contained in:
parent
37dc719d13
commit
9f54cea5c5
1 changed files with 35 additions and 0 deletions
|
@ -746,6 +746,41 @@ there." This is reasonable for OpenSSL, which has a stable API.
|
||||||
and will be fixed in a future release.
|
and will be fixed in a future release.
|
||||||
|
|
||||||
|
|
||||||
|
^^^^^^^^^^^^^
|
||||||
|
BLAS / LAPACK
|
||||||
|
^^^^^^^^^^^^^
|
||||||
|
|
||||||
|
The recommended way to use system-supplied BLAS / LAPACK packages is
|
||||||
|
to add the following to ``packages.yaml``:
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
packages:
|
||||||
|
netlib-lapack:
|
||||||
|
paths:
|
||||||
|
netlib-lapack@system: /usr
|
||||||
|
version: [system]
|
||||||
|
buildable: False
|
||||||
|
all:
|
||||||
|
providers:
|
||||||
|
blas: [netlib-lapack]
|
||||||
|
lapack: [netlib-lapack]
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
The ``@system`` "version" means "I don't care what version it is,
|
||||||
|
just use what is there." Above we pretend that the system-provided
|
||||||
|
Blas/Lapack is ``netlib-lapack`` only because it is the only BLAS / LAPACK
|
||||||
|
provider which use standard names for libraries (as opposed to, for example,
|
||||||
|
`libopenblas.so`).
|
||||||
|
|
||||||
|
Although we specify external package in ``/usr``, Spack is smart enough not
|
||||||
|
to add ``/usr/lib`` to RPATHs, where it could cause unrelated system
|
||||||
|
libraries to be used instead of their Spack equivalents. ``usr/bin`` will be
|
||||||
|
present in PATH, however it will have lower precedence compared to paths
|
||||||
|
from other dependencies. This ensures that binaries in Spack dependencies
|
||||||
|
are preferred over system binaries.
|
||||||
|
|
||||||
^^^
|
^^^
|
||||||
Git
|
Git
|
||||||
^^^
|
^^^
|
||||||
|
|
Loading…
Reference in a new issue