]> dxcluster.org Git - spider.git/commitdiff
added client file
authordjk <djk>
Mon, 21 Dec 1998 12:32:06 +0000 (12:32 +0000)
committerdjk <djk>
Mon, 21 Dec 1998 12:32:06 +0000 (12:32 +0000)
html/client.html [new file with mode: 0644]
html/hops.html
html/index.html
html/install.html

diff --git a/html/client.html b/html/client.html
new file mode 100644 (file)
index 0000000..b63ec80
--- /dev/null
@@ -0,0 +1,119 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<html>
+  <head>
+    <title>The Standard Client</title>
+    <title>Connecting to other Clusters</title>
+       <meta name="Keywords" content="DX Cluster, DXSpider, Spider, Packet Cluster, DXCluster, Pavillion Software, AK1A, AX25, AX.25, WWV, Packet Radio, Amateur Radio, Propagation, DX, DXing, G1TLH, GB7TLH, Dirk Koopman, Mailing list, Linux, RedHat, PERL">
+       <meta name="Description" content="Software and systems for realtime digital communications between amateur radio stations for the provision of information on propagation conditions and stations operating">
+       <meta name="Author" content="Dirk Koopman G1TLH">
+  </head>
+
+  <body TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#FFFFFF">
+       <FONT COLOR="#606060"> 
+         <hr>
+         <h2>The Standard Client</h2>
+         <hr>
+       </font>
+       
+       
+       <address><a href="mailto:djk@tobit.co.uk">Dirk Koopman G1TLH</a></address>
+       <p>
+         <!-- Created: Sun Dec 13 20:25:14 GMT 1998 -->
+         <!-- hhmts start -->
+Last modified: Mon Dec 21 12:26:18 GMT 1998
+<!-- hhmts end -->
+
+       <h4>Introduction</h4>
+
+       The standard client program is written in perl and lives in <tt>/spider/perl/client.pl</tt>. 
+       It performs the interface function
+       between the cluster daemon (<tt>/spider/perl/cluster.pl</tt>) and 
+       AX25 or Telnet connections, both incoming and outgoing.
+
+       <h4>client.pl</h4>
+
+       The client itself is a rather rudimentary program which really only deals with 
+       things like line end conventions and noticing when a connection goes away. It is
+       envisaged that at some time in the nearish future this program will be written in
+       C and thus become considerably smaller. But, for the moment and whilst this area
+       is under some development, it will remain in perl for ease of change.
+
+       <P>The client can take up two arguments: a "callsign" and a connection type. 
+
+       <p>The "callsign" can have the following values:-
+       <ol>
+               <p><li>A real callsign (!).
+
+               <P>For incoming connections it is important to make sure that
+               the callsign passed <b>DOES NOT</b> have an SSID (use the %u
+               or %U in <tt>ax25d.conf</tt>). The DXSpider system largely
+               ignores what it regards as 'duplicate' callsigns (and that
+               includes those with SSIDs) except in certain <a
+               href="#special">special</a> cases. 
+
+               <P><li>The name of a <a href="connect.html">connect</a> script.
+
+               <p><li><b>login</b> This will cause a unix like <tt>login:</tt> and
+               <tt>password:</tt> phase to be run. With version 1.13 the password isn't
+               checked unless there is a password recorded in the user file - but you have
+               no means of recording a password! (unless you have created a local <tt>set/password</tt>
+               command - please donate a copy it you have)
+               
+               <p>Also in 1.13 only existing users can enter via this means. This will probably
+                 change, but please discuss this in the <a href="../lists/dxspider-support/index.html">support</a>
+                 mailing list.
+
+       </ol>
+
+       <p>The connection type can be:-
+       <ol>
+               <p><li><b>ax25</b> This tells the client to use ax25 line conventions.
+
+               <p><li><b>telnet</b> This tells the client to use normal unix line conventions.
+
+               <p><li><b>connect</b> Start an outgoing <a href="connect.html">connect</a> script.
+               Use the line conventions in that script.
+       </ol>
+
+       <p>The connection type can be missing in which case the default is unix line conventions.
+
+       <p>If both the callsign and the connection are missing then it is
+       assumed that the client is the sysop and uses the callsign set in
+       your local copy of <a href="install.html#dxvar">DXVars.pm</a>.
+
+       <h4>Considerations</h4>
+
+       <a name="special"></a>As mentioned earlier, SSIDs are generally stripped from
+         callsigns except in two cases:
+       <ol>
+               <p><li>For Cluster node callsigns. Although here in the UK we are issued with
+               special callsigns to run cluster nodes and BBSs, this is not universal. Therefore
+               by marking a callsign as a node you disable SSID checking. You will have to treat
+               incoming cluster callsigns specially in <tt>ax25d.conf</tt> to use this feature (i.e
+               you will have to set up a line specially for that callsign with a %s or %S for the
+               callsign substitution [better just put the callsign you want!]).
+
+               <p><li>The sysop callsign set up in your local copy of 
+               <a href="install.html#dxvar">DXVars.pm</a>. You must call <tt>client.pl</tt> with
+               no parameters for this to work.
+       </ol>
+
+       <h4>Files</h4>
+
+       The client only uses files when in the <b>login</b> phase.  It
+       prints the <tt>/spider/data/issue</tt> file, if it is present, to
+       the user before issuing the <tt>login:</tt> prompt. After a callsign
+       and password is entered it uses
+       the standard cluster user file to check them.
+
+
+<!-- Standard Footer!! -->
+       <p>&nbsp;</p>
+       <p>
+         <FONT COLOR="#606060"><hr></font>
+       <font color="#FF0000" size=-2>
+         Copyright &copy; 1998 by Dirk Koopman G1TLH. All Rights Reserved<br>
+       </font>
+       <font color="#000000" size=-2>$Id$</font>
+  </body>
+</html>
index 5ffa84c38ab11323ce2842debc6a8e7be20099ad..1da205546820bd7fd7c3248b87632c9311854378 100644 (file)
@@ -19,7 +19,7 @@
        <p>
          <!-- Created: Sun Dec 13 20:25:14 GMT 1998 -->
          <!-- hhmts start -->
