# Podręcznik &kcron;

## 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;