НАИМЕНОВАНИЕ
       ipastat - утилита просмотра статистики

СИНТАКСИС
       ipastat -h|v

       ipastat [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
               -t [-t]

       ipastat [-c <directory>] [-u <user>] [-g <group>] [-f <config-file>]
               -q <query>

ОПИСАНИЕ
       Утилита  ipastat используется для запроса статистики у IPA модулей ста-
       тистики и для вывода результатов на стандартный вывод  (stdout).  Стра-
       ница документации ipastat.conf(5) содержит полное описание как конфигу-
       рировать ipastat, она также содержит описание  всех  возможностей  этой
       утилиты.

       ipastat,  в  соответствии  с настройками в конфигурационном файле ipas-
       tat.conf(5) и установоками в командной строке, запрашивает  IPA  модули
       статистики  и выводит результаты на стандартный вывод. Эта утилита поз-
       воляет выводить список правил, лимитов и порогов,  выводить  статистику
       для  правил,  лимитов  и  порогов.  Возможно  одновременно использовать
       несколько систем статистики и одновременно запрашивать  статистику  для
       нескольких правил, лимитов и порогов.

       ipastat  не воспринимает никаких сигналов и обработка сигналов не опре-
       делена.

       Доступные опции:

       -c <directory>
              Определяет директорию, для которой  ipastat  сразу  же  выполнит
              функцию  chroot(2),  директория  должна быть задана с абсолютным
              путевым именем.  Рабочая директория не изменяется.

       -f <config-file>
              Использовать данный конфигурационный файл вместо  конфигурацион-
              ного файла, заданного по умолчанию. Конфигурационный файл должен
              быть задан с абсолютным путевым именем.

       -u <user>
              Изменить UID запущенной копии ipastat. Указанное значение  может
              быть  именем  пользователя или UID. Если опция -g не указана, то
              GID будет равен  группе  указанного  пользователя,  также  будут
              установлены все дополнительные группы пользователя.

       -g <group>
              Изменить  GID запущенной копии ipastat. Указанное значение может
              быть именем группы или GID. Эта опция также заменяет все  допол-
              нительные группы пользователя.

       -t     Проверить  конфигурационный  файл  на  правильность, вывести его
              содержимое и завершить работу. Эта  опция  позволяет  проверить,
              понимает  ли  ipastat и IPA модули ваш конфигурационный файл или
              нет. Выведенная конфигурация обычно не должна использоваться как
              конфигурационный  файл (см. комментарий в выводе). Два ключа -tt
              включают так называемый ``режим подражания  реальной  конфигура-
              ции'', в этом режиме ipastat установит все значение по умолчанию
              и применит установки из секций rulepat для секций rule.

       -q <query>
              Запрос статистики из IPA модулей статистики (описан в  отдельном
              списке опций).

       -h     Вывести информацию о доступных опциях и завершить работу.

       -v     Вывести номер версии, некоторые установки, что поддерживается из
              ipastat.conf(5) и завершить работу.

       Доступные опции строки запроса статистики:

       -a rules
              Вывести список правил.

       -a limits
              Вывести список лимитов для всех правил заданных в опциях -r.

       -a thresholds
              Вывести список порогов для всех правил заданных в опциях -r.

       -x <regexp>
              Отфильтровать вывод имён (опция -a) при помощи данного  регуляр-
              ного выражения POSIX (расширенный формат).

       -s <stat1> <stat2> ...
              Определить  st_list  для  следующих правил, лимитов или порогов.
              Новая опция -s начинает новый  список  систем  статистики.  Этот
              список  изменяет список систем статистики, заданный в конфигура-
              ционном файле для правила, лимита или порога. Возможно указывать
              встроенную  систему  статистики  null.  Если список в этой опции
              пустой, то предыдущий список забывается и  список  для  соответ-
              ствующей секции берётся из конфигурационного файла.

       -i|-I <interval>
              Определить  временной интервал, чтобы определить несколько непо-
              следовательных временных интервалов используйте несколько опций.
              Опция  -I  обозначает  ``точный интервал'' и имеет эффект только
              для статистики правил. Описание форматов и что  такое  временной
              интервал см. ниже.

       -r <rule>
              Определить  имя  правила, возможно использовать несколько правил
              одновременно.

       -l <limit>
              Определить имя лимита, возможно использовать  несколько  лимитов
              одновременно.

       -t <threshold>
              Определить  имя  порога, возможно использовать несколько порогов
              одновременно.

       Во всех опциях -a возможно использовать укороченные аргументы.

       Если не задана опция -a, тогда выводится статистика для правил, лимитов
       или  порогов. Не разрешается смешивать опции -l и -t, также не разреша-
       ется смешивать одиночные опции -r с опциями -l или -t. Другими словами:
       разрешается  запрашивать статистику только для правил, только для лими-
       тов или только для порогов.

       Если правило, заданное в опции -r, не существует,  то  ipastat  создаст
       правило с заданным именем на лету, если это разрешено в ipastat.conf(5)
       и это правило унаследует установки из секций rulepat и global. Этот  же
       эффект  для  лимитов  и  порогов (даже для правил, которые существуют в
       конфигурационном файле).

       Временные интервалы.

       Общая и полная форма временного интервала следующая:

            Y1.M1.D1/h1:m1:s1-Y2.M2.D2/h2:m2:s2

       где, Y1, Y2 -- года, M1, M2 -- месяца, D1, D2 -- дни, h1, h2  --  часы,
       m1,  m2 -- минуты, s1, s2 -- секунды. Месяца могут быть заданы трёхбук-
       венными сокращениями месяцов в английском языке.

       Любой временной интервал состоит из левой и правой частей. Не требуется
       чтобы  каждая часть была полностью определена. Если левая часть времен-
       ного интервала определена не полностью, то принимается  первая  секунда
       первой  минуты  первого  часа  (и  т.д.).  Если правая часть временного
       интервала определена  не  полностью,  то  принимается  конец  последней
       секунды последней минуты последнего часта (и т.д.).

       Правая  часть  временного  интервала  может быть упущена. В этом случае
       правая часть равна левой части.

       Для правила временной интервал означает, что временные отметки  записей
       правила в базе данных должны быть в диапазоне дат, заданных в временном
       интервале. Если временной интервал задан в опции -i, то только одна  из
       временных отметок записей правила в базе данных должна быть в диапазоне
       дат. Если временной интервал задан в опции -I, то тогда  обе  временные
       отметки записей правила в базе данных должны быть в диапазоне дат. Если
       временной интервал не задан, то  по  умолчанию  используется  временной
       интервал для текущего месяца.

       Для  лимита временной интервал означает, что время старта лимита должно
       быть в диапазоне дат в временном интервале. Если временной интервал  не
       задан, то выводится текущее состояние лимита.

       Для порога временной интервал не имеет никакого эффекта.

ПРИМЕРЫ
       Вывести список правил:

            ipastat -q -a rul

       Вывести список правил, начинающихся с подстроки "10":

            ipastat -q -x ^10 -a rul

       Вывести список лимитов для правил my и lan:

            ipastat -q -a lim -r my -r lan

       Вывести  список  порогов  для заданных правил: rule1 и rule2, используя
       систему статистики sdb, правило rule3 должно использовать систему  ста-
       тистики из конфигурационного файла:

            ipastat -q -a thr -s sdb -r rule1 -r rule2 -s "" rule3

       Вывести статистику для правил rule1 и rule2 за текущий месяц:

            ipastat -q -r rule1 -r rule2

       Вывести статистику для правила rule1 за январь и март текущего года:

            ipastat -q -i jan -i mar -r rule1

       Вывести статистику для правила rule1 с 10:00 до 12:00 текущего дня:

            ipastat -q -i /10-/12 -r rule1

       Вывести статистику для правил rule1, rule2 и rule3 за 2005 год:

            ipastat -q -i 2005 -r rule1 -r rule2 -r rule3

       Вывести текущие состояния лимитов lim1 для rule1 и limx для rule2:

            ipastat -q -r rule1 -l lim1 -r rule2 -l limx

       Вывести  статистику для тех же лимитов, но все состояния лимитов должны
       иметь время старта в январе 2004 года:

            ipastat -q -i 2004.jan -r rule1 -l lim1 -r rule2 -l limx

       Вывести статистику для порогов thr1 для rule1, thrx и thry  для  rule2,
       порог  thrx  должен  использовать систему статистики sdb, другие пороги
       должны использовать системы статистики из конфигурационного файла:

            ipastat -q -r rule1 -t thr1 -r rule2 -s sdb -t thrx -s "" -t thry

ДИАГНОСТИКА
       ipastat завершает свою работу с кодом возврата 0 или с  кодом  возврата
       отличным от 0, если произошла какая-то ошибка.

ФАЙЛЫ
       ipastat.conf

       (запустите  ipastat с ключём -h, чтобы увидеть путевое имя конфигураци-
       онного файла, используемое по умолчанию)

ДРУГИЕ ИСТОЧНИКИ
       ipa(8), ipactl(8), ipa.conf(5), ipastat.conf(5), ipa_mod(3)

АВТОР
       Andrey Simonenko <simon@comsys.ntu-kpi.kiev.ua>

НЕДОРАБОТКИ
       Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите  мне  по
       email.



                               16 апреля 2005 г.