1. protect against PC41s with field[3] == field[2]
[spider.git] / html / adminmanual-2.html
index 62a7471a2086f042eaf1cb76bf885f458e4e6092..b28822c1fb083c59afb49ff45cf8c04a13c0cef4 100644 (file)
@@ -2,7 +2,7 @@
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>The DXSpider Installation and Administration Manual : Quick installation guide</TITLE>
+ <TITLE>The DXSpider Administration Manual v1.48: Other filters</TITLE>
  <LINK HREF="adminmanual-3.html" REL=next>
  <LINK HREF="adminmanual-1.html" REL=previous>
  <LINK HREF="adminmanual.html#toc2" REL=contents>
 <A HREF="adminmanual-1.html">Previous</A>
 <A HREF="adminmanual.html#toc2">Contents</A>
 <HR>
-<H2><A NAME="s2">2. Quick installation guide</A></H2>
+<H2><A NAME="s2">2. Other filters</A></H2>
 
-<P>This section is designed for experienced Spider sysops who want to install
-Spider from scratch.  It is simply a check list of things that need to be
-done without any explanations.  The name in brackets at the end of each line
-is the user that should be doing that process.
+<H2><A NAME="ss2.1">2.1 Filtering Mail</A>
+</H2>
+
+<P>In the /spider/msg directory you will find a file called badmsg.pl.issue.  Rename
+this to badmsg.pl and edit the file.  The original looks something like this ....
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+
+# the list of regexes for messages that we won't store having
+# received them (bear in mind that we must receive them fully before
+# we can bin them)
+
+
+# The format of each line is as follows
+
+#     type      source             pattern 
+#     P/B/F     T/F/O/S            regex  
+
+# type: P - private, B - bulletin (msg), F - file (ak1a bull)
+# source: T - to field, F - from field,  O - origin, S - subject 
+# pattern: a perl regex on the field requested
+
+# Currently only type B and P msgs are affected by this code.
+# 
+# The list is read from the top down, the first pattern that matches
+# causes the action to be taken.
+
+# The pattern can be undef or 0 in which case it will always be selected
+# for the action specified
+
+
+
+package DXMsg;
+
+@badmsg = (
+'B',    'T',    'SALE', 
+'B',    'T',    'WANTED',
+'B',    'S',    'WANTED',
+'B',    'S',    'SALE', 
+'B',    'S',    'WTB',
+'B',    'S',    'WTS',
+'B',    'T',    'FS',
+);
+</PRE>
+</CODE></BLOCKQUOTE>
 <P>
-<UL>
-<LI>Login as root</LI>
-<LI>Get the additional CPAN modules and install them (root)</LI>
-<LI>Create the "sysop" user and set a password (root)</LI>
-<LI>Put the Spider tarball in &nbsp;sysop and untar it (root)</LI>
-<LI>ln -s &nbsp;sysop/spider /spider (root)</LI>
-<LI>groupadd -g 251 spider (root)</LI>
-<LI>Add any more users you need to the group entry in /etc/group (root)</LI>
-<LI>Set the permissions on the spider tree (root)</LI>
-<LI>Fix permissions on ax25_call and netrom_call (root)</LI>
-<LI>Login as the sysop user</LI>
-<LI>cd to /spider (sysop)</LI>
-<LI>mkdir local (sysop)</LI>
-<LI>mkdir local_cmd (sysop)</LI>
-<LI>cp perl/DXVars.pm.issue local/DXVars.pm (sysop)</LI>
-<LI>cd to /spider/local and edit DXVars to set your details (sysop)</LI>
-<LI>cd ../perl (sysop)</LI>
-<LI>./create_sysop.pl (sysop)</LI>
-<LI>./cluster.pl (sysop)</LI>
-</UL>
-<P>Spider should now be running and you should be able to login using the
-client program.
+<P>I think this is fairly self explanatory.  It is simply a list of subject 
+headers that we do not want to pass on to either the users of the cluster or 
+the other cluster nodes that we are linked to.  This is usually because of 
+rules and regulations pertaining to items for sale etc in a particular country.
+<P>
+<H2><A NAME="ss2.2">2.2 Filtering DX callouts (Depricated)</A>
+</H2>
+
+<P><B><I>From version 1.47, this method is replaced by the command set/baddx</I></B>
+<P>
+<P>In the same way as mail, there are some types of spot we do not wish to pass on 
+to users or linked cluster nodes.  In the /spider/data directory you will find 
+a file called baddx.pl.issue.  Rename this to baddx.pl and edit the file.  The
+original looks like this ....
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+
+# the list of dx spot addresses that we don't store and don't pass on
+
+
+package DXProt;
+
+@baddx = qw 
+
+ FROG 
+ SALE
+ FORSALE
+ WANTED
+ P1RATE
+ PIRATE
+ TEST
+ DXTEST
+ NIL
+ NOCALL 
+);
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
+<P>Again, this is simply a list of names we do not want to see in the spotted 
+field of a DX callout.
+<P>
+<P>
+<H2><A NAME="ss2.3">2.3 Filtering words from text fields in Announce, Talk and DX spots</A>
+</H2>
+
+<P>Create a file in /spider/data called <EM>badwords</EM>.  The format is quite
+simple.  Lines beginning with # are ignored so comments can be added.  An
+example file is below ...
 <P>
-<UL>
-<LI>Login as root</LI>
-<LI>Enter the correct line in ax25d.conf (root)</LI>
-<LI>Enter the correct line in /etc/services (root)</LI>
-<LI>Enter the correct line in /etc/inetd.conf (root)</LI>
-<LI>killall -HUP inetd (root)</LI>
-</UL>
-<P>Spider should now be able to accept logins via telnet, netrom and ax25.
+<BLOCKQUOTE><CODE>
+<PRE>
+# Below is a list of words we do not wish to see on the cluster
+grunge grunged grunging
+splodge splodger splodging
+grince
+fluffle
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>Multiple words can be used on the same line as shown.  Obviously these
+are just examples :-)
 <P>
-<UL>
-<LI>Login as sysop</LI>
-<LI>Start the cluster (sysop)</LI>
-<LI>set/node and type for links (sysop)</LI>
-<LI>Write any connect scripts (sysop)</LI>
-<LI>Edit /spider/crontab as required (sysop)</LI>
-<LI>Edit any other files as necessary (sysop)</LI>
-<LI>Set filters, hops and forwarding files (sysop)</LI>
-<LI>Login as root</LI>
-<LI>Enter the correct line in /etc/inittab (root)</LI>
-</UL>
+<P>You can reload the file from the cluster prompt as sysop with load/badwords.
 <P>
 <HR>
 <A HREF="adminmanual-3.html">Next</A>