Command line options are provided to enable other programs (such as the alarm daemon) to start up KAlarm if it is not already running, in order to display or cancel scheduled messages, or schedule new messages. The reason for using command line options for this purpose is that if KAlarm were started without any command line parameters and then sent DCOP requests, it would start in its default graphical mode, which is clearly undesirable for an inter-program request.
![]() |
Programs should first check whether KAlarm is already running; if it is, they should instead use DCOP calls to request these operations. |
The command line options for scheduling a new alarm message are as described in the chapter Using KAlarm. The options for displaying and cancelling scheduled messages are as follows:
![]() |
Normal users may also if they wish use these command line options (assuming that they can supply the necessary parameter information). |
Option | Description |
---|---|
--calendarURL url | Use the calendar file with the specified URL. This option is only used for integrity checking: if the URL doesn't specify KAlarm's current default calendar file, the request will be ignored. |
--cancelEvent eventID | Cancel the event with the specified event ID. |
--displayEvent eventID | Display the event with the specified event ID. |
--handleEvent eventID | Display or cancel the event with the specified event ID. KAlarm determines which action to take in the same way as for the handleEvent() DCOP call. |
--cancelEvent, --displayEvent and --handleEvent are mutually exclusive. --calendarURL is optional, but can only be used with one of the other three options.
Examples are: