The upc_all_gather function

Synopsis

    
    #include <upc.h>
    #include <upc_collective.h>
    void upc_all_gather(shared void * restrict dst, 
                        shared const void * restrict src, 
                        size_t nbytes, 
                        upc_flag_t flags); 

Description

The upc_all_gather function copies a block of shared memory that has affinity to the ith thread to the ith block of a shared memory area that has affinity to a single thread. The number of bytes in each block is nbytes.

nbytes must be strictly greater than 0.

The upc all gather function treats the src pointer as if it pointed to a shared memory area of nbytes bytes on each thread and therefore had type:

    shared [nbytes] char[nbytes * THREADS]

and it treats the dst pointer as if it pointed to a shared memory area with the type:

    shared [] char[nbytes * THREADS]
    

The target of the src pointer must have affinity to thread 0.

The src pointer is treated as if it has phase 0.

For each thread i, the effect is equivalent to copying the block of nbytes bytes pointed to by src that has affinity to thread i to the ith block of nbytes bytes pointed to by dst.

 

 

Terms, definitions, and symbols

Back to index of all UPC functions