IPA(8) IPA(8)
НАИМЕНОВАНИЕ
ipa -- утилита учёта статистики
СИНТАКСИС
ipa -h|v
ipa [-c <directory>] [-u <user>] [-g <group>]
[-p <pid-file>] -k <signal>
ipa [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
-t [-t]
ipa [-d] [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
[-o <log-file>] [-i <log-ident>] [-p <pid-file>]
ipa -x [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
[-r <rule> [-l <limit> [-s <sublimit>]|-t <threshold>]]
section [subsection]
ОПИСАНИЕ
IPA это ``Модульная система учёта и ведения статистики''. Пакет IPA
состоит из трёх утилит общего назначения для учёта и ведения стати-
стики: ipa, ipactl и ipastat. Каждая из этих утилит описана в собствен-
ной странице документации.
ipa это утилита учёта статистики. Страница документации ipa.conf(5)
содержит полное описание как конфигурировать ipa, она также содержит
описание всех возможностей этой утилиты.
ipa, в соответствии с настройками в конфигурационном файле ipa.conf(5),
периодически собирает статистику с IPA модулей систем учёта и передаёт
эту статистику IPA модулям баз данных. Возможно одновременно использо-
вать несколько систем учёта и баз данных.
Доступные опции:
-c <directory>
Определяет директорию, для которой ipa сразу же выполнит функцию
chroot(2), директория должна быть задана с абсолютным путевым
именем. Рабочая директория не изменяется.
-d Не переходить в фоновый режим. Если используется лог-файл, то
все сообщения также выводятся в стандартный вывод ошибок
(stderr). Если используется syslog, то сообщения копируются в
stderr только на некоторых системах. Эта опция полезна для
отладки.
-f <config-file>
Использовать данный конфигурационный файл вместо конфигурацион-
ного файла, заданного по умолчанию. Конфигурационный файл должен
быть задан с абсолютным путевым именем.
-k <signal>
Послать сигнал запущенной копии ipa. Доступны следующие аргу-
менты: shutdown (послать сигнал SIGTERM), reconfigure (послать
сигнал SIGHUP), kill (послать сигнал SIGKILL), test (проверить
заблокирован ли PID-файл, никакой сигнал не посылается). PID
запущенной копии берётся как PID процесса имеющего эксклюзивную
блокировку на PID-файл. Сигнал не будет посылаться в том случае,
если PID-файл не заблокирован эксклюзивно.
-i <log-ident>
Использовать данный идентификатор лог-сообщений, вместо ``ipa'',
заданного по умолчанию.
-o <log-file>
Записывать лог-сообщения в заданный лог-файл, вместо использова-
ния syslog. Этот файл может быть удалён во время работы ipa, он
при необходимости будет создан заново. Это свойство помогает
организовать ротацию лог-файлов.
-p <pid-file>
Использовать данный <pid-file>, вместо PID-файла, заданного по
умолчанию. Эта опция позволяет запускать несколько копий ipa
одновременно.
-u <user>
Изменить UID запущенной копии ipa. Указанное значение может быть
именем пользователя или UID. Если опция -g не указана, то GID
будет равен группе указанного пользователя, также будут установ-
лены все дополнительные группы пользователя.
-g <group>
Изменить GID запущенной копии ipa. Указанное значение может быть
именем группы или GID. Эта опция также заменяет все дополнитель-
ные группы пользователя.
-t Проверить конфигурационный файл на правильность, вывести его
содержимое и завершить работу. Эта опция позволяет проверить,
понимает ли ipa и IPA модули ваш конфигурационный файл или нет.
Выведенная конфигурация обычно не должна использоваться как кон-
фигурационный файл (см. комментарий в выводе). Два ключа -tt
включают так называемый ``режим подражания реальной конфигура-
ции'', в этом режиме ipa установит все значение по умолчанию и
применит установки из секций rulepat для секций rule.
-x ... Запустить команды из данной секции (подсекции) и завершить
работу. Нет возможности запустить какую-либо команду из секций
из autorule и rulepat секций. В этой опции правила наследуют
установки из секций rulepat. См. страницу документации
ipa.conf(5) для получения информации об именах секций и подсек-
ций, правилах, лимитах, подлимитах и порогах.
-h Вывести информацию о доступных опциях и завершить работу.
-v Вывести номер версии, некоторые установки, что поддерживается из
ipa.conf(5) и завершить работу.
ipa эксклюзивно блокирует PID-файл, чтобы избежать запуска нескольких
своих копий и сохраняет свой PID в этом файле. Этот сохранённый PID
никаким образом не используется в ipa.
Запущенная копия ipa завершает свою работу, если получит сигнал
SIGTERM. Это единственный правильный метод завершения работы ipa. Если
в командной строке указан ключ -d, тогда сигнал SIGINT обрабатывается
также, как и сигнал SIGTERM (сигнал SIGINT обычно посылается программе
запущенной в интерактивном режиме, если набрать последовательность Con-
trol-C на клавиатуре).
Если послать сигнал SIGHUP, то ipa перечитает конфигурационный файл
(заданный по умолчанию или определённый в командной строке, когда
запускалась ipa). Если ipa будет не в состоянии обработать содержимое
конфигурационного файла, то она завершит свою работу. Прочтите стра-
ницу документации ipa.conf(5) для большей информации о том, в каких
случаях лучше перечитать конфигурацию, чем останавливать и потом снова
запускать ipa.
Не посылайте сигнал SIGKILL запущенной копии ipa, используйте этот сиг-
нал только в том случае, если ipa не работает должным образом и не реа-
гирует на сигнал SIGTERM (или сигнал SIGINT, если ipa запущена в интер-
активном режиме). Это замечание присутствует здесь лишь потому, что
опция -k воспринимает аргумент kill.
Заметьте, что выше перечисленные сигналы ловятся ipa, только если в
данный момент времени не выполняется какая-либо функция из используемых
IPA модулей или запускаются команды в синхронном режиме. Обработка дру-
гих сигналов не определена.
Когда ipa запускается в фоновом режиме, то она перенаправляет стандарт-
ный ввод (stdin) в /dev/null (см. реальный путь в выводе команды
``ipa -v''), вывод в стандартный вывод (stdout) и стандартный вывод
ошибок (stderr) перенаправляется во внутренние pipe(2) и асинхронно
посылается в лог с префиксами *STDOUT и *STDERR. Дескриптор для записи
в pipe(2) устанавливается в неблокирующий режим. Так как любой pipe(2)
имеет ограниченный размер своих буферов, то некоторая информация
посланная в stdout или stderr может быть потеряна. В любом случае это
лучше, чем просто игнорировать вывод в stdout и stderr. Когда ipa
запускается в режиме отладки, то stdin и stderr работают как обычно
(stderr используется для вывода лог сообщений). ipa сама не посылает
никаких сообщений в stdout и stderr (когда запущена в фоновом режиме),
но библиотечные функции или запускаемые команды могут посылать сообще-
ния в stdout и stderr.
ДИАГНОСТИКА
ipa завершает свою работу с кодом возврата 0 в случае успешного завер-
шения работы, и с кодом возврата 1 если произошла какая-то ошибка. По
умолчанию ipa запускается в фоновом режиме и вам не следует полагаться
на возвращаемый код (это всего лишь код возврата исходного процесса),
лучше посмотреть содержимое лог-файла. Если вам необходимо контролиро-
вать код возврата, то запускайте ipa в фоновом режиме (используйте ключ
-d).
ФАЙЛЫ
ipa.pid
ipa.conf
(запустите ipa с ключём -h, чтобы увидеть путевые имена файлов, исполь-
зуемых по умолчанию)
ДРУГИЕ ИСТОЧНИКИ
ipactl(8), ipastat(8), ipa.conf(5), ipastat.conf(5), ipa_mod(3)
АВТОР
Andrey Simonenko <simon@comsys.ntu-kpi.kiev.ua>
НЕДОРАБОТКИ
Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите мне по
email.
16 апреля 2005 г. IPA(8)