'\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LOGROTATE 8 3.22.0 Linux "Руководство системного администратора" .de tq . br . ns . TP \\$1\" no doublequotes around argument! .. .\" Per groff_man(7), the TQ macro should be copied from an-ext.tmac when .\" not running under groff. That's not quite right; not all groff .\" installations include this macro. So bring it in with another name .\" unconditionally. .\" Continuation line for .TP header. .SH НАИМЕНОВАНИЕ logrotate \- ротация, сжатие и отправление электронной почтой файлов системных журналов .SH СИНОПСИС \fBlogrotate\fP [\fB\-\-force\fP] [\fB\-\-debug\fP] [\fB\-\-state\fP \fIfile\fP] [\fB\-\-skip\-state\-lock\fP] [\fB\-\-wait\-for\-state\-lock\fP] [\fB\-\-verbose\fP] [\fB\-\-log\fP \fIfile\fP] [\fB\-\-mail\fP \fIcommand\fP] \fIconfig_file\fP [\fIconfig_file2 ...\fP] .SH ОПИСАНИЕ Утилита \fBlogrotate\fP разработана для облегчения администрирования систем, которые порождают большое количество файлов журналов происходящих в системе событий. Утилита предоставляет автоматическую ротацию, сжатие, удаление и отправление по электронной почте журналов системы. Каждый файл журнала сообщений может обрабатываться ежедневно, еженедельно, ежемесячно, либо когда увеличится в размерах выше указанного предела. .P Обычно \fBlogrotate\fP выполняется в порядке ежесуточного задания службы cron. В течении одних суток она не будет несколько раз изменять файл журнала сообщений, если критерий обработки для этого журнала не основан на размере файла и \fBlogrotate\fP не запускается каждые сутки многократно; если не применяется опция \fB\-f\fP или \fB\-force\fP. .P В командной строке может быть задано любое количество конфигурационных файлов. Каждый последующий конфигурационный файл может переназначить настройки заданные в предыдущих файлах; таким образом, для \fBlogrotate\fP важен порядок следования файлов конфигурации. Широко распространено применение единственного конфигурационного файла, включающего в себя другие используемые файлы настроек. О том, как это осуществить с помощью директивы \fBinclude\fP, смотрите ниже. Если в командной строке задан каталог, то все файлы, находящиеся в этом каталоге, используются в качестве конфигурационных. .P Если аргументы командной строки не указаны, то \fBlogrotate\fP выведет информацию о версии и авторских правах, а также краткое описание использования. Если при ротации журналов возникнут ошибки, то \fBlogrotate\fP завершит работу с ненулевым статусом, но файл состояния будет обновлен. .SH ОПЦИИ .TP \fB\-f\fP, \fB\-\-force\fP Приказывают \fBlogrotate\fP принудительно выполнить ротацию, даже если, в этом нет необходимости. Иногда это полезно после добавления новых записей в конфигурационный файл \fBlogrotate\fP или если старые файлы журналов были удалены вручную, так как в этом случае будут созданы новые файлы и журналирование продолжится корректно. .TP \fB\-d\fP, \fB\-\-debug\fP Включить режим отладки, при котором в журналы не вносятся никакие изменения, а файл состояния \fBlogrotate\fP не обновляется. Выводятся только отладочные сообщения. .TP \fB\-s\fP, \fB\-\-state\fP \fIstatefile\fP Указывает \fBlogrotate\fP, что нужно использовать альтернативный файл состояния. Это полезно, если \fBlogrotate\fP запускается от имени другого пользователя для работы с разными наборами файлов журналов. Чтобы предотвратить параллельное выполнение, \fBlogrotate\fP по умолчанию блокирует файл состояния. Если блокировка не удается, то \fBlogrotate\fP завершает работу с кодом ошибки 3. Файл состояния по умолчанию — \fI/var/lib/logrotate/status\fP. Если в качестве файла состояния указан \fI/dev/null\fP, то \fBlogrotate\fP не будет пытаться заблокировать файл состояния или записать в него данные. .TP \fB\-\-skip\-state\-lock\fP Не блокировать файл состояния, например, если блокировка не поддерживается или запрещена. .TP \fB\-\-wait\-for\-state\-lock\fP Ждать, пока другой процесс logrotate снимет блокировку с файла состояния. Эта опция может привести к бесконечному ожиданию logrotate. Используйте её с осторожностью. .TP \fB\-v\fP, \fB\-\-verbose\fP Включает подробный режим, например для отображения сообщений во время ротации. .TP \fB\-l\fP, \fB\-\-log\fP \fIfile\fP Указывает \fBlogrotate\fP, что подробный вывод должен записываться в файл журнала. Подробный вывод, записываемый в этот файл, аналогичен тому, что происходит при запуске \fBlogrotate\fP с переключателем \fB\-v\fP. Файл журнала перезаписывается при каждом запуске \fBlogrotate\fP. .TP \fB\-m\fP, \fB\-\-mail\fP \fIcommand\fP Указывает \fBlogrotate\fP, какую команду использовать при отправке журналов по электронной почте. Эта команда должна принимать следующие аргументы: .IP 1) тема сообщения, указанная с помощью '\-s subject' .br 2) получатель. .IP Эта команда должна считать сообщение со стандартного ввода и отправить его получателю по электронной почте. Почтовая команда по умолчанию — \fI/usr/bin/mail\fP. .TP \fB\-\-usage\fP Выводит краткое сообщение об использовании. .TP \fB\-?\fP, \fB\-\-help\fP Вывести справочную информацию. .TP \fB\-\-version\fP Вывести на дисплей сведения о версии. .SH "ФАЙЛ КОНФИГУРАЦИИ" \fBlogrotate\fP считывает всю информацию о файлах журналов, с которыми ей предстоит работать, из ряда файлов конфигурации, указанных в командной строке. В каждом файле конфигурации можно задать глобальные опции (локальные определения имеют приоритет над глобальными, а более поздние определения имеют приоритет над более ранними) и указать файлы журналов для ротации. Глобальные опции не влияют на предыдущие директивы include. Простой файл конфигурации выглядит следующим образом: .nf .ta +8n # sample logrotate configuration file compress /var/log/messages { rotate 5 weekly postrotate /usr/bin/killall \-HUP syslogd endscript } "/var/log/httpd/access.log" /var/log/httpd/error.log { rotate 5 mail recipient@example.org size 100k sharedscripts postrotate /usr/bin/killall \-HUP httpd endscript } /var/log/news/* { monthly rotate 2 olddir /var/log/news/old missingok sharedscripts postrotate kill \-HUP $(cat /var/run/inn.pid) endscript nocompress } ~/log/*.log {} .fi .PP Первые несколько строк задают глобальные опции. В данном примере журналы сжимаются после ротации. Примечание. Комментарии могут находиться в любом месте файла конфигурации, если первым непробельным символом в строке является \fB#\fP. Значения отделяются от директив пробелами и/или необязательным знаком =. Числа должны быть указаны в формате, поддерживаемом \fBstrtoul\fP(3). Следующий раздел конфигурационного файла определяет, как обрабатывать файл журнала \fI/var/log/messages\fP. Журнал будет ротироваться пять раз в неделю, после чего будет удаляться. После ротации файла журнала (но до сжатия старой версии журнала) будет выполнена команда \fI/usr/bin/killall \-HUP syslogd\fP. В следующем разделе определены параметры для файлов \fI/var/log/httpd/access.log\fP и \fI/var/log/httpd/error.log\fP. Ротация каждого из них происходит, когда их размер превышает 100 килобайт, а старые файлы журналов после пяти ротаций отправляются (в несжатом виде) по электронной почте на адрес recipient@\:example.org, а не удаляются. Значение \fBsharedscripts\fP означает, что скрипт \fBpostrotate\fP будет запущен только один раз для этого раздела, а не для каждого ротируемого журнала. Примечание. Названия файлов журналов могут быть заключены в кавычки (и что кавычки обязательны, если в названии есть пробелы). Применяются стандартные правила экранирования символов в командной оболочке, поддерживаются символы \fB'\fP, \fB"\fP и \fB\e\fP. В следующем разделе определены параметры для всех файлов в \fI/var/log/news\fP. Каждый файл обновляется ежемесячно. В последнем разделе используется тильдовое расширение для ротации файлов журналов в домашнем каталоге текущего пользователя. Это возможно только в том случае, если ваша библиотека glob поддерживает тильдовое расширение. Библиотека GNU glob поддерживает это расширение. Пожалуйста, используйте подстановочные знаки с осторожностью. Если вы укажете *, то \fBlogrotate\fP будет выполнять ротацию всех файлов, включая те, которые уже были ротированы. Чтобы этого избежать, используйте директиву \fBolddir\fP или более точный подстановочный знак (например, *.log). Обратите внимание, что по умолчанию при использовании \fBsystemd\fP(1)) в файле \fIProtectSystem=full\fP установлена опция \fIProtectSystem=full\fP. Это не позволяет \fBlogrotate\fP изменять журналы в \fI/etc\fP и \fI/usr\fP. Далее представлена информация о директивах, которые могут быть указаны в конфигурационном файле \fBlogrotate\fP: .SH "КОНФИГУРАЦИОННЫЙ ФАЙЛ ДИРЕКТИВ" Эти директивы могут быть включены в файл конфигурации \fBlogrotate\fP: .SS Ротация .TP \fBrotate \fP\fIcount\fP Файлы журналов ротируются \fIcount\fP раз, после чего удаляются или отправляются по адресу, указанному в директиве \fBmail\fP. Если \fIcount\fP равно 0, то старые версии не ротируются, а удаляются. Если \fIcount\fP равно \-1, старые журналы вообще не удаляются, за исключением случаев, когда к ним применяется действие \fBmaxage\fP (используйте с осторожностью, так как это может привести к снижению производительности и потере дискового пространства). Значение по умолчанию — 0. .TP \fBolddir \fP\fIdirectory\fP Журналы перемещаются в каталог \fIdirectory\fP для ротации. Каталог \fIdirectory\fP должен находиться на том же физическом устройстве, что и файл журнала, для которого выполняется ротация, если не используется опции \fBcopy\fP, \fBcopytruncate\fP или \fBrenamecopy\fP. Предполагается, что каталог \fIdirectory\fP находится относительно каталога, в том же месте, в котором хранится файл журнала, если не указан абсолютный путь. При использовании этой опции все старые версии журнала попадают в \fIdirectory\fP. Эта опция может быть переопределена опцией \fBnoolddir\fP. .TP \fBnoolddir\fP Журналы перемещаются в каталог, в котором они обычно находятся (это переопределяет опцию \fBolddir\fP). .TP \fBsu \fP\fIuser\fP \fIgroup\fP Выполнять ротацию файлов журнала от имени этого пользователя и группы, а не пользователя или группы по умолчанию (обычно root). Значение \fIuser\fP определяет пользователя, от имени которого выполняется ротация, а значение \fIgroup\fP — группу, от имени которой выполняется ротация (подробности смотрите в разделе \fBПОЛЬЗОВАТЕЛЬ И ГРУППА\fP). Если у указанного здесь пользователя или группы недостаточно прав для создания файлов с владельцем, указанным в директиве \fBcreate\fP, то это приведет к ошибке. Если \fBlogrotate\fP запускается с правами root, то следует использовать директиву \fBsu\fP для ротации файлов в каталогах, которые прямо или косвенно находятся под контролем непривилегированных пользователей. .SS Частотность .TP \fBhourly\fP LФайлы журнала обновляются каждый час. Примечание. Обычно \fBlogrotate\fP настроена на ежедневный запуск по расписанию cron (или по расписанию \fIlogrotate.timer\fP при использовании \fBsystemd\fP(1)). Чтобы действительно обновлять журналы каждый час, необходимо изменить эту настройку и запускать \fBlogrotate\fP ежечасно. .TP \fBdaily\fP Файлы журналов ротируются каждые сутки. .TP \fBweekly\fP [\fIweekday\fP] Файлы журналов ротируются один раз в сутки недели \fIweekday\fP или если с момента последней ротации прошло не менее 7 дней (без учета точного времени). Интерпретация суток недели следующая: 0 — воскресенье, 1 — понедельник, \&.\|.\|.\|\&, 6 — суббота; специальное значение 7 означает ротацию каждые 7 дней независимо от суток недели. По умолчанию используется значение 0, если аргумент \fIweekday\fP не указан. .TP \fBmonthly\fP Файлы журналов ротируются при первом запуске \fBlogrotate\fP в течение месяца (обычно это происходит в первый день месяца). .TP \fByearly\fP Файлы журналов ротируются, если текущий год не совпадает с годом последней ротации. .TP \fBsize \fP\fIsize\fP Файлы журналов ротируются только в том случае, если их размер превышает \fIsize\fP байт. Если после \fIsize\fP указано \fIk\fP, то размер указывается в килобайтах. Если указано \fIM\fP, то размер указывается в мегабайтах, а если \fIG\fP, то в гигабайтах. Таким образом, допустимы значения \fIsize 100\fP, \fIsize 100k\fP, \fIsize 100M\fP и \fIsize 100G\fP. Эта опция является взаимоисключающей с опциями временных интервалов и приводит к ротации файлов журналов без учета времени последней ротации, если она указана после критериев времени (последняя указанная опция имеет приоритет). .SS "Выбор файла" .TP \fBmissingok\fP В случае отсутствия файла журнала перейти к обработке следующего не выдавая сообщения об ошибке. Смотрите также \fBnomissingok\fP. .TP \fBnomissingok\fP Если файл журнала не существует, выдать ошибку. Это установлено по умолчанию. .TP \fBignoreduplicates\fP Игнорировать все последующие совпадения в файле журнала. .TP \fBifempty\fP Выполнять ротацию файла журнала, даже если он пуст; переопределяет опцию \fBnotifempty\fP (по умолчанию используется \fBifempty\fP). .TP \fBnotifempty\fP Не ротировать журнал, если он пустой (это переопределяет опцию \fBifempty\fP). .TP \fBminage\fP \fIcount\fP Не ротировать журналы, которым меньше суток. .TP \fBmaxage\fP \fIcount\fP Удалить ротированные логи старше суток. Возраст проверяется только в том случае, если необходимо выполнить ротацию файла журнала. \fBrotate \-1\fP не препятствует удалению. Файлы отправляются на указанный адрес, если настроены \fBmaillast\fP и \fBmail\fP. .TP \fBminsize\fP \fIsize\fP Файлы журналов перезаписываются, когда их размер превышает \fIsize\fP байт, но не раньше указанного дополнительного временного интервала (\fBdaily\fP, \fBweekly\fP, \fBmonthly\fP или \fByearly\fP). Соответствующая опция \fBsize\fP аналогична предыдущей, за исключением того, что она взаимоисключает опции, связанные с временным интервалом, и приводит к перезаписи файлов журналов без учета времени последней перезаписи, если указана после критериев времени (последняя указанная опция имеет приоритет). При использовании \fBminsize\fP учитываются размер и временная метка файла журнала. .TP \fBmaxsize\fP \fIsize\fP Файлы журналов перезаписываются, когда их размер превышает \fIsize\fP байт, даже раньше указанного дополнительного временного интервала (\fBdaily\fP, \fBweekly\fP, \fBmonthly\fP или \fByearly\fP). Соответствующая опция \fBsize\fP аналогична предыдущей, за исключением того, что она взаимоисключает опции, связанные с временным интервалом, и приводит к перезаписи файлов журналов без учета времени последней перезаписи, если указана после критериев времени (последняя указанная опция имеет приоритет). При использовании \fBmaxsize\fP учитываются размер и временная метка файла журнала. .TP \fBtabooext\fP [+] \fIlist\fP Текущий список запрещенных расширений (табу) изменен (смотрите директиву включить \fBinclude\fPдля получения информации о запрещенных расширениях). Если перед списком расширений стоит знак +, то текущий список запрещенных расширений увеличивается, в противном случае он заменяется. При запуске список запрещенных расширений будет содержать \fI,v\fP, \fI.bak\fP, \fI.cfsaved\fP, \&\fI.disabled\fP, \fI.dpkg\-bak\fP, \fI.dpkg\-del\fP, \fI.dpkg\-dist\fP, \fI.dpkg\-new\fP, \&\fI.dpkg\-old\fP, \fI.dpkg\-tmp\fP, \fI.new\fP, \fI.old\fP, \fI.orig\fP, \fI.rhn\-cfg\-tmp\-*\fP, \&\fI.rpmnew\fP, \fI.rpmorig\fP, \fI.rpmsave\fP, \fI.swp\fP, \fI.ucf\-dist\fP, \fI.ucf\-new\fP, \&\fI.ucf\-old\fP, \fI~\fP .TP \fBtaboopat\fP [+] \fIlist\fP Изменен текущий список запрещенных шаблонов glob (информацию о расширениях и шаблонах табуляции смотрите в директиве \fBinclude\fP). Если перед списком шаблонов стоит +, текущий список запрещенных шаблонов дополняется, в противном случае он заменяется. При запуске список запрещенных шаблонов пуст. .SS "Файлы и каталоги" .TP \fBcreate \fP\fImode\fP \fIowner\fP \fIgroup\fP, \fBcreate \fP\fIowner\fP \fIgroup\fP Сразу после ротации (до запуска скрипта \fBpostrotate\fP) создается файл журнала (с тем же названием, что и у только что ротированного файла журнала). \fImode\fP задает режим доступа к файлу журнала в восьмеричном формате (аналогично \fBchmod\fP(2)), \fIowner\fP указывает пользователя, которому будет принадлежать файл журнала, а \fIgroup\fP — группу, к которой будет принадлежать файл журнала (подробнее смотрите в разделе \fBПОЛЬЗОВАТЕЛЬ И ГРУППА\fP). Любой из атрибутов файла журнала можно не указывать, в этом случае для нового файла будут использоваться те же значения атрибутов, что и для исходного файла журнала. Эту опцию можно отключить с помощью опции \fBnocreate\fP. .TP \fBnocreate\fP Не создавать новый файл журнала (это переопределяет опцию \fBcreate\fP). .TP \fBcreateolddir \fP\fImode\fP [\fIowner\fP [\fIgroup\fP]], \fBcreateolddir \fP[\fIowner\fP [\fIgroup\fP]] IЕсли каталог, указанный в директиве \fBolddir\fP, не существует, то он будет создан. Значение \fImode\fP указывает режим доступа к каталогу \fBolddir\fP в восьмеричном формате (такой же, как в \fBchmod\fP(2)), \fIowner\fP указывает пользователя, которому будет принадлежать каталог \fBolddir\fP, а \fIgroup\fP указывает группу, к которой будет принадлежать каталог \fBolddir\fP (подробнее см. в разделе \fBПОЛЬЗОВАТЕЛЬ И ГРУППА\fP). Если \fImode\fP не указано, то предполагается значение \fB0755\fP. Эту опцию можно отключить с помощью опции \fBnocreateolddir\fP. .TP \fBnocreateolddir\fP Каталог \fBolddir\fP не создается утилитой \fBlogrotate\fP, если он не существует. .TP \fBcopy\fP Создать копию файла журнала, но не изменять исходный файл. Этот вариант можно использовать, например, для создания копии текущего файла журнала или когда какой\-либо другой утилите нужно обрезать или проанализировать файл. При использовании этого варианта опция \fBcreate\fP не будет работать, так как старый файл журнала останется на месте. Опция \fBcopy\fP позволяет хранить ротированные файлы журналов на разных устройствах с помощью директивы \fBolddir\fP. .TP \fBnocopy\fP Не копировать исходный файл журнала и оставить его в штатном местоположении (это переопределяет параметр \fBcopy\fP). .TP \fBcopytruncate\fP Обрезать исходный файл журнала до нулевого размера на месте после создания копии, вместо того чтобы перемещать старый файл журнала и при необходимости создавать новый. Это может пригодиться, если какой\-то программе нельзя указать закрыть файл журнала, и она может продолжать записывать (добавлять) данные в предыдущий журнал лог бесконечно. Обратите внимание, что между копированием файла и его усечением проходит очень мало времени, поэтому часть данных может быть потеряна. При использовании этой опции опция \fBcreate\fP не будет работать, так как старый лог останется на месте. Опция \fBcopytruncate\fP позволяет хранить ротированные лог\-файлы на разных устройствах с помощью директивы \fBolddir\fP. Опция \fBcopytruncate\fP подразумевает \fBnorenamecopy\fP. .TP \fBnocopytruncate\fP Не обрезать исходный файл журнала после создания копии (это переопределяет опция \fBcopytruncate\fP). .TP \fBrenamecopy\fP Файл журнала переименовывается на временное название в том же каталоге с добавлением расширения «.tmp». После этого запускается скрипт \fBpostrotate\fP, и файл журнала копируется из временного названия в файл с окончательным названием. По окончанию копирования файл с временным названием удаляется. Опция \fBrenamecopy\fP позволяет хранить ротированные файлы журналов на разных устройствах с помощью директивы \fBolddir\fP. Опция \fBrenamecopy\fP подразумевает \fBnocopytruncate\fP. .TP \fBnorenamecopy\fP Не переименовывать и не копировать исходный файл журнала (это переопределяет опцию \fBrenamecopy\fP). .TP \fBshred\fP Удалить файлы журналов с помощью \fBshred\fP \-u вместо unlink(). Это гарантирует, что журналы будут недоступны для чтения после запланированного удаления. По умолчанию эта опция отключена. Смотрите также \fBnoshred\fP. .TP \fBnoshred\fP Не использовать \fBshred\fP при удалении старых файлов журналов. Смотрите также \fBshred\fP. .TP \fBshredcycles\fP \fIcount\fP Запрашивать у GNU \fBshred\fP(1) перезапись файлов журнала \fBcount\fP раз перед удалением. Без этой опции используется значение по умолчанию для \fBshred\fP. .TP \fBallowhardlink\fP Ротация файлов с несколькими жесткими ссылками. По умолчанию это отключено. Целевой файл может быть очищен, например с помощью \fBshred\fP или \fBcopytruncate\fP. Используйте это с осторожностью, особенно если ротация журналов выполняется от имени пользователя root. .TP \fBnoallowhardlink\fP Не ротировать файлы с несколькими жесткими ссылками. Смотрите также \fBallowhardlink\fP. .SS Compression .TP \fBcompress\fP Сжать старые версии файлов журналов (по умолчанию с помощью \fBgzip\fP(1)). Смотрите также \fBnocompress\fP. .TP \fBnocompress\fP Не сжимать старые версии файлов журналов. Смотрите также \fBcompress\fP. .TP \fBcompresscmd\fP Определяет команду для сжатия файлов журналов. По умолчанию \fBgzip\fP. Смотрите также \fBcompress\fP. .TP \fBuncompresscmd\fP Определяет команду для декомпрессии файлов журналов. По умолчанию \fBgunzip\fP(1). .TP \fBcompressext\fP Если сжатие включено, то определяет расширение сжатых файлов журналов. По умолчанию определяется из настроек команды сжатия. .TP \fBcompressoptions\fP Опции командной строки могут быть переданы программе сжатия, если она используется. По умолчанию для \fBgzip\fP(1) используется значение "\-6" (с высокой степенью сжатия в ущерб скорости). Если вы используете другую программу сжатия, то вам может потребоваться изменить \fBcompressoptions\fP. .TP \fBdelaycompress\fP Отложить сжатие предыдущего файла журнала до следующего циклического сдвига. Это имеет силу только в комбинации с \fBcompress\fP. Это может пригодиться, если какой\-то программе не было сказано закрыть файл журнала, и она какое\-то время продолжает записывать данные в предыдущий журнал. .TP \fBnodelaycompress\fP Не откладывать сжатие предыдущего файла журнала до следующего цикла ротации (это переопределяет опцию \fBdelaycompress\fP). .SS "Названия файлов" .TP \fBextension \fP\fIext\fP Файлы журналов с расширением \fIext\fP могут сохранять его после ротации. Если используется сжатие, расширение для сжатия (обычно \fI.gz\fP) указывается после \fIext\fP. Например, у вас есть файл журнала с названием mylog.foo и вы хотите переименовать его в mylog.1.foo.gz вместо mylog.foo.1.gz. .TP \fBaddextension \fP\fIext\fP После ротации файлам журналов присваивается окончательное расширение \fIext\fP. Если исходный файл уже имеет расширение \fIext\fP, то оно не дублируется, а просто перемещается в конец, то есть файлы \fBfilename\fP и \fBfilename\fP\fIext\fP будут ротированы в filename.1\fIext\fP. Если используется сжатие, расширение, указывающее на тип сжатия (обычно \fB.gz\fP), то оно указывается после \fIext\fP. .TP \fBstart \fP\fIcount\fP Заданное число \-\- то, с которого начнётся счёт ротаций. Например, если указать 0, то при ротации исходные файлы журналов будут создаваться с расширением .0. Если указать 9, то файлы журналов будут создаваться с расширением .9, пропуская 0\(en8. Файлы будут ротироваться указанное в директиве \fBrotate\fP количество раз. .TP \fBdateext\fP Архивировать старые версии файлов журналов добавляя расширение с указанием даты в формате YYYYMMDD вместо простого номера. Расширение можно настроить с помощью опций \fBdateformat\fP и \fBdateyesterday\fP. .TP \fBnodateext\fP Не архивировать старые версии файлов журналов с расширением даты (это переопределяет опцию \fBdateext\fP). .TP \fBdateformat\fP \fIformat_string\fP Определяет расширение для \fBdateext\fP, используя обозначения, аналогичные функции \fBstrftime\fP(3). Допустимы только спецификаторы %Y %m %d %H %M %S %V %s и %z. Значение по умолчанию — \-%Y%m%d, за исключением ежечасного формата, в котором используется значение по умолчанию \-%Y%m%d%H. Обратите внимание, что символ, отделяющий название файла от расширения, также является частью строки с форматом даты. Для корректной работы %s системные часы должны быть переведены на время после 9 сентября 2001 года. Обратите внимание, что метки времени, созданные в этом формате, должны быть лексически сортируемыми (то есть сначала указывается год, затем месяц, а потом день. Например, 2001/12/01 — это нормально, а 01/12/2001 — нет, так как 01/11/2002 будет иметь меньший приоритет, хотя это более поздняя дата). Это происходит потому, что при использовании опции \fBrotate\fP \fBlogrotate\fP сортирует все переименованные названия файлов, чтобы определить, какие из них старше и должны быть удалены. .TP \fBdateyesterday\fP Использовать вчерашнюю дату вместо сегодняшней для создания расширения \fBdateext\fP, чтобы в названии файла журнала с измененными временными метками была указана та же дата, что и в самих метках. .TP \fBdatehourago\fP Использовать "час назад" вместо текущей даты, чтобы создать расширение \fBdateext\fP, в результате чего в названии файла журнала будет указан час, совпадающий с временными метками внутри него. Полезно при использовании rotate \fBhourly\fP. .SS Mail .TP \fBmail \fP\fIaddress\fP Когда журнал перестает обновляться, его содержимое отправляется по электронной почте на адрес \fIaddress\fP. Если для конкретного журнала не нужно отправлять почту, можно использовать директиву \fBnomail\fP. .TP \fBnomail\fP Не отправлять старые файлы журналов по электронной почте на какой‑либо адрес. .TP \fBmailfirst\fP При использовании команды \fBmail\fP отправлять по электронной почте только что обновленный файл, а не тот, срок действия которого скоро истечет. .TP \fBmaillast\fP При использовании команды \fBmail\fP, отправить по электронной почте файл, срок действия которого скоро истечет, а не только что обновленный файл (это значение по умолчанию). .SS "Дополнительные файлы конфигурации" .TP \fBinclude \fP\fIfile_or_directory\fP Прочитать файл, указанный в качестве аргумента, как если бы он был встроен в то место, где находится директива \fBinclude\fP. Если указан каталог, то большинство файлов из него читаются в алфавитном порядке, после чего продолжается обработка включаемого файла. Игнорируются только те файлы, которые не являются обычными файлами (например, каталоги и именованные каналы), а также файлы, названия которых заканчиваются на одно из запрещенных расширений или шаблонов, указанных в директивах \fBtabooext\fP или \fBtaboopat\fP, соответственно. Указанный путь может начинаться с \fB~/\fP, чтобы он был относительным по отношению к домашнему каталогу пользователя, от имени которого выполняется программа. Из соображений безопасности файлы конфигурации не должны быть доступны для записи ни группе, ни всем пользователям. .SS Скрипты .TP \fBsharedscripts\fP Обычно скрипты \fBprerotate\fP и \fBpostrotate\fP запускаются для каждого ротируемого журнала, а абсолютный путь к файлу журнала передается в качестве первого аргумента скрипта. Это означает, что один и тот же скрипт может запускаться несколько раз для записей в журналах, соответствующих нескольким файлам (например, в случае с шаблоном \fI/var/log/news/*\fP). Если определена опция \fBsharedscripts\fP, т о скрипты запускаются только один раз, независимо от того, сколько журналов соответствует шаблону с подстановочными знаками, и им передается весь шаблон. Однако если ни один из журналов в шаблоне не требует ротации, то скрипты запускаться не будут. Если скрипты завершаются с ошибкой (или ротация какого\-либо журнала не удалась), то остальные действия для всех журналов выполняться не будут. Эта опция имеет приоритет над опцией \fBnosharedscripts\fP. .TP \fBnosharedscripts\fP Запускать скрипты \fBprerotate\fP и \fBpostrotate\fP для каждого ротируемого файла журнала (это значение по умолчанию, оно переопределяет опцию \fBsharedscripts\fP). Абсолютный путь к файлу журнала передается в качестве первого аргумента скрипта. Абсолютный путь к итоговому ротированному файлу журнала передается в качестве второго аргумента скрипта \fBpostrotate\fP. Если скрипты завершатся с ошибкой, то остальные действия не будут выполнены только для затронутого журнала. .tq \fBfirstaction\fP .tq \ \ \ \ \fIscript\fP .tq \fBendscript\fP Скрипт \fIscript\fP выполняется один раз перед ротацией всех файлов журналов, соответствующих шаблону с подстановочными знаками, перед запуском скрипта prerotate и только в том случае, если хотя бы один журнал будет ротирован. Эти директивы могут использоваться только внутри определения файла журнала. Весь шаблон передается скрипту в качестве первого аргумента. Если скрипт завершает работу с ошибкой, то дальнейшая обработка не выполняется. Смотрите. также \fBlastaction\fP и раздел \fBСКРИПТЫ\fP. .tq \fBlastaction\fP .tq \ \ \ \ \fIscript\fP .tq \fBendscript\fP Скрипт \fIscript\fP выполняется один раз после ротации всех файлов журналов, соответствующих шаблону с подстановочными знаками, после запуска скрипта postrotate и только в том случае, если ротация была выполнена хотя бы для одного файла журнала. Эти директивы могут использоваться только внутри определения файла журнала. Весь шаблон передается в скрипт в качестве первого аргумента. Если скрипт завершается с ошибкой, то отображается только сообщение об ошибке (поскольку это последнее действие). Смотрите также \fBfirstaction\fP и раздел \fBСКРИПТЫ\fP. .tq \fBprerotate\fP .tq \ \ \ \ \fIscript\fP .tq \fBendscript\fP Скрипт \fIscript\fP выполняется до ротации файла журнала и его старых версий, и только в том случае, если журнал действительно будет ротирован. Эти директивы могут использоваться только в определении файла журнала. Обычно абсолютный путь к файлу журнала передается в качестве первого аргумента скрипта. Если указано \fBsharedscripts\fP, то в скрипт передается весь шаблон. Смотрите также \fBpostrotate\fP и раздел \fBСКРИПТЫ\fP. Смотрите \fBsharedscripts\fP и \fBnosharedscripts\fP для получения информации об обработке ошибок. .tq \fBpostrotate\fP .tq \ \ \ \ \fIscript\fP .tq \fBendscript\fP Скрипт \fIscript\fP выполняется после ротации файла журнала и перед его сжатием. Эти директивы могут использоваться только в определении файла журнала. Обычно абсолютный путь к файлу журнала передается в качестве первого аргумента скрипта, а абсолютный путь к итоговому ротированному файлу журнала — в качестве второго аргумента. Если указано \fBsharedscripts\fP, то весь шаблон передается в качестве первого аргумента скрипта, а второй аргумент опускается. Смотрите также \fBprerotate\fP и раздел \fBСКРИПЫ\fP. Смотрите \fBsharedscripts\fP и \fBnosharedscripts\fP для получения информации об обработке ошибок. .tq \fBpreremove\fP .tq \ \ \ \ \fIscript\fP .tq \fBendscript\fP Скрипт \fIscript\fP выполняется один раз непосредственно перед удалением файла журнала. \fBlogrotate\fP передает название файла, который скоро будет удален, в качестве первого аргумента скрипту. Смотрите также \fBfirstaction\fP и раздел \fBСКРИПТЫ\fP. .SH СКРИПТЫ Строки между запускающим ключевым словом (например, \fBprerotate\fP) и \fBendscript\fP (оба слова должны находиться в отдельных строках) выполняются (с помощью \fB/bin/sh\fP). Скрипт наследует некоторые свойства процесса \fBlogrotate\fP, в том числе stderr, stdout, текущий каталог, среду окружения и umask. Скрипты запускаются от имени пользователя и группы, вызвавших их, независимо от директивы \fBsu\fP. Если указан флажок \fB\-\-log\fP, то дескриптор файла 3 является дескриптором файлом журнала. Текущий рабочий каталог не указан. .SH "ПОЛЬЗОВАТЕЛЬ И ГРУППА" Идентификаторы пользователя и группы сначала проверяются по текстовому представлению, а в случае неудачи — по числовому значению. .SH ФАЙЛЫ .TS tab(:); l l l. \fI/var/lib/logrotate/status\fP:Файл состояния по умолчанию. \fI/etc/logrotate.conf\fP:Опции настройки .TE .SH "СМОТРИТЕ ТАКЖЕ" \fBchmod\fP(2), \fBgunzip\fP(1), \fBgzip\fP(1), \fBmail\fP(1), \fBshred\fP(1), \fBstrftime\fP(3), \fBstrtoul\fP(3), .SH АВТОРЫ .nf Erik Troan, Preston Brown, Jan Kaluza. .fi .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Василий Коломеец и Aleksandr Felda . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT debian-l10n-russian@lists.debian.org списка рассылки русских переводчиков .ME .