# Podręcznik &kcron;

Morgan
N.
Sandquist

    morgan@pipeline.com

Gary
Meyer

    gary@meyer.net

Autor
Lauri
Watts

    lauri@kde.org

Recenzent
Michał
Bendowski

    bendowski@gmail.com

2000
Morgan N. Sandquist
&FDLNotice;
2003-09-16
3.1.91

&kcron; jest programem, który pozwala zaplanować uruchomienie określonych programów w określonym czasie.

KDE
kdeadmin
KCron
cron
crontab
Program planujący

## Wstęp

&kcron; jest programem pozwalającym zaplanować uruchomienie programów w tle. Jest graficznym interfejsem użytkownika do uniksowego programu planującego `cron`.

## Używanie programu &kcron;

Nie zapomnij uruchomić w swoim systemie demona `crond`, w przeciwnym wypadku &kcron; nie będzie działał.

### Uruchamianie &kcron;

Po uruchomieniu programu &kcron; zobaczysz podsumowanie wszystkich zaplanowanych zadań i przypisanych im zmiennych środowiskowych. Jeżeli działasz jako administrator (użytkownik root), zobaczysz zadania wszystkich użytkowników, jak i zadania systemowe. Każdy katalog może zostać rozwinięty i zwinięty z powrotem.

&kcron; w trakcie uruchamiania.
&kcron; w trakcie uruchamiania.

#### Zaplanowane zadania

Zaplanowane zadania pojawiają się w katalogu Zadania. Każde zaplanowane zadanie opisane jest następującymi właściwościami:

Nazwa

  Identyfikator danego zadania.

Wartość

  Nazwa programu i jego parametry.

Opis

  Zrozumiały dla człowieka opis zaplanowanego zadania.

Jeżeli zadanie jest wyłączone, nie pokaże się żadna nazwa programu, a jego opis będzie nieaktywny.

#### Zmienne środowiskowe

Zmienne środowiskowe pokazane są w folderze Zmienne. Przy każdej zmiennej środowiskowej wyświetlane są:

Nazwa

  Nazwa zmiennej

Wartość

  Wartość zmiennej.

Opis

  Zrozumiały opis zmiennej.

Pojawiające się tutaj zmienne środowiskowe zastąpią wszelkie inne zmienne środowiskowe dla zaplanowanych zadań. Jeżeli zmienna została wyłączona, nie pojawi się żadna wartość, a opis będzie nieaktywny.

Główne okno programu &kcron;
Główne okno programu &kcron;

### Dodawanie zadań

Żeby dodać nowe zadanie, najpierw wybierz folder Zadania, a następnie wybierz z menu Edycja Nowy... . Możesz też kliknąć prawym przyciskiem myszy i z wyświetlonego menu wybrać Nowy..., lub po prostu użyć kombinacji klawiszy Ctrl N.

#### Okno dialogowe Edytuj zadanie

Okno dialogowe Edytuj zadanie.
Okno dialogowe Edytuj zadanie

Komentarz

  Pozwala wpisać opis planowanego zadania.

Program

  Pozwala wpisać nazwę programu. Możesz wpisać względną lub bezwzględną ścieżkę dostępu. Jeżeli chcesz, możesz kliknąć przycisk Przeglądaj... i wskazać program w oknie dialogowym.

Włączone

  Żeby włączyć zadanie, zaznacz lub odznacz opcję Włączone.

Bez komunikatów

  Wyłącza zapisywanie w dzienniku zarówno polecenia, jak i jego wyniku.

Miesiące

  Wybierz miesiące, w których zadanie ma zostać uruchomione.

Dni miesiąca

  Wybierz dni miesiąca, w których zadanie ma zostać uruchomione.

Dni tygodnia

  Wybierz dni tygodnia, w których zadanie ma zostać uruchomione.

Codziennie

  Jeżeli chcesz, żeby zadanie zostało zaplanowne codziennie, wybierz opcję Uruchamiaj codziennie.

Godziny

  Wybierz godziny, w których zadanie ma zostać uruchomione.

Minuty

  Wybierz minutę w której zadanie ma zostać uruchomione. Program &kcron; nie obsługuje zadań zaplanowanych z odstępem mniejszym niż pięć minut.

