update the docs on filtering
authorminima <minima>
Sat, 8 Sep 2001 22:43:51 +0000 (22:43 +0000)
committerminima <minima>
Sat, 8 Sep 2001 22:43:51 +0000 (22:43 +0000)
Changes
cmd/set/var.pl
cmd/show/var.pl
html/adminmanual-1.html
html/adminmanual.html
sgml/adminmanual.sgml
txt/adminmanual.txt

diff --git a/Changes b/Changes
index aa2ffe23b7c2574af213295a595c655c34256dbb..13ef5838ed96ad88790aac928f2b433b4bf8f2af 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,3 +1,5 @@
+08Sep01=======================================================================
+1. Update the sgml docs on filtering a bit.
 06Sep01=======================================================================
 1. prevent nodes appearing as users from incoming PC16s
 2. Change ping averaging to be like TCP and become a smoothed RTT.
index 1870d1a699b42a903c7f4dc19801a395225a337b..d2ea1d1380ae4875e25d6c5321919febf7f0c314 100644 (file)
@@ -10,7 +10,7 @@
 
 my ($self, $line) = @_;
 return (1, $self->msg('e5')) if $self->priv < 9 || $self->remotecmd;
-my ($var, $rest) = split /\s+/, $line, 2;
+my ($var, $rest) = split /=|\s+/, $line, 2;
 $rest =~ s/^=\s*//;
 Log('DXCommand', $self->call . " set $var = $rest" );
 eval "$var = $rest";
index b09193c29bc306f71dffd5822de649a5f77cf409..3f0715713a4f64c20d71ea209dd527a16731259c 100644 (file)
@@ -15,9 +15,9 @@ my $f;
 my @out;
 
 foreach $f (@f) {
-    print "\$f = $f\n";
+#    print "\$f = $f\n";
        my $var = eval "$f";
-       if ($var) {
+       if (defined $var) {
         my $dd = Data::Dumper->new([ $var ], [ "$f" ]);
         $dd->Indent(1);
                $dd->Quotekeys(0);
index 78a3afcce12c625dae012178036e7a2516ed98be..34f3fb0ccba805b3ea44418ccd7ece9b3d26d964 100644 (file)
@@ -31,30 +31,45 @@ these do not have any protection from loops.  Certainly AK1A does not
 handle loops well at all.  It is therefore necessary to have some form 
 of protection for these nodes.
 <P>
-<P>This is achieved by using filtering on a route basis.  There is a
-default setting to help to protect the network, especially useful for new
-and inexperienced SysOps.  The idea is simple.  When Spider is started
-for the first time and a connection is made to or from another node, 
-the default is to only send the nodes you already have that are in your
-own zone.  For example, in the UK the default setting would be to send
-only UK nodes to any connection.  This can be filtered further (down to
-a single node if needed) or expanded as required.
-<P>
+<P>In fact DXSpider has had a simple system for some time which is called
+<I>isolation</I>. This is similar to what, in other systems such as 
+<B>clx</B>, is called <I>passive mode</I>. A more detailed explanation
+of <I>isolation</I> is given further below. This system is still available
+and, for simple networks, is probably all that you need.
+<P>
+<P>The new functionality introduced in version 1.48 is filtering the node
+and user protocol frames on a "per interface" basis. We call this
+<I>route filtering</I>. This is used <B>instead of</B>
+<I>isolation</I>. 
+<P>
+<P>What this really means is that you can control more or less completely
+which PC protocol frames, to do with user and node management, pass to
+each of your partner nodes. You can also limit what comes into your
+node from your partners. You can even control the settings that your
+partner node has for the routing information that it sends to you
+(using the <I>rcmd</I> command).
 <P>
 <H2><A NAME="ss1.2">1.2 Route Filters</A>
 </H2>
 
-<P>As mentioned in the introduction, a default setting exists.  If this is
-all you want to use then that is fine, you have nothing else to do.
-However, if you want to make any alterations then you need to know
-a bit about filters.
-<P>
-<P>It is possible to reset the default setting for node connections should
-you wish to do so, however this can be dangerous to the network unless
-you have some experience in how all this works.... be careful!  It is
-also possible to change settings for one connection only.  You can,
-therefore, have many different filters set dependent on the amount of
-node links you have.
+<P>Initially when route filters were being tested we generated a
+"default" filter.  Unfortunately it quickly became apparent that this
+might suit the UK cluster network but didn't really fit anybody else.
+However using a default filter is an appropriate thing to do. How, is
+explained further on.
+<P>
+<P>The first thing that you must do is determine whether you need to do route filtering <B>at all</B>. If you are a "normal" node with two or three partners
+and you arranged in an "official" non-looping tree type network, then <B>you do 
+not need to do route filtering</B> and you will feel a lot better for not 
+getting involved. If you are successfully using <I>isolation</I> then you
+also probably don't need to use route filtering.
+<P>
+<P>You will only require this functionality if you are
+"well-connected". What that means is that you are connected to several
+different parts of (say) the EU cluster and, at the same time, also
+connected to two or three places in the US which, in turn are
+connected back to the EU. This is called a "loop" and if you are
+seriously looped then you need filtering.
 <P>
 <P>I should at this stage give a little bit of background on filters.  All
 the filters in Spider work in basically the same way.  You can either
@@ -62,23 +77,31 @@ accept or reject various options in order to create the filter rules
 you wish to achieve.  Some filters are user settable, others can only
 be altered by the sysop.  Route filtering can only be done by the sysop.
 <P>
-<H2><A NAME="ss1.3">1.3 The default_node filter</A>
+<P> 
+Anyway, without further discouragement, let me start the process
+of explanation.
+<P>
+<H2><A NAME="ss1.3">1.3 The node_default filter</A>
 </H2>
 
-<P>As discussed previously, a default setting exists that only sends nodes
-from your own zone.  This can be overridden by using the default_node
-filter option like this ...
+<P>All normal systems should have a default routing filter and it should
+usually be set to send only the normal, unlooped, view of your
+"national" network.  Here in the UK that means nodes from the UK and
+Eire, in EU it is more complex as the networks there grew up in a more
+intertwined way.
+<P>
+<P> 
+The generic commands are:-
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-reject/route default_node &lt;filter_option&gt;
+reject/route node_default &lt;filter_option&gt;
 
 or
 
-accept/route default_node &lt;filter_option&gt;
+accept/route node_default &lt;filter_option&gt;
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>
 <P>where filter_option is one of the following ...
 <P>
 <BLOCKQUOTE><CODE>
@@ -87,16 +110,67 @@ call &lt;prefixes&gt;
 call_dxcc &lt;numbers&gt;
 call_itu &lt;numbers&gt;
 call_zone &lt;numbers&gt;
-origin &lt;prefixes&gt;
-origin_dxcc &lt;numbers&gt;
-origin_itu &lt;numbers&gt;
-origin_zone &lt;numbers&gt;
+channel &lt;prefixes&gt;
+channel_dxcc &lt;numbers&gt;
+channel_itu &lt;numbers&gt;
+channel_zone &lt;numbers&gt;
 </PRE>
 </CODE></BLOCKQUOTE>
-<P>
 <P>Please be careful if you alter this setting, it will affect 
 <B><I>ALL</I></B> your links!
 <P>
+<P>For the default routing filter then you have two real choices: either
+a "national" view or the "safe" option of only your own
+callsign. Examples of each (for my node: GB7DJK) are:-
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+acc/route node_default call_dxcc 61,38
+acc/route node_default call gb7djk
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>GB7DJK uses the first of these. The DXCC countries can be obtained from the 
+<I>show/prefix</I> command.
+<P>
+<P>The example filters shown control <I>output</I> <B>TO</B> all your
+partner nodes unless they have a specific filter applied to them (see
+next section).
+<P>
+<P>It is also possible to control the <I>incoming</I> routing
+information that you are prepared to accept <B>FROM</B> your partner
+nodes. The reason this is necessary is to make sure that stuff like
+mail, pings and similar commands a) go down the correct links and b)
+don't loop around excessively. Again using GB7DJK as an example a typical
+default input filter would be something like:
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+rej/route node_default input call_dxcc 61,38 and not channel_dxcc 61,38
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>What this does is accept node and user information for our national
+network from nodes that are in our national network, but rejects such
+information from anyone else. Although it doesn't explicitly say so,
+by implication, any other node information (not from the UK and Eire)
+is accepted.
+<P>
+<P>As I imagine it will take a little while to get one's head around all of this you
+can study the effect of any rules that you try by watching the debug output
+after having done:-
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+set/debug filter
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>After you have got tired of that, to put it back the way it was:-
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+unset/debug filter
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>
 <H2><A NAME="ss1.4">1.4 General route filtering</A>
 </H2>
 
@@ -113,31 +187,41 @@ accept/route &lt;node_call&gt; &lt;filter_option&gt;
 </PRE>
 </CODE></BLOCKQUOTE>
 <P>
-<P>where filter_option is one of the following ...
+<P>Here are some examples of route filters ...
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-call &lt;prefixes&gt;
-call_dxcc &lt;numbers&gt;
-call_itu &lt;numbers&gt;
-call_zone &lt;numbers&gt;
-origin &lt;prefixes&gt;
-origin_dxcc &lt;numbers&gt;
-origin_itu &lt;numbers&gt;
-origin_zone &lt;numbers&gt;
+rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
+rej/route all     (equiv to [very] restricted mode)
+acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
+acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>In practice you will either be opening the default filter out for a
+partner by defining a specific filter for that callsign:-
 <P>
-<P>Here are some examples of route filters ...
+<BLOCKQUOTE><CODE>
+<PRE>
+acc/route gb7baa all
+acc/route gb7baa input all
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>or restricting it quite a lot, in fact making it very nearly like an <I>isolated</I> node, like this:-
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
-rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
-rej/route all     (equiv to [very] restricted mode)
-acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
-acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
+acc/route pi4ehv-8 call gb7djk
+rej/route pi4ehv-8 input call_dxcc 61,38 
 </PRE>
 </CODE></BLOCKQUOTE>
+<P>This last example takes everything except UK and Eire from PI4EHV-8
+but only sends him my local configuration (just a PC19 for GB7DJK and
+PC16s for my local users).
+<P>
+<P>It is possible to do <B>much</B> more complex rules, there are up to 10
+accept/reject pairs per callsign per filter. For more information see the 
+next section. 
+<P>
 <P>
 <H2><A NAME="ss1.5">1.5 General filter rules</A>
 </H2>
@@ -153,7 +237,7 @@ are <EM>accept</EM>, <EM>reject</EM> and <EM>clear</EM>.  First we will look
 generally at filtering. There are a number of things you can filter in the 
 DXSpider system. They all use the same general mechanism.
 <P>
-<P>In general terms you can create a 'reject' or an 'accept' filter which can have 
+<P>In general terms you can create a "reject" or an "accept" filter which can have 
 up to 10 lines in it. You do this using, for example ... 
 <P>
 <BLOCKQUOTE><CODE>
index f986c0d8cda3cbd1b3e6171e729d7b7985d7db22..0e84bafb0e68472c98328c71df68227b838a35da 100644 (file)
@@ -25,7 +25,7 @@ Contents
 <UL>
 <LI><A HREF="adminmanual-1.html#ss1.1">1.1 Introduction</A>
 <LI><A HREF="adminmanual-1.html#ss1.2">1.2 Route Filters</A>
-<LI><A HREF="adminmanual-1.html#ss1.3">1.3 The default_node filter</A>
+<LI><A HREF="adminmanual-1.html#ss1.3">1.3 The node_default filter</A>
 <LI><A HREF="adminmanual-1.html#ss1.4">1.4 General route filtering</A>
 <LI><A HREF="adminmanual-1.html#ss1.5">1.5 General filter rules</A>
 <LI><A HREF="adminmanual-1.html#ss1.6">1.6 Types of filter</A>
index cc6ba498f7cdbbc2030356d223cf5dcfbc2eb031..d91dab680b17f3f7de83b9d1201f4e6f61e257b0 100644 (file)
@@ -36,31 +36,49 @@ handle loops well at all.  It is therefore necessary to have some form
 of protection for these nodes.
 
 <P>
-This is achieved by using filtering on a route basis.  There is a
-default setting to help to protect the network, especially useful for new
-and inexperienced SysOps.  The idea is simple.  When Spider is started
-for the first time and a connection is made to or from another node, 
-the default is to only send the nodes you already have that are in your
-own zone.  For example, in the UK the default setting would be to send
-only UK nodes to any connection.  This can be filtered further (down to
-a single node if needed) or expanded as required.
-
+In fact DXSpider has had a simple system for some time which is called
+<it>isolation</it>. This is similar to what, in other systems such as 
+<bf>clx</bf>, is called <it>passive mode</it>. A more detailed explanation
+of <it>isolation</it> is given further below. This system is still available
+and, for simple networks, is probably all that you need.
+
+<P>
+The new functionality introduced in version 1.48 is filtering the node
+and user protocol frames on a "per interface" basis. We call this
+<it>route filtering</it>. This is used <bf>instead of</bf>
+<it>isolation</it>. 
+
+<p>
+What this really means is that you can control more or less completely
+which PC protocol frames, to do with user and node management, pass to
+each of your partner nodes. You can also limit what comes into your
+node from your partners. You can even control the settings that your
+partner node has for the routing information that it sends to you
+(using the <it>rcmd</it> command).
 
 <sect1>Route Filters
 
-<P>
-As mentioned in the introduction, a default setting exists.  If this is
-all you want to use then that is fine, you have nothing else to do.
-However, if you want to make any alterations then you need to know
-a bit about filters.
-
-<P>
-It is possible to reset the default setting for node connections should
-you wish to do so, however this can be dangerous to the network unless
-you have some experience in how all this works.... be careful!  It is
-also possible to change settings for one connection only.  You can,
-therefore, have many different filters set dependent on the amount of
-node links you have.
+<p>
+Initially when route filters were being tested we generated a
+"default" filter.  Unfortunately it quickly became apparent that this
+might suit the UK cluster network but didn't really fit anybody else.
+However using a default filter is an appropriate thing to do. How, is
+explained further on.
+
+<p>
+The first thing that you must do is determine whether you need to do route filtering <bf>at all</bf>. If you are a "normal" node with two or three partners
+and you arranged in an "official" non-looping tree type network, then <bf>you do 
+not need to do route filtering</bf> and you will feel a lot better for not 
+getting involved. If you are successfully using <it>isolation</it> then you
+also probably don't need to use route filtering.
+
+<p>
+You will only require this functionality if you are
+"well-connected". What that means is that you are connected to several
+different parts of (say) the EU cluster and, at the same time, also
+connected to two or three places in the US which, in turn are
+connected back to the EU. This is called a "loop" and if you are
+seriously looped then you need filtering.
 
 <P>
 I should at this stage give a little bit of background on filters.  All
@@ -69,22 +87,30 @@ accept or reject various options in order to create the filter rules
 you wish to achieve.  Some filters are user settable, others can only
 be altered by the sysop.  Route filtering can only be done by the sysop.
 
-<sect1>The default_node filter
+<P> 
+Anyway, without further discouragement, let me start the process
+of explanation.
+
+<sect1>The node_default filter
 
 <P>
-As discussed previously, a default setting exists that only sends nodes
-from your own zone.  This can be overridden by using the default_node
-filter option like this ...
+All normal systems should have a default routing filter and it should
+usually be set to send only the normal, unlooped, view of your
+"national" network.  Here in the UK that means nodes from the UK and
+Eire, in EU it is more complex as the networks there grew up in a more
+intertwined way.
+
+<p> 
+The generic commands are:-
 
 <tscreen><verb>
-reject/route default_node &lt;filter_option&gt;
+reject/route node_default &lt;filter_option&gt;
 
 or
 
-accept/route default_node &lt;filter_option&gt;
+accept/route node_default &lt;filter_option&gt;
 </verb></tscreen>
 
-<P>
 where filter_option is one of the following ...
 
 <tscreen><verb>
@@ -92,16 +118,66 @@ call &lt;prefixes&gt;
 call_dxcc &lt;numbers&gt;
 call_itu &lt;numbers&gt;
 call_zone &lt;numbers&gt;
-origin &lt;prefixes&gt;
-origin_dxcc &lt;numbers&gt;
-origin_itu &lt;numbers&gt;
-origin_zone &lt;numbers&gt;
+channel &lt;prefixes&gt;
+channel_dxcc &lt;numbers&gt;
+channel_itu &lt;numbers&gt;
+channel_zone &lt;numbers&gt;
 </verb></tscreen>
 
-<P>
 Please be careful if you alter this setting, it will affect 
 <bf><it>ALL</it></bf> your links!
 
+<p>
+For the default routing filter then you have two real choices: either
+a "national" view or the "safe" option of only your own
+callsign. Examples of each (for my node: GB7DJK) are:-
+
+<tscreen><verb>
+acc/route node_default call_dxcc 61,38
+acc/route node_default call gb7djk
+</verb></tscreen>
+
+GB7DJK uses the first of these. The DXCC countries can be obtained from the 
+<it>show/prefix</it> command.
+
+<p>
+The example filters shown control <it>output</it> <bf>TO</bf> all your
+partner nodes unless they have a specific filter applied to them (see
+next section).
+
+<p>
+It is also possible to control the <it>incoming</it> routing
+information that you are prepared to accept <bf>FROM</bf> your partner
+nodes. The reason this is necessary is to make sure that stuff like
+mail, pings and similar commands a) go down the correct links and b)
+don't loop around excessively. Again using GB7DJK as an example a typical
+default input filter would be something like:
+
+<tscreen><verb>
+rej/route node_default input call_dxcc 61,38 and not channel_dxcc 61,38
+</verb></tscreen>
+
+What this does is accept node and user information for our national
+network from nodes that are in our national network, but rejects such
+information from anyone else. Although it doesn't explicitly say so,
+by implication, any other node information (not from the UK and Eire)
+is accepted.
+
+<p>
+As I imagine it will take a little while to get one's head around all of this you
+can study the effect of any rules that you try by watching the debug output
+after having done:-
+
+<tscreen><verb>
+set/debug filter
+</verb></tscreen>
+
+After you have got tired of that, to put it back the way it was:-
+
+<tscreen><verb>
+unset/debug filter
+</verb></tscreen>
+
 <sect1>General route filtering
 
 <P>
