package/openblas: allow disabling multithreading
authorThomas De Schampheleire <thomas.de_schampheleire@nokia.com>
Fri, 12 Feb 2021 09:15:09 +0000 (10:15 +0100)
committerThomas Petazzoni <thomas.petazzoni@bootlin.com>
Tue, 16 Feb 2021 22:10:57 +0000 (23:10 +0100)
Buildroot would automatically enable multithreading in OpenBLAS if the
architecture supports it. However, one may want to avoid OpenBLAS creating
threads itself and configure single-threaded operation. To accommodate this
use case, add a config option for multithreading.

When multithreading is disabled but OpenBLAS functions are called in the
same application by multiple threads, then locking is mandatory. The
USE_LOCKING flag was added in version 0.3.7 with following release note:

    a new option USE_LOCKING was added to ensure thread safety when OpenBLAS
    itself is built without multithreading but will be called from multiple
    threads.

However, if one knows that OpenBLAS will only be called from single-threaded
applications, then passing USE_LOCKING is not necessary, so make it a config
option too.

When multithreading is enabled, locking is implicitly enabled inside
openblas, so only provide the locking option when multithreading is
disabled.

Signed-off-by: Thomas De Schampheleire <thomas.de_schampheleire@nokia.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
package/openblas/Config.in
package/openblas/openblas.mk

index 3f658c862a2f870bf5296ae973a439bced7950a7..0144e93a3faf98b89346b3c64e2f3bcb7f7aea40 100644 (file)
@@ -73,4 +73,25 @@ config BR2_PACKAGE_OPENBLAS_TARGET
        string "OpenBLAS target CPU"
        default BR2_PACKAGE_OPENBLAS_DEFAULT_TARGET
 
+config BR2_PACKAGE_OPENBLAS_USE_THREAD
+       bool "use multithreading"
+       default y
+       depends on BR2_TOOLCHAIN_HAS_THREADS
+       depends on !BR2_STATIC_LIBS
+       help
+         Tell OpenBLAS to use multithreading, by passing USE_THREAD=1.
+
+config BR2_PACKAGE_OPENBLAS_USE_LOCKING
+       bool "use locking"
+       default y
+       depends on BR2_TOOLCHAIN_HAS_THREADS
+       depends on !BR2_PACKAGE_OPENBLAS_USE_THREAD
+       help
+         Tell OpenBLAS to use locking, by passing USE_LOCKING=1.
+         Locking is implicitly enabled when USE_THREAD=1.
+         However, if USE_THREAD=0 (i.e. OpenBLAS itself will run in
+         single-threaded mode) but an application makes OpenBLAS
+         function calls from multiple threads, then locking is
+         mandatory for correct operation.
+
 endif
index 9701df9148665d766f669c353516b97e47fec9a6..21d05cf30d2dd523bce49a113028d86baa498e6b 100644 (file)
@@ -25,12 +25,19 @@ OPENBLAS_MAKE_OPTS += ONLY_CBLAS=1
 endif
 
 # Enable/Disable multi-threading (not for static-only since it uses dlfcn.h)
-ifeq ($(BR2_TOOLCHAIN_HAS_THREADS):$(BR2_STATIC_LIBS),y:)
+ifeq ($(BR2_PACKAGE_OPENBLAS_USE_THREAD),y)
 OPENBLAS_MAKE_OPTS += USE_THREAD=1
 else
 OPENBLAS_MAKE_OPTS += USE_THREAD=0
 endif
 
+ifeq ($(BR2_PACKAGE_OPENBLAS_USE_LOCKING),y)
+OPENBLAS_MAKE_OPTS += USE_LOCKING=1
+else
+# not passing USE_LOCKING=0 as this could be confusing: its effect is implicit
+# in case of USE_THREAD=1.
+endif
+
 # We don't know if OpenMP is available or not, so disable
 OPENBLAS_MAKE_OPTS += USE_OPENMP=0