<---------------------------------------------------------------------------->
\ ( ' ,_) ) \_/
(_ , /\ ,_/
______-\ `\--` __
____/_ __/__\__\__ _____/ /__
/ ___// / / __\/ __ '/ ___/ //_/
/ / / / / / /\/_/ / /__/ ,<
/_/ /_/ /_/ /_\_/\|\___/_/|_|
\\
-.'.`\.'.-
the ultimate ftn mail robot
~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Введение. Что такое RTLib и с чем его едят.
1.1. rTrack - это DPMI, Win32, OS/2 библиотека (RTLib.dll) для написания
роботов-обработчиков почты. RTLib включает в себя все основные функции
почтового робота. Такие как:
- проверка адресов в нодлисте;
- поддержка подхабника;
- роутинг писем по файлу роутинга;
- проверка письма на петлю роутинга (кол-во проходов через вашу систему);
- работа с BSO, LongBSO, t-boxes, Long Boxes, Brake fileboxes;
- постинг и форвард писем в pkt 2.0+, fido msg, squish, jam (rMsg engine);
- мощный движок для темплейтов;
- поддержка автором :-)
1.2. При написании функций этого трекера я базировался на единственный
юзаный мною трекер MNTrack 3.06. Честно скажу, что он мне понравился. Но
все же не хватало нескольких довольно нужных фич, а с крутейшим трекером
O/Track разбираться было почему-то лень (как и с AllFix впрочем). На все
мои просьбы поделится конфигами от O/Track мои ноды либо вообще не
отвечали, либо отвечали, с какими-то непонятными отмазами. Но это уже
другая история. Потом я увидел ItraX... хм - библиотека. Как мне стало
жалко, что у меня не стоит полуось! И вот я решился написать нечто похожее
на ItraX, всем понятное и главное - на русском языке. В результате
получилось то, что сейчас занимает место на Вашем винте.
1.3. Ошибки.
Я гонял эту библиотеку под MsDos 6.22 (Dos ver), Win95 OSR2 (Dos, Win32
versions), NTWS4SP3 (Dos, Win32 versions), при этом страшных глюков
замечено не было, но все таки если Вы засекли глюк (программа подвисла,
взорвала монитор, отформатировала винт etc) или нелогичность/неверность,
то нужно:
1) Прислать мне всю ту информацию, которую rTrack выдал при падении.
2) Разобраться в какой rTrack функции произошла ошибка. После этого
пришлите мне ту мессагу, на которой упал rTrack и имя функции, где
обнаружен глюк. Если у Вас нет на это времени, тогда просто шлите мне ту
мессагу на котором произошла ошибка и ваши конфиги, с помощью которых я
смогу повторить эту ошибку у себя. Обратите внимание, что мне не нужно
форвардить ту самую мессагу, мне нужен ее двоичный эквивалент, то есть,
например, файл *.msg для msg формата.
3) Попытаться сообщить мне максимум сведений об ошибке. Первых двух
пунктов я думаю вполне достаточно, но чем больше информации тем лучше.
Вообще первое время я хотел бы слышать о всех сообщениях об ошибках.
Первые два пункта - это необходимый минимум, который нужен для отлова
ошибки, поэтому их выполнять нужно обязательно, а то есть люди, которые
только говорят что-то типа "ой, а он у меня падает с ошибкой 216". Как я
по-вашему должен реагировать на такие письма?
1.4. Где взять новые версии?
1) в интернете: http://arena.chel.com.ru/raven/ в разделе warez;
2) хатчатся в AFTNMISC и AFTNFAST;
3) фрекнуть на 2:5010/148 файл rt10*.rar.
<---------------------------------------------------------------------------->
2. Лицензионное соглашение.
2.1. rTrack является интеллектуальной собственностью его автора Суходоева
Дмитрия Владимировича и охpаняется законом Российской Федеpации "Об
охpане автоpских пpав на пpогpаммы для ПЭВМ и баз данных".
2.2. rTrack является EmailWare программой и может использоваться лишь в том
случае, если Вы выслали мне заполненную форму для регистрации (подробней
смотрите файл RTLib.frm). Вы можете использовать rTrack без регистрации
только в течении ознакомительного срока (21 день).
2.3. Вы имеете право использовать rTrack лишь только, если не получаете от
этого материальной выгоды и не вносите изменения в какие либо части
распространяемого автором дистрибутива. В противном случае - это будет
нарушением моих авторских прав.
2.5. Программа поставляется по принципу как есть (AS IS). Т.е. если из-за
использования этой программы у Ваши интернетовские пароли оказались у
левых людей, у вас упал масдай или сдохла собака, то автор за это
ответственности не несет! Я гарантирую лишь одно - программа будет
занимать место на Вашем накопителе. Но это отнюдь не значит, что
программа содержит одни ошибки (как Win9X).
2.6. Связаться с автором можно по следующим адресам (в порядке предпочтения):
2.6.1. Fido: 2:5010/148.28;
2.6.2. Email: raven@fido.urc.ac.ru;
2.6.3. Echo: RU.FASTUUE (технические вопросы и предложения);
RU.FASTUUE.TALK (прочий базар :).
2.7. ВНИМАНИЕ!!! КАТЕГОРИЧЕСКИ ЗАПРЕЩАЕТСЯ ИСПОЛЬЗОВАТЬ ЭТУ БИБЛИОТЕКУ ДЛЯ
РАССЫЛОК РЕКЛАМЫ И ДРУГИХ (ВОЗМОЖНО ДОСЕЛЕ НЕИЗВЕСТНЫХ) ВИДОВ СПАМА.
НАРУШЕНИЕ ЭТОГО ЗАПРЕТА БУДЕТ СЧИТАТЬСЯ НАРУШЕНИЕМ МОИХ АВТОРСКИХ ПРАВ И
КАРАТЬСЯ МАКСИМАЛЬНО ВОЗМОЖНЫМ СРОКОМ, ПРЕДУСМОТРЕННЫМ ЗАКОНОМ!!!
2.8. RTLib писалась в течении нескольких месяцев одним человеком, и если у
вас вдруг возникло желание поощрить труд автора, то немедленно обратитесь
к психиатору.
А если серьезно, то при желании можно выслать сумму, превышающую 5 у.е.
на выше указанные адреса. За меньшее не стоит беспокоиться.
<---------------------------------------------------------------------------->
3. Для пользователя.
3.1. Форма для регистрации: для чего она нужна?
Я писал эту программу для себя. И если не будет стимулов для продолжения
и развития этого трекера, я просто положу на него, как только он
достигнет точки, которая достаточна для меня. Если я не получу Вашу форму
для регистрации - я не буду знать, что программа используется, не буду
знать о ее глюках, которые впоследствии не будут пофиксены.
3.2. Требования к системе.
Для DOS версии:
Процессор 286 или выше, сопроцессор не требуется;
Память менее 400Kb досовой, не менее 512Kb расширенной.
Для W32, OS2 версий:
Процессор 386 или выше, сопроцессор не требуется;
Память для запуска самих W32 и OS2.
3.3. О нумерации версий.
Формат нумерации такой: %mv.%sv.%b, где %mv - номер версии, %sv - номер
подверсии, %b - номер билда для этой подверсии.
3.4. Etc..
В общем сейчас мне надо хорошего курьера (человека, который будет
раскидывать rTrack по файлэхам и в инет). Приветствуются узлы, готовые
держать всегда новые версии rTrack, т.е. узлы поддержки. Также последнее
время меня пинают за очень краткую доку. Можете написать лучше - дерзайте.
Если Ваш мануал мне понравиться, то он будет ходить в дистрибутиве в
дополнение к остальной документации. В общем буду очень благодарен за
любую помощь, и обещаю упомянуть в кредитсах ;-)
<---------------------------------------------------------------------------->
4. RTLib.
4.1. Комплект поставки.
Compile.bat - для компиляции примеров;
Folders.pas - список папок;
MSGMake.pas - простенький постер текстов в Fido Msg на основе RTLib.dll;
MSGMake1.pas- простенький постер текстов в Jam(tm) на основе RTLib.dll;
rtpost.pas - простенький постер из коммандной строки в любую базу;
RTNC.pas - компилятор нодлистов на основе RTLib.dll для rTrack.pas;
rTrack.pas - пример для написания своего трекера, этот стоит у меня;
RTApi.PAS - модуль, где прописаны все импортируемые функции RTLib.dll.
всегда должен подключаться к Вашему трекеру.
RTLib.dll - главная библиотека [DOS версия];
RTLib2.dll - главная библиотека [OS2 версия];
RTLib32.dll - главная библиотека [W32 версия];
Doc\ - документация;
Template\ - там лежат примеры темплейтов, которые юзаю я;
RTM\ - там лежат файлы DPMI сервера, их нужно поместить
куда-нибудь, что прописано в Path, если вы используете DOS
версию
BPC\ - резаный компилятор паскаля для DOS [DOS версия];
VPC\ - резаный компилятор паскаля для OS2, W32 [OS2, W32 версии]
4.2. Преимущества и недостатки.
Было сделано все возможное, чтобы исключить потерю NetMail при
пропадении напряжения в сети и других подобных инцидентов. После такого
возможны дупы, бэды, мусор в конце концов, но пропажа писем - никогда!
Пара слов о памяти. Перед распаковкой (да и во время трекинга) каждая
мессага полностью грузится в память. Для этой загрузки надо:
1) память под кладжи;
2) память для хранения тела мессаги;
3) буфер для каждой мессаги 4096 байт.
Поэтому реальный размер мессаги в памяти будет примерно на 5-6 килобайт
больше чем она занимает на диске. Отсюда следует, что мессагу больше чем
размер ОЗУ на вашей машине обработать не получится. Что будет? А просто
мессага при сохранении сохранится пустая, без тела. Кстати обязательно об
этом скажет и в логе и на экране, что мол мессага не загружена.
4.3. Характеристики, ограничения.
Максимальная длинна строки в темплейте............................65535;
Максимальный кол-во сообщений в Msg базе.......................99999999;
Максимальный кол-во сообщений в Squish базе..................2147483647;
Максимальный кол-во сообщений в Jam базе.....................2147483647;
Максимальный кол-во сообщений в Pkt базе.....................2147483647;
Максимальное кол-во кладжей в письме.........................2147483647;
Максимальное количество aka..................................2147483647;
Формат нетмэйла..........................*.msg (Fido), Pkt, Squish, Jam;
Максимальный размер письма.................................неограниченo;
Максимальная длина строки в письме.........................неограниченo;
Максимальное количество нодов в нодлисте...................неограниченo;
Максимальное количество обрабатываемых нодлистов...........неограниченo;
Почта...............................................только непакованная;
Адресация........................................5D/частично с доменами;
Паковка...........................Bink Style OutBound, T-Mail Fileboxes,
T-Mail Long Fileboxes [W32;OS2], Long
FileBoxes;
Думается, что увеличивать здесь уже нечего... Но мало ли кому надо -
пишите, что нибудь придумаем. Кстати, под "неограниченно" подразумевается,
что ограничено размером свободной памяти.
| 
Dmitry Suhodoev