@@ -116,20 +192,6 @@ or
 accept/route &lt;node_call&gt; &lt;filter_option&gt; 
 </verb></tscreen>
 
-<P>
-where filter_option is one of the following ...
-
-<tscreen><verb>
-call &lt;prefixes&gt;
-call_dxcc &lt;numbers&gt;
-call_itu &lt;numbers&gt;
-call_zone &lt;numbers&gt;
-origin &lt;prefixes&gt;
-origin_dxcc &lt;numbers&gt;
-origin_itu &lt;numbers&gt;
-origin_zone &lt;numbers&gt;
-</verb></tscreen>
-
 <P>
 Here are some examples of route filters ...
 
@@ -140,6 +202,31 @@ acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
 acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
 </verb></tscreen>
 
+In practice you will either be opening the default filter out for a
+partner by defining a specific filter for that callsign:-
+<tscreen><verb>
+acc/route gb7baa all
+acc/route gb7baa input all
+</verb></tscreen>
+
+or restricting it quite a lot, in fact making it very nearly like an <it>isolated</it> node, like this:-
+
+<tscreen><verb>
+acc/route pi4ehv-8 call gb7djk
+rej/route pi4ehv-8 input call_dxcc 61,38 
+</verb></tscreen>
+
+This last example takes everything except UK and Eire from PI4EHV-8
+but only sends him my local configuration (just a PC19 for GB7DJK and
+PC16s for my local users).
+
+<p>
+It is possible to do <bf>much</bf> more complex rules, there are up to 10
+accept/reject pairs per callsign per filter. For more information see the 
+next section. 
+
+
 <sect1>General filter rules
 
 <P>
