Наряду с файлом
esns.ini, часть настроек сервера новостей
ESNS
содержится в файле
esns.dat, описанию которого и посвящена
эта страница. Файл esns.dat должен находиться в каталоге
Windows - сервер ESNS ищет его только там, и ни в каком другом
месте.
Информация в dat-файле читается сервером ESNS построчно,
каждая строка содержит ту или иную директиву, либо может быть пустой,
либо может содержать комментарии (любая нераспознанная строка автоматически
считается комментарием). Строка с директивой состоит из полей (первое поле
всегда содержит саму команду, а последующие поля - параметры команды),
разделенных знаком двоеточия - ":". Если команда содержит согласно спецификации
N полей, то все поля данной строки, начиная с N+1 сервером ESNS игнорируются
(не читаются), и по этой причине могут содержать комментарии администратора
(эти "лишние" поля никак не мешают ESNS правильно обработать текущую
команду). Для удобочитаемости (человеком) поля могут содержать пробелы -
сервер ESNS их игнорирует.
Команды в dat-файле идут блоками, каждый из которых определяет
некоторую группу новостей. Блок начинается командой GROUP и
завершается следующей командой GROUP или концом файла. Команда
GROUP имеет один параметр - имя группы новостей:
GROUP : my.forum :
создает группу новостей с именем "my.forum".
Группа новостей может иметь описание, которое определяется командой
DESCRIPTION:
DESCRIPTION : Forum of my company :
Время жизни сообщений любой группы может быть ограничено командой
TTL, параметром которой служит время в часах:
TTL : 720 :
Такая команда ограничивает время жизни сообщений текущей
группы сроком 30 дней.
Группа новостей может быть предназначена для ограниченного круга клиентов.
В этом случае, блок должен содержать одну или несколько команд PRIVATE,
в которых вторым параметром идет номер категории клиентов, для которых
должна быть доступна данная группа новостей (номер категории должен быть больше
нуля):
PRIVATE : 1 :
Такой набор команд PRIVATE делает данную группу новостей
доступной для клиентов первой и второй категории. Если блок
не содержит ни одной команды PRIVATE, то такая группа новостей
будет доступна любому клиенту (в том числе и без всякой
авторизации).
Для того, чтобы клиенты ваших новостей смогли определить
наличие на сервере новых групп, блок должен содержать команду
CREATED, в которой второй параметр содержит дату создания
группы в формате YYYYMMDD (четыре цифры года, две цифры месяца
и две цифры числа):
CREATED : 20030201 :
определяет, что данная группа новостей была
создана 1 февраля 2003 года.
Если описания некоторых групп новостей содержат команду
PRIVATE, то должны быть описаны клиенты данного сервера новостей.
Описание клиентов идет вне блоков команд, описывающих группы
новостей, и может находиться в любом месте dat-файла. Для описания
клиента служит команда USER, в которой второе поле содержит логин,
третье - пароль, а четвертое - номер категории данного клиента (номер
категории должен быть больше нуля). Каждый клиент может быть описан
только один раз, таким образом принадлежность одного клиента к
нескольким категориям не допускается. Пример:
USER : alex : c67G8 : 1 :
Эта команда определяет клиента первой категории с логином
"alex" и паролем "c67G8".
Добавленные вами в dat-файл новые группы новостей перечитываются сервером
ESNS автоматически, перезагрузка сервера не требуется. Однако
при этом следует добавлять новые группы только в конец dat-файла,
так чтобы это не нарушало внутреннюю нумерацию групп в активной
копии ESNS. При остановленном сервисе ESNS добавлять новые
группы можно в любое место dat-файла. Нежелательно удалять
группы при активном сервисе ESNS. (Все эти рекомендации относятся
к тому случаю, когда в момент перечитывания нового dat-файла
имеются подключенные к ESNS клиенты; если активных клиентов
в данный момент нет, то на действия администратора не налагается
никаких ограничений.)
PRIVATE : 2 :