funzione MPI_Cancel
Annulla una richiesta di comunicazione.
Sintassi
int MPIAPI MPI_Cancel(
_In_ MPI_Request *request
);
Parametri
-
richiesta [in]
Richiesta di comunicazione.
Valore restituito
Restituisce MPI_SUCCESS sull'esito positivo. In caso contrario, il valore restituito è un codice di errore.
In Fortran il valore restituito viene archiviato nel parametro IERROR .
Fortran
MPI_CANCEL(REQUEST, IERROR)
INTEGER REQUEST, IERROR
Commenti
L'uso principale previsto di MPI_Cancel è in schemi di multi-buffering, in cui vengono realizzati MPI_Irecvspeculativi. Al termine del calcolo, alcune di queste richieste di ricezione potrebbero rimanere; usando MPI_Cancel consente all'utente di annullare queste richieste non soddisfatte.
L'annullamento di un'operazione di invio è molto più difficile, in gran parte perché l'invio in genere sarà almeno parzialmente completato (le informazioni sul tag, le dimensioni e l'origine vengono in genere inviate immediatamente alla destinazione). Gli utenti consigliano di annullare un invio, mentre un'operazione locale (come definito dallo standard MPI), è probabile che sia costoso (in genere generando uno o più messaggi interni).
Requisiti
Prodotto |
Pacchetto ridistribuibile HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |