HTICK 1.9 - Husky Ticker

HTICK

Этот документ описывает HTICK 1.9, фидошный файлэхо-процессор под OS/2, Windows, BeOS и клоны Unix.

• Overview: Что такое HTICK.
• Installation: Установка. Прочтите это!
• Command Line: ОПЦИИ и КЛЮЧИ командной строки.
• Configuration Reference: Пояснения к конфигурационному файлу.
• Support: Информация о поддержке.
• Keyword Index: Спискок ключевых слов конфигурационного файла.

1 Что такое HTICK

HTICK - это фидошный тоссер файлэх, включающий filefix. В настоящее время проект поддерживается Husky Development Team (см. http://husk.sf.net/team.html).

Фичи HTICK:

1. Тоссинг файлэх.
2. Filefix (на лету, из командной строки, ограничение областей...)
3. Автосоздание на лету.
4. Автоматическая подписка на отсутствующую арию у аплинка.
5. Перевод арий в пассивный (только посылка) и обратно в активный режимы.
6. Повторная посылка файлов из passthrough и не-passthrough файлэх.
7. Группы и уровни для личного и общего доступа к файлэхам.
8. Проверка безопастности tossgroup.
9. Установки линков по умолчанию.
10. Постинг в нетмейловые и эхообласти.
11. Гибкая настройка анонсов в эхообласти или нетмейл. Поддержка масок имен файлэх позволяет легко настроить несколько областей для анонсов из разных групп файлэх.
12. Сохраняя анонсы на диск, вы защищаете себя от их потери из-за аварийного завершения HTICK (недостаточно свободного места на диске, нажато ^Break, отключение питания и т.д.)
13. И многое, многое другое :)

Преимущества HTICK:

1. Открытые исходники (GPL)
2. Множество поддерживаемых платформ и операционных систем
3. Быстрое исправление багов

2 Процедуры установки и замечания разработчиков

Этот раздел содержит информацию, необходимую для успешных установки и использования HTICK.

Предполагается, что вы уже скомпилировали исполняемые файлы. Если нет, смотрите разделы "Скачивание" или "Компилирование исходного кода".

1. Прочитайте документацию на FIDOCONFIG, касающуюся расположения конфигурационных файлов
2. Отредактируйте конфигурационные файлы в соответствии со своими целями
3. Запустите tparser из пакета FIDOCONFIG, чтобы проверить свой конфиг (прочитайте о PublicGroup или AccessGrp, если хотите использовать группы для FileEchoAreas)
4. Это просто, не правда ли? :-)

• Download: Скачивание исходного кода и исполняемых файлов
• Compiling: Как скомпилировать исходный код
• Support: Поддержка, связь с автором, сообщения о багах, поддержка разработки

2.1 Скачивание исходного кода и исполняемых файлов

Главная страница (релизы, исходный код, последние бета-версии) - http://husky.sf.net/htick.html

Прямой линк на исходники 'stable' ветки: http://husky.sf.net/cvs2/stable/

Прямой линк на исходники 'current' (девелоперской) ветки: http://husky.sf.net/cvs2/current/

2.2 Компилирование исходного кода

1. Необходимы пакеты smapi и fidoconf.

2. Поместите пакеты smapi и fidoconf в директорию, где размещены остальные пакеты fido:

/usr/src/packages/

-> smapi/

-> fidoconfig/

-> htick/

3. Скомпилируйте и установите пакеты smapi и fidoconf. Для компилирования динамических исполняемых файлов используйте "Makefile", для статических - makefile.lnx (или тот, который вам нужен).

4. Компиляция и установка HTICK:

$ make

$ make install

2.3 Поддержка

Существует бессчетное количество причин, по которым вы можете захотеть установить контакт с разработчиками.

1. Вы решили постоянно использовать HTICK. В этом случае, пожалуйста, пошлите письмо по адресу, указанному ниже.
2. У вас есть общие вопросы о том, как сконфигурировать или как использовать конкретную фичу HTICK. Другими словами, вам нужна поддержка. В этом случае вам лучше всего разместить свой вопрос в одной из следующих эх:

   FIDOSOFT.HUSKY

   Международная конференция Husky. Предпочтительный язык - английский.
   

   RU.HUSKY

   Это русская эха Husky Project.

   Если у вас есть доступ к Internet, вы, разумеется, можете поместить свой вопрос или сообщение о баге в форму на сайте разработчиков husky: http://sourceforge.net/projects/husky, идите по ссылке "Bugs", если хотите разместить сообщение о баге.

   Если у вас нет доступа ни к этим эхам, ни к Internet, вы, конечно, можете связаться с разработчиками через нетмейл или e-mail по адресам, указанным ниже.

