Hpt_ro russian (koi8-r) readme: $Id: ro_readme_rus.txt,v 1.5 2003/01/10 23:44:36 i_zkh Exp $

    � ���������
    -----------

� ����設�⢥ ��砥� ����� �।�� HPT ��� ��࠭�祭�� ����㯠 ������ � �堬
������ 墠⠥�. �� �뢠�� ���樨, ����� ���� ������� ����� "�ᥬ, �஬�",
��� ����� ���� ᫥���� �� �ப�� ����⢨� ��࠭�祭��, � �.�. � ��� ��
���������⥩, ����� �।��⠢������ ���஬, ���� �������筮, ���� ��
��㤮��� �ᯮ�짮����. � ������, ࠧࠡ��稪� HPT ᤥ���� �祭� 㤮���� ���� -
��૮�� �㪨. �⮡� �� �ய��뢠�� ��࠭�祭�� �����।�⢥��� � ⥪��
�ਯ� filter.pl, �� ᮧ��� ��������� ����� Hpt_ro.pm, �����
�������� �뭥�� ��࠭�祭�� � �⤥��� ���䨣 � ����ࠨ���� �����,
�� �㬠� � ��૥ � ��� ᨭ⠪��.


   ������
   ------

Hpt_ro.pm - ������⥪� �㭪権. ������� �஬ �����.

ro_parser.pl - �� ᢮��� �����祭�� ���������� tparser.exe: �뢮��� १����
              ��ࠡ�⪨ ���䨣�� � 㤮���� ��� ���祭�� ����.

ro_purge.pl - 㤠��� �� ���䨣� �ࠢ��� � ����訬 �ப�� ����⢨�. ��� �����
             �६� �� �६��� ����᪠�� �� �஭� ��� ������.

ro.cfg - �ਬ�� ���䨣�.

ro_readme_rus.txt - �� ����.


   ���������
   ---------

��� ࠡ��� ����� ����室�� HPT � ����祭��� �����প�� ��૮��� �㪮� �
��⠭������� Perl (���ᨨ �� ���� 5.6.0). �᫨ ��� �� ����, � �����
���室��� � ��⠭���� �����:

1. �������� 䠩�� � �����-����� ��⠫��. �� ����� ���� (�� �� ��易⥫쭮)
��⠫�� HPT. ������� �᫮���, �⮡� ro_parser.pl, ro_purge.pl � Hpt_ro.pm
��室����� � ����� ��⠫���.

2. ����� � Hpt_ro.pm ��� � ���䨣��樮��� 䠩���:

 my $defhptconf = "n:\\bin\\hpt\\config";
 $ro_conf = "n:\\bin\\hpt\\ro.cfg";

� ��ࢮ� ���窥 㪠�뢠���� ������ ��� ���䨣� HPT, � �� ��ன - ���
ᮡ�⢥����� ���䨣� �����. �᫨ ��।����� ��६����� ���㦥��� FIDOCONFIG,
� ��� ���䨣� HPT ������� �� ���.

����� ��������, �� ����� ������ ���⭮�� ᫥� ���� �⠢��� ���.

3. ������� ���� ��� ��।������ �ਫ������ � ����⢥ �ਬ�� 䠩�
ro.cfg. �� �� ��易� ���뢠���� ������ ro.cfg ��� ��室����� ⠬ ��, ���
�ਯ�� �����. ���뢠�� ��� ��� � ������ �㤠 ���, ⮫쪮
�� ���뢠�� �ய���� ��� ������ ��� � Hpt_ro.pm.

4. ��᫥ ⮣�, ��� 䠩� ro.cfg (��� ��� �� ⠬ ��� �������) ����ᠭ, ���
�஢�ન �ࠢ��쭮�� ���䨣��樨 ������� ro_parser.pl. ���� �뢮�����
�⨬ �ਯ⮬ ���ଠ樨 ����� ���� ���쬠 ����訬, ���⮬� ���� �뢮�
��७��ࠢ��� � 䠩�:

 perl ro_parser.pl > ro.txt

