Schedule Events

Schedule Events — Interface for scheduling events.

Synopsis




gboolean    schedule_set_alarm              (guint id,
                                             time_t start,
                                             const gchar *action);
gboolean    schedule_cancel_alarm           (guint id,
                                             time_t start);

Description

The library libschedule provides functions to set scheduled alerts to notify applications of a defined event.

Details

schedule_set_alarm ()

gboolean    schedule_set_alarm              (guint id,
                                             time_t start,
                                             const gchar *action);

Set a new alert including an action which should become executed at the alarm time.

`id` :	Unique alarm identifier.
`start` :	Time to start the alarm action.
`action` :	Command to become executed if alarm time is reached.
Returns :	TRUE on success, FALSE otherwise.

schedule_cancel_alarm ()

gboolean    schedule_cancel_alarm           (guint id,
                                             time_t start);

Cancel a schedule alarm event.

`id` :	Unique alarm identifier.
`start` :	Alarm time.
Returns :	TRUE on success, FALSE otherwise.