Signals

Directives provided are: More...

Collaboration diagram for Signals:

Modules
	Signals Implementation

Files
file	signal.h
	Signals API.
file	signal.c
	Signal Manager Initialization.
file	signalcatch.c
	RTEMS Catch Signal.
file	signalsend.c
	RTEMS Send Signal.

Functions
rtems_status_code	rtems_signal_catch (rtems_asr_entry asr_handler, rtems_mode mode_set)
	RTEMS Catch Signal. More...
rtems_status_code	rtems_signal_send (rtems_id id, rtems_signal_set signal_set)
	RTEMS Send Signal. More...

Detailed Description

Directives provided are:

• establish an asynchronous signal routine
• send a signal set to a task

Function Documentation

rtems_signal_catch()

rtems_status_code rtems_signal_catch	(	rtems_asr_entry	asr_handler,
		rtems_mode	mode_set
	)

RTEMS Catch Signal.

This routine implements the rtems_signal_catch directive. This directive is used to establish asr_handler as the Asynchronous Signal Routine (RTEMS_ASR) for the calling task. The asr_handler will execute with a mode of mode_set.

Parameters

[in]	asr_handler	is the address of asynchronous signal routine (asr) ( NULL indicates asr is invalid )
[in]	mode_set	is the mode value for asr

Return values

RTEMS_SUCCESSFUL

References _ASR_Initialize(), _ASR_Is_null_handler(), _Thread_Disable_dispatch(), _Thread_Enable_dispatch(), _Thread_Get_executing(), Thread_Control::API_Extensions, ASR_Information::handler, ASR_Information::mode_set, RTEMS_SUCCESSFUL, RTEMS_API_Control::Signal, and THREAD_API_RTEMS.

rtems_signal_send()

rtems_status_code rtems_signal_send	(	rtems_id	id,
		rtems_signal_set	signal_set
	)

RTEMS Send Signal.

This routine implements the rtems_signal_send directive. This directive sends the signal_set to the task specified by ID.

Parameters

[in]	id	is the thread thread id
[in]	signal_set	is the signal set

Return values

RTEMS_SUCCESSFUL

if successful or error code if unsuccessful

References _Thread_Get(), and RTEMS_INVALID_NUMBER.