�᫨ �㦭� ��ᬮ���� ⮫쪮 ������ � ����⠬�, � ������:

 perl ro_parser.pl denyonly > ro.txt

5. �᫨ १���� ��� ���ந�, � ᠬ�� �६� �ࠢ��� filter.pl. �������
� ��砫� 䠩�� ���窨

 use lib "n:\\bin\\hpt";
 use Hpt_ro;

��� ��᫥ 'use lib' � ����窠� 㪠��� ����, �� ���஬� ��室���� Hpt_ro.pm.
�� ������, �� ����� ������ ���⭮�� ᫥� ���� �⠢��� ���.

� �㭪�� filter() ����� ���窨:

 if ($area) {
   my $res = Hpt_ro::checkro($area,$pktfrom);
   return $res if $res;
 }


6. ������� �ਯ� �� ���������, �⮡� �஢����, �� ��� �ய�ᠭ� ��୮:

 perl filter.pl

7. ��⠭���� �����祭�.


    � � � � � � � � !
    -----------------

��᫥ ��� ��������� ro.cfg ��易⥫쭮 ����᪠�� ro_parser.pl, �⮡�
㡥������, �� ���䨣 �� ᮤ�ন� �訡��. �᫨ ���䨣 ���ࠢ����, �
filter.pl �믮������ � �訡���, HPT ��� �⪫���, � readonly ����⠭��
����⢮���� ᮢᥬ.


    ��ଠ� ro.cfg
    -------------

���� ��⮨� �� ��᫥����⥫쭮�� ��।������ ��㯯 � �ࠢ��. ��㯯� �����
��।����� � �� ���� ���䨣�, �� ��易⥫쭮 �� ��ࢮ�� �ᯮ�짮�����
��㯯� � �ࠢ���.

������ �� ����뢠���� ���祢� ᫮��� echogroup.

���ᠭ�� ��㯯� ����� ���� ᤥ���� � ���� �����:

echogroup <groupname> echomask1 echomask2 ...

� �⮬ ��砥 �� (��᪨ ��) ���������� ��᫥ ����� ��㯯�.

�᫨ �� � ��㯯� �����, � 㤮���� ���������� �ଠ�:

echogroup <groupname>
  echomask1 echomask2 echomask3 ...
  echomaski echomaski+1 ...
  ...
  echomaskn-1 echomaskn
endechogroup

���� � �� �� ��㯯� ����� ��।����� �������⭮, �� �⮬ ᯨ᪨ ��
��ꥤ�������, ���ਬ��:

echogroup sysops R50.SYSOP*
echogroup sysops N5020.SYSOP*

��������� �������⭮

echogroup sysops R50.SYSOP* N5020.SYSOP*


������ ������ ����뢠���� �������筮:

linkgroup <groupname> linkmask1 linkmask2 ...

���

linkgroup <groupname>
  linkmask1 linkmask2 linkmask3 ...
  linkmaski linkmaski+1 ...
  ...
  linkmaskn-1 linkmaskn
endlinkgroup

linkmask ����� �ଠ� d:d/d[.d], ��� d - �� �᫮ ��� ���� '*'. ����
'd:d/d.0' �������⥭ 'd:d/d', �.�. �㫥��� ����� ���� � ���� ᠬ�� ���� -
�� ���� � � ��.

����������:
- ॣ���� ����� ��㯯� ����� ���祭��, �.�. sysops � SYSOPS - �� ࠧ��
��㯯�.
- ����� ��㯯 �� � ������ ����� ᮢ������, �� �⮬ ��� �� ��९������, ⠪
��� �࠭���� � ࠧ��� �����. �.�. 'linkgroup all' � 'echogroup all' - ��
ࠧ�� �����ᥪ��騥�� ��㯯�.
- ��� ��㯯� �� �� ����� ��稭����� � ���� '-' (��祬�, ����ᠭ� ����).

������� ����� �ଠ�:

{deny|allow} {@linkgroup|linkmask} {@echogroup|echomask} [expiration date]