@@ -156,7 +243,7 @@ generally at filtering. There are a number of things you can filter in the
 DXSpider system. They all use the same general mechanism.
 
 <P>
-In general terms you can create a 'reject' or an 'accept' filter which can have 
+In general terms you can create a "reject" or an "accept" filter which can have 
 up to 10 lines in it. You do this using, for example ... 
 
 <tscreen><verb> 
index 0a9b21d60fc905af4107dae8de7c9d3e0a8b1c1c..21590b7ab0e5c1a53e82148b4a5b93b490731c90 100644 (file)
@@ -68,7 +68,7 @@
 
      1.1 Introduction
      1.2 Route Filters
-     1.3 The default_node filter
+     1.3 The node_default filter
      1.4 General route filtering
      1.5 General filter rules
      1.6 Types of filter
   of protection for these nodes.
 
 
-  This is achieved by using filtering on a route basis.  There is a
-  default setting to help to protect the network, especially useful for
-  new and inexperienced SysOps.  The idea is simple.  When Spider is
-  started for the first time and a connection is made to or from another
-  node, the default is to only send the nodes you already have that are
-  in your own zone.  For example, in the UK the default setting would be
-  to send only UK nodes to any connection.  This can be filtered further
-  (down to a single node if needed) or expanded as required.
+  In fact DXSpider has had a simple system for some time which is called
+  isolation. This is similar to what, in other systems such as clx, is
+  called passive mode. A more detailed explanation of isolation is given
+  further below. This system is still available and, for simple
+  networks, is probably all that you need.
 
 
+  The new functionality introduced in version 1.48 is filtering the node
+  and user protocol frames on a "per interface" basis. We call this
+  route filtering. This is used instead of isolation.
+
+
+  What this really means is that you can control more or less completely
+  which PC protocol frames, to do with user and node management, pass to
+  each of your partner nodes. You can also limit what comes into your
+  node from your partners. You can even control the settings that your
+  partner node has for the routing information that it sends to you
+  (using the rcmd command).
+
 
   1.2.  Route Filters
 