3. Вы хотите сообщить о баге. Существует два типа багов:
   1. Обычные баги. Вы думаете, что конкретная функция HTICK работает не так, как ожидается, например, выводит мусор или странно себя ведет, или что-то подобное. В таком случае, поместите сообщение в эхи, указанные выше, или в bugtrack на сайте или свяжитесь с разработчиками нетмейлом. Пожалуйста, укажите всю информацию, которая необходима для понимания вашей проблемы.
   2. Фатальные баги. Фатальный баг случается, если HTICK падает. В зависимости от вашей операционной системы, симптомами могут быть падение ядра (core dump), SYS 3175, общая ошибка защиты (general protection fault), "повисшая" система, внезапная перезагрузка. Мы считаем падение недопустимым. Какие бы глупые вещи вы не делали, у вас не должно получиться уронить HTICK.

      Если вы опытный пользователь, и у вас упало ядро, вы можете послать разработчикам gdb-репорт. Найдите файл core, который был сгенерирован. Затем запустите $ gdb htick core. HTICK должен быть скомпилирован с информацией для отладки (DEBUG=1 в файле huskymak.cfg). После этого отошлите сообщение по адресу, указанному ниже.

      Если вы используете любую другую версию исполняемых файлов (например, под Windows), вы не получите файл ядра при падении. Запишите как можно больше информации, попытайтесь воспроизвести падение и свяжитесь с авторами по адресам, указанным ниже. Пожалуйста, прикрепите к письму лог-файл с loglevels 1-0A-Za-z (все буквы и цифры).

4. Вы хотите участвовать в разработке HTICK. Если вы программист и самостоятельно исправили ошибку в HTICK, пожалуйста, пришлите мне свои изменения. Лучший путь сделать это - прислать разработчикам файл изменений в формате GNU diff (с параметром -c). Ваша работа будет высоко оценена и отмечена в соответствующем месте. Если вы хотите регулярно работать над HTICK, у нас также есть онлайновый CVS сервер, к которому вы сможете получить доступ.

   Если вы хотите добавить в HTICK новую фичу, пожалуйста, свяжитесь сначала с разработчиками - чтобы не делать лишнюю работу. Мы оценим все ваши усилия. Пожалуйста, примите во внимание, что для написания расширений HTICK вы должны быть знакомы с C. Кроме того, HTICK использует специальный стиль кода, и мы бы хотели, чтобы вы его придерживались.

Итак, вот адреса разработчиков, если вы хотите связаться с нами:

• Fidonet: Max Chernogor @ 2:464/108
• e-mail: mche@ua.fm

• Fidonet: Stas Degteff @ 2:5080/102
• e-mail: stas_degteff@users.sf.net

3 ОПЦИИ и КЛЮЧИ командной строки HTICK 1.9

Чтобы получить спискок опций командной строки, запустите HTICK без параметров.

Синтаксис:

htick [options] <command>

где <command>:

toss

Обработать *.tic и протоссить файлы

scan

ffix

Искать в Netmail области писем к filefix и обработать команды filefix

ffix <FTN address> <filefix command>

Обработать команду filefix command из командной строки

ffix! <FTN address> <filefix command>

Выполнить то же, что 'ffix' и послать письмо с подпиской/отпиской линку, который был подписан/отписан вручную командой filefix вида: htick ffix! 2:464/910 -910.TEST Эта команда отписывает файлэхолинка 2:464/910 от 910.TEST и создает письмо к 2:464/910, содержащее "-910.TEST"

clean

Очистить passthrough директорию (удалить посланные файлы) и удалить старые файлы в файлэхах

announce

Создать анонс о новых файлах, описанный операторами конфига Ann* (см. яЛНРПХРЕ Announce System.)

hatch <file> <area> [replace [<filemask>]] [desc [<desc>] [<ldesc>]]

Хатчить файл в Area, используя Description файла; если указано "replace", заполнить поле Replace в TIC; если <filemask> не указана, поместить в это поле <file>. Параметры desc могут быть:

@BBS

взять описание из files.bbs

@DIZ

взять описание из находящегося в архиве File_Id.Diz

@<file>

взять описание из <file>

@@BBS

взять первую строку из Files.Bbs

@@DIZ

взять первую строку из находящегося в архиве File_Id.Diz

@@<file>

взять первую строку из <file>

send <file> <filearea> <address>

Послать файл из filearea на address

filelist <file> [<dirlist>]

Создать файл-лист, содержащий все файлы в базе

• <file> Имя файла, в который записывать вывод
• <dirlist> Список директорий, которые должны быть включены в файл-лист.

4 Справка по конфигурации HTICK 1.9

HTICK основан на библиотеке FIDOCONFIG, поэтому прочитайте в документации на FIDOCONFIG о расположении конфигурационного файла и идеологии ключевых слов.