linkgroup - ��� ࠭�� ���ᠭ��� ��㯯� ������. ��। ������ ��㯯� ��易⥫쭮
 ���� ��������� ᨬ��� '@';
linkmask - ���� ��� ��᪠ �����;
echogroup - ��� ࠭�� ���ᠭ��� ��㯯� ��. ��। ������ ��㯯� ��易⥫쭮 ����
 ��������� ᨬ��� '@'. �᫨ ��� ��㯯� ��稭����� � ᨬ���� '-', � ��
 ����砥� ��뫪� �� ��㯯� �� �� ���䨣� HPT (���� -g � echoarea). ���ਬ��,
 '@-A' - ����砥� �� ��, ����� ᮣ��᭮ ���䨣� HPT ����� ��㯯� 'A', �.�.
 � �� ����� 㪠���� '-g A';
echomask - ��� ��� ��᪠ ��;
expiration date - ���, ��᫥ ���ன �ࠢ��� ������� ����⢮����. ���
 �������� � �ଠ�: dd.mm.yy. ����� �� 㪠�뢠����, ⮣�� �ࠢ��� �������
 ����ﭭ�.

�ࠢ���, �᫮��� ������, �������� ᫥���騬 ��ࠧ��: ������ ��� ��-����,
��।����� � �㭪�� checkro(), �� ��।� �ࠢ�������� � �ࠢ����� (�᫨ �ப
����⢨� �ࠢ��� ����, � ��� ����뢠����). �� �����㦥��� ᮢ�������, �.�.
����� � ���� � �� ᮢ������ � ᮮ⢥�����騬� ��᪠�� � �ࠢ���, �ࠢ�����
�४�頥���, � ᮢ���襥 �ࠢ��� ��।����, ࠧ�襭� �� ����� ����� � ���.

�������:

- ������� ����� � OSCOL.SYSOPS �ᥬ ����⠬, �஬� 2:6037/1.28:

allow 2:6037/1.28 OSCOL.SYSOPS
deny 2:6037/1.* OSCOL.SYSOPS

- ������� ����⠬ ����� � �ᮯ᪨� ��:

echogroup sysopechoes R50.SYSOP* N5020.SYSOP*
deny 2:6037/1.* @sysopechoes

- �� ������� ����祭 "!", �⪫���騩 ���� �� SUPER.ECHO �� 31 �������
2001 ���� �����⥫쭮:

deny 2:6037/1.* SUPER.ECHO 31.12.01

- ����� � ���� ���� ��᪮�쪮 �������� � ��㭫�����. � ࠧ��� �������� ��室��
��, � ����� ���� �� ��㭫����� ����� �� ������.

# ��᪠ *:*/*.* ����砥� "�� �����". ��᪠ *:*/* �� ���室��, ⠪ ���
# ����砥� "�� ����" � �������⭠ ��᪥ *:*/*.0
linkgroup all *:*/*.*

# ��㯯� ��������.
linkgroup uplinks 2:5020/52 2:5025/3 2:6037/9

# �� "⮫쪮 ��� �⥭��"
echogroup readonly
 HUMOR.FILTERED
 1072.COMPNEWS
 BOCHAROFF.MUST.DIE  BOCHAROFF.UNPLUGGED
endechogroup

# ࠧ���� ����� ��������, ...
allow @uplinks @readonly
#  ...�� ������� �ᥬ ��⠫��
deny @all @readonly

��� ��ਠ�� ⥮���᪨ �������� ������ ������� ����� � readonly ���,
������ �� ����砥� � ��㣮�� �������. �᫨ ⠪�� ������ ᮡ�⨩ ����
�᪫����, � �ਤ���� ᤥ���� ������� ⥫���������. ��-�����, �
���䨣� HPT �ᥬ �堬, ����� ���� � ࠧ��� �������� ��᢮��� ࠧ�� ��㯯�.
����� �� ��, ����� ���� � 2:5020/52 ����� ��㯯� A, �� � 2:5025/3 - B,
�� � 2:6037/9 - �. �������� ���� ⠪�� ��᢮��� ᮮ⢥�����騥 linkgrp.
����� ᮧ������� ��������� �堬 ���� ��⮬���᪨ ��ᢠ������� �㦭�
��㯯�.
��᫥ ⮣�, ��� ���䨣���� HPT ��ࠢ���� �㦭� ��� ��ࠧ��, ����� ������
ro.cfg:

linkgroup all *:*/*.*
echogroup readonly
 HUMOR.FILTERED
 1072.COMPNEWS
 BOCHAROFF.MUST.DIE  BOCHAROFF.UNPLUGGED
