.\" 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: ipa_st_sdb.8,v 1.2 2006/03/21 20:24:44 simon Exp $
.\"
.TH IPA_ST_SDB 8 "26 апреля 2005 г."
.SH НАИМЕНОВАНИЕ
ipa_st_sdb\ \-\ IPA модуль простой базы данных (статистика)
.SH ОПИСАНИЕ
\fBipa_st_sdb\fP это IPA модуль статистики, это модуль статистики для
модуля базы данных ipa_db_sdb(8), таким образом он имеет теже самые
свойства что и модуль базы данных.
.PP
Обычно бинарная реализация модуля \fBipa_st_sdb\fP хранится в файле
\fIipa_st_sdb.so\fP.
Имя базы данных -\- \fBsdb\fP.
.SH ФОРМАТ КОНФИГУРАЦИОННОГО ФАЙЛА
Конфигурация модуля интегрирована в файл ipa.conf(5).
Конфигурационный префикс модуля -\- \fBsdb\fP.
.PP
Параметр \fBdb_dir\fP позволяет изменить директорию базы данных
\fI/var/ipa_sdb\fP, заданную по умолчанию:
.PP
.nf
	sdb:db_dir = "/path/to/directory";
.fi
.PP
Этот параметр может быть расположен в секциях \fBglobal\fP и \fBrule\fP.
Так как этот параметр может быть расположен в секциях \fBrule\fP, то
каждое правило может иметь собственную директорию для своих файлов и
директорий базы данных.
.PP
Следующие параметры могут быть расположены только в нулевой секции модуля:
.PP
.nf
	sdb: {
	    /* Параметры. */
	}
.fi
.PP
По умолчанию модуль не ожидает, что какая-то директория или файл в
базе данных представлена символической ссылкой, возможно разрешить или
запретить символические ссылки в параметра \fBallow_symlinks\fP:
.PP
.nf
	allow_symlinks = <boolean>;
.fi
.PP
Значение этого параметра по умолчанию равно ``no''.
.PP
По умолчанию каждая базовая директория базы данных имеет специальный
файл, который содержит номер версии формата базы данных и модуль проверяет
версию, сохранённую в этом файле.
Чтобы ускорить работу модуля в случае использования большого количества
правил, возможно отключить проверку версии формата базы данных в параметре
\fBcheck_version\fP:
.PP
.nf
	check_version = <boolean>;
.fi
.PP
Значение этого параметра по умолчанию равно ``yes''.
Не рекомендуется отключать проверку версии формата базы данных.
.PP
По умолчанию модуль не посылает никаких сообщений в лог, до тех пор,
пока не наступит какая-нибудь ошибка, если необходимо просмотреть все
сообщения от модуля, то установите параметр \fBquiet\fP в ``no'':
.PP
.nf
	quiet = <boolean>;
.fi
.PP
Значение этого параметра по умолчанию равно ``yes''.
.PP
\fIПример:\fP
.PP
.nf
	st_mod "ipa_st_sdb.so";

	global {
	    /* ... */
	    st_list sdb;
	    sdb:db_dir = "/var/db/ipa_sdb";
	}

	rule 1 {
	    /* ... */
	}

	rule 2 {
	    /* ... */
	    sdb:db_dir = "/home/my/ipa_sdb";
	}
.fi
.PP
Первое правило наследует значения параметров \fBdb_dir\fP из секции
\fBglobal\fP.
Второе правило имеет собственное значение для этого параметра.
Все динамические правила унаследуют значение параметра \fBdb_dir\fP из
секции \fBglobal\fP.
.SH ДРУГИЕ ИСТОЧНИКИ
ipa_sdb(5), ipa_db_sdb(8), ipa_sdb_dump(8)
.SH АВТОР
Andrey\ Simonenko\ <simon@comsys.ntu-kpi.kiev.ua>
.SH НЕДОРАБОТКИ
Если вы обнаружите какие-либо ошибки, то, пожалуйста, сообщите мне по email.