17.4. Deprecated since MPI-4.1

PreviousUpNext
Up: Deprecated Interfaces Next: Host Rank Previous: Deprecated since MPI-4.0

The use of the mpif.h include file has been deprecated. Information supporting the transition to USE mpi or USE mpi_f08 is provided in Section Fortran Support Through the mpif.h Include File.

The predefined attribute key MPI_HOST for MPI_COMM_WORLD when using the World Model is deprecated.

MPI_HOST: Host process rank, if such exists, MPI_PROC_NULL, otherwise.


PreviousUpNext
Up: Deprecated Interfaces Next: Host Rank Previous: Deprecated since MPI-4.0


Host Rank

PreviousUpNext
Up: Deprecated since MPI-4.1 Next: Removed Interfaces Previous: Deprecated since MPI-4.1

The value returned for MPI_HOST gets the rank of the HOST process in the group associated with communicator MPI_COMM_WORLD, if there is such. MPI_PROC_NULL is returned if there is no host. MPI does not specify what it means for a process to be a HOST, nor does it requires that a HOST exists.

The attribute MPI_HOST has the same value on all processes of MPI_COMM_WORLD.

Environmental inquiry keys
C type: const int (or unnamed enum)
Fortran type: INTEGER
MPI_HOST

All MPI_ XXX_X procedures have been deprecated and may be removed in a future version of the MPI specification. In the case of their C binding and their Fortran binding through the mpi_f08 module, they are superseded by the large count and large byte displacement bindings of their counterpart in the form of MPI_ XXX.

MPI_TYPE_SIZE_X(datatype, size)
IN datatypedatatype to get information on (handle)
OUT sizedatatype size (integer)
C binding
int MPI_Type_size_x(MPI_Datatype datatype, MPI_Count *size)
Fortran 2008 binding
MPI_Type_size_x(datatype, size, ierror)
TYPE(MPI_Datatype), INTENT(IN) :: datatype
INTEGER(KIND=MPI_COUNT_KIND), INTENT(OUT) :: size
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
Fortran binding
MPI_TYPE_SIZE_X(DATATYPE, SIZE, IERROR)
INTEGER DATATYPE, IERROR
INTEGER(KIND=MPI_COUNT_KIND) SIZE

The description of MPI_TYPE_SIZE is applicable to this deprecated MPI_TYPE_SIZE_X accordingly, see Section Address and Size Procedures.

MPI_TYPE_GET_EXTENT_X(datatype, lb, extent)
IN datatypedatatype to get information on (handle)
OUT lblower bound of datatype (integer)
OUT extentextent of datatype (integer)
C binding
int MPI_Type_get_extent_x(MPI_Datatype datatype, MPI_Count *lb, MPI_Count *extent)
Fortran 2008 binding
MPI_Type_get_extent_x(datatype, lb, extent, ierror)
TYPE(MPI_Datatype), INTENT(IN) :: datatype
INTEGER(KIND=MPI_COUNT_KIND), INTENT(OUT) :: lb, extent
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
Fortran binding
MPI_TYPE_GET_EXTENT_X(DATATYPE, LB, EXTENT, IERROR)
INTEGER DATATYPE, IERROR
INTEGER(KIND=MPI_COUNT_KIND) LB, EXTENT

The description of MPI_TYPE_GET_EXTENT is applicable to this deprecated MPI_TYPE_GET_EXTENT_X accordingly, see Section Extent and Bounds of Datatypes.

MPI_TYPE_GET_TRUE_EXTENT_X(datatype, true_lb, true_extent)
IN datatypedatatype to get information on (handle)
OUT true_lbtrue lower bound of datatype (integer)
OUT true_extenttrue extent of datatype (integer)
C binding
int MPI_Type_get_true_extent_x(MPI_Datatype datatype, MPI_Count *true_lb, MPI_Count *true_extent)
Fortran 2008 binding
MPI_Type_get_true_extent_x(datatype, true_lb, true_extent, ierror)
TYPE(MPI_Datatype), INTENT(IN) :: datatype
INTEGER(KIND=MPI_COUNT_KIND), INTENT(OUT) :: true_lb, true_extent
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
Fortran binding
MPI_TYPE_GET_TRUE_EXTENT_X(DATATYPE, TRUE_LB, TRUE_EXTENT, IERROR)
INTEGER DATATYPE, IERROR
INTEGER(KIND=MPI_COUNT_KIND) TRUE_LB, TRUE_EXTENT

The description of MPI_TYPE_GET_TRUE_EXTENT is applicable to this deprecated MPI_TYPE_GET_TRUE_EXTENT_X accordingly, see Section True Extent of Datatypes.

MPI_GET_ELEMENTS_X(status, datatype, count)
IN statusreturn status of receive operation (status)
IN datatypedatatype used by receive operation (handle)
OUT countnumber of received basic elements (integer)
C binding
int MPI_Get_elements_x(const MPI_Status *status, MPI_Datatype datatype, MPI_Count *count)
Fortran 2008 binding
MPI_Get_elements_x(status, datatype, count, ierror)
TYPE(MPI_Status), INTENT(IN) :: status
TYPE(MPI_Datatype), INTENT(IN) :: datatype
INTEGER(KIND=MPI_COUNT_KIND), INTENT(OUT) :: count
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
Fortran binding
MPI_GET_ELEMENTS_X(STATUS, DATATYPE, COUNT, IERROR)
INTEGER STATUS(MPI_STATUS_SIZE), DATATYPE, IERROR
INTEGER(KIND=MPI_COUNT_KIND) COUNT

The description of MPI_GET_ELEMENTS is applicable to this deprecated MPI_GET_ELEMENTS_X accordingly, see Section Use of General Datatypes in Communication.

MPI_STATUS_SET_ELEMENTS_X(status, datatype, count)
INOUT statusstatus with which to associate count (status)
IN datatypedatatype associated with count (handle)
IN countnumber of elements to associate with status (integer)
C binding
int MPI_Status_set_elements_x(MPI_Status *status, MPI_Datatype datatype, MPI_Count count)
Fortran 2008 binding
MPI_Status_set_elements_x(status, datatype, count, ierror)
TYPE(MPI_Status), INTENT(INOUT) :: status
TYPE(MPI_Datatype), INTENT(IN) :: datatype
INTEGER(KIND=MPI_COUNT_KIND), INTENT(IN) :: count
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
Fortran binding
MPI_STATUS_SET_ELEMENTS_X(STATUS, DATATYPE, COUNT, IERROR)
INTEGER STATUS(MPI_STATUS_SIZE), DATATYPE, IERROR
INTEGER(KIND=MPI_COUNT_KIND) COUNT

The description of MPI_STATUS_SET_ELEMENTS is applicable to this deprecated MPI_STATUS_SET_ELEMENTS_X accordingly, see Section Associating Information with Status.


PreviousUpNext
Up: Deprecated since MPI-4.1 Next: Removed Interfaces Previous: Deprecated since MPI-4.1


Return to MPI-5.0 Standard Index
Return to MPI Forum Home Page

(Unofficial) MPI-5.0 of June 9, 2025
HTML Generated on March 2, 2025