НАИМЕНОВАНИЕ
       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 или в  лог-файл.
              Если  сообщения  выводятся в 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.  Сиг-
       нал  SIGTERM  обычно  посылается  автоматически  всем  процессам, когда
       система завершает свою работу и обычно  нет  смысла  писать  какой-либо
       скрипт,  чтобы послать сигнал SIGTERM запущенной копии ipa.  syslogd(8)
       обычно завершает свою  работу  первым,  поэтому  ipa  может  не  успеть
       послать  последние сообщения в syslog, если используется syslog. Если в
       командной строке указан ключ -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 или с кодом возврата
       отличным от 0, если произошла какая-то ошибка. По умолчанию 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)