cray_upc_team_t

Date:

03-31-2014

NAME

cray_upc_team_t - Type definition for a Cray UPC team handle

SYNOPSIS

#include <upc_collective_cray.h>

DESCRIPTION

Cray UPC teams are ordered sets of UPC threads. Every UPC thread in a team of size s has an integer rank r such that 0 <=*r* < s. A thread’s rank in a team can be queried using the cray_upc_team_rank(3c) function. The size of a team can be queried using the cray_upc_team_size(3c) function.

cray_upc_team_t(3c) defines a handle for a Cray UPC team. It is a local handle that cannot be shared between UPC threads. Using a handle created on a different thread will cause undefined behavior.

Two special handles are predefined by the runtime. Passing either of these two handles to cray_upc_team_free(3c) results in undefined behavior:

  • CRAY_UPC_TEAM_ALL

  • Contains every UPC thread in thread order. Similar to MPI_COMM_WORLD.

  • CRAY_UPC_TEAM_NODE

  • Contains all threads who are running on the same compute node; they have the same value of MYNODE, also in thread order.

SEE ALSO

cray_upc_team_rank(3c), cray_upc_team_size(3c), cray_upc_team_split(3c), cray_upc_team_free(3c), cray_upc_barrier(3c), cray_upc_team_reduce(3c), cray_upc_team_allreduce(3c)