OK

  Kończy tworzenie danego zadania.

Anuluj

  Anuluje tworzenie danego zadania.

Jeżeli wybierzesz zarówno dni miesiąca i tygodnia, zadanie zostanie wykonane, kiedy dowolny z tych warunków będzie spełniony. Na przykład - jeżeli wybierzesz pierwszy i piętnasty dzień miesiąca oraz każdą niedzielę, program zostanie uruchomiony każdego pierwszego i piętnastego dnia wybranych miesięcy (niezależnie od przypadającego dnia tygodnia) oraz w każdą niedzielę wybranych miesięcy (niezależnie od dnia miesiąca, w który przypada).

Zaplanowane zadanie nie jest zapisywane dopóki zmiany nie zostaną zapisane w pliku `crontab`

### Zarządzanie zaplanowanymi zadaniami

Podobnie jak przy tworzeniu nowych zadań, zmiany dokonane w istniejących zadaniach zapisane zostaną dopiero wtedy, gdy zapisany zostanie plik `crontab`.

#### Wycinanie zaplanowanego zadania

Żeby wyciąć zaplanowane zadanie, najpierw musisz je zaznaczyć. Następnie z menu wybierz Edycja Wytnij.

Możesz też użyć prawego przycisku myszy i wybrać z menu Wytnij, lub po prostu użyj kombinacji klawiszy Ctrl X.

#### Kopiowanie zaplanowanych zadań

Żeby skopiować zaplanowane zadanie, najpierw musisz je zaznaczyć. Następnie z menu wybierz Edycja Kopiuj

Możesz też użyć prawego przycisku myszy i wybrać z menu Kopiuj, lub po prostu użyj kombinacji klawiszy Ctrl C.

#### Wklejanie zaplanowanych zadań

Żeby wkleić zadanie, musi ono zostać najpierw wycięte lub skopiowane do schowka. Kiedy zadanie zostało już wycięte lub skopiowane do schowka, opcja wklejania stanie się aktywna. Żeby wkleić zadanie, wybierz katalog Zadania, a następnie wybierz w menu Edycja Wklej .

Możesz też użyć prawego przycisku myszy i wybrać z menu Wklej, lub po prostu użyj kombinacji klawiszy Ctrl V.

#### Edycja zaplanowanych zadań

Żeby zmodyfikować zadanie, najpierw trzeba je zaznaczyć. Następnie należy wybrać z menu Edycja Edytuj... .

Możesz też użyć prawego przycisku myszy i wybrać z menu Edytuj, lub po prostu użyć kombinacji klawiszy Ctrl O. Zobaczysz okno dialogowe Edytuj zadanie.

#### Usuwanie zaplanowanych zadań

Żeby usunąć zadanie, najpierw trzeba je zaznaczyć. Następnie należy wybrać z menu Edycja Usuń.

Możesz też użyć prawego przycisku myszy i wybrać z menu Usuń.

#### Włączanie i wyłączanie zaplanowanych zadań

Żeby włączyć lub wyłączyć zadanie, najpierw trzeba je zaznaczyć. Wyłączone zadania będą w opisie zawierały słowo Wyłączone. Następnie należy wybrać z menu Edycja Włączone.

Możesz też użyć prawego przycisku myszy i wybrać z menu Włączone. Upewnij się, że nazwa, opis i parametry zaplanowanego zadania są prawidłowe.

#### Uruchamianie zaplanowanych zadań

Żeby uruchomić zaplanowane zadanie w danym momencie, zaznacz je, a następnie wybierz z menu Edycja Uruchom teraz.

Możesz też użyć prawego przycisku myszy i wybrać z menu Uruchom teraz.

### Dodawanie zmiennych środowiskowych

Żeby utworzyć nową zmienną środowiskową, najpierw wybierz katalog Zmienne. Następnie wybierz z menu Edycja Nowy... .

Możesz też użyć prawego przycisku myszy i wybrać z menu Nowy..., lub po prostu użyj kombinacji klawiszy Ctrl N.

#### Okno dialogowe Edytuj zmienną

