.\" Copyright (c) 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: ipactl.8,v 1.1.4.3 2007/07/20 09:53:40 simon Exp $ .\" .TH IPACTL 8 "16 апреля 2005 г." .SH НАИМЕНОВАНИЕ ipactl -\- утилита управления ipa(8) .SH СИНТАКСИС .nf \fBipactl\fP\ \fB-h\fP|\fBv\fP \fBipactl\fP\ [\fB-n\fP] [\fB-s\fP\ ]\ [\fB-w\fP\ ] \ \ \ \ \ \ \ [\fB-r\fP\ [\fB-l\fP |\fB-t\fP ]]\ [] .fi .SH ОПИСАНИЕ Утилита \fBipactl\fP используется для управления работы ipa(8) на лету. Контроль осуществляется посредством посылки сообщений на известный для ipa(8) и \fBipactl\fP Unix domain сокет. Перед тем как использовать \fBipactl\fP необходимо разрешить использование Unix domain сокет для принятия сообщений в ipa.conf(5) и предоставить права пользователям, которым будет разрешено использовать \fBipactl\fP. Прочтите детали о разрешении доступа в странице документации ipa.conf(5). .PP Утилита \fBipactl\fP также может использоваться как источник статистики для правила, даже если это правило не использует ни одну систему учёта. .PP Доступные опции: .IP \fB-s\fP\ Подключаться к , вместо того, чтобы подключатся к Unix domain сокету, заданного по умолчанию. .IP \fB-r\fP\ Имя правила. .IP \fB-l\fP\ Имя лимита. .IP \fB-t\fP\ Имя порога. .IP \fB-n\fP Не ждать ответа от ipa(8), асинхронный режим. .IP \fB-w\fP\ Определить число секунд ожидания ответа от ipa(8), нуль обозначает безграничный таймаут (по умолчанию). На самом деле этот таймаут применяется для двух или трёх системных вызовов по отдельности. .IP \fB-h\fP Вывести информацию о доступных опциях и командах и завершить работу. .IP \fB-v\fP Вывести номер версии, установки конфигурации и завершить работу. .PP Доступные команды: .IP \fIdump\fP Указывает сохранить текущую статистику в базах данных, после получения ответа от ipa(8), можете быть уверены, что работа ipa(8) будет заморожена на время \fBsleep_after_dump\fP (см. ipa.conf(5)). .IP \fIfreeze\fP Заморозить работу ipa(8), после получения ответа от ipa(8), вы можете быть уверены, что работа ipa(8) будет заморожена на время \fBfreeze_time\fP (см. ipa.conf(5)). .IP \fImemory\fP Вывести информацию об использованной памяти, о зонах памяти и о массивах памяти (используя статистику функций \fIipa_memfunc\fP). .IP \fIstatus\fP Вывести различную статусную информацию, эта команда может быть использована с опциями \fB-r\fP, \fB-l\fP и \fB-t\fP. .IP \fIexpire\fP Перезапустить лимит, если он уже был достигнут, даже если лимит не имеет секции \fBexpire\fP; но если он содержит секцию \fBexpire\fP и в ней есть команды, то эти команды будут запущены. .IP \fIrestart\fP Перезапустить лимит, если он не был достигнут, даже если лимит не имеет секции \fBrestart\fP; но если он содержит секцию \fBrestart\fP и в ней есть команды, то эти команды будут запущены. .IP \fIset\fP\ \fIlimit\fP\ [+|-] Изменить значение параметра \fBlimit\fP для лимита, значение параметра \fBload_limit\fP для лимита должно быть равно ``yes''. .IP \fIset\fP\ \fIthreshold\fP\ [+|-] Изменить значение параметра \fBthreshold\fP для порога, значение параметра \fBload_threshold\fP для порога должно быть равно ``yes''. .IP \fIset\fP\ \fIcounter\fP\ [+|-] Изменить значение счётчика для правила, лимита или порога. .PP Любая управляющая команда, которая требует или , также требует . .PP Во всех командах `+' означает увеличение и `-' означает уменьшие текущего значения (значение счётчика, значение параметра \fBlimit\fP или \fBthreshold\fP). .PP Для команд \fIexpire\fP, \fIrestart\fP и \fIset\fP новое состояние лимита регистрируется в базе данных немедленно и лимит также проверяется немедленно, даже если лимит неактивен или его правило неактивно, в этом случае лимит (и его правило) устанавливается в активное состояние и затем после обновления состояния лимита он опять устанавливаются в неактивное состояние. .PP Команда \fIset\fP для правила позволяет только увеличить или уменьшить счётчик правила. Прочтите параграф о статистике и об отрицательной статистике в странице документации ipa.conf(5), чтобы понять что происходит, когда вы уменьшаете статистику. Если какие-то из лимитов или порогов правила неактивны, то их статистика не обновляется. Обновляется только статистика правила и активных лимитов и порогов этого правила. Если правило неактивно, то оно устанавливается в активное состояние и затем после обновления статистики правила, правило опять устанавливается в неактивное состояние. .PP Команда \fIset\fP для правила может изменить статистику для лимитов и порогов правила. Эта статистика не будет проверяться немедленно, проверка для лимитов и порогов будет запланирована и будет выполнена как можно быстрее. .PP Если лимит является достигнутым и после команды \fIset\fP он стал недостигнутым, и у него есть секция \fBexpire\fP, то никакие команды из этой секции не запускаются. .PP Если лимит является недостигнутым и после команды \fIset\fP он стал достигнутым, и у него есть секция \fBreach\fP, то запускаются все команды из этой секции. .PP Если какой-то подлимит является недостигнутым и после команды \fIset\fP он стал достигнутым, и у него есть секция \fBreach\fP, то запускаются все команды из этой секции. .PP Команда \fIset\fP для лимита имеет один побочный эффект: если лимит не имеет параметра \fBload_limit\fP с значением ``yes'', и он достигнут, и значение параметра \fBlimit\fP в базе данных не равно значению параметра \fBlimit\fP в конфигурационном файле, то если вы измените счётчик лимита, то счётчик и значение параметра \fBlimit\fP (реальное значение) будут обновлены вместе в базе данных. .PP Для команда \fIset\fP новое состояние порога регистрируется в базе данных немедленно, даже если порог неактивен или его правило неактивно, как и в случае с лимитами. Новые установки порога будут проверены в следующее временное событие \fBthreshold_time_slice\fP. .PP \fBipactl\fP принимает как 64-битное целое, время или байты. Форматы для времени и байтов в схожи с аналогичными форматами в ipa.conf(5), но пробелы в форматах запрещены. .SH ДИАГНОСТИКА \fBipactl\fP завершает свою работу с кодом возврата 0, если всё в порядке; 1, если не возможно разобрать командную строку, не возможно отправить комамду или получить ответ от ipa(8); 2, если был получен ответ от ipa(8) и этот ответ сообщает, что управляющая команда в ipa(8) не была выполнена. Если \fBipactl\fP запущена с ключём \fB-n\fP, то невозможно определить по коду возврату была ли принята команда утилитой ipa(8) или нет. .SH ФАЙЛЫ ipactl.sock .PP (запустите \fBipactl\fP с ключём \fB-h\fP, чтобы увидеть путь, заданный по умолчанию) .SH ДРУГИЕ ИСТОЧНИКИ ipa(8), ipastat(8), ipa.conf(5), ipastat.conf(5), ipa_mod(3) .SH АВТОР Andrey\ Simonenko\ .SH НЕДОРАБОТКИ Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите мне по email.