17.2.222. MPI_Info_env

MPI_Info_env — 包含应用程序信息的静态MPI_Info对象

17.2.222.1. 描述

MPI-3标准定义了一个名为MPI_Info_env的静态MPI_Info对象,该对象可用于从运行时获取应用程序执行方式的相关信息。

17.2.222.2. 支持的字段

command

如果可用,该值将被设置为argv[0]。请注意,该值可能并不总是可用 - 例如,程序可以调用MPI_Init并传入NULL参数,在这种情况下如果作为单例运行,argv[0]将不会被设置。在Fortran程序中这个值永远不会被设置,因为无法获取argv参数。

argv

应用程序接收的argv参数。如果未向应用程序传递任何参数,则不会设置此值。对于使用NULL参数调用MPI_Init的单例程序或Fortran程序,此值也不会被设置。

maxprocs

作业中的进程数量。

soft

Open MPI不支持使用soft选项来指定要执行的进程数量,因此该值被设置为与maxprocs相同。

host

该进程正在运行的主机名称 - 即从gethostname()函数返回的值。

arch

该进程正在运行的主机架构。如果可以确定,此值表示底层芯片架构(例如x86_64)。

wdir

mpiexec启动进程时的工作目录。请注意,对于以单例模式启动的进程,此值不会被设置,因为MPI库无法可靠地确定其位置。

file

尽管MPI-3标准已对此字段进行了定义,但目前尚未设置具体值。

thread_level

请求的MPI线程级别 - 请注意这可能与应用程序的实际MPI线程级别不同。

ompi_num_apps

MPMD作业中的应用上下文数量。这是一个Open MPI特有的字段和值。

ompi_np

每个应用上下文中的进程数量,以空格分隔的整数列表形式提供。这是一个Open MPI特有的字段和值。

ompi_first_rank

每个应用上下文中第一个进程的MPI等级,以空格分隔的整数列表形式提供。这是一个Open MPI特有的字段和值。

ompi_positioned_file_dir

如果Open MPI被要求预置文件,此字段提供这些文件存放的顶级目录。这是一个Open MPI特有的字段和值。

17.2.222.3. 错误

When calling MPI_Info_get, the flag parameter will be set to zero (false) if a value for the field has not been set.

另请参阅