fungsi MPI_Comm_dup

Menduplikasi komunikator yang ada dengan nilai kunci terkait. Untuk setiap nilai kunci, fungsi panggilan balik salinan masing-masing menentukan nilai atribut yang terkait dengan kunci ini di komunikator baru. Panggilan balik salin dapat, misalnya, menghapus atribut dari komunikator baru.

Sintaks

int MPIAPI MPI_Comm_dup(
        MPI_Comm comm,
  _Out_ MPI_Comm *newcomm
);

Parameter

• Comm
  Komunikator untuk menduplikasi.

• newcomm [out]
  Saat kembali, berisi handel ke komunikator baru. Komunikator baru memiliki grup atau grup yang sama dan informasi cache apa pun yang disalin dari sumbernya, tetapi berisi informasi konteks baru.

Nilai kembali

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .

Fortran

    MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
        INTEGER COMM, NEWCOMM, IERROR

Keterangan

Fungsi ini menciptakan ruang komunikasi duplikat yang memiliki properti yang sama dengan komunikator asli. Ini termasuk atribut dan topologi apa pun. Fungsi ini valid bahkan jika ada komunikasi titik-ke-titik yang tertunda yang melibatkan komunikator sumber.

Pengguna dapat memanggil fungsi MPI_Comm_dup di awal proses paralel dan kemudian membebaskan komunikator duplikat dengan menggunakan fungsi MPI_Comm_free . Model manajemen komunikator lainnya juga dimungkinkan.

Fungsi ini berlaku untuk intrakomunikator dan interkomunikator.

Persyaratan

Produk	Paket HPC Pack 2012 MS-MPI Redistributable, HpC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package atau HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Pustaka	Msmpi.lib
DLL	Msmpi.dll

Lihat juga

Fungsi Komunikator MPI