Kommandolinjegrænseflade

Kommandolinjeflag er der for at gøre det muligt for andre programmer (såsom alarmdæmonen) at starte KAlarm hvis den ikke allerede kører, til at vise eller annullere skemalagte beskeder, eller skemalægge nye beskeder. Grunden til at kommandolinjeflag bruges til dette formål er at hvis KAlarm startedes uden kommandolinjeflag og DCOP-kald siden blev sendt, så ville det starte i den forvalgte grafiske tilstand, hvilket helt klart ikke er ønskværdigt for en forespørgsel mellem programmer.

Bemærk

Programmer bør først kontrollere om KAlarm allerede kører. Hvis dette er tilfældet, bør de i stedet bruge DCOP-kald til at bede om disse handlinger.

Kommandolinjeflagene til at skemalægge en ny alarmbesked beskrives i kapitlet Kommandolinjeoperation. Valgmulighederne for at udløse og annullere skemalagte alarmer er følgende:

Bemærk

Normale brugere kan også, hvis de ønsker det, bruge disse kommandolinjeflag (under antagelse af at de kan angive den nødvendige parameterinformation).

TilvalgBeskrivelse
--calendarURL urlBrug kalenderfilen med angiven URL. Dette bruges kun til integritetskontrol: Hvis URL'en ikke angiver KAlarms nuværende standardkalenderfil, så ignoreres forespørgslen.
--cancelEvent begivenheds-IDAnnullér begivenheden med med den angivne begivenheds-ID.
--triggerEvent begivenheds-IDUdløs begivenheden med den angivne begivenheds-ID. Handlingen som udføres er den samme som for triggerEvent() DCOP-kaldet.
--handleEvent begivenheds-IDUdløs eller annullér begivenheden med den angivne begivenheds-ID. KAlarm afgør hvilken handling der behøves på samme måde som for handleEvent() DCOP-kaldet.

--cancelEvent, --triggerEvent og --handleEvent er gensidigt udelukkende. --calendarURL er valgfri, men kan kun bruges med et af de andre tre flag.

Nogle eksempler:

% kalarm --triggerEvent KAlarm-387486299.702 --calendarURL file:/home/zaphod/hydra.ics
% kalarm --cancelEvent KAlarm-388886299.793