Context management routines

Context management routines#

ROCSHMEM_CTX_CREATE#

__device__ int rocshmem_wg_ctx_create(int64_t options, rocshmem_ctx_t *ctx)#
__device__ int rocshmem_wg_team_create_ctx(rocshmem_team_t team, long options, rocshmem_ctx_t *ctx)#
Parameters:

  • team – Team handle to derive the context from.

  • options – Options for context creation. Ignored in current design; use the value 0.

  • ctx – Context handle.

Returns:

All threads returns 0 if the context was created successfully. If any thread returns non-zero value, the operation fails and a higher number of ROCSHMEM_MAX_NUM_CONTEXTS is required.

Description: This routine creates an OpenSHMEM context. By design, the context is private to the calling work-group. It must be called collectively by all threads in the work-group.

ROCSHMEM_CTX_DESTROY#

__device__ void rocshmem_wg_ctx_destroy(rocshmem_ctx_t *ctx)#
Parameters:

ctx – Context handle.

Returns:

None.

Description: This routine destroys an rocSHMEM context. It must be called collectively by all threads in the work-group.

ROCSHMEM_GET_DEVICE_CTX#

__host__ void *rocshmem_get_device_ctx()#
Param:

None.

Returns:

Returns ROCSHMEM_CTX_DEFAULT device pointer that users. can query from one instance of rocSHMEM host library and use later for dynamic module initialization in kernel bitcode device library in the same application.

Description: This routine queries rocSHMEM default device context from host API.

Contents