.\" Copyright (c) 2001-2004 Andrey Simonenko .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#)$Id: ipa.8,v 1.1.4.3 2007/07/20 09:53:40 simon Exp $ .\" .TH IPA 8 "16 апреля 2005 г." .SH НАИМЕНОВАНИЕ ipa -\- утилита учёта статистики .SH СИНТАКСИС .nf \fBipa\fP\ \fB-h\fP|\fBv\fP \fBipa\fP\ [\fB-c\fP\ ]\ [\fB-u\fP\ ]\ [\fB-g\fP\ ] \ \ \ \ [\fB-p\fP\ ]\ \fB-k\fP\ \fBipa\fP\ [\fB-c\fP\ ]\ [\fB-u\fP\ ]\ [\fB-g\fP\ ]\ [\fB-f\fP\ ] \ \ \ \ \fB-t\fP [\fB-t\fP] \fBipa\fP\ [\fB-d\fP]\ [\fB-c\fP\ ]\ [\fB-u\fP\ ]\ [\fB-g\fP\ ]\ [\fB-f\fP\ ] \ \ \ \ [\fB-o\fP\ ]\ [\fB-i\fP\ ]\ [\fB-p\fP\ ] \fBipa\fP\ \fB-x\fP\ [\fB-c\fP\ ]\ [\fB-u\fP\ ]\ [\fB-g\fP\ ]\ [\fB-f\fP\ ] \ \ \ \ [\fB-r\fP\ \ [\fB-l\fP\ [\fB-s\fP ]|\fB-t\fP ]] \ \ \ \ section\ [subsection] .fi .SH ОПИСАНИЕ IPA это ``Модульная система учёта и ведения статистики''. Пакет IPA состоит из трёх утилит общего назначения для учёта и ведения статистики: \fBipa\fP, \fBipactl\fP и \fBipastat\fP. Каждая из этих утилит описана в собственной странице документации. .PP \fBipa\fP это утилита учёта статистики. Страница документации ipa.conf(5) содержит полное описание как конфигурировать \fBipa\fP, она также содержит описание всех возможностей этой утилиты. .PP \fBipa\fP, в соответствии с настройками в конфигурационном файле ipa.conf(5), периодически собирает статистику с IPA модулей систем учёта и передаёт эту статистику IPA модулям баз данных. Возможно одновременно использовать несколько систем учёта и баз данных. .PP Доступные опции: .IP \fB-c\fP\ Определяет директорию, для которой \fBipa\fP сразу же выполнит функцию chroot(2), директория должна быть задана с абсолютным путевым именем. Рабочая директория не изменяется. .IP \fB-d\fP Не переходить в фоновый режим. Если используется лог-файл, то все сообщения также выводятся в стандартный вывод ошибок (stderr). Если используется syslog, то сообщения копируются в stderr только на некоторых системах. Эта опция полезна для отладки. .IP \fB-f\fP\ Использовать данный конфигурационный файл вместо конфигурационного файла, заданного по умолчанию. Конфигурационный файл должен быть задан с абсолютным путевым именем. .IP \fB-k\fP\ Послать сигнал запущенной копии \fBipa\fP. Доступны следующие аргументы: \fIshutdown\fP (послать сигнал SIGTERM), \fIreconfigure\fP (послать сигнал SIGHUP), \fIkill\fP (послать сигнал SIGKILL), \fItest\fP (проверить заблокирован ли PID-файл, никакой сигнал не посылается). PID запущенной копии берётся как PID процесса имеющего эксклюзивную блокировку на PID-файл. Сигнал не будет посылаться в том случае, если PID-файл не заблокирован эксклюзивно. .IP \fB-i\fP\ Использовать данный идентификатор лог-сообщений, вместо ``ipa'', заданного по умолчанию. .IP \fB-o\fP\ Записывать лог-сообщения в заданный лог-файл, вместо использования syslog. Этот файл может быть удалён во время работы \fBipa\fP, он при необходимости будет создан заново. Это свойство помогает организовать ротацию лог-файлов. .IP \fB-p\fP\ Использовать данный , вместо PID-файла, заданного по умолчанию. Эта опция позволяет запускать несколько копий \fBipa\fP одновременно. .IP \fB-u\fP\ Изменить UID запущенной копии \fBipa\fP. Указанное значение может быть именем пользователя или UID. Если опция \fB-g\fP не указана, то GID будет равен группе указанного пользователя, также будут установлены все дополнительные группы пользователя. .IP \fB-g\fP\ Изменить GID запущенной копии \fBipa\fP. Указанное значение может быть именем группы или GID. Эта опция также заменяет все дополнительные группы пользователя. .IP \fB-t\fP Проверить конфигурационный файл на правильность, вывести его содержимое и завершить работу. Эта опция позволяет проверить, понимает ли \fBipa\fP и IPA модули ваш конфигурационный файл или нет. Выведенная конфигурация обычно не должна использоваться как конфигурационный файл (см.\ комментарий в выводе). Два ключа \fB-tt\fP включают так называемый ``режим подражания реальной конфигурации'', в этом режиме \fBipa\fP установит все значение по умолчанию и применит установки из секций \fBrulepat\fP для секций \fBrule\fP. .IP \fB-x\fP\ ... Запустить команды из данной секции (подсекции) и завершить работу. Нет возможности запустить какую-либо команду из секций из \fBautorule\fP и \fBrulepat\fP секций. В этой опции правила наследуют установки из секций \fBrulepat\fP. См.\ страницу документации ipa.conf(5) для получения информации об именах секций и подсекций, правилах, лимитах, подлимитах и порогах. .IP \fB-h\fP Вывести информацию о доступных опциях и завершить работу. .IP \fB-v\fP Вывести номер версии, некоторые установки, что поддерживается из ipa.conf(5) и завершить работу. .PP \fBipa\fP эксклюзивно блокирует PID-файл, чтобы избежать запуска нескольких своих копий и сохраняет свой PID в этом файле. Этот сохранённый PID никаким образом не используется в \fBipa\fP. .PP Запущенная копия \fBipa\fP завершает свою работу, если получит сигнал SIGTERM. Это единственный правильный метод завершения работы \fBipa\fP. Если в командной строке указан ключ \fB-d\fP, тогда сигнал SIGINT обрабатывается также, как и сигнал SIGTERM (сигнал SIGINT обычно посылается программе запущенной в интерактивном режиме, если набрать последовательность Control-C на клавиатуре). .PP Если послать сигнал SIGHUP, то \fBipa\fP перечитает конфигурационный файл (заданный по умолчанию или определённый в командной строке, когда запускалась \fBipa\fP). Если \fBipa\fP будет не в состоянии обработать содержимое конфигурационного файла, то она завершит свою работу. Прочтите страницу документации ipa.conf(5) для большей информации о том, в каких случаях лучше перечитать конфигурацию, чем останавливать и потом снова запускать \fBipa\fP. .PP Не посылайте сигнал SIGKILL запущенной копии \fBipa\fP, используйте этот сигнал только в том случае, если \fBipa\fP не работает должным образом и не реагирует на сигнал SIGTERM (или сигнал SIGINT, если \fBipa\fP запущена в интерактивном режиме). Это замечание присутствует здесь лишь потому, что опция \fB-k\fP воспринимает аргумент \fIkill\fP. .PP Заметьте, что выше перечисленные сигналы ловятся \fBipa\fP, только если в данный момент времени не выполняется какая-либо функция из используемых IPA модулей или запускаются команды в синхронном режиме. Обработка других сигналов не определена. .PP Когда \fBipa\fP запускается в фоновом режиме, то она перенаправляет стандартный ввод (stdin) в /dev/null (см. реальный путь в выводе команды ``ipa\ \-v''), вывод в стандартный вывод (stdout) и стандартный вывод ошибок (stderr) перенаправляется во внутренние pipe(2) и асинхронно посылается в лог с префиксами *STDOUT и *STDERR. Дескриптор для записи в pipe(2) устанавливается в неблокирующий режим. Так как любой pipe(2) имеет ограниченный размер своих буферов, то некоторая информация посланная в stdout или stderr может быть потеряна. В любом случае это лучше, чем просто игнорировать вывод в stdout и stderr. Когда \fBipa\fP запускается в режиме отладки, то stdin и stderr работают как обычно (stderr используется для вывода лог сообщений). \fBipa\fP сама не посылает никаких сообщений в stdout и stderr (когда запущена в фоновом режиме), но библиотечные функции или запускаемые команды могут посылать сообщения в stdout и stderr. .SH ДИАГНОСТИКА \fBipa\fP завершает свою работу с кодом возврата 0 в случае успешного завершения работы, и с кодом возврата 1 если произошла какая-то ошибка. По умолчанию \fBipa\fP запускается в фоновом режиме и вам не следует полагаться на возвращаемый код (это всего лишь код возврата исходного процесса), лучше посмотреть содержимое лог-файла. Если вам необходимо контролировать код возврата, то запускайте \fBipa\fP в фоновом режиме (используйте ключ \fB-d\fP). .SH ФАЙЛЫ ipa.pid .br ipa.conf .PP (запустите \fBipa\fP с ключём \fB-h\fP, чтобы увидеть путевые имена файлов, используемых по умолчанию) .SH ДРУГИЕ ИСТОЧНИКИ ipactl(8), ipastat(8), ipa.conf(5), ipastat.conf(5), ipa_mod(3) .SH АВТОР Andrey\ Simonenko\ .SH НЕДОРАБОТКИ Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите мне по email.