kupl_shm_win_free
Frees the win.
Interface Definition
int kupl_shm_win_free(kupl_shm_win_h win)
Parameters
Parameter |
Type |
Description |
Input/Output |
|---|---|---|---|
win |
kupl_shm_win_h |
Window object to be freed. |
Input |
Return Value
- Success: KUPL_OK
- Failure: KUPL_ERROR
Examples
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 | #include <stdio.h> #include <mpi.h> #include <unistd.h> #include <string.h> #include "kupl.h" // Callback 1 required for creating a KUPL communicator. static int oob_barrier_callback(void *group) { return MPI_Barrier((MPI_Comm)group); } // Callback 2 required for creating a KUPL communicator. static int oob_allgather_callback(const void *sendbuf, void *recvbuf, int size, void *group, kupl_shm_datatype_t datatype) { switch (datatype) { case KUPL_SHM_DATATYPE_CHAR: return MPI_Allgather(sendbuf, size, MPI_CHAR, recvbuf, size, MPI_CHAR, (MPI_Comm)group); default: fprintf(stderr, "not support datatype"); return KUPL_ERROR; } } int main(int argc, char *argv[]) { // Initialize the MPI environment. MPI_Init(&argc, &argv); MPI_Comm comm = MPI_COMM_WORLD; // Obtain the size of the MPI communicator. int world_size; MPI_Comm_size(comm, &world_size); // Obtain the rank of the process. int world_rank; MPI_Comm_rank(comm, &world_rank); // Obtain the PID. int pid = getpid(); // Create a KUPL communicator. kupl_shm_oob_cb_t oob_cbs; kupl_shm_oob_cb_h oob_cbs_h = &oob_cbs; oob_cbs_h->oob_allgather = oob_allgather_callback; oob_cbs_h->oob_barrier = oob_barrier_callback; kupl_shm_comm_h kupl_comm; int ret = kupl_shm_comm_create(world_size, world_rank, pid, oob_cbs_h, (void *)comm, &kupl_comm); if (ret != KUPL_OK || kupl_comm == NULL) { fprintf(stderr, "kupl shm comm create failed: %d\n", ret); return -1; } // Allocate the shared memory. kupl_shm_win_h win; void *local_buffer; int count = 4; size_t buf_size = count * sizeof(int); ret = kupl_shm_win_alloc(buf_size, kupl_comm, &local_buffer, &win); if (ret != KUPL_OK) { fprintf(stderr, "kupl shm win alloc failed: %d\n", ret); return -1; } // Process 0 assigns a value to its own buffer. if (world_rank == 0) { for (int i = 0; i < count; i++) { ((int *)local_buffer)[i] = i; } } // All other processes obtain the buffer of process 0 for memcpy. if (world_rank != 0) { void *remote_buffer; int remote_rank = 0; kupl_shm_win_query(win, remote_rank, &remote_buffer); memcpy(local_buffer, remote_buffer, buf_size); // Check whether memcpy is successful. bool check = true; for (int i = 0; i < count; i++) { if (((int *)local_buffer)[i] != i) { check = false; break; } } if (check) { printf("check success\n"); } else { printf("check fail\n"); } } // Destroy the shared memory. kupl_shm_win_free(win); // Destroy the KUPL communicator. kupl_shm_comm_destroy(kupl_comm); MPI_Finalize(); return 0; } |
The execution result is as follows:
check success
The preceding example demonstrates how to create, query, and free a KUPL window. The kupl_shm_win_free function frees the KUPL window created by kupl_shm_win_alloc.
Parent topic: Shared Memory Communication Functions