cray_upc_op_create

Date:

09-23-2013

NAME

cray_upc_op_create - Create a user-defined UPC operation

SYNOPSIS

#include <upc_collective_cray.h>

cray_upc_return_t cray_upc_op_create( cray_upc_user_fun *function,
                                             int commute, upc_op_t *new_op );

DESCRIPTION

The cray_upc_op_create function associates a user-defined function with a upc_op_t(3c) value for use with collective reductions. The resulting value is local to the thread on which it was created and cannot be used on any other thread. If a user-defined operation is used in a collective, the results are undefined if different ranks pass in operations that use different functions.

RETURN VALUE

The cray_upc_op_create function returns CRAY_UPC_SUCCESS if it successfully created the new operation and assigned its handle to *new_op, or CRAY_UPC_ERROR if an error occurred.

SEE ALSO

cray_upc_op_free(3c), cray_upc_team_allreduce(3c), cray_upc_team_reduce(3c), cray_upc_user_fun(3c), upc_dtype_t,(3c), upc_op_t(3c)