Kapitel 4. Kommandolinjeflag

Indholdsfortegnelse

Skemalæg en ny alarm
Øvrige tilvalg
Hjælpetilvalg

Når kommandolinjeflag angives, viser KAlarm ikke listen med skemalagte alarmer som beskrevet i Brug af KAlarm ovenfor. Specielle kommandolinjeflag for KAlarm kan bruges til at udføre følgende operationer:

Yderligere kommandolinjeflag er tilgængelige først og fremmest for at lade andre programmer kunne arbejde sammen med KAlarm. De beskrives i kapitlet Udviklingsguide for KAlarm.

Kommandolinjen må kun indeholde flag for én KAlarm-operation. Hvis du vil udføre flere operationer, skal du kalde KAlarm flere gange, med et enkelt sæt flag hver gang.

Skemalæg en ny alarm

Følgende flag bruges til at skemalægge en ny alarm:

TilvalgBeskrivelse
-a, --ack-confirmSpørg en ekstra gang når du bekræfter alarmen.
-A, --attach URLAngiv sti eller URL for en fil som skal vedlægges e-mail. Dette tilvalg kan gentages efter behov. --mail skal angives sammen med dette flag.
--auto-closeLuk alarmvinduet automatisk efter udløb af --late-cancel perioden. --late-cancel skal være angivet med dette tilvalg.
-b, --beepAfgiv en hørbar lyd når meddelelsen vises. --speak, --play og --play-repeat kan ikke angives med dette flag.
--bccSend en blind kopi af e-mailen til dig selv. --mail skal angives med dette flag.
-c, --color, --colour farveVis beskeden med baggrundsfarven ifølge det angivne Qt™-farvenavn eller den hexadecimal kode 0xRRGGBB.
-C, --colorfg, --colourfg farveVis beskeden med forgrundsfarven ifølge det angivne Qt™-farvenavn eller den hexadecimale kode 0xRRGGBB.
-d, --disableDeaktivér alarmen. Den vil ikke blive udløst før den er blevet aktiveret manuelt.
-e, --exec kommandolinjeAngiver en skalkommando som skal køres. Hvis dette er angivet, så skal dette flag være det sidste på KAlarms kommandolinje. Alle efterfølgende kommandolinjeflag tolkes som om de udgør kommandolinjen som skal køres. --file og --mail kan ikke angives sammen med dette flag. --ack-confirm, --beep, --color og --colorfg ignoreres med dette flag.
-f, --file URLAngiv sti eller URL for en tekst- eller billedfil hvis indhold skal bruges som alarmbesked. --exec og --mail kan ikke angives, og beskeden må ikke være til stede med dette flag.
-F, --from-id IDBrug angiven KMail-identitet som afsender af brevet. --mail skal angives med dette flag.
-i, --interval periodeAngiv intervallet mellem gentagelser af alarmen. Timer/minutter angives i formatet nHnM, hvor n er et tal, f.eks. 3H30M. Andre tidsperioder angives i formatet nX, hvor n er et tal og X er et af følgende bogstaver: Y (år), M (måneder), W (uger), D (dage). Hvis --recurrence også er angivet er , Y (år) og M (måneder) ikke tilladt. Krævet hvis --repeat eller --until er angivet.
-k, --korganizerVis alarmen som en begivenhed i KOrganizers aktive kalender.
-l, --late-cancel periodeAnnullér alarmen hvis den ikke kan blive udløst inden den angivne periode efter det rigtige tidspunkt. periode perioden angives i samme format som beskrevet for --reminder. Standardværdien af periode er 1 minut.
-L, --loginVis alarmen hver gang du logger på. --interval, --repeat og --until kan ikke angives sammen med dette flag.
-m, --mail adresseSend e-mail til angiven adresse. Dette tilvalg kan gentages om nødvendigt. --exec og --file kan ikke angives sammen med dette flag. --ack-confirm, --beep, --color og --colorfg ignoreres med dette flag.
-p, --play URLAngiv navn eller URL for en lydfil som skal afspilles en gang når alarmmeddelelsen vises. --play-repeat, --beep og --speak kan ikke angives med dette flag.
-P, --play-repeat URLAngiv navn eller URL for en lydfil som skal afspilles gentagne gange mens alarmmeddelelsen vises. --play, --beep og --speak kan ikke angives med dette flag.
--recurrence specIndstil at alarmen skal gentages. Angiv gentagelsesinterval med iCalendar-syntaks (defined in RFC2445), f.eks. “FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO”. --until kan ikke angives med dette flag.
-r, --repeat antalSæt det antal gange alarmen skal udløses, eller hvis en gentagelse er angivet med --recurrence, antallet af gange alarmen skal udløses hver gang --recurrence aktiverer den (dvs. en repetition indeni en gentagelse). Hvis --recurrence ikke er tilstede, angives -1 for at gentage alarmen i det uendelige. --interval skal være, og --until kan ikke være angivet med dette flag.
-R, --reminder periodeVis en påmindelsesalarm det angivne tidsrum inden hovedalarmen og for hver af dens gentagelser (hvis der er nogen). Timer/minutter angives i formatet nHnM, hvor n er et tal, f.eks. 3H30M. Andre tidsperioder angives i formatet nX, hvor n er et tal og X er et af følgende bogstaver: Y (år), M (måneder), W (uger), D (dage). Dette flag kan ikke angives sammen med --exec, --mail eller --reminder-once.
--reminder-once periodUdsted en alarmpåmindelse én gang, den angivne tidslængde før den første gentagelse af alarmen. Ingen påmindelse vil blive vist før efterfølgende gentagelser (om nogen). Dette tilvalg kan ikke angives med --exec, --mail eller --reminder.
-s, --speakLæs meddelelsen op når den vises. Dette kræver at KTTSD er installeret og indstillet, sammen med en fungerede talesyntese. --beep, --play og --play-repeat kan ikke angives med dette flag.
-S, --subject emneE-mailens emne. --mail skal angives med dette flag.
-t, --time dato/tidVis alarmen på den dato eller dato/tid som angives. Angiv en dato uden en tid i formatet åååå-mm-dd, og angiv en dato og en tid med [[[åååå-]mm-]dd-]tt:mm (hvor udeladte felter antages at gælde dagens dato).
-v, --volume procentSæt lydstyrken for afspilning af lydfilen. Dette tilvalg kan kun bruges når --play eller --play-repeat er angivet.
-u, --until dato/tidGentag alarmen indtil den dato eller dato/tid som angives. Angiv en dato uden en tid i samme format som for --time. --interval skal angives, og --repeat eller --recurrence kan ikke angives sammen med dette flag.
beskedBeskedtekst som skal vises, eller hvis --mail angives, beskedteksten i e-mailen.

Enten en beskedtekst, --file eller --exec skal angives. Ellers er alle flag valgfrie, bortset fra hvor andet er angivet ovenfor.

To forskellige eksempler som viser en besked med flere linjer, med rød baggrund, klokken 20:00 den 27. i indeværende måned, er:

% kalarm -c red -t 27-22:00 "Husk  at \nSTOPPE"
% kalarm -c 0xFF0000 -t 27-22:00 "Husk  at\nSTOPPE"