服务#

服务函数在以下文件中定义

  • C / C++ 头文件: include/nvpl_lapack_service.h

版本信息#

nvpl_lapack_get_version()#

  • C / C++

    int nvpl_lapack_get_version()#

以以下格式返回库版本：NVPL_LAPACK_VERSION_MAJOR * 10000 + NVPL_LAPACK_VERSION_MINOR * 100 + NVPL_LAPACK_VERSION_PATCH。

线程控制#

nvpl_lapack_get_max_threads()#

  • C / C++

    int nvpl_lapack_get_max_threads()#

返回 NVPL LAPACK 可用于并行化的线程数。如果设置了线程局部线程数，此函数将返回线程局部数。否则，将返回全局线程数。

nvpl_lapack_set_num_threads()#

  • C / C++

    void nvpl_lapack_set_num_threads(int nthr)#

设置 NVPL LAPACK 应使用的线程数。

  • 默认值：0。

  • 使用 0 以遵循线程运行时默认值。负数 nthr 将被忽略。

  • 该函数对于顺序库无效。

nvpl_lapack_set_num_threads_local()#

  • C / C++

    int nvpl_lapack_set_num_threads_local(int nthr_local)#

设置从当前线程调用库时库应使用的（线程）局部线程数。当库从可能需要不同嵌套线程行为的不同线程调用时，此函数很有用。

  • 默认值：0。

  • 使用 0 以遵循全局设置。负数 nthr_local 将被忽略。

  • 此函数优先于 nvpl_lapack_set_num_threads()。

  • 该函数对于顺序库无效。

建议将线程局部线程数设置为先前的值或重置它。

返回 nthr_local 的先前值。

数学模式#

数学模式定义了 NVPL LAPACK 将用于库内部计算的模式。有关可能的值，请参见服务类型。

nvpl_lapack_get_math_mode()#

  • C / C++

    nvpl_lapack_math_mode_t nvpl_lapack_get_math_mode()#

返回当前数学模式。如果设置了线程局部数学模式，此函数将返回线程局部数学模式。否则，将返回全局数学模式。

nvpl_lapack_set_math_mode()#

  • C / C++

    void nvpl_lapack_set_math_mode(nvpl_lapack_math_mode_t math_mode)#

设置 NVPL LAPACK 的全局数学模式。默认值：NVPL_LAPACK_MATH_MODE_DEFAULT。

nvpl_lapack_set_math_mode_local()#

  • C / C++

    nvpl_lapack_math_mode_t nvpl_lapack_set_math_mode_local(
    nvpl_lapack_math_mode_t math_mode,
    )#

设置 NVPL LAPACK 的线程局部数学模式。默认值：使用全局数学模式。此函数优先于 nvpl_lapack_set_math_mode()。设置 NVPL_LAPACK_MATH_MODE_USE_GLOBAL 将禁用线程局部数学模式设置。

建议在使用后将线程局部数学模式设置为先前的值或重置它。

返回局部数学模式的先前值。

环境模式#

环境模式用于忽略或遵循 NVPL LAPACK 特定环境变量的值。另请参阅 库特定 和 服务类型。

nvpl_lapack_get_env_mode()#

  • C / C++

    nvpl_lapack_env_mode_t nvpl_lapack_get_env_mode()#

返回当前环境模式。如果设置了线程局部环境模式，此函数将返回线程局部环境模式。否则，将返回全局环境模式。

nvpl_lapack_set_env_mode()#

  • C / C++

    void nvpl_lapack_set_env_mode(nvpl_lapack_env_mode_t env_mode)#

设置 NVPL LAPACK 的全局环境模式。默认值：NVPL_LAPACK_ENV_MODE_DEFAULT。

nvpl_lapack_set_env_mode_local()#

  • C / C++

    nvpl_lapack_env_mode_t nvpl_lapack_set_env_mode_local(
    nvpl_lapack_env_mode_t env_mode,
    )#

设置 NVPL LAPACK 的线程局部环境模式。默认值：NVPL_LAPACK_ENV_MODE_DEFAULT。此函数优先于 nvpl_lapack_set_env_mode()。设置 NVPL_LAPACK_ENV_MODE_USE_GLOBAL 将禁用线程局部环境模式设置。

建议在使用后将线程局部环境模式设置为先前的值或重置它。

返回局部环境模式的先前值。