cma_thread_alert

Allows a thread to request that it or another thread terminate execution.

Syntax

cma_thread_alert( thread);

Argument Data Type Access

thread opaque cma_t_thread read

C Binding

#include 


void
cma_thread_alert (
         cma_t_thread   *thread);

Arguments

thread: Handle of the thread that receives an alert.

Description

This routine sends an alert to the specified thread. Issuing an alert does not guarantee that the alerted thread will receive or handle the alert. The alerted thread can delay processing the alert after receiving it. For example, if the alerted thread has disabled alerts during an important operation, it will continue because it cannot be interrupted at the point where the alert is requested.

Because of communication delays, the calling thread can only rely on the fact that an alert will eventually become pending in the designated thread (provided that the thread does not terminate beforehand). Furthermore, the calling thread has no guarantee that a pending alert will be delivered because delivery is controlled by the designated thread.

The cma_e_existence exception is raised if the value specified in thread is cma_c_null, or if it refers to a thread that does not currently exist.

This routine is not alertable.

Exceptions

cma_e_existence
cma_e_use_error