interrupt_queueSignal¶

Synopsis¶

#include <sys/interrupt.h>

int interrupt_queueSignal(handle_t queue);

Status¶

Implemented

Conformance¶

Phoenix-RTOS specific

Description¶

The interrupt_queueSignal() function shall unblock at least one thread waiting on the interrupt queue queue, created with either interrupt_queueCreate() or interrupt_queueCreateLocked().

The function is intended to be called from the thread context only - it must not be used inside an interrupt handler. The kernel signals the queue on its own after the handler returns a value greater than or equal to zero.

The queue is sticky: if it is signaled while no thread is waiting on it, the next call to interrupt_queueWait() or interrupt_queueWaitLocked() shall return immediately.

No mutex is required to call this function, regardless of how the queue was created.

Return value¶

Upon successful completion, a value of zero shall be returned; otherwise, an error number shall be returned to indicate the error.

Errors¶

The interrupt_queueSignal() function shall fail if:

-EINVAL - The value queue does not refer to a valid interrupt queue.