Scheduler Interface SilcSchedule SilcTask SilcTaskEvent SilcTaskCallback SilcTaskEventCallback SilcTaskNotifyCb SILC_ALL_TASKS SILC_TASK_CALLBACK SILC_TASK_EVENT_CALLBACK silc_schedule_init silc_schedule_uninit silc_schedule_stop silc_schedule silc_schedule_one silc_schedule_wakeup silc_schedule_get_parent silc_schedule_get_context silc_schedule_get_stack silc_schedule_set_notify silc_schedule_set_global silc_schedule_get_global silc_schedule_task_add_fd silc_schedule_task_add_timeout silc_schedule_task_add_signal silc_schedule_task_add_event silc_schedule_task_del silc_schedule_task_del_by_fd silc_schedule_task_del_by_callback silc_schedule_task_del_by_context silc_schedule_task_del_by_all silc_schedule_task_del_event silc_schedule_set_listen_fd silc_schedule_get_fd_events silc_schedule_unset_listen_fd silc_schedule_event_connect silc_schedule_event_disconnect silc_schedule_event_signal

silc_schedule_event_signal

SYNOPSIS

    SilcBool silc_schedule_event_signal(SilcSchedule schedule,
                                        const char *event,
                                        SilcTask task, ...);

DESCRIPTION

Signals an event task. The `event' or `task' must be non-NULL. If `event' is non-NULL it is the name of the event to signal. If the `task' is non-NULL it is the event task to be signalled. It is marginally faster to use the `task' pointer directly instead of `event' to send the signal.

The variable arguments are the arguments to be sent in the signal to the connected entities. The silc_schedule_task_add_event defines what arguments must be sent to each signal. The variable argument list must not be ended with SILC_PARAM_END even though it is ended with that in silc_schedule_task_add_event.

Signal delivery is synchronous; the signal is delivered inside this function. If a receiver was originally in another thread, the signal is delivered in the thread where this function is called. This means that concurrency control (locking) is required if the application uses events in multiple threads.

EXAMPLE

    silc_schedule_event_signal(schedule, "foo event", NULL, intarg, buffer);