.\" 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: ipastat.8,v 1.2.2.2 2007/07/20 09:53:40 simon Exp $ .\" .TH IPASTAT 8 "16 апреля 2005 г." .SH НАИМЕНОВАНИЕ ipastat -\- утилита просмотра статистики .SH СИНТАКСИС .nf \fBipastat\fP\ \fB-h\fP|\fBv\fP \fBipastat\fP\ [\fB-c\fP\ ]\ [\fB-u\fP\ ]\ [\fB-g\fP\ ]\ [\fB-f\fP\ ] \ \ \ \ \ \ \ \ \fB-t\fP [\fB-t\fP] \fBipastat\fP\ [\fB-c\fP\ ]\ [\fB-u\fP\ ]\ [\fB-g\fP\ ]\ [\fB-f\fP\ ] \ \ \ \ \ \ \ \ \fB-q\fP\ .fi .SH ОПИСАНИЕ Утилита \fBipastat\fP используется для запроса статистики у IPA модулей статистики и для вывода результатов на стандартный вывод (stdout). Страница документации ipastat.conf(5) содержит полное описание как конфигурировать \fBipastat\fP, она также содержит описание всех возможностей этой утилиты. .PP \fBipastat\fP, в соответствии с настройками в конфигурационном файле ipastat.conf(5) и установоками в командной строке, запрашивает IPA модули статистики и выводит результаты на стандартный вывод. Эта утилита позволяет выводить список правил, лимитов и порогов, выводить статистику для правил, лимитов и порогов. Возможно одновременно использовать несколько систем статистики и одновременно запрашивать статистику для нескольких правил, лимитов и порогов. .PP \fBipastat\fP не воспринимает никаких сигналов и обработка сигналов не определена. .PP Доступные опции: .IP \fB-c\fP\ Определяет директорию, для которой \fBipastat\fP сразу же выполнит функцию chroot(2), директория должна быть задана с абсолютным путевым именем. Рабочая директория не изменяется. .IP \fB-f\fP\ Использовать данный конфигурационный файл вместо конфигурационного файла, заданного по умолчанию. Конфигурационный файл должен быть задан с абсолютным путевым именем. .IP \fB-u\fP\ Изменить UID запущенной копии \fBipastat\fP. Указанное значение может быть именем пользователя или UID. Если опция \fB-g\fP не указана, то GID будет равен группе указанного пользователя, также будут установлены все дополнительные группы пользователя. .IP \fB-g\fP\ Изменить GID запущенной копии \fBipastat\fP. Указанное значение может быть именем группы или GID. Эта опция также заменяет все дополнительные группы пользователя. .IP \fB-t\fP Проверить конфигурационный файл на правильность, вывести его содержимое и завершить работу. Эта опция позволяет проверить, понимает ли \fBipastat\fP и IPA модули ваш конфигурационный файл или нет. Выведенная конфигурация обычно не должна использоваться как конфигурационный файл (см.\ комментарий в выводе). Два ключа \fB-tt\fP включают так называемый ``режим подражания реальной конфигурации'', в этом режиме \fBipastat\fP установит все значение по умолчанию и применит установки из секций \fBrulepat\fP для секций \fBrule\fP. .IP \fB-q\fP\ Запрос статистики из IPA модулей статистики (описан в отдельном списке опций). .IP \fB-h\fP Вывести информацию о доступных опциях и завершить работу. .IP \fB-v\fP Вывести номер версии, некоторые установки, что поддерживается из ipastat.conf(5) и завершить работу. .PP Доступные опции строки запроса статистики: .IP \fB-a\fP\ rules Вывести список правил. .IP \fB-a\fP\ limits Вывести список лимитов для всех правил заданных в опциях \fB-r\fP. .IP \fB-a\fP\ thresholds Вывести список порогов для всех правил заданных в опциях \fB-r\fP. .IP \fB-x\fP\ Отфильтровать вывод имён (опция \fB-a\fP) при помощи данного регулярного выражения POSIX (расширенный формат). .IP \fB-s\fP\ \ \ ... Определить \fBst_list\fP для следующих правил, лимитов или порогов. Новая опция \fB-s\fP начинает новый список систем статистики. Этот список изменяет список систем статистики, заданный в конфигурационном файле для правила, лимита или порога. Возможно указывать встроенную систему статистики \fInull\fP. Если список в этой опции пустой, то предыдущий список забывается и список для соответствующей секции берётся из конфигурационного файла. .IP \fB-i\fP|\fB-I\fP\ Определить временной интервал, чтобы определить несколько непоследовательных временных интервалов используйте несколько опций. Опция \fB-I\fP обозначает ``точный интервал'' и имеет эффект только для статистики правил. Описание форматов и что такое временной интервал см. ниже. .IP \fB-r\fP\ Определить имя правила, возможно использовать несколько правил одновременно. .IP \fB-l\fP\ Определить имя лимита, возможно использовать несколько лимитов одновременно. .IP \fB-t\fP\ Определить имя порога, возможно использовать несколько порогов одновременно. .PP Во всех опциях \fB-a\fP возможно использовать укороченные аргументы. .PP Если не задана опция \fB-a\fP, тогда выводится статистика для правил, лимитов или порогов. Не разрешается смешивать опции \fB-l\fP и \fB-t\fP, также не разрешается смешивать одиночные опции \fB-r\fP с опциями \fB-l\fP или \fB-t\fP. Другими словами: разрешается запрашивать статистику только для правил, только для лимитов или только для порогов. .PP Если правило, заданное в опции \fB-r\fP, не существует, то \fBipastat\fP создаст правило с заданным именем на лету, если это разрешено в ipastat.conf(5) и это правило унаследует установки из секций \fBrulepat\fP и \fBglobal\fP. Этот же эффект для лимитов и порогов (даже для правил, которые существуют в конфигурационном файле). .PP \fBВременные интервалы.\fP .PP Общая и полная форма временного интервала следующая: .PP .nf Y1.M1.D1/h1:m1:s1-Y2.M2.D2/h2:m2:s2 .fi .PP где, Y1, Y2 -\- года, M1, M2 -\- месяца, D1, D2 -\- дни, h1, h2 -\- часы, m1, m2 -\- минуты, s1, s2 -\- секунды. Месяца могут быть заданы трёхбуквенными сокращениями месяцов в английском языке. .PP Любой временной интервал состоит из левой и правой частей. Не требуется чтобы каждая часть была полностью определена. Если левая часть временного интервала определена не полностью, то принимается первая секунда первой минуты первого часа (и т.д.). Если правая часть временного интервала определена не полностью, то принимается конец последней секунды последней минуты последнего часта (и т.д.). .PP Правая часть временного интервала может быть упущена. В этом случае правая часть равна левой части. .PP Для правила временной интервал означает, что временные отметки записей правила в базе данных должны быть в диапазоне дат, заданных в временном интервале. Если временной интервал задан в опции \fB-i\fP, то только одна из временных отметок записей правила в базе данных должна быть в диапазоне дат. Если временной интервал задан в опции \fB-I\fP, то тогда обе временные отметки записей правила в базе данных должны быть в диапазоне дат. Если временной интервал не задан, то по умолчанию используется временной интервал для текущего месяца. .PP Для лимита временной интервал означает, что время старта лимита должно быть в диапазоне дат в временном интервале. Если временной интервал не задан, то выводится текущее состояние лимита. .PP Для порога временной интервал не имеет никакого эффекта. .SH ПРИМЕРЫ Вывести список правил: .PP .nf ipastat -q -a rul .fi .PP Вывести список правил, начинающихся с подстроки "10": .PP .nf ipastat -q -x ^10 -a rul .fi .PP Вывести список лимитов для правил my и lan: .PP .nf ipastat -q -a lim -r my -r lan .fi .PP Вывести список порогов для заданных правил: rule1 и rule2, используя систему статистики sdb, правило rule3 должно использовать систему статистики из конфигурационного файла: .PP .nf ipastat -q -a thr -s sdb -r rule1 -r rule2 -s "" rule3 .fi .PP Вывести статистику для правил rule1 и rule2 за текущий месяц: .PP .nf ipastat -q -r rule1 -r rule2 .fi .PP Вывести статистику для правила rule1 за январь и март текущего года: .PP .nf ipastat -q -i jan -i mar -r rule1 .fi .PP Вывести статистику для правила rule1 с 10:00 до 12:00 текущего дня: .PP .nf ipastat -q -i /10-/12 -r rule1 .fi .PP Вывести статистику для правил rule1, rule2 и rule3 за 2005 год: .PP .nf ipastat -q -i 2005 -r rule1 -r rule2 -r rule3 .fi .PP Вывести текущие состояния лимитов lim1 для rule1 и limx для rule2: .PP .nf ipastat -q -r rule1 -l lim1 -r rule2 -l limx .fi .PP Вывести статистику для тех же лимитов, но все состояния лимитов должны иметь время старта в январе 2004 года: .PP ipastat -q -i 2004.jan -r rule1 -l lim1 -r rule2 -l limx .PP Вывести статистику для порогов thr1 для rule1, thrx и thry для rule2, порог thrx должен использовать систему статистики sdb, другие пороги должны использовать системы статистики из конфигурационного файла: .PP .nf ipastat -q -r rule1 -t thr1 -r rule2 -s sdb -t thrx -s "" -t thry .fi .SH ДИАГНОСТИКА \fBipastat\fP завершает свою работу с кодом возврата 0 в случае успешного завершения работы, и с кодом возврата 1 если произошла какая-то ошибка. .SH ФАЙЛЫ ipastat.conf .PP (запустите \fBipastat\fP с ключём \fB-h\fP, чтобы увидеть путевое имя конфигурационного файла, используемое по умолчанию) .SH ДРУГИЕ ИСТОЧНИКИ ipa(8), ipactl(8), ipa.conf(5), ipastat.conf(5), ipa_mod(3) .SH АВТОР Andrey\ Simonenko\ .SH НЕДОРАБОТКИ Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите мне по email.