MPI_Win_shared_query function

Queries the process-local address for remote memory segments created with MPI_Win_allocate_shared.

Syntax

int MPIAPI MPI_Win_shared_query(
        MPI_Win  *win
        int      rank,
  _Out_ MPI_Aint *size,
  _Out_ int      *disp_unit,
  _Out_ void     *baseptr
);

Parameters

• win [in]
  Shared memory window object.

• rank
  Rank in the group of window win (non-negative integer) or MPI_PROC_NULL.

• size [out]
  Size of the window segment.

• disp_unit [out]
  Local unit size for displacements, in bytes.

• baseptr [out]
  Address for load/store access to window segment.

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_SHARED_QUERY(WIN, RANK, SIZE, DISP_UNIT, BASEPTR, IERROR)
        INTEGER WIN, RANK, DISP_UNIT, IERROR
        INTEGER (KIND=MPI_ADDRESS_KIND) SIZE, BASEPTR

Remarks

This function queries the process-local address for remote memory segments created with MPI_Win_allocate_shared. This function can return different process-local addresses for the same physical memory on different processes.

Requirements

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Library	Msmpi.lib
DLL	Msmpi.dll

See also

MPI One-Sided Communications Functions