MPI_Info_create_env.3.rst

MPI_Info_create_env

:ref:`MPI_Info_create_env` - Creates a new info object with the same construction as :ref:`MPI_INFO_ENV` as created during :ref:`MPI_Init` or :ref:`MPI_Init_thread` when the same arguments are used.

SYNTAX

C Syntax

#include <mpi.h>

int MPI_Info_create_env(int argc, char *argv[], MPI_Info *info)

Fortran Syntax

USE MPI
! or the older form: INCLUDE 'mpif.h'
MPI_INFO_CREATE_ENV(INFO, IERROR)
     INTEGER INFO, IERROR

Fortran 2008 Syntax

USE mpi_f08
MPI_Info_create_env(info, ierror)
     TYPE(MPI_Info), INTENT(OUT) :: info
     INTEGER, OPTIONAL, INTENT(OUT) :: ierror

OUTPUT PARAMETERS

• info: Info object created (handle).
• ierror: Fortran only: Error status (integer).

DESCRIPTION

:ref:`MPI_Info_create_env` creates a new info object with the same construction as :ref:`MPI_INFO_ENV` as created during :ref:`MPI_Init` or :ref:`MPI_Init_thread` when the same arguments are used.

NOTE

:ref:`MPI_Info_create_env` is one of the few functions that can be called before :ref:`MPI_Init` and after :ref:`MPI_Finalize`.

ERRORS

.. seealso::
   * :ref:`MPI_Info_delete`
   * :ref:`MPI_Info_dup`
   * :ref:`MPI_Info_free`
   * :ref:`MPI_Info_get`
   * :ref:`MPI_Info_set`