add CTY-3304
[spider.git] / html / adminmanual_en-2.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
5  <TITLE>The DXSpider Administration Manual v1.51: Other filters</TITLE>
6  <LINK HREF="adminmanual_en-3.html" REL=next>
7  <LINK HREF="adminmanual_en-1.html" REL=previous>
8  <LINK HREF="adminmanual_en.html#toc2" REL=contents>
9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
10 </HEAD>
11 <BODY>
12 <A HREF="adminmanual_en-3.html">Next</A>
13 <A HREF="adminmanual_en-1.html">Previous</A>
14 <A HREF="adminmanual_en.html#toc2">Contents</A>
15 <HR>
16 <H2><A NAME="s2">2.</A> <A HREF="adminmanual_en.html#toc2">Other filters</A></H2>
17
18 <H2><A NAME="ss2.1">2.1</A> <A HREF="adminmanual_en.html#toc2.1">Filtering Mail</A>
19 </H2>
20
21 <P>In the /spider/msg directory you will find a file called badmsg.pl.issue.  Rename
22 this to badmsg.pl and edit the file.  The original looks something like this ....</P>
23 <P>
24 <BLOCKQUOTE><CODE>
25 <PRE>
26
27 # the list of regexes for messages that we won't store having
28 # received them (bear in mind that we must receive them fully before
29 # we can bin them)
30
31
32 # The format of each line is as follows
33
34 #     type      source             pattern 
35 #     P/B/F     T/F/O/S            regex  
36
37 # type: P - private, B - bulletin (msg), F - file (ak1a bull)
38 # source: T - to field, F - from field,  O - origin, S - subject 
39 # pattern: a perl regex on the field requested
40
41 # Currently only type B and P msgs are affected by this code.
42
43 # The list is read from the top down, the first pattern that matches
44 # causes the action to be taken.
45
46 # The pattern can be undef or 0 in which case it will always be selected
47 # for the action specified
48
49
50
51 package DXMsg;
52
53 @badmsg = (
54 'B',    'T',    'SALE', 
55 'B',    'T',    'WANTED',
56 'B',    'S',    'WANTED',
57 'B',    'S',    'SALE', 
58 'B',    'S',    'WTB',
59 'B',    'S',    'WTS',
60 'B',    'T',    'FS',
61 );
62 </PRE>
63 </CODE></BLOCKQUOTE>
64 </P>
65
66 <P>I think this is fairly self explanatory.  It is simply a list of subject 
67 headers that we do not want to pass on to either the users of the cluster or 
68 the other cluster nodes that we are linked to.  This is usually because of 
69 rules and regulations pertaining to items for sale etc in a particular country.</P>
70
71
72 <H2><A NAME="ss2.2">2.2</A> <A HREF="adminmanual_en.html#toc2.2">Filtering words from text fields in Announce, Talk and DX spots</A>
73 </H2>
74
75 <P>From version 1.48 onwards the interface to this has changed. You can now
76 use the commands <EM>set/badword</EM> to add words that you are not prepared
77 to see on the cluster, <EM>unset/badword</EM> to allow that word again and 
78 <EM>show/badword</EM> to list the words that you have set.</P>
79
80 <P>If you have a previous <EM>/spider/data/badwords</EM>, the first time you start
81 the node, it will read and convert this file to the new commands. The old style
82 file will then be removed.</P>
83
84 <H2><A NAME="ss2.3">2.3</A> <A HREF="adminmanual_en.html#toc2.3">Stopping (possibly bad) DX Spots from Nodes or Spotters</A>
85 </H2>
86
87 <P> 
88 There are a number of commands that control whether a spot progresses
89 any further by regarding it as "bad" in some way.</P>
90
91 <P>A DX Spot has a number of fields which can be checked to see whether they
92 contain "bad" values, they are: the DX callsign itself, the Spotter and
93 the Originating Node.</P>
94
95 <P>There are a set of commands which allow the sysop to control whether a
96 spot continues:-</P>
97 <P>
98 <BLOCKQUOTE><CODE>
99 <PRE>
100 set/baddx
101 set/badspotter
102 set/badnode
103 </PRE>
104 </CODE></BLOCKQUOTE>
105 </P>
106 <P>These work in the same as the <EM>set/badword</EM> command, you can add
107 any words or callsigns or whatever to the appropriate database. For
108 example, to stop a spot from a particular node you do:</P>
109 <P>
110 <BLOCKQUOTE><CODE>
111 <PRE>
112 set/badnode gb7djk gb7dxc
113 </PRE>
114 </CODE></BLOCKQUOTE>
115 </P>
116 <P>a bad spotter:</P>
117 <P>
118 <BLOCKQUOTE><CODE>
119 <PRE>
120 set/badspotter b0mb p1rat nocall
121 </PRE>
122 </CODE></BLOCKQUOTE>
123 </P>
124 <P>and some bad dx:</P>
125 <P>
126 <BLOCKQUOTE><CODE>
127 <PRE>
128 set/baddx video wsjt
129 </PRE>
130 </CODE></BLOCKQUOTE>
131 </P>
132 <P>You can remove a word using the appropriate unset command
133 (<EM>unset/baddx, unset/badspotter, unset/badnode</EM>) or list them
134 using one of <EM>show/baddx, show/badspotter</EM> and
135 <EM>show/badnode</EM>.</P>
136
137 <HR>
138 <A HREF="adminmanual_en-3.html">Next</A>
139 <A HREF="adminmanual_en-1.html">Previous</A>
140 <A HREF="adminmanual_en.html#toc2">Contents</A>
141 </BODY>
142 </HTML>