• Keywords: Этот раздел описывает ключевые слова
• Common husky keywords: Список ключевых слов, используемых многими программами husky
• Link Keywords: Ключевые слова, которые могут быть использованы для разных линков
• FileArea Definition: Определение файлобластей
• Announce System: Определение анонсов

4.1 Ключевые слова

• FileAreaBaseDir: Базовая директория файлобластей.
• PassFileAreaDir: В эту директорию будут помещены файлы из passthrough файлобластей.
• FileDescPos: Отступ для длинных описаний в FILES.BSS.
• fileLDescString: Префикс для длинных описаний в FILES.BSS.
• FileFixHelp: Файл помощи для FileFix.
• FileArea: Определение файлобласти.
• ExecOnFile: Выполнить команду по приему файла.
• SaveTic: Сохранять файлы с TIC'ами.
• MaxTicLineLength: Установить максимальную длину строки в исходящих TIC'ах.
• BusyFileDir: Куда будут сложены TIC'и для линков с флагом busy.
• ConvertLongNames: Что делать с длинными именами при тоссинге и хатчинге.
• ConvertShortNames: Что делать с короткими именами при тоссинге и хатчинге.
• addDLC: Добавлять счетчики скачиваний в FILES.BBS.
• DLCDigits: Количество цифр в DLC.
• ticOutbound: TIC' хранятся здесь и удаляются после отсылки.
• filefixKillRequests: Удалять запрос к filefix после обработки.
• filefixReportsAttr: Установить флаг kill/sent на ответы filefix.
• BBSarea: Файлобласть без возможности подписки (для `htick filelist`).
• fileDescription: Имя файла, содержащего описания файлов, по умолчанию files.bbs
• fileDescName: Если поле LDESC в TIC-файле не заполнено, использовать для его заполнения файл <name> из архива.
• FileAreaCreatePerms: Установить права на созданную директорию файлобласти.
• FileFixFromName: Имя отправителя в ответах filefix.
• AutoFileCreateFlag: Создавать флаг при автосоздании файлобластей.
• FileFixNames: Список имен, на которые будет откликаться filefix.

4.1.1 FileAreaBaseDir

Синтаксис:

FileAreaBaseDir <directory>

Пример:

FileAreaBaseDir /var/spool/fido/fileareas

Где будут созданы директории всех файлобластей при автосоздании. Подобно MsgBaseDir.

Этот оператор не может повторяться.

4.1.2 PassFileAreaDir

Синтаксис:

PassFileAreaDir <directory>

Пример:

PassFileAreaDir /var/spool/fido/transit

