MPI_Win_create_dynamic function

Creates a window that allows the user to dynamically control which memory is exposed by the window.

Syntax

int MPIAPI MPI_Win_create_dynamic(
        MPI_Info info,
        MPI_Comm comm,
  _Out_ MPI_Win  *win
);

Parameters

• info
  Info argument.

• comm
  Communicator.

• win [out]
  Window object returned by the call.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_WIN_CREATE_DYNAMIC(INFO, COMM, WIN, IERROR)
        INTEGER INFO, COMM, WIN, IERROR

Remarks

This is a collective call executed by all processes in the group of comm. It returns a window win without memory attached. This routine returns a window object that can be used by these processes to perform RMA operations on attached memory.

The info argument can be used to specify hints similar to the info argument for MPI_Win_create.

In the case of a window created with MPI_Win_create_dynamic, the target_disp for all RMA functions is the address at the target; i.e., the effective window_base is MPI_BOTTOM and the disp_unit is one. For dynamic windows, the target_disp argument to RMA communication operations is not restricted to non-negative values. Users should use MPI_Get_address at the target process to determine the address of a target memory location and communicate this address to the origin process.

Requirements

See also

MPI One-Sided Communications Functions