-Last modified: Sun Dec 20 18:15:15 GMT 1998
+Last modified: Mon Dec 21 11:57:54 GMT 1998
 <!-- hhmts end -->
 
        <h4>Introduction</h4>
@@ -120,7 +120,7 @@ $def_hopcount = 15;
          is working at least as well as advertised) you should keep the default hop 
          counts down to the sort of levels shown above.
  
-       <h4>Isolated Networks</h4>
+       <h4><a name="isolate"></a>Isolated Networks</h4>
 
        It is possible to isolate networks from each other on a "gateway" node using
        the <tt>set/isolate &lt;node call></tt> command.
index 72e277a5fb3ef53e49a5007eea94dad783168cea..f10c02656b249d10a8fc8d3a10282f908614933b 100644 (file)
@@ -18,7 +18,7 @@
        <p>
        <!-- Created: Wed Dec  2 18:22:33 GMT 1998 -->
        <!-- hhmts start -->
-Last modified: Sun Dec 20 16:25:28 GMT 1998
+Last modified: Mon Dec 21 11:58:48 GMT 1998
 <!-- hhmts end -->
        <p>The DXSpider dx cluster system is written in perl5 as an exercise in self-training
          for both protocol research and teaching myself perl.
@@ -28,8 +28,9 @@ Last modified: Sun Dec 20 16:25:28 GMT 1998
        <ol>
          <li> <a href="install.html">Installation</a> of the main cluster software.
          <li> Installing the lastest version of <a href="cpan.html">CPAN</a>.
+         <li> Explaining the <a href="client.html">client.pl</a> program.
          <li> <a href="connect.html">Connecting</a> to other clusters.
-         <li> <a href="hops.html">Hop</a> control, network <a href="hops.html">isolation</a> etc.
+         <li> <a href="hops.html">Hop</a> control, network <a href="hops.html#isolate">isolation</a> etc.
          <li> <a href="../download/">Download</a> the software and any patches.
          </ol>
 
index 089854b7aba3255636db8e7a47bf7d7d638cdf2f..753144b760ff754b9300982aab0ed9d37fcbf94f 100644 (file)
@@ -17,7 +17,7 @@
        <address><A HREF="mailto:ip@g8sjp.demon.co.uk">Iain Phillips G0RDI</A></address>
 <!-- Created: Wed Dec  2 16:40:25 GMT 1998 -->
 <!-- hhmts start -->
-Last modified: Sun Dec 20 17:55:19 GMT 1998
+Last modified: Mon Dec 21 11:26:05 GMT 1998
 <!-- hhmts end -->
        <P>This HOWTO describes the installation for DX Spider v1.11 on a "vanilla" 
          <A href="http://www.redhat.com">RedHat</A> 5.1 platform, 
@@ -246,7 +246,7 @@ default  * * * * * *  - sysop /spider/perl/client.pl client.pl %u ax25
                </PRE>
                <P>This has to be done to allow you to specify the correct callsigns on outgoing connects
 
-               <p><LI>Login to your computer as sysop, and create the initial DX Spider parameters necessary to start the cluster for the first time.
+               <p><LI><a name="dxvar"></a>Login to your computer as sysop, and create the initial DX Spider parameters necessary to start the cluster for the first time.
                <PRE>
 $ startx&#9;&#9;&#9;(much easier to use X)
 $ cd /spider