función MPI_Comm_dup
Duplica un comunicador existente con valores de clave asociados. Para cada valor de clave, la función de devolución de llamada de copia respectiva determina el valor de atributo asociado a esta clave en el nuevo comunicador. La devolución de llamada de copia puede, por ejemplo, eliminar el atributo del nuevo comunicador.
Sintaxis
int MPIAPI MPI_Comm_dup(
MPI_Comm comm,
_Out_ MPI_Comm *newcomm
);
Parámetros
comm
Comunicador que se va a duplicar.newcomm [out]
Al devolver, contiene un identificador para un nuevo comunicador. El nuevo comunicador tiene el mismo grupo o grupos y cualquier información almacenada en caché copiada del origen, pero contiene nueva información de contexto.
Valor devuelto
Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.
En Fortran, el valor devuelto se almacena en el parámetro IERROR .
Fortran
MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
INTEGER COMM, NEWCOMM, IERROR
Comentarios
Esta función crea un espacio de comunicación duplicado que tiene las mismas propiedades que el comunicador original. Esto incluye todos los atributos y topologías. Esta función es válida aunque haya comunicaciones de punto a punto pendientes que impliquen al comunicador de origen.
Un usuario puede llamar a la función MPI_Comm_dup al principio del proceso paralelo y liberar posteriormente el comunicador duplicado mediante la función MPI_Comm_free . También son posibles otros modelos de administración del comunicador.
Esta función se aplica tanto a los intracomunicadores como a los intercomunicadores.
Requisitos
Producto |
Paquete redistribuible de HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities |
Encabezado |
Mpi.h; Mpif.h |
Biblioteca |
Msmpi.lib |
Archivo DLL |
Msmpi.dll |