-  As mentioned in the introduction, a default setting exists.  If this
-  is all you want to use then that is fine, you have nothing else to do.
-  However, if you want to make any alterations then you need to know a
-  bit about filters.
+  Initially when route filters were being tested we generated a
+  "default" filter.  Unfortunately it quickly became apparent that this
+  might suit the UK cluster network but didn't really fit anybody else.
+  However using a default filter is an appropriate thing to do. How, is
+  explained further on.
 
 
-  It is possible to reset the default setting for node connections
-  should you wish to do so, however this can be dangerous to the network
-  unless you have some experience in how all this works.... be careful!
-  It is also possible to change settings for one connection only.  You
-  can, therefore, have many different filters set dependent on the
-  amount of node links you have.
+  The first thing that you must do is determine whether you need to do
+  route filtering at all. If you are a "normal" node with two or three
+  partners and you arranged in an "official" non-looping tree type
+  network, then you do not need to do route filtering and you will feel
+  a lot better for not getting involved. If you are successfully using
+  isolation then you also probably don't need to use route filtering.
 
 
+  You will only require this functionality if you are "well-connected".
+  What that means is that you are connected to several different parts
+  of (say) the EU cluster and, at the same time, also connected to two
+  or three places in the US which, in turn are connected back to the EU.
+  This is called a "loop" and if you are seriously looped then you need
+  filtering.
   I should at this stage give a little bit of background on filters.
   All the filters in Spider work in basically the same way.  You can
   either accept or reject various options in order to create the filter
   sysop.
 
 