endechogroup
# ������� �������� ����� � ����砥�� �� ��� ��
allow 2:5020/52 @-A
allow 2:5025/3 @-B
allow 2:6037/9 @-C
# �ᥬ ��⠫�� ������� ����� � readonly-��.
deny @all @readonly

    ��� ��������
    ------------

�� ��ࢮ� ���饭�� � �㭪樨 checkro() ���뢠���� ���䨣 HPT � ᮡ�⢥���
���䨣. ��⥬ �� ����� ��� ��, ����� �� ���䨣� HPT, �ண������� �१
�ࠢ���, � � १���� �ନ������ ��� ��㬥��� �� allow � deny (�� - ��
���ᨢ, � ����⢥ ������ ���ண� ����㯠�� �� �᫠, � ��ப�). ��⥬
��।���� � �㭪�� �� � ���� �஢������� �� ������⢨� � ����� �� �襩.
�᫨ ���������� � allow, � ����� ����� ����� � ���, �᫨ ���������� �
deny, � ����饭�. ����� �।��ࠡ�⪠ ���� ��������� ����প� �� ��ࢮ�
���饭�� � �㭪樨, �� � ���쭥�襬 �஢�ઠ �ந�室�� �����.
�᫨ � ����� ��� ���� ��� �� ����������, �����, ��� ���� �� �����ᠭ ��
���, ��� �� �� ���� �� �������, ��� ���� �����ᠫ�� �� ��� � ��� �� ����ᠫ
� ��� ���쬮. � ����� ���� ����� �஢��� ����� ������� HPT -
�������ᠭ���� ����� �� �� ����� � ���, � ������������ ��� �� ���� ᮧ����,
����, �᫨ ����� ���ᮧ����� ����饭�, ������� ���쬮 � badmail. ���쪮 ���
��᫥�����, ��� � ।����, �� ���������� ���� ᤥ���� ����୮�
�����뢠��� ���䨣��. �᫨ ��᫥ �����뢠��� ���� � �� ���������� � ��
deny, �����, ���� ����� ࠧ�襭� ����� � ����७��, ���� �� ���� ���
����.


    ��������
    --------

�� ᮢ��襭�� ᢮����� �����࠭塞� ���. ����� ��� �ᯮ�짮���� ���
㣮��� � ��� 㣮���. :) ����ࠩ� ��࠭��� �� ��易⥫쭮. ����, ��� ��
������� � �������� �����, ������� �⢥��⢥����� �� �������� ���,
������訩 � १���� �ᯮ�짮����� �⮣� �ணࠬ����� ���ᯥ祭��, �� �����.


    �������୮��
    -------------

����讥 ᯠᨡ�:
- ᮧ��⥫� HPT - �� 㤮��� � ����� ����
- ���ࠬ �몠 Perl - �� 㭨���ᠫ쭮� �।�⢮ ��� ������� ������� :)
- ���� ��⨭��� - �� ���� � FTrack
- �ᥬ ��訬 䨤�譨��� - �� �, �� �� ����.


    ������� ������᪮� ���ᨨ readme
    ---------------------------------

Igor Zakharoff (2:5030/290.36)


    ����, ����!
    ---------------

����: Andrew Sagulin (���३ ���㫨�)
FIDO:  2:6037/1.28
e-mail: [email protected]
ICQ: 128724384