Куда будут сложены файлы из passthrough файлобластей (и TIC'и, если ticOutbound не определен).

Этот оператор не может повторяться.

4.1.3 FileDescPos

Синтаксис:

FileDescPos <number>

Пример:

FileDescPos 13

Количество пробелов в отступе длинных описаний в FILES.BBS. Рекомендуется 13 (8.3+пробел).

Этот оператор не может повторяться.

4.1.4 fileLDescString

Синтаксис:

fileLDescString <string>

Пример:

fileLDescString ">"

Эта строка помещается перед длинным описанием в FILES.BBS (обычно ">" или "+".). Значение по умолчанию: один пробел.

Этот оператор не может повторяться.

4.1.5 FileFixHelp

Синтаксис:

FileFixHelp <string>

Пример:

FileFixHelp /usr/local/fido/filefix.hlp

Файл помощи для FileFix, подобно AreaFixHelp для AreaFix'а HPT.

Этот оператор не может повторяться.

4.1.6 ExecOnFile

Синтаксис:

ExecOnFile <filearea> <filemask> <command>

Пример:

ExecOnFile husky *.diff /usr/local/fido/update_source.sh

Выполнить некоторую команду по приему файла. Команда получает как параметр полный путь к файлу (пробел и имя файла должны быть добавлены к командной строке до выполнения).

Этот оператор может повторяться.

4.1.7 SaveTic

Синтаксис:

SaveTic <FileEchoMask> <FileOption> <DirToSaveTic> <DaysToKeepTics>

Пример:

SaveTic husky -l /usr/local/husky

<DirToSaveTic>

куда складывать TIC'и для файлобласти(ей) <FileEchoMask>

<FileOption>

сохранять файлы с TIC'ами. Может быть:

empty

файлы не будут скопированы

-l

линк на файлы из директории файлобласти в <DirToSaveTic>

-c

копировать файлы из директории файлобласти в <DirToSaveTic>

<DaysToKeepTics>

параметр <DaysToKeepTics> является опциональным. Если он определен, TIC'и, сохраненные в <DirToSaveTic>, будут храниться там в течение <DaysToKeepTics> дней.

Этот оператор может повторяться.

4.1.8 MaxTicLineLength

Синтаксис:

MaxTicLineLength <number>

Пример:

MaxTicLineLength 79

Установить максимальную длину строки в исходящих TIC'ах в значение <number>.

Этот оператор не может повторяться.

4.1.9 BusyFileDir

Синтаксис:

BusyFileDir <directory>

Пример:

BusyFileDir /var/spool/fido/htick.busy/

Куда будут складываться TIC'и для линков с флагом busy (по умолчанию <outbound>/busy.htk).

Этот оператор не может повторяться.

4.1.10 ConvertLongNames

Синтаксис:

ConvertLongNames <Upper|Lower|DontTouch>

Пример:

ConvertLongNames DontTouch

Что делать с длинными именами при тоссинге и хатчинге. Под "длинным" мы имеем в виду имя со смешанным регистром или имя длиннее 8.3

Этот оператор не может повторяться.

4.1.11 ConvertShortNames

Синтаксис:

ConvertShortNames <Upper|Lower|DontTouch>

Пример:

ConvertShortNames DontTouch

Что делать с короткими именами при тоссинге и хатчинге. Под "коротким" мы имеем в виду имя DOS-типа: 8.3, одного регистра.

Этот оператор не может повторяться.

4.1.12 addDLC

Синтаксис:

addDLC <bool>

Пример:

addDLC yes

Добавлять счетчики скачиваний ([000]) в files.bbs. Используйте только с DLCDigits!

Этот оператор не может повторяться.

4.1.13 DLCDigits

Синтаксис:

DLCDigits <number>

Пример:

DLCDigits 4

Установить количество цифр в DLC. DLC имеет вид [000].

Этот оператор не может повторяться.

4.1.14 ticOutbound

Синтаксис:

ticOutbound <directory>

Пример:

ticOutbound /var/spool/fido/ticOub

TIC'и хранятся здесь и удаляются после отправки. По умолчанию: использовать значение PassFileAreaDir.

Этот оператор не может повторяться.

4.1.15 filefixKillRequests

Синтаксис:

filefixKillRequests <bool>

Пример:

filefixKillRequests yes

Удалять запросы к filefix после обработки.

Этот оператор не может повторяться.

4.1.16 filefixReportsAttr

Синтаксис:

filefixReportsAttr <attr>

Пример:

filefixReportsAttr pvt k/s loc

или

filefixReportsAttr pvt,k/s,loc

Установить флаги на ответы filefix.

Допустимые флаги:

pvt

crash

read

sent

att

fwd

orphan

k/s

loc

fwd

xx2

frq

rrq

cpt

arq

urq

kfs

tfs

dir

imm

cfm

npd

По умолчанию "pvt loc k/s npd".

Этот оператор не может повторяться.

4.1.17 BBSarea

Синтаксис:

BBSarea <name> <bbsareapath>

Пример:

bbsarea bbs /var/spool/fido/bbsareas/bbs

Файлобласть без возможности подписки, не показывается в ответах filefix. Используется только для генерации файл-листа (команда `htick filelist`).

Этот оператор не может повторяться.

4.1.18 fileDescription

Синтаксис:

fileDescription <name>

Пример:

fileDescription descript.ion

Имя файла, содержащего описания файлов, по умолчанию files.bbs

Этот оператор может повторяться.

4.1.19 fileDescName

Синтаксис:

fileDescName <name>

Пример:

fileDescName file_id.diz

Если поле LDESC в TIC-файле не заполнено, использовать для его заполнения файл <name> из архива (обычно file_id.diz).

Этот оператор может повторяться.

4.1.20 Замечание

Параметр unpack должен быть определен для архива и содержать $f ($f заменяется на имя файла в процессе распаковки).

Примеры:

     Unpack  "/path/to/unrar e -y -c- -o+ -inul $a $p $f"   0 52617221 # *.rar
     Unpack  "d:\path\unrar  e -y -c- -o+ -inul $a $p $f"  28 52534658 # rar-sfx/DOS
     Unpack "\path\pkzipc -ext -dir=none -over=all -nozip -silent $a $p $f" 0 504b0304
     Unpack "unzip -joLqq $a -d $p" 0 504b0304
     Unpack "pkunzip -njCL $a -d $p $f" 0 504b0304
     Unpack "pkzip25 -ext -silent -over=all -nofix -nozip $a $p $f" 0

4.1.21 FileAreaCreatePerms

Синтаксис:

FileAreaCreatePerms <mode>

Пример:

FileAreaCreatePerms 644

Определить права на созданные директории файлобластей (только для UNIX).

Этот оператор не может повторяться.

4.1.22 FileFixFromName

Синтаксис:

FileFixFromName <string>

Пример:

FileFixFromName FileFix

Имя отправителя в ответах filefix.

Этот оператор не может повторяться.

4.1.23 AutoFileCreateFlag

Синтаксис:

AutoFileCreateFlag <file>

Пример:

AutoFileCreateFlag /usr/local/fido/flags/new_filearea

Создавать флаг при автосоздании файобластей.

Этот оператор не может повторяться.

4.1.24 FileFixNames

Синтаксис:

FileFixNames <string>

Пример:

FileFixNames allfix filefix htick

Список имен, разделенных пробелами, на которые будет откликаться filefix.

Этот оператор не может повторяться.

4.2 Ключевые слова линков

• fileEchoFlavour: Этот оператор устанавливает флавор, который получают исходящие на этого линка файлы из файлэх.
• fileAreaDefaults: Установить умолчания для последующих определений файлобластей.
• RemoteFileRobotName: Имя удаленного робота filefix (нужно для FileForwardRequest).
• FileFix: Доступ к filefix для этого линка.
• FileFixEchoLimit: Лимит подписки на файлэхи.
• noTIC: Отключить создание файлов TIC.
• autoFileCreate: Разрешить или запретить автосоздание файлэх, полученных от этого линка.
• AutoFileCreateFile: Указывает файл, в который будет помещено описание новой файлобласти.
• AutoFileCreateDefaults: Определяет умолчания новой файлобласти.
• AutoFileCreateSubdirs: Автосоздавать арии как /fils/gfd.app.edit (off) или как /files/gfd/app/edit (on).
• delNotReceivedTIC: Если файл не получен, удалять TIC.
• FileFixFSC87Subset: Этот булевый переключатель определяет, как будут обрабатываться TIC'и.
• TickerPackToBox: Если для линка определен файлбокс - тоссить файлы и TIC'и в нем.
• LinkFileBaseDir: Куда будут помещены автосозданные файлобласти.
• ForwardFileRequests: Разрешить форвард на линка запросов подписки на файлобласти.
• ForwardFilePriority: Приоритет аплинка при форвард-реквестах подписок на файлобласти.
• ForwardFileRequestFile: Список доступных у этого линка файлобластей.

4.2.1 fileEchoFlavour

Синтаксис:

fileEchoFlavour <hold|normal|crash|direct|immediate>

Пример:

fileEchoFlavour direct

Этот оператор устанавливает флавор, который получают исходящие на этого линка файлы из файлэх. Например, установите fileEchoFlavour в hold для пойнтов и в crash для аплинков.

Этот оператор может повторяться только для разных линков.

4.2.2 fileAreaDefaults

Синтаксис:

fileAreaDefaults <options> [links]

Пример:

fileAreaDefaults -lw 100 -g Z 2:5097/31.1

Установить умолчания для последующих определений файлобластей. Допустимы любые опции, кроме ареатага и пути. Установки в определении файлобласти приоритетнее, чем fileAreaDefaults. Также см. яЛНРПХРЕ echoAreaDefaults. Умолчания выключаются с помощью пустого fileAreaDefaults.

Этот оператор может повторяться только для разных линков.

4.2.3 RemoteFileRobotName

Синтаксис:

RemoteFileRobotName <name>

Пример:

RemoteFileRobotName allfix

Имя удаленного робота filefix (нужно для FileForwardRequest).

Этот оператор может повторяться только для разных линков.

4.2.4 noTIC

Синтаксис:

noTIC <bool>

Пример:

noTIC yes

Отключить создание файлов TIC.

Этот оператор может повторяться только для разных линков.

4.2.5 autoFileCreate

Синтаксис:

autoFileCreate <on|off>

Пример:

autoFileCreate on

Разрешить или запретить автосоздание файлэх, полученных от этого линка.

Этот оператор может повторяться только для разных линков.

4.2.6 AutoFileCreateFile

Синтаксис:

AutoFileCreateFile <file>

Пример:

AutoFileCreateFile /usr/local/fido/hpt/config.filefix

Указывает файл, в который будет помещено описание новой файлобласти.

Этот оператор может повторяться только для разных линков.

4.2.7 AutoFileCreateDefaults

Синтаксис:

AutoFileCreateDefaults <string>

Пример:

AutoFileCreateDefaults -lw 100 -g Z

Определяет умолчания новой файлобласти при автокриейте. Не стоит использовать здесь указания каких-либо путей или passthrough - для этого существует отдельный токен - LinkFileBaseDir. яЛНРПХРЕ LinkFileBaseDir.

Этот оператор может повторяться только для разных линков.

4.2.8 AutoFileCreateSubdirs

Синтаксис:

AutoFileCreateSubdirs <on|off>

Пример:

AutoFileCreateSubdirs on

Автосоздавать арии как /filebase/gfd.app.edit (off) или как /filebase/gfd/app/edit (on). Если вы хотите установить эту опцию глобально, а не для каждого линка по отдельности, установите ее в секции deflink. Также см. 'AutoAreaCreateSubdirs' в документации на hpt.

Этот оператор может повторяться только для разных линков.

4.2.9 delNotReceivedTIC

Синтаксис:

delNotReceivedTIC <on|off>

Пример:

delNotReceivedTIC on

Удалять TIC, если файл не был принят.

Этот оператор может повторяться только для разных линков.

4.2.10 FileFixFSC87Subset

Синтаксис:

FileFixFSC87Subset <on|off>

Пример:

FileFixFSC87Subset on

Этот булевый переключатель определяет, как будут обрабатываться файлы TIC для каждого линка. Значение по умолчанию ON. В процессе обработки файлов TIC htick будет реагировать только на совместимые с FSC87 ключевые слова и игнорировать неизвестные. Если переключатель установлен в OFF, будут использованы все поддерживаемые ключевые слова, что может привести (а при работе с некоторыми файл-процессорами, ПРИВЕДЕТ) к серьезным проблемам. Неизвестные ключевые слова, найденные в TIC, вынудят htick прекратить обработку этого файла. Если вы не представляете, что все это значит, установите FileFixFSC87Subset в ON для всех линков. Это не повредит.

Этот оператор может повторяться только для разных линков.

4.2.11 TickerPackToBox

Синтаксис:

TickerPackToBox <on|off>

Пример:

TickerPackToBox on

Если для линка определен файлбокс - тоссить файлы и TIC'и в нем.

Этот оператор может повторяться только для разных линков.

4.2.12 LinkFileBaseDir

Синтаксис:

LinkFileBaseDir <directory>

Пример:

LinkFileBaseDir /usr/local/fido/fileareas/2.5097.64.0

Куда будут помещены автосозданные файлобласти (может быть "passthrough").

Этот оператор может повторяться только для разных линков.

4.2.13 ForwardFileRequests

Синтаксис:

ForwardFileRequests <on|off>

Пример:

ForwardFileRequests on

Разрешить форвард-реквесты файлобластей на этого линка.

Этот оператор может повторяться только для разных линков.

4.2.14 ForwardFilePriority

Синтаксис:

ForwardFilePriority <number>

Пример:

ForwardFilePriority 1

Приоритет аплинка при форвард-реквестах подписок на файлобласти.

Этот оператор может повторяться только для разных линков.

4.2.15 ForwardFileRequestFile

Синтаксис:

ForwardFileRequestFile <file>

Пример:

ForwardFileRequestFile /usr/local/fido/hpt/uplink1.lst

Список доступных у этого линка файлобластей.

Этот оператор может повторяться только для разных линков.

4.2.16 FileFix

Синтаксис:

filefix <bool>

Пример:

filefix off

По умолчанию filefix включен (on). Вы можете отключить использование этим линком filefix'а.

Этот оператор может повторяться только для разных линков.

4.2.17 FileFixEchoLimit

Синтаксис:

FileFixEchoLimit <number>

Пример:

FileFixEchoLimit 10

Лимит подписки на области (максимальное количество файлобластей, на которое этот линк может подписаться).

Этот оператор может повторяться только для разных линков.

4.3 Определение файлобласти.

• FileArea: Определение файлобласти.

4.3.1 FileArea

Синтаксис:

FileArea <name> <fileareapath> [options] <uplink> <downlinks>

Пример:

FileArea husky /var/spool/fido/fileareas/husky -a 2:5097/31 -p 28 -g Z -d "HUSKY fileecho" 2:5097/64 2:5097/303

Подобно EchoArea, доступно большинство опций:

-a <address>

Наш адрес в этой области.

-d "<string>"

Описание этой области.

-g <group>

Группа этой области.

-hide

Спрятать область (не показывать по %LIST и в анонсах).

-nohide

Показывать область по %LIST и в анонсах, если fileareadefaults установлено в -hide.

-lr <number>

"Уровень для чтения": минимальный уровень линка, необходимый для того, чтобы посылать ему файлы из этой области. Должен быть неотрицательным.

-lw <number>

"Уровень для записи": минимальный уровень линка, необходимый для того, чтобы постить в область файлы, полученные от него. Должен быть неотрицательным.

-mandatory

Запретить удаленную отписку (отключить соответствующую команду filefix).

-nomandatory

Разрешить удаленную отписку (включить соответствующую команду filefix), если fileareadefaults установлено в -mandatory.

-manual

Запретить удаленную подписку (отключить соответствующую команду filefix).

-nomanual

Разрешить удаленную подписку (включить соответствующую команду filefix), если fileareadefaults установлено в -manual.

-noCRC

Отключить проверку CRC входящих файлов.

-CRC

Включить проверку CRC входящих файлов, если fileareadefaults установлено в -noCRC.

-nodiz

Не пытаться получить описание файла из <fileDescName> (для архивных файлов).

-diz

Попытаться получить описание файла из <fileDescName> (для архивных файлов), если fileareadefaults установлено в -nodiz.

-pause

Эффект %PAUSE для этой области.

-nopause

Отключить эффект %PAUSE для этой области, если fileareadefaults установлено в -pause.

-noreplace

Не заменять существующие в этой области файлы.

-replace

Заменять существующие в этой области файлы, если fileareadefaults установлено в -noreplace.

-p <integer>

Пуржить каждые n дней. Установка в 0 (значение по умолчанию) отключает пуржинг.

-sendorig

Посылать файлы из PassFileAreaDir для не-passthrough областей.

-nosendorig

Посылать файлы из директории файлобласти для не-passthrough областей, если fileareadefaults установлено в -sendorig.

4.4 Система анонсов

htick имеет гибкую систему анонсов, которые могут различаться для разных файлобластей. Токен AnnAreaTag начинает новую секцию определения анонса, другие токены определяют списки файлобластей, включенных в анонс, и описывают формат анонса.

Запустите htick announce, чтобы постить анонсы.

Вы можете отключить анонсы - просто удалите AnnounceSpool из своего конфига.

• AnnounceSpool: Директория для накапливания информации для анонсов.
• AnnAreaTag: Имя области или файла, куда будет помещен анонс.
• AnnInclude: Массив масок файлэх, которые будут анонсированы в этом annAreaTag.
• AnnExclude: Массив масок файлэх, которые не будут анонсированы в этом annAreaTag.
• AnnTo: Имя получателя в письме с анонсом.
• AnnFrom: Имя отправителя в письме с анонсом.
• AnnSubj: Тема в письме с анонсом.
• AnnAddrTo: Адрес получателя в письме с анонсом (используйте только для нетмейловых областей).
• AnnAddrFrom: Адрес отправителя в письме с анонсом.
• AnnOrigin: Origin в письме с анонсом.
• AnnMessFlags: Атрибуты письма с анонсом (k/s loc hld ...).
• AnnFileRFrom: Указывать в анонсе: адрес системы, от которой был получен файл.
• AnnFileOrigin: Указывать в анонсе: адрес системы, которая захатчила файл.
• Announcements example: Пример для понимания анонсов (из действующего конфига).

4.4.1 AnnounceSpool

Синтаксис:

AnnounceSpool <path>

Пример:

AnnounceSpool /var/spool/fido/announce

Директория для накапливания информации для анонсов.

Этот оператор не может повторяться.

4.4.2 AnnAreaTag

Синтаксис:

AnnAreaTag <AREATAG|@filename>

Пример:

AnnAreaTag local.announce

Начинает новую секцию определения анонса. <AREATAG> - имя области, в которую будет помещен анонс; <@filename> - имя файла с префиксом '@', в который будет помещен анонс.

Этот оператор может повторяться.

4.4.3 AnnInclude

Синтаксис:

AnnInclude <fileecho mask list>

Пример:

AnnInclude *

Массив имен|масок файлобластей, которые будут анонсированы в этом annAreaTag. По умолчанию: все файлобласти.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.4 AnnExclude

Синтаксис:

AnnExclude <fileecho mask list>

Пример:

AnnExclude aftnged

Массив имен|масок файлобластей, которые не будут анонсированы в этом annAreaTag.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.5 AnnTo

Синтаксис:

AnnTo <string>

Пример:

AnnTo All

Имя получателя в письме с анонсом.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.6 AnnFrom

Синтаксис:

AnnFrom <string>

Пример:

AnnFrom Announce Robot

Имя отправителя в письме с анонсом.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.7 AnnSubj

Синтаксис:

AnnSubj <string>

Пример:

AnnSubj New files arrived

Тема в письме с анонсом.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.8 AnnAddrTo

Синтаксис:

AnnAddrTo <address>

Пример:

AnnAddrTo 2:5097/31.1

Адрес получателя в письме с анонсом (используйте для нетмейловых областей).

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.9 AnnAddrFrom

Синтаксис:

AnnAddrFrom <address>

Пример:

AnnAddrFrom 2:5097/31

Адрес отправителя в письме с анонсом.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.10 AnnOrigin

Синтаксис:

AnnOrigin <string>

Пример:

AnnOrigin New files!

Origin в письме с анонсом.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.11 AnnMessFlags

Синтаксис:

AnnMessFlags <string>

Пример:

AnnMessFlags loc hld

Флаги письма с анонсом (k/s loc hld ...).

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.12 AnnFileRFrom

Синтаксис:

AnnFileRFrom <on|off>

Пример:

AnnFileRFrom on

Указывать в анонсе: адрес системы, от которой был получен файл.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.13 AnnFileOrigin

Синтаксис:

AnnFileOrigin <on|off>

Пример:

AnnFileOrigin on

Указывать в анонсе: адрес системы, которая захатчила файл.

Этот оператор может повторяться только для разных AnnAreaTag.

4.4.14 Пример анонсов

Следующий текст взят из действующего конфигурационного файла.

     #= Определения анонсов =====================================
     AnnounceSpool   E:\FIDO\EXCH\report
     
     # сообщать обо всех пришедших файлах в файл e:\fido\rep.txt
     AnnAreaTag      @e:\fido\rep.txt
     AnnFileOrigin   on
     
     # сообщать в область 'seumbieky.news' о файлах, захатченных
     # в группу файлэх 'union.*'
     AnnAreaTag      seumbieky.news
     AnnInclude      union.*
     AnnSubj         New mp3's arrives
     AnnTo           United mp3 fans
     AnnFrom         Fullfeed Distribution Site
     AnnOrigin       *** seumbieky forever ***
     AnnFileOrigin   on
     AnnFileRfrom    on
     
     # сообщать о файлах в группе файлэх 'uue.*' в область
     # 'seumbieky.news'
     AnnAreaTag      seumbieky.news
     AnnInclude      uue.*
     
     # сообщать в область 'seumbieky.news' о файлах во всех
     # группах, кроме 'uue.*' и 'union.*'
     AnnAreaTag      seumbieky.news
     AnnExclude      uue.* union.*
     
     # сообщать нетмейлом на заданный адрес
     AnnAreaTag      netmail
     AnnInclude      union.*
     AnnSubj         New mp3's arrives
     AnnTo           Max Inda Houze
     Annaddrto       2:464/108
     AnnFrom         Fullfeed Distribution Site
     Annaddrfrom     2:464/910.108
     AnnOrigin       *** seumbieky forever ***
     AnnMessFlags    k/s loc hld
     AnnFileOrigin   on
     AnnFileRfrom    on
     #= Конец определений анонсов ===============================

4.4.15 Общие ключевые слова husky

Список ключевых слов, используемых многими программами husky. Подробнее см. в документации на fidoconfig.

BBSArea

LogLevels

...

Appendix A Список ключевых слов конфигурационного файла

• addDLC: addDLC
• AnnAddrFrom: AnnAddrFrom
• AnnAddrTo: AnnAddrTo
• AnnAreaTag: AnnAreaTag
• AnnExclude: AnnExclude
• AnnFileOrigin: AnnFileOrigin
• AnnFileRFrom: AnnFileRFrom
• AnnFrom: AnnFrom
• AnnInclude: AnnInclude
• AnnMessFlags: AnnMessFlags
• AnnOrigin: AnnOrigin
• AnnounceSpool: AnnounceSpool
• AnnSubj: AnnSubj
• AnnTo: AnnTo
• autoFileCreate: autoFileCreate
• AutoFileCreateDefaults: AutoFileCreateDefaults
• AutoFileCreateFile: AutoFileCreateFile
• AutoFileCreateFlag: AutoFileCreateFlag
• AutoFileCreateSubdirs: AutoFileCreateSubdirs
• BBSarea: BBSarea
• BusyFileDir: BusyFileDir
• ConvertLongNames: ConvertLongNames
• ConvertShortNames: ConvertShortNames
• delNotReceivedTIC: delNotReceivedTIC
• DLCDigits: DLCDigits
• ExecOnFile: ExecOnFile
• FileArea: FileArea
• FileAreaBaseDir: FileAreaBaseDir
• FileAreaCreatePerms: FileAreaCreatePerms
• fileAreaDefaults: fileAreaDefaults
• fileDescName: fileDescName
• FileDescPos: FileDescPos
• fileDescription: fileDescription
• fileEchoFlavour: fileEchoFlavour
• FileFixEcho: FileFix
• FileFixEchoLimit: FileFixEchoLimit
• FileFixFromName: FileFixFromName
• FileFixFSC87Subset: FileFixFSC87Subset
• FileFixHelp: FileFixHelp
• filefixKillRequests: filefixKillRequests
• FileFixNames: FileFixNames
• filefixReportsAttr: filefixReportsAttr
• fileLDescString: fileLDescString
• ForwardFilePriority: ForwardFilePriority
• ForwardFileRequestFile: ForwardFileRequestFile
• ForwardFileRequests: ForwardFileRequests
• LinkFileBaseDir: LinkFileBaseDir
• MaxTicLineLength: MaxTicLineLength
• noTIC: noTIC
• PassFileAreaDir: PassFileAreaDir
• RemoteFileRobotName: RemoteFileRobotName
• SaveTic: SaveTic
• TickerPackToBox: TickerPackToBox
• ticOutbound: ticOutbound
• Общие ключевые слова husky: Common husky keywords
• Пример анонсов: Announcements example