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. 错误
另请参阅