Этот документ описывает HTICK 1.9, фидошный файлэхо-процессор под OS/2, Windows, BeOS и клоны Unix.
HTICK - это фидошный тоссер файлэх, включающий filefix. В настоящее время проект поддерживается Husky Development Team (см. http://husk.sf.net/team.html).
Фичи HTICK:
Преимущества HTICK:
Этот раздел содержит информацию, необходимую для успешных установки и использования HTICK.
Предполагается, что вы уже скомпилировали исполняемые файлы. Если нет, смотрите разделы "Скачивание" или "Компилирование исходного кода".
tparser из пакета FIDOCONFIG, чтобы проверить свой конфиг
(прочитайте о PublicGroup или AccessGrp, если хотите использовать
группы для FileEchoAreas)
1. Необходимы пакеты smapi и fidoconf.
2. Поместите пакеты smapi и fidoconf в директорию, где размещены остальные пакеты fido:
3. Скомпилируйте и установите пакеты smapi и fidoconf. Для компилирования динамических исполняемых файлов используйте "Makefile", для статических - makefile.lnx (или тот, который вам нужен).
4. Компиляция и установка HTICK:
Существует бессчетное количество причин, по которым вы можете захотеть установить контакт с разработчиками.
FIDOSOFT.HUSKYRU.HUSKYЕсли у вас есть доступ к Internet, вы, разумеется, можете поместить свой вопрос или сообщение о баге в форму на сайте разработчиков husky: http://sourceforge.net/projects/husky, идите по ссылке "Bugs", если хотите разместить сообщение о баге.
Если у вас нет доступа ни к этим эхам, ни к Internet, вы, конечно, можете связаться с разработчиками через нетмейл или e-mail по адресам, указанным ниже.
Если вы опытный пользователь, и у вас упало ядро, вы можете послать разработчикам gdb-репорт. Найдите файл core, который был сгенерирован. Затем запустите $ gdb htick core. HTICK должен быть скомпилирован с информацией для отладки (DEBUG=1 в файле huskymak.cfg). После этого отошлите сообщение по адресу, указанному ниже.
Если вы используете любую другую версию исполняемых файлов (например, под
Windows), вы не получите файл ядра при падении. Запишите как можно больше
информации, попытайтесь воспроизвести падение и свяжитесь с авторами по адресам,
указанным ниже. Пожалуйста, прикрепите к письму лог-файл с
loglevels 1-0A-Za-z (все буквы и цифры).
Если вы хотите добавить в HTICK новую фичу, пожалуйста, свяжитесь сначала с разработчиками - чтобы не делать лишнюю работу. Мы оценим все ваши усилия. Пожалуйста, примите во внимание, что для написания расширений HTICK вы должны быть знакомы с C. Кроме того, HTICK использует специальный стиль кода, и мы бы хотели, чтобы вы его придерживались.
Итак, вот адреса разработчиков, если вы хотите связаться с нами:
Чтобы получить спискок опций командной строки, запустите HTICK без параметров.
<command>:command из командной строки
@BBS@DIZ@<file>@@BBS@@DIZ@@<file><file>
Имя файла, в который записывать вывод
<dirlist>
Список директорий, которые должны быть включены в файл-лист.
HTICK основан на библиотеке FIDOCONFIG, поэтому прочитайте в документации на FIDOCONFIG о расположении конфигурационного файла и идеологии ключевых слов.
FileAreaBaseDir <directory>
FileAreaBaseDir /var/spool/fido/fileareas
Где будут созданы директории всех файлобластей при автосоздании. Подобно MsgBaseDir.
Этот оператор не может повторяться.
PassFileAreaDir <directory>
PassFileAreaDir /var/spool/fido/transit
Куда будут сложены файлы из passthrough файлобластей (и TIC'и, если ticOutbound не определен).
Этот оператор не может повторяться.
FileDescPos <number>
FileDescPos 13
Количество пробелов в отступе длинных описаний в FILES.BBS. Рекомендуется 13 (8.3+пробел).
Этот оператор не может повторяться.
fileLDescString <string>
fileLDescString ">"
Эта строка помещается перед длинным описанием в FILES.BBS (обычно ">" или "+".). Значение по умолчанию: один пробел.
Этот оператор не может повторяться.
FileFixHelp <string>
FileFixHelp /usr/local/fido/filefix.hlp
Файл помощи для FileFix, подобно AreaFixHelp для AreaFix'а HPT.
Этот оператор не может повторяться.
ExecOnFile <filearea> <filemask> <command>
ExecOnFile husky *.diff /usr/local/fido/update_source.sh
Выполнить некоторую команду по приему файла. Команда получает как параметр полный путь к файлу (пробел и имя файла должны быть добавлены к командной строке до выполнения).
Этот оператор может повторяться.
SaveTic <FileEchoMask> <FileOption> <DirToSaveTic> <DaysToKeepTics>
SaveTic husky -l /usr/local/husky
Этот оператор может повторяться.
MaxTicLineLength <number>
MaxTicLineLength 79
Установить максимальную длину строки в исходящих TIC'ах в значение <number>.
Этот оператор не может повторяться.
BusyFileDir <directory>
BusyFileDir /var/spool/fido/htick.busy/
Куда будут складываться TIC'и для линков с флагом busy (по умолчанию <outbound>/busy.htk).
Этот оператор не может повторяться.
ConvertLongNames <Upper|Lower|DontTouch>
ConvertLongNames DontTouch
Что делать с длинными именами при тоссинге и хатчинге. Под "длинным" мы имеем в виду имя со смешанным регистром или имя длиннее 8.3
Этот оператор не может повторяться.
ConvertShortNames <Upper|Lower|DontTouch>
ConvertShortNames DontTouch
Что делать с короткими именами при тоссинге и хатчинге. Под "коротким" мы имеем в виду имя DOS-типа: 8.3, одного регистра.
Этот оператор не может повторяться.
addDLC <bool>
addDLC yes
Добавлять счетчики скачиваний ([000]) в files.bbs. Используйте только с DLCDigits!
Этот оператор не может повторяться.
DLCDigits <number>
DLCDigits 4
Установить количество цифр в DLC. DLC имеет вид [000].
Этот оператор не может повторяться.
ticOutbound <directory>
ticOutbound /var/spool/fido/ticOub
TIC'и хранятся здесь и удаляются после отправки. По умолчанию: использовать значение PassFileAreaDir.
Этот оператор не может повторяться.
filefixKillRequests <bool>
filefixKillRequests yes
Удалять запросы к filefix после обработки.
Этот оператор не может повторяться.
filefixReportsAttr <attr>
filefixReportsAttr pvt k/s loc
filefixReportsAttr pvt,k/s,loc
Установить флаги на ответы filefix.
Допустимые флаги:
По умолчанию "pvt loc k/s".
Этот оператор не может повторяться.
BBSarea <name> <bbsareapath>
bbsarea bbs /var/spool/fido/bbsareas/bbs
Файлобласть без возможности подписки, не показывается в ответах filefix. Используется только для генерации файл-листа (команда `htick filelist`).
Этот оператор не может повторяться.
fileDescription <name>
fileDescription descript.ion
Имя файла, содержащего описания файлов, по умолчанию files.bbs
Этот оператор может повторяться.
fileDescName <name>
fileDescName file_id.diz
Если поле LDESC в TIC-файле не заполнено, использовать для его заполнения файл <name> из архива (обычно file_id.diz).
Этот оператор может повторяться.
Параметр 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
FileAreaCreatePerms <mode>
FileAreaCreatePerms 644
Определить права на созданные директории файлобластей (только для UNIX).
Этот оператор не может повторяться.
FileFixFromName <string>
FileFixFromName FileFix
Имя отправителя в ответах filefix.
Этот оператор не может повторяться.
AutoFileCreateFlag <file>
AutoFileCreateFlag /usr/local/fido/flags/new_filearea
Создавать флаг при автосоздании файобластей.
Этот оператор не может повторяться.
FileFixNames <string>
FileFixNames allfix filefix htick
Список имен, разделенных пробелами, на которые будет откликаться filefix.
Этот оператор не может повторяться.
fileEchoFlavour <hold|normal|crash|direct|immediate>
fileEchoFlavour direct
Этот оператор устанавливает флавор, который получают исходящие на этого линка
файлы из файлэх.
Например, установите fileEchoFlavour в hold для пойнтов и в crash для
аплинков.
Этот оператор может повторяться только для разных линков.
fileAreaDefaults <options> [links]
fileAreaDefaults -lw 100 -g Z 2:5097/31.1
Установить умолчания для последующих определений файлобластей. Допустимы любые
опции, кроме ареатага и пути.
Установки в определении файлобласти приоритетнее, чем fileAreaDefaults.
Также см. аэчБЮьБу echoAreaDefaults. Умолчания выключаются с помощью
пустого fileAreaDefaults.
Этот оператор может повторяться только для разных линков.
RemoteFileRobotName <name>
RemoteFileRobotName allfix
Имя удаленного робота filefix (нужно для FileForwardRequest).
Этот оператор может повторяться только для разных линков.
noTIC <bool>
noTIC yes
Отключить создание файлов TIC.
Этот оператор может повторяться только для разных линков.
autoFileCreate <on|off>
autoFileCreate on
Разрешить или запретить автосоздание файлэх, полученных от этого линка.
Этот оператор может повторяться только для разных линков.
AutoFileCreateFile <file>
AutoFileCreateFile /usr/local/fido/hpt/config.filefix
Указывает файл, в который будет помещено описание новой файлобласти.
Этот оператор может повторяться только для разных линков.
AutoFileCreateDefaults <string>
AutoFileCreateDefaults -lw 100 -g Z
Определяет умолчания новой файлобласти при автокриейте. Не стоит использовать здесь указания каких-либо путей или passthrough - для этого существует отдельный токен - LinkFileBaseDir. аэчБЮьБу LinkFileBaseDir.
Этот оператор может повторяться только для разных линков.
AutoFileCreateSubdirs <on|off>
AutoFileCreateSubdirs on
Автосоздавать арии как /filebase/gfd.app.edit (off) или как /filebase/gfd/app/edit (on). Если вы хотите установить эту опцию глобально, а не для каждого линка по отдельности, установите ее в секции deflink. Также см. 'AutoAreaCreateSubdirs' в документации на hpt.
Этот оператор может повторяться только для разных линков.
delNotReceivedTIC <on|off>
delNotReceivedTIC on
Удалять TIC, если файл не был принят.
Этот оператор может повторяться только для разных линков.
FileFixFSC87Subset <on|off>
FileFixFSC87Subset on
Этот булевый переключатель определяет, как будут обрабатываться файлы TIC для
каждого линка. Значение по умолчанию ON. В процессе обработки файлов TIC htick
будет реагировать только на совместимые с FSC87 ключевые слова и игнорировать
неизвестные. Если переключатель установлен в OFF, будут использованы все
поддерживаемые ключевые слова, что может привести (а при работе с некоторыми
файл-процессорами, ПРИВЕДЕТ) к серьезным проблемам. Неизвестные ключевые слова,
найденные в TIC, вынудят htick прекратить обработку этого файла. Если вы не
представляете, что все это значит, установите FileFixFSC87Subset в ON для
всех линков. Это не повредит.
Этот оператор может повторяться только для разных линков.
TickerPackToBox <on|off>
TickerPackToBox on
Если для линка определен файлбокс - тоссить файлы и TIC'и в нем.
Этот оператор может повторяться только для разных линков.
LinkFileBaseDir <directory>
LinkFileBaseDir /usr/local/fido/fileareas/2.5097.64.0
Куда будут помещены автосозданные файлобласти (может быть "passthrough").
Этот оператор может повторяться только для разных линков.
ForwardFileRequests <on|off>
ForwardFileRequests on
Разрешить форвард-реквесты файлобластей на этого линка.
Этот оператор может повторяться только для разных линков.
ForwardFilePriority <number>
ForwardFilePriority 1
Приоритет аплинка при форвард-реквестах подписок на файлобласти.
Этот оператор может повторяться только для разных линков.
ForwardFileRequestFile <file>
ForwardFileRequestFile /usr/local/fido/hpt/uplink1.lst
Список доступных у этого линка файлобластей.
Этот оператор может повторяться только для разных линков.
filefix <bool>
filefix off
По умолчанию filefix включен (on). Вы можете отключить использование этим линком filefix'а.
Этот оператор может повторяться только для разных линков.
FileFixEchoLimit <number>
FileFixEchoLimit 10
Лимит подписки на области (максимальное количество файлобластей, на которое этот линк может подписаться).
Этот оператор может повторяться только для разных линков.
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, доступно большинство опций:
-hide.
-mandatory.
-manual.
-noCRC.
-nodiz.
-pause.
-noreplace.
-sendorig.
htick имеет гибкую систему анонсов, которые могут различаться для разных
файлобластей.
Токен AnnAreaTag начинает новую секцию определения анонса, другие токены
определяют списки файлобластей, включенных в анонс, и описывают формат анонса.
Запустите htick announce, чтобы постить анонсы.
Вы можете отключить анонсы - просто удалите AnnounceSpool из своего
конфига.
AnnounceSpool <path>
AnnounceSpool /var/spool/fido/announce
Директория для накапливания информации для анонсов.
Этот оператор не может повторяться.
AnnAreaTag <AREATAG|@filename>
AnnAreaTag local.announce
Начинает новую секцию определения анонса. <AREATAG> - имя области, в которую будет помещен анонс; <@filename> - имя файла с префиксом '@', в который будет помещен анонс.
Этот оператор может повторяться.
AnnInclude <fileecho mask list>
AnnInclude *
Массив имен|масок файлобластей, которые будут анонсированы в этом annAreaTag. По умолчанию: все файлобласти.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnExclude <fileecho mask list>
AnnExclude aftnged
Массив имен|масок файлобластей, которые не будут анонсированы в этом annAreaTag.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnTo <string>
AnnTo All
Имя получателя в письме с анонсом.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnFrom <string>
AnnFrom Announce Robot
Имя отправителя в письме с анонсом.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnSubj <string>
AnnSubj New files arrived
Тема в письме с анонсом.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnAddrTo <address>
AnnAddrTo 2:5097/31.1
Адрес получателя в письме с анонсом (используйте для нетмейловых областей).
Этот оператор может повторяться только для разных AnnAreaTag.
AnnAddrFrom <address>
AnnAddrFrom 2:5097/31
Адрес отправителя в письме с анонсом.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnOrigin <string>
AnnOrigin New files!
Origin в письме с анонсом.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnMessFlags <string>
AnnMessFlags loc hld
Флаги письма с анонсом (k/s loc hld ...).
Этот оператор может повторяться только для разных AnnAreaTag.
AnnFileRFrom <on|off>
AnnFileRFrom on
Указывать в анонсе: адрес системы, от которой был получен файл.
Этот оператор может повторяться только для разных AnnAreaTag.
AnnFileOrigin <on|off>
AnnFileOrigin on
Указывать в анонсе: адрес системы, которая захатчила файл.
Этот оператор может повторяться только для разных AnnAreaTag.
Следующий текст взят из действующего конфигурационного файла.
#= Определения анонсов =====================================
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
#= Конец определений анонсов ===============================
Список ключевых слов, используемых многими программами husky. Подробнее см. в документации на fidoconfig.
BBSAreaLogLevelsaddDLC: addDLCAnnAddrFrom: AnnAddrFromAnnAddrTo: AnnAddrToAnnAreaTag: AnnAreaTagAnnExclude: AnnExcludeAnnFileOrigin: AnnFileOriginAnnFileRFrom: AnnFileRFromAnnFrom: AnnFromAnnInclude: AnnIncludeAnnMessFlags: AnnMessFlagsAnnOrigin: AnnOriginAnnounceSpool: AnnounceSpoolAnnSubj: AnnSubjAnnTo: AnnToautoFileCreate: autoFileCreateAutoFileCreateDefaults: AutoFileCreateDefaultsAutoFileCreateFile: AutoFileCreateFileAutoFileCreateFlag: AutoFileCreateFlagAutoFileCreateSubdirs: AutoFileCreateSubdirsBBSarea: BBSareaBusyFileDir: BusyFileDirConvertLongNames: ConvertLongNamesConvertShortNames: ConvertShortNamesdelNotReceivedTIC: delNotReceivedTICDLCDigits: DLCDigitsExecOnFile: ExecOnFileFileArea: FileAreaFileAreaBaseDir: FileAreaBaseDirFileAreaCreatePerms: FileAreaCreatePermsfileAreaDefaults: fileAreaDefaultsfileDescName: fileDescNameFileDescPos: FileDescPosfileDescription: fileDescriptionfileEchoFlavour: fileEchoFlavourFileFixEcho: FileFixFileFixEchoLimit: FileFixEchoLimitFileFixFromName: FileFixFromNameFileFixFSC87Subset: FileFixFSC87SubsetFileFixHelp: FileFixHelpfilefixKillRequests: filefixKillRequestsFileFixNames: FileFixNamesfilefixReportsAttr: filefixReportsAttrfileLDescString: fileLDescStringForwardFilePriority: ForwardFilePriorityForwardFileRequestFile: ForwardFileRequestFileForwardFileRequests: ForwardFileRequestsLinkFileBaseDir: LinkFileBaseDirMaxTicLineLength: MaxTicLineLengthnoTIC: noTICPassFileAreaDir: PassFileAreaDirRemoteFileRobotName: RemoteFileRobotNameSaveTic: SaveTicTickerPackToBox: TickerPackToBoxticOutbound: ticOutboundОбщие ключевые слова husky: Common husky keywordsПример анонсов: Announcements example