README.md
1# FIDOCONFIG LIBRARY
2[![Build Status](https://travis-ci.org/huskyproject/fidoconf.svg?branch=master)](https://travis-ci.org/huskyproject/fidoconf)
3[![Build status](https://ci.appveyor.com/api/projects/status/rmxqn7rmveb5am4i/branch/master?svg=true)](https://ci.appveyor.com/project/dukelsky/fidoconf/branch/master)
4[![Codacy Badge](https://api.codacy.com/project/badge/Grade/8c3df1b7e10c4ebfae005e60cf533fd5)](https://www.codacy.com/app/dukelsky/fidoconf?utm_source=github.com&utm_medium=referral&utm_content=huskyproject/fidoconf&utm_campaign=Badge_Grade)
5
6Warning: see "LAST CHANGES" section in this file!
7
8## WHAT IS IT
9----------
10
11This library is a core part of HUSKY portable fidonet software which
12parsing and manipulating config file.
13For details see docs/fidoconfig.*
14
15
16## SUPPORTED COMPILERS
17-------------------
18
19The following makefiles can be used to compile this release of FIDOCONFIG:
20```
21Makefile Target library Compiler
22------------ -------------- -------------------------------------------
23Makefile libfidoconfig.* Any (huskymak.cfg required), use GNU make
24makefile.bcd fconfbcd.lib Borland C++ 3.1 for DOS
25makefile.bco fconfbco.lib Borland C++ 1.0 for OS/2
26makefile.bcw fconfbco.lib Borland C++ 4.0 for Windows
27makefile.be libfidoconfigbe.a GNU C 2.7.x for BeOS
28makefile.bsd libfidoconfigbsd.a GNU C 2.9.x for BSD clones
29makefile.bsd4 libfidoconfigbsd.a GNU C 2.9.x for FreeBSD 4.*
30makefile.cyg libfidoconfigcyg.a GNU C 2.9.3 - 3.2.1 for Cygwin (mingw32
31 fidoconf.dll library and/or dll and binaries)
32makefile.djg fconfdjg.a GNU C 2.7.x for MS-DOS (DJGPP)
33makefile.emo fconfemo.lib GNU C 2.7.x for OS/2 (EMX 0.9) with
34 OMF-Style linkage
35makefile.emx fconfemx.a GNU C 2.7.x for OS/2 (EMX 0.9) a.out-style
36 linkage (EMX Runtime)
37makefile.hco fconfhco.lib MetaWare High C 3.2 for OS/2
38makefile.ibo fconfibo.lib IBM C/Set++ 2.0 for OS/2
39makefile.lnx fconflnx.a GNU C 2.7.x for Linux
40makefile.qnx libfidconfigqnx.* GNU C 2.95.3 for QNX 6.x
41makefile.mgw libfidoconfigmgw.a Mingw32 for NT
42makefile.mvc fidoconfigmvc.lib Microsoft Visual C/C++ 6.0
43makefile.mvcdll fidoconfigmvc.dll Microsoft Visual C/C++ 6.0
44 (shared library produced)
45makefile.qcd fconfqcd.lib Microsoft QuickC 2.5 for DOS (makefile
46 requires either the Microsoft Macro
47 Assembler, MASM, or the Borland Turbo
48 Assembler, TASM)
49makefile.rxw fconfrxw.lib GNU C 2.7.x for Windows NT (RSXNT/EMX)
50makefile.sun libfidoconfigsun.a GNU C 2.7.x for Solaris
51makefile.unx libfidoconfigunix.a Generic Unix Makefile
52makefile.wcd fconfwcd.lib WATCOM C/C++ 10.x for 16-bit DOS
53makefile.wco fconfwco.lib WATCOM C/C++ 10.x for 32-bit OS/2
54makefile.wcw fconfwcw.lib WATCOM C/C++ 10.x for 32-bit Windows
55makefile.wcx fconfwcx.lib WATCOM C/C++ 10.x for 32-bit DOS
56```
57Note that the Linux, BSD and other unix-like makefiles must be in UNIX text
58file format (linefeeds only; no carriage returns). Other must be in DOS text
59file format usually (CRLF ends of lines).
60
61The Makefile creates a shared library and depends on GCC, while the
62generic Unix Makefile (makefile.unx) should work on any Unix system with
63any set of cc, ld and ranlib, and creates a static libarry.
64
65
66## LAST CHANGES
67------------
68
69This russian text is describing undocumented changes.
70
71Замечания о (недокументированных) новшествах в current.
72Подборку сделал Serge Travin, 2:5030/1080.18
73
74─────────────────────────────────────────────────────────────────────
75
76От : val khokhlov 2:550/180 02 янв 05 22:28
77
78Тема: husky-current
79─────────────────────────────────────────────────────────────────────
80
81 Greetings, All!
82
83 завершена первая (и наибольшая) очередь работ, связанных с переделкой
84системы роботов. hpt-current и htick-current собираются и даже, вероятно,
85работают. я проверял информационные команды и подписку/отписку - работает. не
86проверялись форвард-реквесты, автосоздание эх и работа с очередью.
87
88большая просьба не использовать current на рабочих системах, но по мере
89сил помочь с тестированием.
90
91изменения токенов произошли по двум большим направлениям:
92
931. некоторые глобальные токены перенесены в секции robot
94
95 пример описания секции:
96```
97robot default\|areafix\|filefix\|<что-то другое>
98
99helpfile <имя файла>
100
101robotorigin <ориджин для данного робота> и т.п.
102```
103последовательность играет роль - default копируется тем роботам, которые
104описаны после него (но не до него!). hpt использует имя робота "areafix", htick
105\- "filefix". обратите внимание - имя может быть произвольным (на будущее)
106
1072. некоторые токены из секций link переименованы и допускают префиксы
108это значит, что, к примеру, "areafixecholimit" определяет граничное
109число эх, которые может подписать данный линк у areafix'а, а "echolimit" (без
110префикса) определяет аналогичное значение и для areafix, и для filefix.
111префиксами могут быть предопределенные имена роботов "areafix" и
112"filefix". роботы, которые реально определены в конфиге, никак не влияют на это
113(т.е., реально можно не обязательно иметь пустую секцию "robot areafix")
114
115вот список измененных токенов:
116```
117[robot]
118
119areafixfromname fromname
120areafixhelp helpfile
121areafixkillrequests killrequests
122areafixmsgsize msgsize
123areafixnames robotnames
124areafixorigin robotorigin
125areafixqueryreports queryreports
126areafixqueuefile queuefile
127areafixreportsattr reportsattr
128areafixsplitstr splitstr
129autoareacreateflag autocreateflag
130autofilecreateflag autocreateflag
131filefixfromname fromname
132filefixhelp helpfile
133filefixkillrequests killrequests
134filefixnames robotnames
135filefixreportsattr reportsattr
136
137[link]
138
139areafixecholimit *echolimit
140autoareacreate *autocreate
141autoareacreatedefaults *autocreatedefaults
142autoareacreatefile *autocreatefile
143autofilecreate *autocreate
144autofilecreatedefaults *autocreatedefaults
145autofilecreatefile *autocreatefile
146denyfwdfile *fwddenyfile
147denyfwdmask *fwddenymask
148denyfwdreqaccess *
149denyuncondfwdreqaccess *
150filefixecholimit *echolimit
151forwardareapriority *fwdpriority
152forwardfilepriority *fwdpriority
153forwardfilerequestfile *fwdfile
154forwardfilerequests *fwdmask
155forwardrequestfile *fwdfile
156forwardrequestmask *fwdmask
157remotefilerobotname filefixname
158remoterobotname areafixname
159```
160\* здесь означает возможность добавления префикса areafix или filefix к данному
161токену для ограничения области действия соответствующим роботом
162
163 Good luck!
164 val
165
166-*- System uptime: 17 days, 10 hours, 33 minutes, 28 seconds
167
168 * 0rigin: I noore uu alasseo (2:550/180)
169
170────────────────────────────────────────────────────────────────────
171
172От : val khokhlov 2:550/180 02 янв 05 22:42
173
174Тема: htick-current
175
176────────────────────────────────────────────────────────────────────
177
178 Greetings, All!
179
180дополнение к письму "husky-current" по поводу htick:
181
182htick теперь использует единую библиотеку роботов areafix, поэтому
183почти все функции работают теперь так же, как в hpt (кроме %resend). реально
184это сразу повлияет на формат %list и подобных команд, которые могут сортировать
185и группировать области в списке. также, для части команд возможно указание
186масок файлэх - при подписке/отписке, %list, %query, %unlinked, %avail (в общем,
187смотрите формат этих команд в hpt/misc/areafix.hlp). новые команды в filefix не
188добавлялись
189
190подобно hpt, для htick появилась функциональность очереди для
191форвард-реквестов. полная аналогия того, что было в hpt. правда, пока без
192наличия соответствущюих ключиков запуска qupd/qrep.
193
194 Good luck!
195 val
196
197-*- System uptime: 17 days, 10 hours, 47 minutes, 35 seconds
198
199 * 0rigin: I noore uu alasseo (2:550/180)
200
201─────────────────────────────────────────────────────────────────────
202
203От : val khokhlov 2:550/180 10 янв 05 19:50
204
205Тема: htick-current
206
207─────────────────────────────────────────────────────────────────────
208
209 Greetings, All!
210
211subj умеет отсылать правила файлэх. точнее, должен - я еще не проверял.
212в связи с этим токен rulesdir перенесен в секцию роботов (определяет
213имя каталога с правилами для эх и файлэх в соотв. роботе), а к токену norules
214может быть добавлен перфикс, который ограничивает его действие одним роботом
215(areafix или filefix)
216
217 Good luck!
218 val
219
220-*- System uptime: 25 days, 7 hours, 55 minutes, 43 seconds
221 * 0rigin: I noore uu alasseo (2:550/180)
222
223─────────────────────────────────────────────────────────────────────
224
225От : val khokhlov 2:550/180 22 янв 05 17:02
226
227Кому: Max Chernogor
228
229Тема: husky-current
230
231─────────────────────────────────────────────────────────────────────
232
233 Greetings, Max!
234
23522 Jan 05 14:34, Max Chernogor wrote to val khokhlov:
236
237 MC> ForwardRequestTimeout
238
239 MC> IdlePassthruTimeout
240
241 MC> KilledRequestTimeout
242
243сорри, забыл указать. эти токены описываются в секции robot
244
245tearline - пока что нет. перенесу.
246
247 Good luck!
248 val
249
250-*- System uptime: 2 days, 5 hours, 43 minutes, 36 seconds
251 * 0rigin: I noore uu alasseo (2:550/180)
252
253 . Sermon - No Place [From Death To Death/1997]
254
255... даже если вас съели, то у вас есть два выхода ...
256
257-+- [СПбГЭТУ гр. 0461] --- [death&black metal] --- [Ленинградская область] ---
258
259 + Origin: Like a moving truck (2:5030/2404)
260