MPI_Open_port function

Establishes an address that can be used to establish connections between groups of MPI processes.

Syntax

int MPIAPI MPI_Open_port(
   MPI_Info                          info,
   _Out_cap_(MPI_MAX_PORT_NAME) char *port_name
);

Parameters

  • info
    Implementation-specific information on how to establish a port for MPI_Comm_accept.

  • port_name
    Newly established port.

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_OPEN_PORT(INFO, PORT_NAME, IERROR)
        CHARACTER*(*) PORT_NAME
        INTEGER INFO, IERROR

Remarks

MPI copies a system-supplied port name into port_name. port_name identifies the newly opened port and can be used by a client to contact the server. The maximum size string that may be supplied by the system is MPI_MAX_PORT_NAME.

Reserved Info Key Values:

  • ip_port - Value contains IP port number at which to establish a port.
  • ip_address - Value contains IP address at which to establish a port.

If the address is not a valid IP address of the host on which the MPI_Open_port call is made, the results are undefined.

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 Process Management Functions