Generator cron: wyrażenie crontab z formularza i jego opis

Składnia wyrażenia cron

Wpis w pliku crontab zaczyna się od pięciu pól czasu oddzielonych spacjami, po których stoi polecenie. Dokumentacja crontab(5) z projektu cronie podaje dla pól następujące wartości:

Nazwy to pierwsze trzy litery angielskiej nazwy dnia lub miesiąca, a wielkość liter nie ma znaczenia. Dokumentacja dopuszcza też zakresy i listy nazw.

Znaki specjalne: gwiazdka, przecinek, myślnik i ukośnik

• * oznacza wszystkie wartości pola, czyli „od pierwszej do ostatniej”.
• 1-5 to zakres: dwie liczby połączone myślnikiem, z obiema granicami włącznie.
• 1,15,30 to lista liczb lub zakresów oddzielonych przecinkami.
• /N to krok. Według crontab(5) stawia się go po zakresie albo po gwiazdce:0-23/2 i */2 oznaczają co drugą godzinę. Sama liczba z krokiem, np.5/15, nie jest w tej składni dozwolona, dlatego generator zapisuje ją jako5-59/15.

Standard POSIX opisuje tylko gwiazdkę, liczby, zakresy i listy. Kroków ani nazw dni i miesięcy w nim nie ma, opisuje je natomiast dokumentacja cronie.

Dzień miesiąca i dzień tygodnia w jednym wyrażeniu

Gdy oba pola są ograniczone, czyli żadne nie zawiera gwiazdki, zadanie uruchamia się w dniu, który pasuje do któregokolwiek z nich. Wyrażenie 0 9 1 * 1 oznacza więc godzinę 9:00 pierwszego dnia miesiąca oraz w każdy poniedziałek, a nie tylko w poniedziałki wypadające pierwszego. Tak samo działa to w standardzie POSIX. Generator uwzględnia tę zasadę w opisie i w liście najbliższych uruchomień.

Makra @daily, @weekly i inne

Zamiast pięciu pól cronie przyjmuje skróty zaczynające się od znaku @:

Przykłady wyrażeń cron

Na co uważać

• Znak % w poleceniu. Według crontab(5) nieescapowany % zamienia się w znak nowej linii. W poleceniach takich jak date +%F zapisuj go jako \%. Generator robi to automatycznie w linii do skopiowania.
• Środowisko. Cron ustawia SHELL na /bin/sh, a LOGNAME i HOME bierze z pliku /etc/passwd właściciela tabeli. Polecenie nie dostaje więc zmiennych z Twojej sesji terminala.
• Strefa czasowa. Zmienna CRON_TZ w pliku crontab ustawia strefę czasową dla tabeli. Lista najbliższych uruchomień na tej stronie używa strefy Twojej przeglądarki.
• Zmiana czasu. Dokumentacja cronie zaznacza, że godziny, których nie ma podczas przestawiania zegara, nigdy nie pasują, więc zadanie się nie uruchomi. Godziny występujące dwa razy powodują dwukrotne uruchomienie.

Jak dodać zadanie do crontab

Polecenie crontab -e otwiera tabelę bieżącego użytkownika w edytorze wskazanym przez zmienną VISUAL lub EDITOR i instaluje ją po zapisaniu. crontab -l wyświetla tabelę, acrontab -r ją usuwa. Wklej linię z generatora jako nowy wiersz tabeli.

Na systemach z systemd zamiast crona możesz użyć timerów. Opisujemy je w artykule Timery systemd zamiast crona: praktyczny przewodnik.