You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
bforce/INSTALL.ru

189 lines
6.3 KiB
Ruby

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

В этом файле описывается процесс установки и настройки
фидонет-совместимого мейлера bforce 0.xx.
В данном документе приняты следующие обозначения:
<SRCDIR> - путь, куда вы распаковали тарболл с исходными
текстами bforce 0.xx (далее bforce)
Тарболл - файл с расширением tar.gz, или tar.bz2
Требования к системе
====================
Для компиляции bforce вам потребуется компилятор (для
gnu/bsd-систем gcc), так же GNU make (make для линукс,
gmake для bsd).
Обратитесь к документации по вашей системе того, что бы
узнать как установить вышеперечисленное программное обеспечение.
Процесс компиляции
==================
Распакуйте тарболл следующими командами:
gzip -d bforce-master.tar.gz
или
bzip2 -d bforce-master.tar.bz2
tar -xvf bforce-master.tar
Перейдите в директорию bforce/source:
cd <SRCDIR>/bforce/source
Для создания Makefile, который наиболее подходит к вашей
системе, наберите:
./configure --help
и внимательно прочитайте предлагаемую справку.
Если вам не понятна предлагаемая справка, то просто запустите:
./configure
## WARNING! Внимание!
## Новые версии bforce собираются с поддержкой syslog по умолчанию.
## Если вы не знаете что это/зачем вам это нужно - тогда делайте
## ./configure --disable-syslog
При необходимости исправьте Makefile для ваших нужд.
Запустите команду make (для bsd - gmake):
make
В случае ошибок при выполнении команды make пишите bugreport на
e.kozhuhovskiy@gmail.com или в эхоконференцию ru.unix.ftn
Возможно, прийдется пересоздать configure с помощью autoconf
Поздравляем, компиляция завершилась успешно.
Для установки bforce наберите:
make install
Для bsd:
gmake install
Внимание! Возможно, вам будет необходимо выполнить make installdirs для того,
что бы создать необходимые директории. Для установки дополнительных
скриптов, выполните make install-contrib
Настройка
=========
Рекомендуется установить системную переменную BFCONFIG,
указывающую на местоположение конфигурации bforce.
Проще всего через /etc/environment для общесистемной или
.profile для переменной пользователя.
Для нормальной работы вам нужно отредактировать конфигурационные файлы
bforce. По умолчанию они находятся в /usr/local/fido/etc и называются
bforce.conf - основной конфигурационный файл bforce
bforce.passwd - файл определения паролей на сессии
bforce.subst - файл переопределения данных из nodelist
freq.dirs - файл задания списка директорий для freq-запросов
freq.aliases - файл задания magic freqests
Так же вам необходимо подправить файл outman. По умолчанию он лежит в
/usr/local/fido/bin. outman - это скрипт, вызываемый вами для создания
прозвонок, файловых запросов и файл-аттачей на узлы ftn.
Использование
=============
bforce - основной файл bforce, служит для запуска
демона, исходящих звонков и запуска из-под mgetty\portslave для приема
входящих звонков.
Попробуйте bforce --help
bfindex - служит для обновления индексных файлов (перекомпиляции)
нодлистов. Испрользование: bfindex
bfstat - служит для показа почтовой очереди. Использование: bfstat
nlookup - служит для поиска информации в нодлисте. Использование:
nlookup <ftn_address>
outman - см. "Настройка". Попробуйте outman --help
В папке debian лежат man-страницы.
TODO: дописать Makefile для установки man-pages
Совместная работа с mgetty
==========================
Для того, что бы узел мог отвечать на входящие звонки, необходимо установить
соотв. програмное обеспечение. Наиболее распространенная программа - mgetty.
Для того, что бы она могла работать на ftn-узле, необходимо собрать ее с опцией
-DFIDO. В случае дистрибутивной сборки это можно проверить с помощью
cat `which mgetty` |strings |grep FIDO |wc -l
Если вы получите число, отличное от нуля, то вам повезло :)
В login.config допишите следующую конструкцию:
/FIDO/ news fido /usr/bin/bforce @
где news - это пользователь, из-под которого у вас работает ftn-подсистема.
Bforce при ИСХОДЯЩИХ звонках использует файлы блокировки порта модема,
при несовпадении каталога или невозможности создания файла
mgetty сбросит модем во время звонка.
Поэтому настоятельно рекомендуется проверить права на папку /var/lock
и то, на какой ФС она расположенв.
Современные системы имеют тенденцию к применению /var/lock как ссылки
на /run/lock, а ФС /run монтируется и создается на tmpfs при каждой
загрузке с помощью systemd-tempfiles.
Для изменения поведения необходимо создать файл в /etc/tempfiles.d/,
совпадающим (за исключением части имени -part) c именем файла в
/usr/lib/systemd/systemd-tempfiles.d.
Рабочий пример legacy-part.conf в папке contrib.
Совместная работа с inetd/xinetd
================================
К сожалению (или к счастью), bforce не умеет самостоятельно принимать входящие
binkd/ifc вызовы. Для этого вам прийдется использовать суперсервер интернета -
inetd или xinetd.
Вот примеры для inetd:
binkp stream tcp nowait news /usr/bin/bforce bforce -i binkp
ifc stream tcp nowait news /usr/bin/bforce bforce -i auto
Проверьте, что бы у вас были соотв. строки в /etc/services, например:
binkp 24554/tcp # binkp fidonet protocol
ifc 60179/tcp # fidonet EMSI over TCP
Дополнительные утилиты
======================
Дополнительные утилиты для bforce находятся в <SRCDIR>/contrib:
bflan - bforce log analyzer
callout.sh - скрипт для отзвонки на аплинков
outman - скрипт outman
timesync.tcl - скрипт для синхорнизации времени с узлами ftn.
init.d/bforce - init-скрипт для RedHat
bfha - bforce history analyzer (bfha)
bfha/README - bfha README
bfha/bfha.pl - собственно, bfha
legacy-part.conf - файл для донастройки прав на /run/lock в systemd
u-srif - продвинутый freq-процессор
u-srif/u-srif-index.py \ с поддержой отчетов,
u-srif/u-srif-lookup.py \ ограничений,
u-srif/u-srif.py \ индексации файловой базы,
u-srif/conf \ что значительно ускоряет
u-srif/conf/report.footer \ работу.
u-srif/conf/report.header \ Написан на python.
u-srif/conf/u-srif.aliases \ --------------------
u-srif/conf/u-srif.conf \ -------------------
u-srif/conf/u-srif.dirs \ ------------------
u-srif/lib / ------------------
u-srif/lib/uconfig.py / -------------------
u-srif/lib/udbase.py / --------------------
u-srif/lib/ufido.py / ---------------------
u-srif/lib/unodestat.py / ----------------------
u-srif/lib/utmpl.py / -----------------------
u-srif/lib/uutil.py / ------------------------