funzione MPI_Win_lock

Avvia un periodo di accesso RMA nel processo di destinazione.

Sintassi

int MPIAPI MPI_Win_lock(
   int     lock_type,
   int     rank,
   int     assert,
   MPI_Win win
);

Parametri

• lock_type
  Indica se altri processi possono accedere alla finestra di destinazione contemporaneamente (se MPI_LOCK_SHARED) o meno (MPI_LOCK_EXCLUSIVE).

• rango
  Classificazione della finestra bloccata.

• Affermare
  Usato per ottimizzare questa chiamata; zero può essere usato come valore predefinito.

• Vincere
  Oggetto Window.

Valore restituito

Restituisce MPI_SUCCESS in caso di esito positivo. In caso contrario, il valore restituito è un codice di errore.

In Fortran il valore restituito viene archiviato nel parametro IERROR .

Fortran

    MPI_WIN_LOCK(LOCK_TYPE, RANK, ASSERT, WIN, IERROR)
        INTEGER LOCK_TYPE, RANK, ASSERT, WIN, IERROR

Commenti

Il nome di questa routine è fuorviante. In particolare, questa routine non deve essere bloccata, tranne quando il processo di destinazione è il processo chiamante.

Le implementazioni possono limitare l'uso della comunicazione RMA sincronizzata dalle chiamate di blocco alle finestre in memoria allocate da MPI_Alloc_mem. I blocchi possono essere usati in modo portabile solo in tale memoria.

L'argomento assert viene usato per indicare condizioni speciali per l'isolamento che un'implementazione può usare per ottimizzare l'operazione di MPI_Win_fence . Il valore zero è sempre corretto. Altri valori di asserzione possono essere ORed insieme. Le asserzioni valide per MPI_Win_fence sono:

• MPI_MODE_NOCHECK : nessun altro processo contiene o tenterà di acquisire un blocco in conflitto, mentre il chiamante mantiene il blocco della finestra. Ciò è utile quando si ottiene l'esclusione reciproca con altri mezzi, ma le operazioni di coerenza che possono essere collegate al blocco e alle chiamate di sblocco sono ancora necessarie.

Requisiti

Prodotto	Pacchetto ridistribuibile DI HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o utilità client HPC Pack 2008
Intestazione	Mpi.h; Mpif.h
Libreria	Msmpi.lib
DLL	Msmpi.dll

Vedi anche

Funzioni di comunicazione mpi One-Sided