-  1.3.  The default_node filter
 
-  As discussed previously, a default setting exists that only sends
-  nodes from your own zone.  This can be overridden by using the
-  default_node filter option like this ...
+  Anyway, without further discouragement, let me start the process of
+  explanation.
 
 
+  1.3.  The node_default filter
 
-  reject/route default_node <filter_option>
+  All normal systems should have a default routing filter and it should
+  usually be set to send only the normal, unlooped, view of your
+  "national" network.  Here in the UK that means nodes from the UK and
+  Eire, in EU it is more complex as the networks there grew up in a more
+  intertwined way.
+
+
+
+  The generic commands are:-
 
-  or
 
-  accept/route default_node <filter_option>
 
+       reject/route node_default <filter_option>
+
+       or
+
+       accept/route node_default <filter_option>
 
 
 
        call_dxcc <numbers>
        call_itu <numbers>
        call_zone <numbers>
-       origin <prefixes>
-       origin_dxcc <numbers>
-       origin_itu <numbers>
-       origin_zone <numbers>
-
+       channel <prefixes>
+       channel_dxcc <numbers>
+       channel_itu <numbers>
+       channel_zone <numbers>
 
 
 
   links!
 
 
+  For the default routing filter then you have two real choices: either
+  a "national" view or the "safe" option of only your own callsign.
+  Examples of each (for my node: GB7DJK) are:-
+
+
+
+       acc/route node_default call_dxcc 61,38
+       acc/route node_default call gb7djk
+
+
+  GB7DJK uses the first of these. The DXCC countries can be obtained
+  from the show/prefix command.
+
+
+  The example filters shown control output TO all your partner nodes
+  unless they have a specific filter applied to them (see next section).
+
+
+  It is also possible to control the incoming routing information that
+  you are prepared to accept FROM your partner nodes. The reason this is
+  necessary is to make sure that stuff like mail, pings and similar
+  commands a) go down the correct links and b) don't loop around
+  excessively. Again using GB7DJK as an example a typical default input
+  filter would be something like:
+
+
+
+       rej/route node_default input call_dxcc 61,38 and not channel_dxcc 61,38
+
+
+
+
+  What this does is accept node and user information for our national
+  network from nodes that are in our national network, but rejects such
+  information from anyone else. Although it doesn't explicitly say so,
+  by implication, any other node information (not from the UK and Eire)
+  is accepted.
+
+
+  As I imagine it will take a little while to get one's head around all
+  of this you can study the effect of any rules that you try by watching
+  the debug output after having done:-
+
+
+
+       set/debug filter
+
+
+
+
+  After you have got tired of that, to put it back the way it was:-
+
+
+
+       unset/debug filter
+
+
+
+
+
   1.4.  General route filtering
 
   Exactly the same rules apply for general route filtering.  You would
 
 
 
+  Here are some examples of route filters ...
 
-  where filter_option is one of the following ...
 
 
+       rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
+       rej/route all     (equiv to [very] restricted mode)
+       acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
+       acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
 
-       call <prefixes>
-       call_dxcc <numbers>
-       call_itu <numbers>
-       call_zone <numbers>
-       origin <prefixes>
-       origin_dxcc <numbers>
-       origin_itu <numbers>
-       origin_zone <numbers>
 
 
 
+  In practice you will either be opening the default filter out for a
+  partner by defining a specific filter for that callsign:-
 
 
 
-  Here are some examples of route filters ...
+       acc/route gb7baa all
+       acc/route gb7baa input all
 
 
 
-       rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
-       rej/route all     (equiv to [very] restricted mode)
-       acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
-       acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
+
+  or restricting it quite a lot, in fact making it very nearly like an
+  isolated node, like this:-
+
 
 
+       acc/route pi4ehv-8 call gb7djk
+       rej/route pi4ehv-8 input call_dxcc 61,38
+
+
+
+
+  This last example takes everything except UK and Eire from PI4EHV-8
+  but only sends him my local configuration (just a PC19 for GB7DJK and
+  PC16s for my local users).
+
+
+  It is possible to do much more complex rules, there are up to 10
+  accept/reject pairs per callsign per filter. For more information see
+  the next section.
 
 
 
   the DXSpider system. They all use the same general mechanism.
 
 
-  In general terms you can create a 'reject' or an 'accept' filter which
+  In general terms you can create a "reject" or an "accept" filter which
   can have up to 10 lines in it. You do this using, for example ...
 
 
 
-
-       accept/spots .....
-       reject/spots .....
+  accept/spots .....
+  reject/spots .....
 
 
 
 
 
 
-
-  show/filter
+       show/filter
 
 
 
 
   then you will ONLY get VHF spots from or to CQ zones 14, 15 and 16.
 
-
   If you set a reject filter like this ...
 
 
 
 
 
+
   which achieves exactly the same thing. You should choose one or the
   other until you are comfortable with the way it works. You can mix
   them if you wish (actually you can have an accept AND a reject on the
   originated there).  If you did not have the brackets to separate the 2
   sections, then Spider would read it logically from the front and see a
   different expression entirely ...
-
-
-
        (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16
 
 
 
        clear/spots 1
 
+
+
+
   To remove all the filter lines in the spot filter ...
 
 
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
   #
   # hop table construction
   #