preparing for 1.23 release
[spider.git] / html / connect.html
index 902af164c73dfd518065a624c1f1d12341768e0d..f4f6308af90c6987252c0195335ac12a3eb05a19 100644 (file)
@@ -19,7 +19,7 @@
        <p>
          <!-- Created: Sun Dec 13 20:25:14 GMT 1998 -->
          <!-- hhmts start -->
-Last modified: Sun Dec 20 17:04:05 GMT 1998
+Last modified: Fri Jan  8 14:27:18 GMT 1999
 <!-- hhmts end -->
        <p>At the moment, anybody can connect inwards at any time from outside, either by ax25 or by
          telnet (assuming you have followed the instructions in <a href="install.html">installation</a>
@@ -28,16 +28,40 @@ Last modified: Sun Dec 20 17:04:05 GMT 1998
        <p><em>Connect</em> scripts live in the <tt>/spider/connect</tt> directory and are simple ascii scripts
          that are written using a normal editor. There are a couple of examples in the issue directory.
          
-       <p>Here are a couple of basic types, first a telnet connection:-
+       <p>Here are a few of basic types, first a telnet connection where the 
+          client is set up in the passwd file thus:-
+       <pre>
+    gb7djk:x:1372:1291::/home/gb7djk:/usr/bin/perl /spider/perl/client.pl gb7djk telnet
+       </pre>
+       and the connect script would be:-
        <pre>
     timeout 15
     # this is a comment
     connect telnet dirkl.tobit.co.uk
     'login' 'gb7djk'
     'word' 'gb7djk'
-    client gb7djk-1 telnet
+    client gb7djk telnet
+       </pre>
+       <p>For a connect that requires a login and execution of the programs
+         from a normal shell, do:-
+
+       <pre>
+    timeout 15
+    connect telnet dirkl.tobit.co.uk
+    'login' 'gb7djk'
+    'word' 'gb7djk'
+    '\$' 'cd /spider/perl'
+    # set the line to prevent echoing, leaving this out will
+    # confuse whole networks for hours!
+    '\$' 'stty -echo raw'
+    # tell GB7DJK that you are GB7DJK-1
+    '\$' 'client.pl gb7djk-1 telnet'
+    # tell GB7DJK-1 that it is connected to GB7DJK
+    # you can leave this out if you call this script 'gb7djk'
+    client gb7djk telnet
        </pre>
-       <p>and an ax25 example:-
+
+       <p>and finally an ax25 example:-
        <pre>
     timeout 60
     abort (Busy|Sorry|Fail)
@@ -47,6 +71,7 @@ Last modified: Sun Dec 20 17:04:05 GMT 1998
     'Connect' 'c np7'
     'Connect' 'c gb7dxm'
     'Connect' ''
+    # you can leave this out if you call the script 'gb7dxm'
     client gb7dxm ax25
        </pre>