Оборот журналів logrotate
LOGROTATE(8) Ротація журналів LOGROTATE(8)
НАЗВА
logrotate - циклічно переміщує, архівує та посилає електронною почтою
системні журнали
ЗВЕДЕННЯ
logrotate [-dv] [-f|--force] [-s|--state file] config_file+
ОПИС
logrotate розроблений для полегшення адміністрування систем, що ведуть
велику кількість журналів. Він також забезпечує ротацію, архівацію,
видалення та відправку журналів електронною почтою. Кожний журнал може
переміщатись щоденно, потижнево чи щомісячно, або при досягненні ним
певного розміру.
Звично logrotate запускають щоденно за допомогою cron. Це не значить що
він буде модифікувати журнали кілька раз в день хіба, що критерій
розміру журналу на якому засновується циклічна заміна журналів буде
виконуватись і logrotate запускатиметься кілька разів на день, або з
опцією -f, або -force для примусової циклічної заміни журналів.
Будь-яке число файлів з налаштуваннями можна вказати в командній
стрічці. Файли вказані пізніше змінюють опції вказані у попередніх
файлах, так, що порядок конфігураційних файлів у logrotate є важливий.
Зазвичай використовується єдиний файл конфігурації, який включає інші
потрібні файли налаштувань. Нижче описано, як це робиться за допомогою
директиви include. Якщо командному рядку вказано каталог, то кожний
файл з цього каталогу використовується як файл налаштувань.
Якщо не вказано ніяких параметрів на командному рядку, logrotate
видасть версію, авторські права та коротеньку інформацію по
використанню і закінчить роботу. При появі будь-яких помилок під час
виконання logrotate припинить роботу з не нульовим статусом.
ОПЦІЇ
-d Вмикає режим відлагодження і додає -v. У режимі відлагодження
ніяких змін з файлами журналів чи файла стану logrotate.
-f, --force
Вказує logrotate проводити примусову циклічну заміну журналів,
навіть, коли потреби в цьому немє. Подеколи це корисно після
додання нового пункту в logrotate, чи для створення нових файлів
журналів, коли старі файли журналів переміщено вручну, щоб
ведення протоколу могло продовжуватись далі правильно.
-m, --mail <command>
Вказує logrotate, яку команду використовувати для пересилки
журналів електронною почтою. Ця команда повинна приймати два
параметри 1) тему повідомлення, і 2) адрес отримувача. Далі
команда повинна зчитати повідомлення з стандартного вводу і
відіслати адресату. По замовленню використовується /bin/mail -s.
-s, --state <statefile>
Вказує logrotate використовувати альтернативний файл статусу. Це
корисно коли ротація стартує під різними користувачами для
різних файлів стану. Без задання використовується
/var/lib/logrotate.status.
--usage
Виводить коротке повідомлення що до використання.
ФАЙЛ НАЛАШТУВАНЬ
logrotate зчитує всі вказівки що до дій з журналами з серії файлів
налаштування вказаних в командній стрічці. Кожний файл може визначати
глобальні опції ( місцеві визначення змінюють глобальні і визначення
вказані пізніше змінюють ті що були перед ними) і файли журналів для
циклічного переміщення. Простий файл з налаштуваннями виглядає так:
$ cat /etc/logrotate.conf
# sample logrotate configuration file
compress
/var/log/messages {
rotate 5
weekly
postrotate
/etc/init.d/syslog-ng reload
endscript
}
"/var/log/httpd/access.log" /var/log/httpd/error.log {
rotate 5
mail www@my.org
size=100k
sharedscripts
postrotate
/sbin/killall -HUP httpd
endscript
}
# packages can drop log rotation information into this directory
include /etc/logrotate.d
$ cat /etc/logrotate.d/news
/var/log/news/* {
monthly
rotate 2
olddir /var/log/news/old
missingok
postrotate
kill -HUP `cat /var/run/inn.pid`
endscript
nocompress
}
Перші декілька стрічок визначають глобальні опції, наприклад архівацію
журналів після їх циклічної перестановки. Коментарі можна вставляти
будь-де у файлі налаштувань, але перша стрічка коментаря повинна
починатись з символу #.
Наступна секція конфігураційного файла визначає які дії потрібно
зробити з журналом /var/log/messages. Журнали будуть циклічно
переміщуватись п'ять тижнів перед тим як витруться. Після циклічного
переміщення (але перед тим як стара версія журналу почне архівуватися),
виконається команда /etc/init.d/syslog-ng reload (/sbin/killall -HUP
syslogd).
Слідуюча секція визначає параметри для двох журналів
/var/log/httpd/access.log та /var/log/httpd/error.log. Вони циклічно
переміщуються як тільки розмір журналу стає більшим 100k і старий
журнал, після 5 циклічних зсувів, не архівований, перед своїм
видаленням, пересилається на адресу www@my.org. sharedscripts означає
що сценарій після зсуву postrotate буде запущений тільки один раз, а не
по разу для кожного журналу що проходить ротацію. Увага, лапки навколо
першого імені файла дозволяють logrotate працювати з іменами файлів
журналів, що містять пробіли. Звично командна оболонка використовує
лапки ', ", і символ \.
Директива include /etc/logrotate.d призводить до зчитування всіх
файлів, як конфігураційних, з каталогу /etc/logrotate.d
Файл /etc/logrotate.d/news визначає параметри для всіх файлів в
/var/log/news. Кожний файл циклічно зсувається з місячним періодом. Це
вважається як єдина директива для ротації і якщо помилки будуть більш
ніж для одного файла, то журнали не архівуватимуться.
Будь-ласка використовуйте * з обережністю. якщо вкажете * logrotate
буде циклічно зсувати кожний файл включаючи попередньо вже зсунуті та
заархівовані. Шлях обійти це полягає у використанні директиви olddir чи
більш точною вказівкою *.log
Далі наведемо більше інформації про директиви що можуть
використовуватись в файлах налаштувань logrotate:
compress
Стара версія журналу архівується без задання програмою gzip.
Також дивіться nocompress.
compresscmd
Вказує котру команду використовувати для архівації журналів. Без
задання gzip. Також дивіться директиву compress.
uncompresscmd
Вказує яку команду використовувати для роз-архівації журналів.
Без задання gunzip.
compressext
Вказує закінчення яке додається до архівованого журналу, якщо
архівація включена. Без задання використовується закінчення
(розширення) архіватора.
compressoptions
Командна стрічка що передається архіватору, якщо він
використовується. Поз вибором для gzip, є "-9" (максимальне
стискання).
copy Робить копію журналу, але не змінює зовсім вхідний. Цю опцію
використовують наприклад для отримання копії поточних журналів,
чи коли якась стороння утиліта потребує урізати чи обрізувати
журнал. Коли використовується copy то опція create не дає
ніякого ефекту, так, як старий файл залишається на місці.
copytruncate
Врізає оригінальний файл журналу на місці після створення копії,
замість переміщення старого файла журналу і можливого створення
нового. Її використовують коли деякій програмі неможливо сказати
закрити попередній журнал і отже вона мусить продовжувати писати
(додавати) до попереднього журналу. Увага між копіюванням файла
журналу та урізанням його існує маленький проміжок часу, так що
деякі дані можуть пропасти. Коли використовується ця опція то
create не дає ніякого ефекту, так, як старий файл залишається на
місці.
create mode owner group
Негайно після ротації (перед запуском післяротаційного сценарію
postrotate) створюється новий журнал (з тим самим іменем, як і у
файла журналу, що тільки зсунувся). mode вказує права допуску в
вісімковій системі (так як у chmod(2), owner вказує власника
журналу, а group вказує групу до якої належить журнал. Будь-які
файлові атрибути можна пропустити у цьому випадку в новому файлі
будуть ті ж атрибути як і в старого журналу, для пропущених
атрибутів. Цю опцію відміняє nocreate.
daily Журнали циклічно переміщуються щодня.
delaycompress
Відтерміновує компресію попереднього журналу до наступного циклу
ротації. Ця опція має ефект тільки в комбінації з compress. Вона
може використовуватись коли деякій програмі не можливо вказати
закрити свій журнал і тому вона мусить продовжувати писати ще
деякий час в попередній журнал.
extension ext
Суфікс журналу що додається до старих журналів після ротації.
Якщо використовується архівування, то закінчення архіву (звично
.gz) додається останнім.
ifempty
Вказує циклічно переміщувати пусті журнали, змінює цю поведінку
опція notifempty (без задання використовується ifempty).
include file_or_directory
Зчитує файл як параметр там де появляється директива include,
так ніби він був включений в командну стрічку. Якщо вказано
каталог, більшість файлів з каталогу зчитуються в алфавітному
порядку перед тим як продовжиться виконання інструкцій з файла в
котрому міститься include. Ігноруються тільки не регулярні файли
(тобто каталоги та посилання) і файли чиї імена закінчуються на
одне з заборонених закінчень, які вказані директивою tabooext.
Директива include не повинна появлятись в середині самого
визначення журналу.
mail address
Коли циклічне зсування доходить до кінця, то останній журнал
перед видаленням відправляється на вказану адресу. Коли не
потрібно робити відправку журналу то вказується директива
nomail.
mailfirst
Коли використовується команда mail, то відсилається щойно
циклічно переміщений файл замість останнього, що видаляється.
maillast
Коли використовується команда mail, то відсилається останній
файл, що видаляється замість того, що щойно циклічно зсунувся
(це - стандартна поведінка).
missingok
Якщо файла журналу не існує то програма, замість видачі помилки,
переходить до наступного. Також дивіться nomissingok.
monthly
Журнали циклічно зсуваються коли logrotate запускається перший
раз в місяці (звично це першого числа місяця).
nocompress
Старі журнали не архівуються gzip. Також дивіться compress.
nocopy Не копіювати оригінальний файл журналу і залишити його на місці
(змінює опцію copy).
nocopytruncate
Не урізувати оригінальний файл журналу після створення його
копії (це змінює опцію copytruncate).
nocreate
Не створюється новий файл після ротації (змінюється опцією cre‐
ate).
nodelaycompress
Не відтерміновувати архівацію попередньо зсунутого файла до
наступного циклу (поведінка змінюється опцією delaycompress).
nomail Не відсилати нікому старий журнал.
nomissingok
Якщо файл журналів не існує, видає помилку. Цe - поведінка поза
вибором.
noolddir
Старі журнали циклічно зсуваються в тому самому каталозі, що і
сам журнал (це змінюється опцією olddir).
nosharedscripts
Запускає перед ротаційний prerotate та після ротаційні postro‐
tate сценарії для кожного журналу котрий циклічно зсувається (це
- поведінка поза вибором, яку можна поміняти опцією shared‐
scripts).
notifempty
Не зсувати циклічно пусті журнали (це змінює опцію ifempty).
olddir directory
Старі журнали переміщаються в каталог для ротації. Каталог має
знаходитись на тому самому фізичному пристрої що й журнали. Коли
використовується ця опція всі старі версії журналів знаходяться
в цьому каталозі. Опцію можна змінити noolddir.
postrotate/endscript
Стрічки між postrotate і endscript (обидві з мусять бути в
окремій стрічці) виконуються після ротації журналів. Ця
директива може тільки появлятись в середені визначення журналу.
також дивіться prerotate.
prerotate/endscript
Стрічки між prerotate і endscript (обидві з мусять бути в
окремій стрічці) виконуються перед ротацією журналів. Ця
директива може тільки появлятись в середені визначення журналу.
Також дивіться postrotate.
rotate count
Журнал циклічно зсувається <count> разів перед видаленням чи
відправкою почтою на адрес вказаний у директиві mail. Якщо count
рівне 0, стара версія журналу видаляється і ротація не
відбувається.
size size
Журнал циклічно зсувається коли він стає більшим за size в
байтах. Якщо вкінці є M, то розмір рахується в мегабайтах. Якщо
стоїть k, то розмір рахується в кілобайтах. Так допустимими є
значення 100, 100k, і 100M.
sharedscripts
Звично prescript і postscript запускаються для кожного журналу,
який циклічно зсувається, що означає запуск одного і тогож
сценарію знову для кожного журналу що відповідає умові
(наприклад /var/log/news/*.log). Якщо вказано опцію sharedscript
сценарій запускається тільки раз, байдуже скільки журналів
задовольняють умові. Однак якщо ні один журнал не потребує
ротації сценарій не запускається взагалі. Цю опцію змінює
nosharedscripts.
start count
Вказує номер з якого починати рахувати ротації. Наприклад якщо
вкажете 0, старі журнали будуть створюватись з суфіксом .0 який
додасться до назви первинного журналу. Якщо вкажете 9 то архів
журналів будуть з суфіксами, що почнуться з .9, а 0-8
пропустяться. Журнал все одно буде зсуватись визначену опцією
count кількість разів.
tabooext [+] list
Змінює поточний список заборонених розширень ( дивіться
директиву include де є інформація про заборонені розширення).
Якщо стоїть + перед списком розширень то поточний список
поповнюється, інакше заміняється. При старті список заборонених
розширень містить: .rpmorig, .rpmsave, ,v, .swp, .rpmnew, та ~.
weekly Журнал циклічно зсувається, якщо поточний день тижня менший ніж
день тижня коли відбувалась остання ротація, або коли пройшло
більш ніж тиждень з часу останньої ротації. Тобто журнали
циклічно зсуваються в перший день тижня, але працює краще коли
logrotate запускається не кожної ночі.
Файл конфігурації
logrotate reads everything about the log files it should be handling from the series of configuration files specified on the command line. Logrotate читає все по файлах журналів слід звернення із серії конфігураційних файлів, зазначених у командному рядку. Each configuration file can set global options (local definitions override global ones, and later definitions override earlier ones) and specify logfiles to rotate. Кожен файл конфігурації може встановити глобальні опції (місцеві визначення перевизначають глобальні, а потім і визначення перевизначають більш ранні) і вкажіть логах обертатися. A simple configuration file looks like this: Простий файл конфігурації виглядає наступним чином:
# sample logrotate configuration file # Зразок Logrotate конфігураційний файл
compress стискати
/var/log/messages { / VAR / Журнал / повідомлення {
rotate 5 обертати 5
weekly тижні
postrotate postrotate
/usr/bin/killall -HUP syslogd / USR / BIN / killall-HUP Syslogd
endscript endscript
} }
"/var/log/httpd/access.log" /var/log/httpd/error.log { "/ VAR / Журнал / HTTPD / access.log" / VAR / Журнал / HTTPD / error.log {
rotate 5 обертати 5
mail www@my.org пошта www@my.org
size 100k Розмір 100k
sharedscripts sharedscripts
postrotate postrotate
/usr/bin/killall -HUP httpd / USR / BIN / killall-HUP HTTPD
endscript endscript
} }
/var/log/news/* { / VAR / Журнал / Новини / * {
monthly щомісячно
rotate 2 обертаються 2
olddir /var/log/news/old OLDDIR / VAR / Журнал / Новини / старі
missingok missingok
postrotate postrotate
kill -HUP 'cat /var/run/inn.pid' вбити-HUP 'кіт / VAR / бігти / inn.pid "
endscript endscript
nocompress NOCOMPRESS
} } The first few lines set global options; in the example, logs are compressed after they are rotated. Перші кілька рядків встановити глобальні опції, в Приміром, журнали стискаються після того як вони повернені. Note that comments may appear anywhere in the config file as long as the first non-whitespace character on the line is a #. Зверніть увагу, що коментарі можуть з'являтися в будь-якому місці конфігураційного файлу до тих пір, як перший символ на лінії #. The next section of the config files defined how to handle the log file /var/log/messages . Наступний розділ конфігураційних файлів визначено, як поводитися з лог-файл / VAR / Журнал / повідомлення. The log will go through five weekly rotations before being removed. Журнал буде проходити через п'ять щотижневих обертання до його видалення. After the log file has been rotated (but before the old version of the log has been compressed), the command /sbin/killall -HUP syslogd will be executed. Після лог-файл був повернутий (але до старої версії журналу був стиснутий), команда / sbin / killall-HUP Syslogd буде виконаний.
The next section defines the parameters for both /var/log/httpd/access.log and /var/log/httpd/error.log . Наступний розділ визначає параметри для обох / VAR / Журнал / HTTPD / access.log та / VAR / Журнал / HTTPD / error.log. They are rotated whenever it grows over 100k in size, and the old logs files are mailed (uncompressed) to www@my.org after going through 5 rotations, rather than being removed. Вони обертаються, коли він росте більше 100 тисяч у розмірах, а старі файли журналів поштою (без стиснення) до www@my.org після проходження 5 обертань, а не видалені. The sharedscripts means that the postrotate script will only be run once (after the old logs have been compressed), not once for each log which is rotated. Sharedscripts означає, що сценарій буде postrotate бути запущена тільки один раз (після того, старі журнали були стиснуті), а не один раз для кожного журналу, який обертається. Note that the double quotes around the first filename at the beginning of this section allows logrotate to rotate logs with spaces in the name. Зверніть увагу, що подвійні лапки навколо першого файлу на початку цього розділу дозволяє Logrotate обертатися журнали з пробілами в імені. Normal shell quoting rules apply, with ', ", and \ characters supported. Нормальна оболонка посиланням правила застосовуються, з ', ", і \ підтримується.
The last section defines the parameters for all of the files in /var/log/news . Останній розділ визначає параметри для всіх файлів в / VAR / Журнал / Новости. Each file is rotated on a monthly basis. Кожен файл повертається на щомісячній основі. This is considered a single rotation directive and if errors occur for more than one file, the log files are not compressed. Це вважається однією директиви обертання і в разі виникнення помилок для більш ніж один файл, лог-файли не стискаються.
Please use wildcards with caution. Будь ласка, використовуйте маски з обережністю. If you specify *, logrotate will rotate all files, including previously rotated ones. Якщо ви вкажете *, Logrotate буде обертатися всі файли, в тому числі раніше повертається них. A way around this is to use the olddir directive or a more exact wildcard (such as *.log). Спосіб вирішити цю проблему полягає у використанні директиви OLDDIR або більш точний шаблон (наприклад, журнал *.).
Here is more information on the directives which may be included in a logrotate configuration file: Тут більше інформації про директиви, які можуть бути включені в файл конфігурації Logrotate:
compress стискати Old versions of log files are compressed with gzip (1) by default. Старі версії лог-файли стислі з GZIP (1) за замовчуванням. See also nocompress . Див також NOCOMPRESS. compresscmd compresscmd Specifies which command to use to compress log files. Визначає, яку команду слід використовувати для стиснення файлів журналів. The default is gzip . Замовчуванням GZIP. See also compress . Див також компрес. uncompresscmd uncompresscmd Specifies which command to use to uncompress log files. Визначає, яку команду слід використовувати для розпакування файлів журналів. The default is gunzip . За умовчанням це розпакувати. compressext compressext Specifies which extension to use on compressed logfiles, if compression is enabled. Визначає, які розширення для використання в стислі логи, якщо включено стиснення. The default follows that of the configured compression command. За замовчуванням випливає, що з налаштованих стиснення команди. compressoptions compressoptions Command line options may be passed to the compression program, if one is in use. Параметри командного рядка можуть бути передані програмі стиснення, якщо він використовується. The default, for gzip (1), is "-9" (maximum compression). Замовчуванням, GZIP (1), є "-9" (максимальне стиснення). copy копія Make a copy of the log file, but don't change the original at all. Зробіть копію файлу журналу, але не змінюють первинний взагалі. This option can be used, for instance, to make a snapshot of the current log file, or when some other utility needs to truncate or parse the file. Ця опція може бути використана, наприклад, зробити знімок поточного файлу журналу, а також при деяких інших утиліти необхідно урізати або синтаксичний аналіз файлу. When this option is used, the create option will have no effect, as the old log file stays in place. Коли ця опція використовується, опція створення не матиме ефекту, оскільки старий файл журналу залишається на місці.
copytruncate copytruncate Truncate the original log file in place after creating a copy, instead of moving the old log file and optionally creating a new one. Truncate вихідний файл увійдіть місце після створення копії, замість переміщення старих лог-файл і при необхідності створити нову. It can be used when some program cannot be told to close its logfile and thus might continue writing (appending) to the previous log file forever. Він може бути використаний, коли деякі програми не можуть сказати, що близько його лог-файл і таким чином може продовжувати писати (додавання) до попереднього файлу журналу назавжди. Note that there is a very small time slice between copying the file and truncating it, so some logging data might be lost. Зазначимо, що існує дуже маленький відрізок часу між копіюванням файлу і його усічення, так що деякі записи даних може бути втрачена. When this option is used, the create option will have no effect, as the old log file stays in place. Коли ця опція використовується, опція створення не матиме ефекту, оскільки старий файл журналу залишається на місці. create mode owner group створити групу режимі власника Immediately after rotation (before the postrotate script is run) the log file is created (with the same name as the log file just rotated). mode specifies the mode for the log file in octal (the same as chmod (2)), owner specifies the user name who will own the log file, and group specifies the group the log file will belong to. Відразу ж після повороту (до postrotate сценарій запускається) файл журналу не створюється (з тим же ім'ям, що лог-файл просто повертається). Режим визначає режим для файлу журналу в вісімковому (те ж, CHMOD (2)), власник задає ім'я користувача, який буде володіти файлу журналу, а група задає групу файлів журналу буде належати. Any of the log file attributes may be omitted, in which case those attributes for the new file will use the same values as the original log file for the omitted attributes. Будь-який з атрибутів файлу журналу може бути опущений, в цьому випадку ці атрибути для нового файлу буде використовувати ті ж значення, що й вихідний файл журналу для опущені атрибути. This option can be disabled using the nocreate option. Ця опція може бути відключена за допомогою nocreate варіант. daily щоденно Log files are rotated every day. Лог-файли обертати кожен день.
dateext dateext Archive old versions of log files adding a daily extension like YYYYMMDD instead of simply adding a number. Архів старих версій файлів журналів, додавши щоденне розширення як РРРРММДД замість того, щоб просто додати номер. The extension may be configured using the dateformat option. Розширення може бути налаштований за допомогою DATEFORMAT варіант. dateformat format_string DATEFORMAT format_string Specify the extension for dateext using the notation similar to strftime (3) function. Вкажіть розширення для dateext використовуючи позначення схожий на STRFTIME (3) функції. Only %Y %m %d and %s specifiers are allowed. Тільки% Y% м г% і% з специфікатори допускається. The default value is -%Y%m%d. Значення за замовчуванням -% Y% м% d. Note that also the character separating log name from the extension is part of the dateformat string. Зверніть увагу, що і характер поділу ім'я журналу з розширенням частина рядка DATEFORMAT. The system clock must be set past Sep 9th 2001 for %s to work correctly. Системні годинник повинні бути встановлені пройшло 9 вересня 2001 у% s. працювати правильно. Note that the datestamps generated by this format must be lexically sortable (ie, first the year, then the month then the day. eg, 2001/12/01 is ok, but 01/12/2001 is not, since 01/11/2002 would sort lower while it is later). Зверніть увагу, що datestamps породжених цей формат повинен бути лексично сортування (тобто, перший рік, потім місяць, потім день. Наприклад, 2001/12/01 це нормально, але 01/12/2001 ні, так як 01/11 / 2002 році буде нижче роду, коли він пізніше). This is because when using the rotate option, logrotate sorts all rotated filenames to find out which logfiles are older and should be removed. Це тому, що при використанні опції повороту, Logrotate сортує все обертається імена з'ясувати, які логи старше і повинні бути видалені. delaycompress delaycompress Postpone compression of the previous log file to the next rotation cycle. Відкладіть стиснення попереднього файлу журналу до наступного циклу ротації. This only has effect when used in combination with compress . Це тільки має сенс, коли застосовуються в поєднанні з компресом. It can be used when some program cannot be told to close its logfile and thus might continue writing to the previous log file for some time. Він може бути використаний, коли деякі програми не можуть сказати, що близько його лог-файл і таким чином може продовжувати запис на попередній файл журналу протягом деякого часу. extension ext розширення доб Log files with ext extension can keep it after the rotation. Вхід файли з розширенням доб можете зберегти його після ротації. If compression is used, the compression extension (normally .gz ) appears after ext . Якщо використовується стиснення, стиск розширення (у звичайному режимі. GZ) з'являється після доб. For example you have a logfile named mylog.foo and want to rotate it to mylog.1.foo.gz instead of mylog.foo.1.gz. Приміром, якщо лог-файл імені mylog.foo і хочуть, щоб повернути її до mylog.1.foo.gz замість mylog.foo.1.gz. ifempty ifempty Rotate the log file even if it is empty, overriding the notifempty option ( ifempty is the default). Поворот лог-файл, навіть якщо він порожній, перекриваючи notifempty варіант (ifempty за замовчуванням). include file_or_directory включають file_or_directory Reads the file given as an argument as if it was included inline where the include directive appears. Читає файл, заданий як аргумент як якби він був включений вбудований де директиви включають з'являється. If a directory is given, most of the files in that directory are read in alphabetic order before processing of the including file continues. Якщо не вказано, більшість файлів у цьому каталозі читаються в алфавітному порядку перед обробкою в тому числі файл триває. The only files which are ignored are files which are not regular files (such as directories and named pipes) and files whose names end with one of the taboo extensions, as specified by the tabooext directive. Тільки ті файли, які ігнорують це файли, які не є звичайними файлами (наприклад, каталоги і іменовані канали) і файли, імена яких закінчуються з одним із табу розширень, як зазначено у директиві tabooext. The include directive may not appear inside a log file definition. Директиви містять у собі не можуть з'являтися всередині визначення журналу. mail address пошти When a log is rotated out-of-existence, it is mailed to address . Коли журнал обертається поза існування, він висланий адресу. If no mail should be generated by a particular log, the nomail directive may be used. Якщо ні пошти повинна бути породжений зокрема журнал, директиви nomail можуть бути використані. mailfirst mailfirst When using the mail command, mail the just-rotated file, instead of the about-to-expire file. При використанні пошти команди, пошта щойно обертається файлу, а не про до минає файл. maillast maillast When using the mail command, mail the about-to-expire file, instead of the just-rotated file (this is the default). При використанні пошти команди, пошти о к закінчується файл, замість того, щоб просто-повертається файлу (це за замовчуванням). maxage count MaxAge рахунок Remove rotated logs older than <count> days. Видалити повертається журнали старше <count> днів. The age is only checked if the logfile is to be rotated. Вік перевіряється тільки якщо лог-файл повинен бути повернений. The files are mailed to the configured address if maillast and mail are configured. Файли поштою з заданим адресою, якщо maillast і пошти налаштовані. minsize size мін_разм розміру Log files are rotated when they grow bigger than size bytes, but not before the additionally specified time interval ( daily , weekly , monthly , or yearly ). Лог-файли повертається, коли вони виростуть більше, ніж розмір байт, але не раніше, ніж додатково заданий інтервал часу (щодня, щотижня, щомісяця або щорічно). The related size option is similar except that it is mutually exclusive with the time interval options, and it causes log files to be rotated without regard for the last rotation time. Пов'язаний з цим варіант розміру аналогічно, за винятком, що він є взаємовиключним з параметрами інтервалу часу, і це викликає лог-файли для повороту без врахування останнього часу обертання. When minsize is used, both the size and timestamp of a log file are considered. Коли мін_разм використовується, як розмір і мітку файлу журналу розглядаються. missingok missingok If the log file is missing, go on to the next one without issuing an error message. Якщо файл журналу відсутня, переходите до наступного без видачі повідомлення про помилку. See also nomissingok . Див також nomissingok. monthly щомісячно Log files are rotated the first time logrotate is run in a month (this is normally on the first day of the month). Лог-файли обертати перший Logrotate час запускається в місяць (це, як правило, у перший день місяця). nocompress NOCOMPRESS Old versions of log files are not compressed. Старі версії лог-файли не стискаються. See also compress . Див також компрес. nocopy NOCOPY Do not copy the original log file and leave it in place. Не копіювати оригінальний файл журналу і залишити його на місці. (this overrides the copy option). (Це перекриває копію опція).
nocopytruncate nocopytruncate Do not truncate the original log file in place after creating a copy (this overrides the copytruncate option). Не обрізати вихідний файл увійдіть місце після створення копії (це перекриває copytruncate опція). nocreate nocreate New log files are not created (this overrides the create option). Нові файли журналів не створюються (це перекриває опцію створення). nodelaycompress nodelaycompress Do not postpone compression of the previous log file to the next rotation cycle (this overrides the delaycompress option). Не відкладайте стиснення попереднього файлу журналу на наступний цикл обертання (це перекриває delaycompress опція). nodateext nodateext Do not archive old versions of log files with date extension (this overrides the dateext option). Не архів старих версій файлів журналів з датою розширення (це перекриває dateext опція). nomail nomail Don't mail old log files to any address. Не надсилайте старі журнали з будь-якою адресою.
nomissingok nomissingok If a log file does not exist, issue an error. Якщо файл журналу не існує, питання про помилки. This is the default. Це значення за замовчуванням. noolddir noolddir Logs are rotated in the same directory the log normally resides in (this overrides the olddir option). Журнали обертаються в тому ж каталозі журналів звичайно проживає в (це перекриває OLDDIR опція). nosharedscripts nosharedscripts Run prerotate and postrotate scripts for every log file which is rotated (this is the default, and overrides the sharedscripts option). Запуск prerotate і postrotate скрипти для кожного файлу журналу, який обертається (це за замовчуванням, і перекриває sharedscripts опція). The absolute path to the log file is passed as first argument to the script. Абсолютний шлях до файлу журналу передається через перший аргумент сценарію. If the scripts exit with error, the remaining actions will not be executed for the affected log only. Якщо сценарії виходу з помилкою, інші дії не будуть виконуватися для постраждалих журнал тільки. noshred noshred Do not use shred when deleting old log files. Не використовуйте клаптик при видаленні старих файлів журналу. See also shred . Див також клаптик. notifempty notifempty Do not rotate the log if it is empty (this overrides the ifempty option). Не повертайте журнал, якщо він порожній (це перекриває ifempty опція). olddir directory OLDDIR каталог Logs are moved into directory for rotation. Журнали переміщуються в каталог для ротації. The directory must be on the same physical device as the log file being rotated, and is assumed to be relative to the directory holding the log file unless an absolute path name is specified. Каталог повинен бути на одному фізичному пристрої, як файл журналу обертається, і вважається відносно каталогу, проведення лог-файл, якщо абсолютний шлях не вказаний. When this option is used all old versions of the log end up in directory . При використанні цієї опції всі старі версії журналу в кінцевому підсумку в каталог. This option may be overridden by the noolddir option. Ця опція може бути відключена опція noolddir. postrotate / endscript postrotate / endscript The lines between postrotate and endscript (both of which must appear on lines by themselves) are executed (using /bin/sh ) after the log file is rotated. Межі між postrotate і endscript (обидва з яких мають з'явитися на лініях самі по собі) виконуються (використовуючи / бен / ш) після лог-файл обертається. These directives may only appear inside a log file definition. Ці директиви можуть з'являтися тільки усередині визначення журналу. Normally, the absolute path to the log file is passed as first argument to the script. Як правило, абсолютний шлях до файлу журналу передається через перший аргумент сценарію. If sharedscripts is specified, whole pattern is passed to the script. Якщо sharedscripts зазначено, цілі картини передається в сценарій. See also prerotate . Див також prerotate. See sharedscripts and nosharedscripts for error handling. Дивіться sharedscripts і nosharedscripts для обробки помилок. prerotate / endscript prerotate / endscript The lines between prerotate and endscript (both of which must appear on lines by themselves) are executed (using /bin/sh ) before the log file is rotated and only if the log will actually be rotated. Межі між prerotate і endscript (обидва з яких мають з'явитися на лініях самі по собі) виконуються (використовуючи / бен / ш), перш ніж файл журналу повертається і тільки якщо журнал насправді буде обертатися. These directives may only appear inside a log file definition. Ці директиви можуть з'являтися тільки усередині визначення журналу. Normally, the absolute path to the log file is passed as first argument to the script. Як правило, абсолютний шлях до файлу журналу передається через перший аргумент сценарію. If sharedscripts is specified, whole pattern is passed to the script. Якщо sharedscripts зазначено, цілі картини передається в сценарій. See also postrotate . Див також postrotate. See sharedscripts and nosharedscripts for error handling. Дивіться sharedscripts і nosharedscripts для обробки помилок. firstaction / endscript firstaction / endscript The lines between firstaction and endscript (both of which must appear on lines by themselves) are executed (using /bin/sh ) once before all log files that match the wildcarded pattern are rotated, before prerotate script is run and only if at least one log will actually be rotated. Межі між firstaction і endscript (обидва з яких мають з'явитися на лініях самі по собі) виконуються (використовуючи / бен / ш) один раз, перш ніж всі лог-файли, які відповідають шаблону символів підстановки обертаються, перш ніж prerotate скрипт запускається і тільки якщо хоча б один Журнал насправді буде обертатися. These directives may only appear inside a log file definition. Ці директиви можуть з'являтися тільки усередині визначення журналу. Whole pattern is passed to the script as first argument. Всього картина передається в сценарій в якості першого аргументу. If the script exits with error, no further processing is done. Якщо скрипт завершується з помилкою, подальшої обробки не зроблено. See also lastaction . Див також lastaction. lastaction / endscript lastaction / endscript The lines between lastaction and endscript (both of which must appear on lines by themselves) are executed (using /bin/sh ) once after all log files that match the wildcarded pattern are rotated, after postrotate script is run and only if at least one log is rotated. Межі між lastaction і endscript (обидва з яких мають з'явитися на лініях самі по собі) виконуються (використовуючи / бен / ш) один раз зрештою файли журналів, які відповідають шаблону символів підстановки обертаються, після postrotate скрипт запускається і тільки якщо хоча б один Журнал обертається. These directives may only appear inside a log file definition. Ці директиви можуть з'являтися тільки усередині визначення журналу. Whole pattern is passed to the script as first argument. Всього картина передається в сценарій в якості першого аргументу. If the script exits with error, just an error message is shown (as this is the last action). Якщо сценарій завершується з помилкою, просто повідомлення про помилку (як це остання дія). See also firstaction . Див також firstaction. rotate count обертати рахунок Log files are rotated count times before being removed or mailed to the address specified in a mail directive. Лог-файли повертається число разів, перш ніж видалити або поштою на адресу, вказану в поштовому директиви. If count is 0, old versions are removed rather than rotated. Якщо лічильник дорівнює 0, то старі версії видаляються, а не повертається. size size розмір розмір Log files are rotated when they grow bigger than size bytes. Лог-файли повертається, коли вони виростуть більше, ніж розмір байт. If size is followed by k , the size is assumed to be in kilobytes. Якщо розмір прямують до, розмір вважається в кілобайтах. If the M is used, the size is in megabytes, and if G is used, the size is in gigabytes. Якщо M використовується, розмір в мегабайтах, а якщо G використовується, розмір в гігабайтах. So size 100 , size 100k , size 100M and size 100Gare all valid. Так розміром 100, розмір 100k, розмір 100M і розмір 100Gare все в силі. sharedscripts sharedscripts Normally, prerotate and postrotate scripts are run for each log which is rotated and the absolute path to the log file is passed as first argument to the script. Як правило, prerotate і postrotate сценарії виконуються для кожного журналу, який обертається і абсолютний шлях до файлу журналу передається через перший аргумент сценарію. That means a single script may be run multiple times for log file entries which match multiple files (such as the /var/log/news/* example). Це означає, що один сценарій може бути запущений кілька разів для запису в журналі, які відповідають відразу декілька файлів (наприклад, / VAR / Журнал / Новини / * приклад). If sharedscripts is specified, the scripts are only run once, no matter how many logs match the wildcarded pattern, and whole pattern is passed to them. Якщо sharedscripts не вказаний, скрипти виконуються тільки один раз, незалежно від того, скільки журналів матчу символів підстановки зразок, і всю картину проходить до них. However, if none of the logs in the pattern require rotating, the scripts will not be run at all. Однак, якщо жоден з журналів в шаблоні вимагає обертання, скрипти не працюватимуть взагалі. If the scripts exit with error, the remaining actions will not be executed for any logs. Якщо сценарії виходу з помилкою, інші дії не будуть виконуватися для будь-якого колоди. This option overrides the nosharedscripts option and implies create option. Ця опція перевизначає опцію nosharedscripts і передбачає створити варіант. shred клаптик Delete log files using shred -u instead of unlink(). Видалити файли журналів використанням клаптик-у, а не розірвати зв'язок (). This should ensure that logs are not readable after their scheduled deletion; this is off by default. Це гарантує, що журнали не читається після запланованого видалення, це за замовчуванням відключена. See also noshred . Див також noshred.
shredcycles count shredcycles рахунок Asks GNU shred (1) to overwite log files count times before deletion. Запитує GNU клаптик (1) для overwite файли журналів число разів до видалення. Without this option, shred 's default will be used. Без цієї опції, клаптик 'и за замовчуванням буде використовуватися. start count почати підрахунок This is the number to use as the base for rotation. Це число для використання в якості бази для обертання. For example, if you specify 0, the logs will be created with a .0 extension as they are rotated from the original log files. Наприклад, якщо ви вкажете 0, логи будуть створені з 0,0 розширення, як вони повернені від оригінальних файлів журналу. If you specify 9, log files will be created with a .9, skipping 0-8. Якщо ви вкажете 9, лог-файли будуть створені з .9, пропускаючи 0-8. Files will still be rotated the number of times specified with the count directive. Файли будуть як і раніше бути повернутий число раз, вказане з графом директиви. tabooext [+] list tabooext [+] Список The current taboo extension list is changed (see the include directive for information on the taboo extensions). Поточний табу список розширень змінюється (див. включають директиву для отримання інформації про табу розширень). If a + precedes the list of extensions, the current taboo extension list is augmented, otherwise it is replaced. Якщо + передує список розширень, поточний табу список розширень збільшується, в іншому випадку він буде замінений. At startup, the taboo extension list contains .rpmorig, .rpmsave, ,v, .swp, .rpmnew, ~, .cfsaved and .rhn-cfg-tmp-*. При запуску табу список розширень містить. Rpmorig. Rpmsave,, г,. SWP. Rpmnew, ~,. Cfsaved і. RHN-CFG-TMP-*. weekly тижні Log files are rotated if the current weekday is less than the weekday of the last rotation or if more than a week has passed since the last rotation. Лог-файли повертається, якщо поточний день тижня менший дня тижня останньої ротації або якщо більше тижня пройшло з моменту останньої ротації. This is normally the same as rotating logs on the first day of the week, but it works better if logrotate is not run every night. Це, як правило ж, як і обертаються входить в перший день тижня, але вона працює краще, якщо Logrotate не запускається кожну ніч.
yearly річний
Log files are rotated if the current year is not the same as the last rotation. Лог-файли повертається, якщо поточний рік не такий же, як останній поворот.
Files Файли /var/lib/logrotate.status / VAR / Бібліотека / logrotate.status Default state file. Файлу за замовчуванням стан.
/etc/logrotate.conf / І т.д. / logrotate.conf