Okno dialogowe Edytuj zmienną.
Okno dialogowe Edytuj zmienną.

Zmienna

  Podaj nazwę zmiennej. Możesz skorzystać z rozwijanego menu, w celu wyboru najpopularniejszych zmiennych środowiskowych, używanych w zaplanowanych zadaniach. Należą do nich:

  HOME

    Zawartość tej zmiennej zostanie użyta zamiast domyślnego katalogu domowego użytkownika.

  MAILTO

    Adres e-mail zawarty w tej zmiennej zostanie użyty przy wysyłaniu poczty zamiast domyślnego adresu e-mail użytkownika.

  PATH

    Ścieżki dostępu do katalogów, w których mogą znajdować się pliki programów.

  SHELL

    Powłoka, która zostanie użyta zamiast domyślnej powłoki użytkownika.

Wartość

  Podaj wartość zmiennej.

Komentarz

  Podaj opis zmiennej środowiskowej, na przykład jej znaczenie.

Włączone

  Żeby włączyć lub wyłączyć zmienną, zaznacz lub odznacz pole Włączone.

OK

  Zatwierdza ustawienie tej zmiennej środowiskowej.

Anuluj

  Anuluje ustawianie zmiennej środowiskowej.

Zmienna środowiskowa nie jest ustawiana, dopóki zmiany w pliku `crontab` nie zostaną zapisane.

### Zarządzanie zmiennymi środowiskowymi

Podobnie jak w przypadku tworzenia nowych zmiennych środowiskowych, zmiany wprowadzone w zmiennych nie zostaną zapisane, dopóki zapisany nie zostanie plik `crontab`.

#### Wycinanie zmiennych środowiskowych

Żeby wyciąć zmienną środowiskową, najpierw musisz ją zaznaczyć. Następnie wybierz z menu Edycja Wytnij .

Możesz też użyć prawego przycisku myszy i wybrać z menu Wytnij, lub po prostu użyj kombinacji klawiszy Ctrl X.

#### Kopiowanie zmiennych środowiskowych

Żeby skopiować zmienną środowiskową, najpierw musisz ją zaznaczyć. Następnie wybierz z menu Edycja Kopiuj .

Możesz też użyć prawego przycisku myszy i wybrać z menu Kopiuj, lub po prostu użyj kombinacji klawiszy Ctrl C.

#### Wklejanie zmiennych środowiskowych

Żeby wkleić zmienną środowiskową, musi ona zostać najpierw wycięta lub skopiowana do schowka. Kiedy zmienna została już wycięta lub skopiowana do schowka, opcja wklejania stanie się aktywna. Żeby wkleić zmienną, wybierz katalog Zmienne, a następnie wybierz w menu Edycja Wklej .

Możesz też użyć prawego przycisku myszy i wybrać z menu Wklej, lub po prostu użyj kombinacji klawiszy Ctrl V.

#### Edycja zmiennych środowiskowych

Żeby zmodyfikować zmienną, najpierw trzeba ją zaznaczyć. Następnie należy wybrać z menu Edycja Edytuj.... Możesz też użyć prawego przycisku myszy i wybrać z menu Edytuj, lub po prostu użyć kombinacji klawiszy Ctrl O. Zobaczysz okno dialogowe Edytuj zmienną, w którym możesz edytować zmienną w ten sam sposób, jak opisano powyżej.

#### Usuwanie zmiennych środowiskowych

Żeby usunąć zmienną, najpierw trzeba ją zaznaczyć. Następnie należy wybrać z menu Edycja Usuń.

Możesz też użyć prawego przycisku myszy i wybrać z menu Usuń.

#### Włączanie i wyłączanie zmiennych środowiskowych

Żeby włączyć lub wyłączyć zmienną, najpierw trzeba ją zaznaczyć. Wyłączone zmienne będą w opisie zawierały słowo Wyłączone. Następnie należy wybrać z menu Edycja Włączone.

Możesz też użyć prawego przycisku myszy i wybrać z menu Włączone. Upewnij się, że nazwa i wartość zmiennej są prawidłowe.

### Zapisywanie pliku `crontab`

