MPI_Cancel funkce

Zruší žádost o komunikaci.

Syntaxe

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

Parametry

• request [in]
  Žádost o komunikaci.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Poznámky

Primární očekávané použití MPI_Cancel je v systémech s více vyrovnávacími paměti, kde se provádějí spekulativní MPI_Irecv. Po dokončení výpočtu mohou některé z těchto požadavků zůstat; pomocí MPI_Cancel umožňuje uživateli zrušit tyto nespokojené žádosti.

Zrušení operace odeslání je mnohem obtížnější, z velké části proto, že odeslání bude obvykle alespoň částečně dokončeno (informace o značce, velikosti a zdroji se obvykle odesílají okamžitě do cíle). Uživatelům se doporučuje, že zrušení odeslání, zatímco místní operace (definovaná standardem MPI) bude pravděpodobně nákladná (obvykle generování jedné nebo více interních zpráv).

Požadavky

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities
Hlavička	Mpi.h; Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce MPI typu point-to-point