18.1.2. oshmem_info

oshmem_info - 显示关于OpenSHMEM安装的信息

18.1.2.1. 概述

oshmem_info [options]

18.1.2.2. 描述

oshmem_info 提供了关于OpenSHMEM安装的详细信息。它在至少三种常见场景下非常有用:

  1. 检查本地配置并查看OpenSHMEM的安装情况。

  2. 向OpenSHMEM社区提交错误报告/帮助请求 (参见获取帮助)。

  3. 查看已安装的OpenSHMEM插件列表并查询它们支持的MCA参数。

注意

oshmem_info 默认情况下仅显示少量MCA参数(即级别1参数)。使用 --level 选项可启用显示更多选项(详见 LEVELS 章节获取更多信息)。

18.1.2.3. 选项

oshmem_info 接受以下选项:

  • -a, --all: 显示所有配置选项和MCA参数

  • --arch: 显示编译OpenSHMEM时所使用的架构

  • -c, --config: 显示配置选项

  • -gmca, --gmca *: 传递适用于所有上下文的全局MCA参数。

  • -h, --help*: 显示帮助/使用信息

  • --hostname: 显示OpenSHMEM配置和构建时使用的主机名

  • --internal: 显示内部MCA参数(这些参数不建议用户修改)

  • --level: 仅显示不超过此级别(1-9)的变量。默认值为1,除非指定了--all而未指定--level,此时默认值为9。更多信息请参阅LEVELS章节。

  • -mca, --mca : 传递上下文特定的MCA参数;如果未使用--gmca且仅指定了一个上下文,则这些参数将被视为全局参数。

  • --param <type> <component>: 显示MCA参数。第一个参数是要显示的组件类型;第二个参数是要显示的具体组件(或关键字all,表示"显示此类型的所有组件")。

  • --parsable: 当与其他参数一起使用时,输出会以机器可解析的格式显示。--parseable--parsable的同义词。

  • --path : 显示OpenSHMEM的配置路径。接受以下参数:prefix, bindir, libdir, incdir, pkglibdir, sysconfdir

  • --pretty: 当与其他参数一起使用时,输出会以美观打印格式显示(默认)

  • --selected-only: 仅显示选定组件中的变量。

  • -V, --version*: 显示OpenSHMEM的版本信息。

18.1.2.4. 级别

  1. 用户感兴趣的基本信息

  2. 用户感兴趣的详细信息

  3. 用户感兴趣的所有剩余信息

  4. 调优所需的基本信息

  5. 调优所需的详细信息

  6. 调优所需的所有剩余信息

  7. OpenSHMEM 实现者的基本信息

  8. OpenSHMEM 实现者的详细信息

  9. 为OpenSHMEM实现者提供的所有剩余信息

18.1.2.5. 示例

shell$ oshmem_info

以人类可读/美观打印的格式显示选项的默认输出和已安装组件的列表。

shell$ oshmem_info --parsable

以机器可解析的格式显示选项的默认输出和已安装组件的列表。

shell$ oshmem_info --param btl openib

以人类可读/美观打印的格式显示“openib”BTL组件的MCA参数。

shell$ oshmem_info --param btl openib --parsable

以机器可解析的格式显示“openib” BTL组件的MCA参数。

shell$ oshmem_info --path bindir

显示OpenSHMEM配置时使用的“bindir”目录。

shell$ oshmem_info --version ompi full --parsable

以机器可读的格式显示OpenSHMEM的完整版本号(包括ORTE和OPAL版本号)。

shell$ oshmem_info --version btl major

以美观的格式显示所有BTL组件的主版本号。

shell$ oshmem_info --version btl:tcp minor

以美观格式显示TCP BTL组件的次要版本号。

shell$ oshmem_info --all

显示关于OpenSHMEM安装的所有信息,包括可找到的所有组件、它们支持的MCA参数、OpenSHMEM及各组件的版本等。