cma_cond_delete

Deletes a condition variable.

Syntax

cma_cond_delete( condition);

Argument Data Type Access

condition opaque cma_t_cond modify

C Binding

#include 


void
cma_cond_delete (
         cma_t_cond   *condition);

Arguments

condition: Handle of the condition variable deleted.

Description

This routine deletes a condition variable. Call this routine when a condition variable is no longer referenced. The effect of calling this routine is to give permission to reclaim storage for the condition variable.

When the condition variable is deleted, the condition argument is set to the value cma_c_null. Specifying cma_c_null for condition is legal and has no effect.

The results of this routine are unpredictable and the cma_ e_existence exception is raised if the handle specified in condition refers to a condition variable that does not currently exist (unless it is cma_c_null).

The results of this routine are unpredictable and the cma_e_in_use exception is raised if there are threads waiting for the specified condition variable to be signaled or broadcasted when it is deleted.

Exceptions

cma_e_existence
cma_e_in_use
cma_e_use_error