Kiedy wszystkie zaplanowane zadania i zmienne środowiskowe zostały utworzone i/lub odpowiednio zmodyfikowane, zapisz plik `crontab` wybierając z menu Plik Zapisz .

Możesz też użyć kombinacji klawiszy &Ctrl;S. Dopóki tego nie uczynisz, wszelkie zmiany nie zostaną dokonane.

### Drukowanie harmonogramu (pliku `crontab`)

Żeby wydrukować plik `crontab` w takiej postaci, w jakiej został zapisany, wybierz z menu Plik Drukuj .

Drukowanie harmonogramu
Drukowanie harmonogramu

Wyświetlone zostanie domyślne okno dialogowe drukowania &kde;. Jeżeli klikniesz opcję Opcje zobaczysz dwie dodatkowe opcje drukowania, charakterystyczne dla programu &kcron;.

Drukuj harmonogram

  Pozwala wydrukować harmonogram z pliku `crontab` bieżącego użytkownika.

Drukuj dane wszystkich użytkowników

  Pozwala wydrukować pliki `crontab` wszystkich użytkowników. Ta opcja jest aktywna jedynie dla użytkowników z uprawnieniami administracyjnymi.

## Polecenia

### Główne okno programu &kcron;

#### Menu Plik

&Ctrl;S Plik Zapisz

  Zapisuje zmiany w pliku `crontab`.

&Ctrl;P Plik Drukuj...

  Drukuje zawartość pliku `crontab`.

&Ctrl;Q Plik Zakończ

  Kończy pracę programu &kcron;.

#### Menu Edycja

&Ctrl;X Edycja Wytnij

  Wycina zaznaczone zadanie lub zmienną.

&Ctrl;C Edycja Kopiuj

  Kopiuje zaznaczone zadanie lub zmienną środowiskową.

&Ctrl;V Edycja Wklej

  Wkleja zadanie lub zmienną środowiskową, która została przedtem wycięta lub skopiowana.

&Ctrl;N Edycja Nowy...

  Tworzy nowe zadanie lub zmienną.

&Ctrl;O Edycja Edytuj...

  Pozwala edytować zadanie lub zmienną środowiskową.

Edycja Usuń

  Usuwa zaznaczone zadania lub zmienne środowiskowe.

Edycja Włączone

  Pozwala włączyć lub wyłączyć zaplanowane zadanie lub zmienną środowiskową.

Edycja Uruchom teraz

  Natychmiast uruchamia zaznaczone zadanie.

#### Menu Ustawienia

Ustawienia Wyświetl pasek narzędzi

  Wyświetla pasek narzędzi.

Ustawienia Wyświetl pasek stanu

  Wyświetla pasek stanu.

#### Menu Pomoc

&help.menu.documentation;

## Pytania i odpowiedzi

Dlaczego zmiany wprowadzone w zadaniach i/lub zmiennych środowiskowych nie przynoszą efektu?

Wszelkie zmiany w zaplanowanych zadaniach nie są dokonywane dopóki nie zostanie zapisany plik `crontab`.

## Podziękowania i licencje

&kcron;

Prawa autorskie do programu: copyright 2000 Gary Meyer gary@meyer.net

Prawa autorskie do dokumentacji: copyright 2000 Morgan N. Sandquist morgan@pipeline.com

Polskie tłumaczenie dokumentacji: Michał Bendowskibendowski@gmail.com

&underFDL; &underGPL;

## Instalacja

### Jak zdobyć program &kcron;?

&install.intro.documentation;

### Wymagania

Żeby skompilować porgram &kcron; pomyślnie, będziesz potrzebować następujących bibliotek:

- `cron`, na przykład `vixie-cron`. Program &kcron; korzysta z komendy `crontab` do modyfikowania zadań danego użytkownika.

- Systemu operacyjnego typu &UNIX; zgodnego ze standardem POSIX. Program &kcron; korzysta z niektórych standardowych wywołań systemowych &UNIX; do formatowania informacji o dacie i godzinie. Są one dostarczane przez m.in. bibliotekę glibc.

### Kompilacja i instalacja

&install.compile.documentation;

&documentation.index;